使用hexo撰写blog

安装nvm管理node.js安装

推荐nvm来管理node.js版本，请参考nvm官方说明

curl -o- https://raw.githubusercontent.com/nvm-sh/nvm/v0.35.2/install.sh | bash

脚本在 ~/.nvm 目录下clone了nvm的git仓库，并在~/.bash_profile， ~/.zshrc， ~/.profile 或 ~/.bashrc 中添加了

export NVM_DIR="$HOME/.nvm"
[ -s "$NVM_DIR/nvm.sh" ] && . "$NVM_DIR/nvm.sh" # This loads nvm

不过，如果你的用户目录下没有上述profile文件，则不会自动添加。例如，最新的macOS Catalina默认使用zsh，在用户目录下默认并没有自己的profile。请参考 oh-my-zsh进行设置。

升级nvm也可以使用上述安装命令，会自动检测当前系统已经安装的nvm版本并使用git升级。
如果在Mac OS X中执行nvm命令提示nvm: command not found，则可能在执行上述脚本的时候，系统中尚未有~/.bash_profie，请先执行touch ~/.bash_profile，然后再执行一遍安装脚本

按照hexo官方文档，应该安装node.js的稳定版本

nvm install stable

可以安装指定版本node（如果需要特定的兼容特性）

nvm install 4.6.0
nvm alias default 4.6.0

早期使用nodejs，例如，2016年2月测试在一些插件兼容性上使用最细的 v5.x 会产生异常，此外，在gitbook的运行中发现，使用 node v5.x 出现cpu资源占用较高问题。不过，我在2016年10月采用最简单的typing模版时，使用最新的6.7.0系列发现无法正常显示，所以还是当时指定采用了4.6.0
如果使用node.js官方pkg包安装，会在系统级别安装到/usr/local目录下，但是对于hexo安装，总是需要使用sudo权限，非常不方便。所以推荐使用nvm作为node.js的包管理。

升级node.js

使用一段时间后，官方node.js长期稳定版本可能升级，例如，使用

nvm ls-remote --lts

可以看到

->       v4.6.0   (LTS: Argon)
         v4.6.1   (Latest LTS: Argon)

nvm install 4.6.1
nvm alias default 4.6.1
nvm uninstall 4.6.0

提示报错

nvm: Cannot uninstall currently-active node version, v4.6.0 (inferred from 4.6.0).

解决方法是（参考 nvm: Cannot uninstall currently-active node version）

nvm deactivate 4.6.0
nvm uninstall 4.6.0

此时还要再进行一次 nvm install 4.6.1 以便将当前活跃版本指向4.6.1

安装hexo

安装Hexo

npm install hexo-cli -g

先使用hexo初始化目录，这个目录名字可以是任意名称，最好和你的网址同名。这里我使用自己的个人网站blog.huatai.me

hexo init blog
cd blog
npm install

启动服务

hexo server

此时默认端口监听4000，可以通过参数 -p 3999 修改监听端口（如果在主机上运行多个服务）

升级hexo

使用一段时间，官方软件版本有所更新，可以使用如下命令升级

npm update -g

不过，遇到升级了node.js版本之后，再执行hexo new "xxxx"提示模块版本不一致

Error: Module version mismatch. Expected 48, got 46.

解决方法参考升级Node.js v6.0.0之后无法编译 #1939 Node.js – Error: Module version mismatch. Expected 48, got 46. 原理类似，在程序目录执行删除模块目录，然后重新安装模块

rm -rf node_modules/
npm i --no-optional

或

rm -rf node_modules && npm install

Typing主题

最初，想回归最简单的文字主题，采用 Maupassant ，参考大道至简——Hexo简洁主题推荐进行设置。不过，geekplux的typing似乎更为简洁，所以准备入手。

cd blog
git clone https://github.com/geekplux/hexo-theme-typing themes/typing

修改_config.yml将theme设置成typing

如果要更新：

cd themes/typing
git pull

