title: blog-theme-fluid
date: 2020-03-09 20:33:18
categories:
- 其他教程
tags:
- blog

安装 Hexo

全局安装
$ npm install hexo-cli -g #282a2e
创建项目
$ hexo init [folder]
# folder  项目名称
启动预览
$ hexo server 预览

# 如你是 webstrom 可在 package 内的 scripts 中添加

"start": "hexo server"

# 方便以后启动预览
新建页面
$ hexo new [layout] <title>

安装 Next 主题

官网 http://theme-next.iissnan.com/

# 官网提供的是 旧版 链接,注意本文的发布日期再去官网对照
$ cd hexo
$ git clone https://github.com/theme-next/hexo-theme-next themes/next
安装完成之后去站点配置文件,根目录/_config 选用 Next
theme: next
配置菜单的 分类、标签
$ cd your-hexo-site
$ hexo new page tags
修改菜单(Next 主题配置文件)
menu:
  home: /
  archives: /archives
  tags: /tags
使用
# ---
# 分类
categories:
  - 其他教程
# 标签
tags:
  - blog
# ---

安装 Algolia 搜索

此操作流程只在 Next 主题下测试

Algolia 搜索

NexT 内部提供 Algolia 的搜索功能,要使用此功能请确保所使用的 NexT 版本在 v5.1.0 之后。需要注意的是,仅仅将 next/_config.ymlalgolia_searchenable 打开并不能让你使用 Algolia 搜索,你还需要使用对应的 Hexo-Algolia 插件 才能真正在博客页面中使用 Algolia 搜索。按照下面介绍的步骤操作即可完成 Algolia 搜索的安装。

  1. 前往 Algolia 注册页面,注册一个新账户。 可以使用 GitHub 或者 Google 账户直接登录,注册后的 14 天内拥有所有功能(包括收费类别的)。之后若未续费会自动降级为免费账户,免费账户 总共有 10,000 条记录,每月有 100,000 的可以操作数。注册完成后,创建一个新的 Index,这个 Index 将在后面使用。

  2. Index 创建完成后,此时这个 Index 里未包含任何数据。接下来需要安装 Hexo Algolia 扩展,这个扩展的功能是搜集站点的内容并通过 API 发送给 Algolia。前往站点根目录,执行命令安装:

    $ cd hexo
    $ npm install --save hexo-algolia
  3. API Keys 页面找到需要使用的一些配置的值,包括 ApplicationIDSearch-Only API Key。注意,Admin API Key 需要保密保存,不要外泄。

  4. API Keys 页面,点击 ALL API KEYS 找到新建 INDEX 对应的 key,编辑权限,在弹出框中找到 ACL ,勾选 Add records、 Delete records、List indices、Delete index 权限,点击 update 更新。


  5. 编辑 站点配置文件,新增以下配置,除了 chunkSize 字段,替换成在 Algolia 获取到的值:

    algolia:
      applicationID: 'applicationID'
      apiKey: 'apiKey'
      indexName: 'indexName'
      chunkSize: 5000
  6. 当配置完成,在站点根目录下执行一下命令来更新上传 Index。请注意观察命令的输出。

    $ export HEXO_ALGOLIA_INDEXING_KEY=Search-Only API key # 使用 Git Bash
    # set HEXO_ALGOLIA_INDEXING_KEY=Search-Only API key # 使用 Windows CMD 命令行
    $ hexo clean
    $ hexo algolia

  7. 切换到 NexT 目录,并安装 algolia-instant-search 到 source/lib 目录。

    $ cd themes/next
    $ git clone https://github.com/theme-next/theme-next-algolia-instant-search source/lib/algolia-instant-search

    如果你想直接使用 CDN 设置 Algolia Search,则需要在主题配置文件中添加 vendors 字段:

    vendors:
      ...
      # Internal version: 1
      # https://www.algolia.com
      algolia_instant_js: https://cdn.jsdelivr.net/npm/instantsearch.js@2.4.1/dist/instantsearch.js
      algolia_instant_css: https://cdn.jsdelivr.net/npm/instantsearch.js@2.4.1/dist/instantsearch.min.css
      ...
  8. 更改主题配置文件,找到 Algolia Search 配置部分,将 enable 改为 true。同时你需要关闭其他搜索插件,如 Local Search 等。你也可以根据需要调整 labels 中的文本:

    # Algolia Search
    algolia_search:
      enable: true
      hits:
        per_page: 10
      labels:
        input_placeholder: Search for Posts
        hits_empty: "We didn't find any results for the search: ${query}"
        hits_stats: "${hits} results found in ${time} ms"

已知的问题

  1. 考虑到 Algolia 免费账户的限制,目前 Hexo-Algolia 插件最新版本去掉了正文索引功能。
  2. Hexo-Algoliasearch 插件提供了正文索引功能,不过需要替换 NEXT 主题中的关键字。对于免费账户,Record Too Big 的问题同样存在。
    • 替换 source/js/algolia-search.js 中所有的 applicationIDappId
    • 替换 layout/_partials/head/head.swig 中所有的 applicationIDappId

此文档在 /themes/nest/docs/ALGOLIA-SEARCH

看完以上文档,默认你以安装完 Algolia,接下来使用 Hexo-Algoliasearch

在站点配置文件
algolia:
  # appid 为 applicationID 如未替换需替换
  appId: "Z7A3XW4R2I"
  # search only key
  apiKey: "12db1ad54372045549ef465881c17e743"
  adminApiKey: "40321c7c207e7f73b63a19aa24c4761b"
  chunkSize: 5000
  indexName: "my-hexo-blog"
  fields:
    - content:strip:truncate,0,500
    - excerpt:strip
    - gallery
    - permalink
    - photos
    - slug
    - tags
    - title

配置完成后运行

$ hexo clean
$ hexo algolia

配置好以上,Next的algolia搜索是没有内容搜索的,所以配置了上面的插件。
默认 algolia 搜索显示只有标题,关键词未高亮,所以开始了老本行工作。

  1. 打开配置文件 /themes/next/source/js 替换以下内容
instantsearch.widgets.hits({
      container  : '#algolia-hits',
      hitsPerPage: algoliaSettings.hits.per_page || 10,
      templates  : {
        item: function(data) {
          var link = data.permalink ? data.permalink : CONFIG.root + data.path;
          return (
            `
              <ul>
                <li>
                  <a href=${link} class="algolia-hit-item-link">${data._highlightResult.title.value}</a>
                  <a href=${link} class="algolia-hit-item-match">
                    <p>${data._highlightResult.contentStripTruncate.value}</p>
                  </a>
                </li>
              </ul>

            `
          );
        },
        empty: function(data) {
          return (
            '<div id="algolia-hits-empty">'
          + algoliaSettings.labels.hits_empty.replace(/\$\{query}/, data.query)
          + '</div>'
          );
        }
      },
      cssClasses: {
        item: 'algolia-hit-item'
      }
    })
  1. 修改 css /themes/next/source/css/main.styl
.algolia-hit-item-match
  text-decoration none
  border none
  color rgba(31, 31, 31, 0.37)
  &:hover
    color rgba(34, 34, 34, 0.53)

  em
    padding 3px
    border-bottom: 1px dashed #f00;
    font-weight: bold;
    color: #f00;