2023-05-26    2024-04-19    2135 字  5 分钟

🚨 后又陆陆续续加了些辅助功能,可以点击下载最新完整的 search.js 源码(另存后使用编辑器打开就不中文乱码了)。

更新日志

- 2024-03-20 11:42 修复多 sections 时站点文章内容索引不完全的问题
- 2022-07-13 11:02 修改了站点内容结构解析方式,以解决随着文章数量增长导致搜索性能下降的问题

简介

近来稍闲,实现了一个 Hugo 本地搜索的小功能,分享一下 🍧 。

:: 这个功能写了两遍,第一次不知道怎么着就在一个临时分支(切换回主分支会自动消失的那种 😠 )中开发了,然后就没什么然后了…… 感觉是 IDE 的锅,对,就是它的,不是也要是!

让我们先来看一下,它可以做什么吧:

  • 内容实时搜索;
  • 搜索内容摘要显示;
  • 搜索词高亮。

都是一些搜索时常用的功能。稍后,我们来看一下上述功能的一些细节,以及开发过程中的一些糗事 😄 。你也可以,先在这里体验一下它的大概使用效果 Search 。

使用

如何实时获取站点的所有内容呢?这里有两个方面,一就是获取站点的所有页面内容,二是实时获取。

搜索模板页

一个大概的思路,就是创建一个模板页,如 _search.html 文件(详见 _search.html),利用 Hugo 模板本身的变量(如 .Site)来获取站点所有的页面内容。

> 废弃 {{ range where .Site.Pages "Kind" "section" }}

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
<div class="container-search">
    <div id="data" style="display: none;">
    <!-- 遍历所有的站点页面 -->
    {{ range where .Site.Pages "Kind" "page" }}
        {{ if (and (ne .Section "snippets"))}}
            [{{- dict 
                    "title" (lower .Title) 
                    "permalink" .Permalink 
                    "date" (.Date | time.Format "2006-01-02")
                    "summary" .Summary
                    "content" (lower .Plain)
                | jsonify -}},]
        {{ end }}
    {{ end }}
    </div>
	<!-- 搜索框 -->
    <div id="search">
        <!-- 🔎 -->
        <span class="sc-icon"><img src="/imgs/icons/search.svg" width="48"> </span>
        <span id="sc-clear" onclick="clearInputVal()">✖</span>
        <input id="sc-input" oninput="search()" type="text" placeholder="here search search..." />
        <div id="sc-res"></div>
    </div>
	<!-- 加载所需搜索脚本 -->
    <script src="/js/search.js" defer></script>
</div>
</div>

当然,你可以进行按需进行一些修改,过滤掉一些,你不想被搜索到的页面。

下面,我们来看一下核心的 js 搜索脚本 search.js (这里我们放在了 static/js/search.js)。其中的注释,是开发过程中帮助记忆和理清思路和一些碎碎念,不要在意。😅

解析站点页面内容

1
2
3
4
let data = document.querySelector('#data').innerText.trim();
data = data.slice(0, data.length - 2) + ']';
data = data.replace(/\]\s+\[/g, '');
let map = JSON.parse(data);

我们使用 Hugo 模板提供的相关功能,组织站点内容映射,以文本形式放在元素 #data 中,后反序列化以得到当前站点所有页面内容的一个集合 map 。

如何搜索

我们的核心就是搜索函数 search() 。在 map 的生成过程中,我们对信息串的 content 做了一些处理,如将所有字符转化为小写。在 search() 中,我们也对搜索词 scVal 进行同样的处理,以实现不区分大小写的内容搜索。

在这之前,我们定义了另一个辅助函数,用来返回搜索词 scVal 在对应页面中出现的所有索引位置 _arrIndex 。

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12
13
function scanStr(content, str) {        // content 页面内容信息串
    let index = content.indexOf(str);   // str     出现的位置
    let num = 0;                        // str     出现的次数
    let arrIndex = [];                  // str     出现的位置集合

    while(index !== -1) {
        arrIndex.push(index);
        num += 1;
        index = content.indexOf(str, index + 1); // 从 str 出现的位置下一位置继续
    }

    return arrIndex;
}

有它 scanStr 我们就可以方便的知道搜索词都出现在了哪里,以方便后续的内容摘要截取及高亮。

内容摘要截取

