快速开始

遇到问题怎么办?

在使用 Nexmoe 之前,请仔细阅读 Hexo 的官方文档,完成对 Hexo 的安装,并完成对 站点配置文件 的基本配置(标题、介绍、作者、时区、语言等)。

1、查阅 Hexo 官方文档

一般遇到的问题都是对 Hexo 不熟悉导致的,本主题作者也不是很了解 Hexo,所以经常会去看官方文档。

Hexo 官方文档解决大部分问题!

请仔细阅读 Hexo 的官方文档

请仔细阅读 Hexo 的官方文档

请仔细阅读 Hexo 的官方文档

2、查阅本文档

本文档内容较少,只解决常见问题

3、使用搜索引擎

以上方法解决不了的问题,搜索引擎一定能解决,如果搜索引擎都解决不了,那就没办法了。

下载

下载最新 Release 版本

最新的释出版本,适合大部分用户。

下载其他版本

你可以自己决定想要使用的版本;部分版本可能不再提供技术支持。

选择你所需要的版本,在新打开的页面中找到 Assets 区域,下载 Source Code (zip) 到本地。 解压所下载的压缩包至站点的 themes 目录下, 并将 解压后的文件夹名称 更改为 nexmoe(推荐)。

使用 Git

你可以自己决定想要使用的分支;使用 Git 下载 nexmoe 以后还可以使用 git pull 更新 nexmoe。




 

cd themes
git clone https://github.com/nexmoe/hexo-theme-nexmoe.git nexmoe
cd nexmoe
git checkout {branch/tags name/commit hash}
1
2
3
4

安装 Nexmoe

其他主题不同,安装 Nexmoe 需要额外的步骤;主题默认已经集成了文章【字数统计】、【阅读时长】统计功能,且暂时无法关闭。如果没有安装 hexo-wordcount 插件,先安装该插件:

npm i --save hexo-wordcount
1

Node 版本 7.6.0 之前,请安装 2.x 版本 (Node.js v7.6.0 and previous) ,安装命令如下:

npm install hexo-wordcount@2 --save
1

同时你需要把nexmoe主题目录下的 _config.example.yml 复制一份并把副本重命名为 _config.yml

cp -i _config.example.yml _config.yml
1

因为在主题的开发迭代过程中,主题的配置文件 很有可能会有变动。所以我们把 _config.yml 添加到了 .gitignore 之中,这样可以避免使用 git pull 更新主题的用户出现冲突。

启用 Nexmoe

站点配置文件 中,修改 theme 的值为 nexmoe

如果在安装时你将主题文件夹重命名为其它名字,就修改为你重命名后文件夹的名字

运行 Nexmoe

在站点根目录下运行下面的命令在本地启动一个 Hexo Server。

hexo s --debug
1

在服务启动的过程,注意观察命令行输出是否有任何异常信息,如果你碰到问题,这些信息将帮助他人更好的定位错误。

当命令行输出下述内容时说明 Hexo 已经监听在本机的 4000 端口,使用浏览器访问 http://localhost:4000 ,检查站点是否正确运行。

INFO  Hexo is running at http://localhost:4000/. Press Ctrl+C to stop.
1

如果你在使用过程中遇到问题,请尝试在文档中进行搜索,或者在 GitHub 上 提出 issue

更新 Nexmoe

如果你是在 版本发布页 下载并安装的 Nexmoe,那么你需要备份你的 主题备份文件,然后将旧的主题文件夹命名为 nexmoe-old,将下载的新版本 Nexmoe 重命名为 nexmoe,根据更新日志的指导迁移旧的 主题配置文件 到新的 主题配置文件 中。测试通过后你可以将 nexmoe-old 删除。

如果你使用 Git 安装的 Nexmoe,你可以直接在主题文件夹下运行 git pull 更新主题,并把备份之前的 主题配置文件 重命名为 _config.old.yml,复制一份 _config.example.yml 并重命名为 _config.yml。从 _config.old.yml 迁移你的配置到新的 _config.yml测试通过后你可以将 _config.old.yml 删除。