github
/
hexo-theme-icarus
mirror of https://github.com/ppoffice/hexo-theme-icarus
1
0
Fork 0
Code Issues Projects Releases Wiki Activity
hexo-theme-icarus/source/_posts/zh-CN/Search-Plugins.md

6.5 KiB
Raw Blame History

title: Icarus用户指南 - 站内搜索插件 date: 2016-01-01 categories:

  • Plugins
  • Search tags:
  • Icarus用户指南 language: zh-CN toc: true providers: cdn: loli fontcdn: loli iconcdn: loli

本文介绍Icarus 4支持的站内搜索插件的安装配置。

本文同时提供以下语言的翻译：English。

Algolia

安装指南 在线预览

  1. 在Hexo站点的根目录安装hexo-algolia插件。

  2. 注册并登录Algolia。 首次登录控制面板(Dashboard)时点击页面上的“创建索引”(Create Index)按钮。 然后，输入”索引名称“(Index name)并点击“创建”(Create)完成索引创建。

    {% img "box px-0 py-0 ml-auto mr-auto" /gallery/screenshots/algolia-create-index.png 360 '"创建索引 - Algolia" "创建索引 - Algolia"' %}

  3. 下一步，点击右侧导航栏上的”API密钥“(API Keys)，复制页面上的“应用ID”(Application ID)和“仅限搜索的API Key” (Search-Only API Key)。 打开Hexo站点根目录下的站点配置文件_config.yml，填入上面复制的信息到hexo-algolia插件的配置中。

    {% img "box px-0 py-0 ml-auto mr-auto" /gallery/screenshots/algolia-api-keys.png 360 '"API密钥 - Algolia" "API密钥 - Algolia"' %}

    例如，下面的Algolia索引信息：

    {% codeblock "Algolia索引信息" %} Algolia索引名称: My-Hexo-Site Application ID: ABCDEFGHIJKL Search-Only API Key: 7b08fca7d42412cee901a25643124221 {% endcodeblock %}

    对应的站点配置为：

    {% codeblock _config.yml lang:yaml %} algolia: applicationID: My-Hexo-Site indexName: ABCDEFGHIJKL apiKey: 7b08fca7d42412cee901a25643124221 {% endcodeblock %}

  4. 回到Algolia控制面板的”API密钥“(API Keys)页面并切换到“所有API Keys”(All API Keys)标签页。 点击“新建API Key”(New API Key)按钮。 在弹出的“创建API Key”(Create API Key)对话框中，在”索引“(Indices)处选择你在上一步中创建的“索引”(Indices)。 然后，“ACL”项中添加addObject，deleteObject，listIndexes， deleteIndex。 点击“创建”(Create)完成密钥的创建。 复制刚刚创建的API Key，例如727fbd8c998fe419318fa350db6793ca。

    {% img "box px-0 py-0 ml-auto mr-auto" /gallery/screenshots/algolia-create-api-key.png 360 '"创建API密钥 - Algolia" "创建API密钥 - Algolia"' %}

  5. 打开一个Windows命令行(CMD)或Linux/macOS终端并切换当前目录到你的Hexo站点的根目录。 设置环境变量HEXO_ALGOLIA_INDEXING_KEY为上一步中创建的API Key。 hexo-algolia插件上传网站索引时会用到这个变量。

    Windows下：

    {% codeblock "Windows命令行(CMD)" lang:cmd %} C:\Users\you> cd path/to/your/hexo/site C:\Users\you> set HEXO_ALGOLIA_INDEXING_KEY=727fbd8c998fe419318fa350db6793ca {% endcodeblock %}

    Linux/macOS下：

    {% codeblock "Linux/macOS终端" lang:shell %} $ cd path/to/your/hexo/site $ export HEXO_ALGOLIA_INDEXING_KEY="727fbd8c998fe419318fa350db6793ca" {% endcodeblock %}

    然后，运行下面的命令来清理站点并上传网站索引到Algolia：

    {% codeblock "Windows命令行(CMD)或Linux/macOS终端" lang:shell %} $ hexo clean $ hexo algolia {% endcodeblock %}

  6. 最后，在主题配置中设置搜索引擎为Algolia：

    {% codeblock _config.icarus.yml lang:yaml %} search: type: algolia {% endcodeblock %}

百度搜索

安装指南

  1. 打开主题配置文件并设置搜索为百度搜索：

    {% codeblock _config.icarus.yml lang:yaml %} search: type: baidu {% endcodeblock %}

谷歌自定义搜索

安装指南 在线预览

  1. 登录你的谷歌账户并访问Google CSE来创建自定义搜索。 在“需要搜索的站点”(Sites to Search)中填入你的Hexo站点域名。 在“语言”(Language)选择框中选择正确的语言。 然后填写自定义“搜索引擎名称”(Name of the search engine)。 点击“创建”(Create)按钮完成引擎的创建。

    {% img "box px-0 py-0 ml-auto mr-auto" /gallery/screenshots/google-cse-create.png 360 '"创建自定义搜索 - Google CSE" "创建自定义搜索 - Google CSE"' %}

  2. 然后，点击页面上的“添加到你的站点”(Add it to your site)右侧的“获取代码”(Get code)按钮。 从HTML代码中复制cx的值填入到对应主题配置项中。

    {% img "box px-0 py-0 ml-auto mr-auto" /gallery/screenshots/google-cse-code.png 360 '"获取代码 - Google CSE" "获取代码 - Google CSE"' %}

    例如，下面的HTML代码：

    {% codeblock "Google CSE HTML代码" lang:html %}

    {% endcodeblock %}

    对应下面的主题配置：

    {% codeblock _config.icarus.yml lang:yaml %} search: type: google_cse cx: 012345601234560123456:abcdefghijklmn {% endcodeblock %}

Insight

安装指南

  1. Insight为本站默认的站内搜索引擎。 你可以通过下面的主题配置来启用它：

    {% codeblock _config.icarus.yml lang:yaml %} search: type: insight {% endcodeblock %}

文章内容有误？请点击此处提交修改。