通过 scanStr ,我们得到了搜索词在页面内容出现的所有位置,我们默认截取每个位置前后 100 个字符长度(后续我称之后 截取半径)的内容进行罗列展示(可以自定义长度)。这里,我们做了一些小小的优化操作,当后续搜索词的索引位置与当前搜索词的索引位置之差仍小于截取半径的时候,将不再对该位置前后内容进行截取(因为它已经包含在了之前的截取内容中),以避免大量重复性内容的展示。

具体逻辑,还是直接看代码吧,其实不需要了解,因为它并没有什么太大的通用性,都是对字符串的蹂躏和被蹂躏。😿

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
let scInput = document.querySelector('#sc-input');
let scRes = document.querySelector('#sc-res')
let scVal = '';

scInput.focus(); // 自动聚集搜索框

function search() {
    let post = '';
    scVal = scInput.value.trim().toLowerCase();

    map.forEach(item => {
        if (!scVal) return;
        if (item.content.indexOf(scVal) > -1) {
            let _arrIndex = scanStr(item.content, scVal);
            let strRes = '';
            let _radius = 100;  // 搜索字符前后截取的长度
            let _strStyle0 = '<span style="background: yellow;">'
            let _strStyle1 = '</span>'
            let _strSeparator = '<hr>'


            // 统计与首个与其前邻的索引(不妨称为基准索引)差值小于截取半径的索引位小于截取半径的索引的个数
            // 如果差值小于半径,则表示当前索引内容已包括在概要范围内,则不重复截取,且
            // 下次比较的索引应继续与基准索引比较,直到大于截取半径, _count重新置 为 0;
            let _count = 0;

            for (let i = 0, len = _arrIndex.length; i < len; i++) {
                let _idxItem = _arrIndex[i];
                let _relidx = i;


                // 如果相邻搜索词出现的距离小于截取半径,那么忽略后一个出现位置的内容截取(因为已经包含在内了)
                if (_relidx > 0 && (_arrIndex[_relidx] - _arrIndex[_relidx - 1 - _count] < _radius)) {
                    _count += 1;
                    continue;
                }
                _count = 0;

                // 概要显示
                // _startIdx, _endIdx 会在超限时自动归限(默认,无需处理)
                strRes += _strSeparator;
                let _startIdx = _idxItem - _radius + (_relidx + 1) * _strSeparator.length;
                let _endIdx = _idxItem + _radius + (_relidx + 1) * _strSeparator.length;
                strRes +=  item.content.substring(_startIdx, _endIdx);
            }

            // 进一步对搜索摘要进行处理,高亮搜索词
            let _arrStrRes = scanStr(strRes, scVal);
            // console.log(_arrStrRes)
            for (let i = 0, len = _arrStrRes.length; i < len; i++) {
                let _idxItem = _arrStrRes[i];
                let _realidx = i;

                strRes =
                    strRes.slice(0, (_idxItem + _realidx * (_strStyle0.length + _strStyle1.length))) +          // 当前索引位置之前的部分
                    _strStyle0 + scVal + _strStyle1 +
                    strRes.slice(_idxItem + scVal.length + _realidx * (_strStyle0.length + _strStyle1.length)); // 之后的部分
            }

            post += `
                <div class="item" >
                    <a href="${item.permalink}">
                        <span>📄</span>
                        <span class="date">${item.date}</span>
                        <span>${item.title}</span>
                    </a>
                    <div>${strRes}</div>
                </div>
            `
        }
    })

    let res = `<div class="list">${post}</div>`;
    scRes.innerHTML = res;

高亮显示

在遍历获取了所有的搜索摘要 strRes 后,我们需要对其进行进一步的处理,以实现搜索词高亮显示,如下:

![[assets/Pasted image 20230526104035.png]]

同样,这也是和字符串长度之间的征战,没什么太大意思。

最后

只需要把 search.js 放在 static/js/ 目录下,或者其他你喜欢的路径,但要保证 _search.html 可以正常引用。再使用 Hugo 创建一个对应的 search.md 页面,用来启用 _search.html 模板即可。比如我把 _search.html 模板放在了 single.html 模板中,并且设置只有 /search 路径才加载这部分内容。

{{ $IsSearch := eq .Title "Search"}}
{{ if $IsSearch }}
    {{- partial "partials/_search.html" . -}}
{{ end }}

上述代码块中的代码,是完整可用的,复制粘贴即可。