静态站点拥有一定的局限性,因此我们需要借助于第三方服务来扩展站点的功能。 以下是 NexT 目前支持的第三方服务,你可以根据你的需求集成一些功能进来。

NexT 支持 多说DISQUS 评论系统。 当同时设置了 多说 和 DISQUS 时,优先选择多说。 NexT 内置了一套 多说 的样式。

如需取消某个 页面/文章 的评论,在 md 文件的 front-matter 中增加 comments: false

多说

使用多说前需要先在 多说 创建一个站点。具体步骤如下:

  1. 登录后在首页选择 “我要安装”。
  2. 创建站点,填写表单。多说域名 这一栏填写的即是你的 duoshuo_shortname,如图:

  3. 创建站点完成后在 站点配置文件 中新增 duoshuo_shortname 字段,值设置成上一步中的值。

DISQUS

编辑 站点配置文件, 添加 disqus_shortname 字段,设置如下:

disqus_shortname: your-disqus-shortname

百度统计

  1. 登录 百度统计,定位到站点的代码获取页面
  2. 复制 hm.js? 后面那串统计脚本 id,如下图所示:
  3. 编辑 站点配置文件, 新增字段 baidu_analytics,值设置成你的百度统计脚本 id。

Google 分析

编辑 站点配置文件, 新增字段 google_analytics, 值设置成你的 Google 跟踪 ID。跟踪 ID 通常是以 UA- 开头。

腾讯分析 Cissoid 贡献

请登录 腾讯分析,登录并获取分析的 ID。 然后在 主题配置文件 里将 ID 放置 tencent_analytics 字段。

CNZZ 统计 jerrybendy 贡献

主题配置文件 中增加了一项 cnzz_siteid的配置项,值为 CNZZ 里面添加统计的站点ID。 这个ID可以在地址栏里,或者自动生成的脚本里面找到。

默认脚本生成的内容会产生“站长统计”几个字,感觉很丑而且和主题不太搭,我用了一个 display: none;把这几个字给隐藏了。

不蒜子统计 panzhitian 贡献

注意: 此特性在版本 5.0.1 中引入,要使用此功能请确保所使用的 NexT 版本在此之后

编辑 主题配置文件 中的busuanzi_count的配置项。

enable: true时,代表开启全局开关。若site_uvsite_pvpage_pv的值均为false时,不蒜子仅作记录而不会在页面上显示。

site_uv: true时,代表在页面底部显示站点的UV值。

site_uv_headersite_uv_footer为自定义样式配置,相关的值留空时将不显示,可以使用(带特效的)font-awesome。显示效果为[site_uv_header]UV值[site_uv_footer]

# 效果:本站访客数12345人次
site_uv: true
site_uv_header: 本站访客数
site_uv_footer: 人次

site_pv: true时,代表在页面底部显示站点的PV值。

site_pv_headersite_pv_footer为自定义样式配置,相关的值留空时将不显示,可以使用(带特效的)font-awesome。显示效果为[site_pv_header]PV值[site_pv_footer]

# 效果:本站总访问量12345次
site_pv: true
site_pv_header: 本站总访问量
site_pv_footer:

page_pv: true时,代表在文章页面的标题下显示该页面的PV值(阅读数)。

page_pv_headerpage_pv_footer为自定义样式配置,相关的值留空时将不显示,可以使用(带特效的)font-awesome。显示效果为[page_pv_header]PV值[page_pv_footer]

# 效果:本文总阅读量12345次
page_pv: true
page_pv_header: 本文总阅读量
page_pv_footer:

阅读次数统计(LeanCloud) Doublemine 贡献

请查看 为NexT主题添加文章阅读量统计功能

分享服务优先选择 JiaThis, 也就是说,当同时开启了 JiaThis、多说分享,将仅启用 JiaThis。

JiaThis

编辑 站点配置文件, 添加字段 jiathis,值为 true

JiaThis 内容分享服务配置示例
# JiaThis 分享服务
jiathis: true

百度分享

编辑 站点配置文件,添加字段 baidushare,值为 true

百度内容分享服务配置示例
# 百度分享服务
baidushare: true

多说分享

多说分享必须与多说评论同时使用

编辑 站点配置文件, 添加字段 duoshuo_share, 值为 true