landscape这个默认主题也不错，除了代码高亮不是很舒服，作为写个人博客还是很适合的。

使用hexo

github提供了一个pages服务，可以将自己账号名同名的repo作为对外展示blog的仓库。即在github 上创建自己的账号，并以自己的账号名字+github.io作为仓库名（参考github pages说明）。例如，我的github账号是huataihuang，则创建的仓库名字是huataihuang.github.io
默认使用的是 Jekyll 作为静态页面平台（使用Ruby生成静态blog）
发布需要设置自己账号的公钥，即将管理密钥设置为ssh公钥

在 _config.yml 中添加如下配置，表示使用github进行部署

# Deployment
## Docs: http://hexo.io/docs/deployment.html
deploy:
  type: git
  repo: https://github.com/huataihuang/nebula.git
  branch: master

安装git插件

npm install hexo-deployer-git --save

创建一个新的post，使用如下命令（默认的layout是位于source/_posts）

hexo new "18 Til I Die"

此时提示 INFO Created: ~/Documents/blog/huataihuang.github.io/source/_posts/18-Til-I-Die.md ，则编辑此文件来撰写blog。

撰写新的post之后，使用命令

hexo g
hexo d

g 表示 generate
d 表示 deploy，即部署到github的页面，然后就可以通过访问 http://huataihuang.github.io 看到自己的页面

创建about页面

hexo new page about

会在source/about中生成index.html。这个就叫做页面，不在文章列表显示，可以通过http://localhost/about浏览。

页面支持文章的大部分属性，除了分类和标签。

增加Disqus评论功能

hexo内置支持了disqus评论功能，只需要在 _config.yml 配置中添加（需要先到disqus上申请域名）

# Disqus
disqus_shortname: bloghuataime

设置域名

我的blog的域名是 blog.huatai.me ，在反复折腾了几次VPS之后，还是决定专注blog撰写，将维护工作交给github处理。也就是将blog.huatai.me域名指向huataihuang.github.io。

参考Setting up a custom domain with GitHub Pages

在hexo的source目录下存放一个CNAME文件，内容就是你希望托管的域名。这里我将blog.huatai.me域名托管，所以这个CNAME文件内容就是blog.huatai.me （参考Using own domain with github and hexo）
在域名服务商（我使用狗爹）的域名管理中添加一个CNAME记录
```
  blog  CNANME  huataihuang.github.io.
```

域名生效后，访问 http://blog.huatai.me 就会访问 http://huataihuang.github.io 并且看到完全一致的页面

插件

hexo-generator-feed ->生成rss
hexo-generator-sitemap ->生成sitemap
hexo-pdf ->嵌入pdf
hexo-qiniu-sync ->插入图片外链，并且同步你的文件到七牛云(暂未使用)

升级hexo

再次进入 huataihuang.github.io 目录，执行

npm update -g

文档撰写

文档采用GitHub favored Markdown格式，可以支持表格、代码着色、高级引用等功能，非常适合代码分享。

其他静态blog

使用github issue撰写博客

没有想到的是，也有人直接使用GitHub的Issues搭建了一个名为"lifesinger"的个人博客，因为issue天然支持MarkDown并且可以开放式讨论，倒是也别有趣味。

jekyll 和 Octopress

jekyll是GitHub官方支持的Pages工具，基于Ruby，由于github巨大的影响力使用非常广泛。Octopress则是Jekyll的定制简化，但依然比较折腾。根据网上的一些评测，对于大量的文档创建，hexo相对速度较快。

考虑到每个人的生活是多面的，我准备使用hexo(typing theme)来构建生活的blog，而使用jekyll来构建偏向技术的blog。
参考 FarBox、Jekyll、Octopress、ghost、marboo、Hexo、Medium、Logdown、prose.io，这些博客程序有什么特点？

其他blog

如果没有被墙，其实用twitter记录碎片化的思绪，用tumblr撰写生活随笔，是非常惬意和轻松的事情。

参考

PreviousHexo Next使用hexo theme tranquilpeak

Last updated 4 years ago