博客终于搭好了,QAQ简直一把辛酸泪,还是记录一下。

版本

Ubuntu 14.04
git version 1.9.1
Node.js v6.10.0
npm 3.10.10
hexo 3.2.2

安装

安装还是推荐官方文档,省得被网上形形色色的教程坑了。

我装 Node.js 的时候一开始试图用 nvm ,然而执行 nvm install node 毫无反应,node ls-remote 显示 N/A,nodejs.org 时断时连,看 issue 可能跟代理有关系,搞了半天最后放弃,从官网下载 installer 了。参考了这篇文章

但是 npm install -g hexo-cli 之后 hexo 提示 command not found,后来按照这篇博客的方法解决了,就是每次都要 sudoDocs 里对此也有说明。

补充
某次重装系统没格式化 /home,安装好 Node.js, npm 和 hexo 之后,在站点根目录下执行 hexo 提示要再执行 npm install hexo --save,执行完之后基本就正常了。

配置

基本信息

站点根目录下的 _config.yml 文件包含了 Hexo 本身的配置,此处依然可以参考官方文档

默认的文章链接分级太多,不利于搜索引擎检索。将 permalink 字段改为 permalink: :year-:month-:day/:title/

最后 deploy 部分,用 ssh 方式的话:

1
2
3
4
deploy:
type: git
repo: git@github.com:Username/Username.github.io.git
branch: master

https 方式每次 push 都需要验证用户名密码,不建议。

之后就可以 init, generate, server 啦!

补充关于站点配置文件里language的写法:对于maupassant主题,应该写 zh-CN

一开始查了List of ISO 639-1 codes之后我直接写了zh,站点依然是英文且偶有乱码;

后来看到主题文件夹下的 language/ 里只有 zh-CNzh-TW,改成 zh-CN就好了。

再后来看到 NexT 文档里的简体中文写法是zh-Hans,就查了查,看到了这个,挺乱的反正。

更换主题 maupassant

找到了一个简洁的主题 maupassant,使用参考开发者博客

npm install hexo-renderer-jade --save 时候的警告不用在意。

如果要把本地 Hexo 文件也备份到 Github 的话,这里不要直接 clone 作者的版本,参见我的下一篇文章

另外,我对主题进行了一些定制,具体见这篇文章

补充

某次重装系统之后, hexo 安装好之后执行 hexo s 虽然看起来还算正常但报了奇怪的错误,似乎是 sass 的问题,按照提示执行 npm rebuild node-sass 之后再执行 hexo s 直接 Bus error (core dumped) 了。无奈执行 npm uninstall hexo-renderer-sass 准备卸载重装,然而卸载完 server 似乎就正常了……感觉非常微妙,凑合用着吧。

还参考了

http://taosama.github.io/2016/03/09/Hello%20World%20%E2%80%94%E2%80%94%20%E5%8D%9A%E5%AE%A2%E6%90%AD%E5%BB%BA%E5%8E%86%E7%A8%8B
http://theme-next.iissnan.com/third-party-services.html
http://www.cnblogs.com/liulangmao/p/4323064.html
http://www.tuicool.com/articles/2mAfIne
http://www.jianshu.com/p/e99ed60390a8
http://www.jianshu.com/p/465830080ea9
http://www.imooc.com/article/4433
https://www.haomwei.com/technology/maupassant-hexo.html
https://zhuanlan.zhihu.com/p/22191919