多说内容分享服务配置示例
# 多说分享服务
duoshuo_share: true

AddThis hackjustu 贡献

  1. 在网站 AddThis 上注册账号。 可以使用 Google/Facebook/Twitter 账号进行第三方登陆
  2. 从下面菜单获得 AddThis id:More.. --> General --> ID。 具体 ID 获得方式参考以下截图
    AddThis Id
  3. 在主题_config.yml中,把#Share下的 #add_this_id取消注释, 改为add_this_id: put_your_add_this_id_here

NexT 支持集成 Swiftype微搜索、Local Search 和 Algolia。

Swiftype 站内搜索 lzlun129 贡献

前往 Swiftype 注册页面,注册一个新账户。

注册完成后,创建一个新的搜索引擎,并按照提示完成创建步骤。

搜索引擎创建完成后,在菜单中选择 Integrate -> Install Search 开启搜索定制,按照步骤完成定制。最后一步记得点击 Active 按钮。

返回定制引擎的第二个步骤 INSTALL CODE,复制出你的 swiftype_key

编辑 站点配置文件, 新增字段 swiftype_key,值设置成第四步中赋值出来的 key

# Swiftype Search Key
swiftype_key: xxxxxxxxx

微搜索 lzlun129 贡献

TBD

添加百度/谷歌/本地 自定义站点内容搜索

  1. 安装 hexo-generator-searchdb,在站点的根目录下执行以下命令:

    $ npm install hexo-generator-searchdb --save
    
  2. 编辑 站点配置文件,新增以下内容到任意位置:

    search:
      path: search.xml
      field: post
      format: html
      limit: 10000
    
  3. 编辑 主题配置文件,启用本地搜索功能:

    # Local search
    local_search:
      enable: true
    
注意: 此特性在版本 5.1.0 中引入,要使用此功能请确保所使用的 NexT 版本在此之后

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

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

npm install --save hexo-algolia

在 Algolia 服务站点上找到需要使用的一些配置的值,包括 ApplicationIDSearch API KeyAdmin API Key。注意,Admin API Key 需要保密保存。

编辑 站点配置文件,新增以下配置:

algolia:
  applicationID: 'applicationID'
  apiKey: 'apiKey'
  adminApiKey: 'adminApiKey'
  indexName: 'indexName'
  chunkSize: 5000
替换除了 chunkSize 以外的其他字段为在 Algolia 获取到的值。

当配置完成,在站点根目录下执行 hexo algolia 来更新 Index。请注意观察命令的输出。

更改主题配置文件,找到 Algolia Search 配置部分:

# Algolia Search
algolia_search:
  enable: false
  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"
enable 改为 true 即可,根据需要你可以调整 labels 中的文本。

MathJax

NexT 借助于 MathJax 来显示数学公式,此选项默认关闭。

编辑 主题配置文件,将 mathjax 设定为 true 即可。

# MathJax Support
mathjax:

ProTip: 使用七牛 CDN 来加速 MathJax 脚本的加载

编辑 主题配置文件, 将 mathjax 下的 enable 设定为 true 即可。 cdn 用于指定 MathJax 的脚本地址,默认是 MathJax 官方提供的 CDN 地址。

# MathJax Support
mathjax:
  enable: true
  cdn: //cdn.mathjax.org/mathjax/latest/MathJax.js?config=TeX-AMS-MML_HTMLorMML

Google Webmaster tools

设置 Google站点管理工具 的验证字符串,用于提交 sitemap

  1. 获取 google site verification code
    登录 Google Webmaster Tools,导航到验证方法,并选择 HTML Tag。将会获取到一段代码:

    <meta name="google-site-verification" content="XXXXXXXXXXXXXXXXXXXXXXX" />

    content 里面的 XXXXXXXXXXXXXXXXXXXXXXX 复制出来。

  2. 设置主题。编辑 站点配置,新增字段 google_site_verification

    google_site_verification: XXXXXXXXXXXXXXXXXXXXXXX
    

多说评论组件提供 热评文章 功能, 详情见 多说官网说明,仅在文章页面显示。

站点/主题配置文件 中设置:

# 多说热评文章 true 或者 false
duoshuo_hotartical: true

使用效果如下图: