Hexo 环境搭建

Welcome to Hexo!
This is your very first post. Check documentation for more info. If you get any problems when using Hexo, you can find the answer in troubleshooting or you can ask me on GitHub.

Install Node

Hexo 需要 Node

  • Mac 安装 Node,可以使用 Homebrew 安装: brew install node
  • Windows 安装 Node,进入 https://nodejs.org/en/ 下载安装

Node 就是 Node.js

使用 Node 的淘宝镜像

由于网络的问题,访问 Node 的默认仓库有可能会有问题,很多东西都下载不下来,所以可以使用淘宝的 Node 的镜像,命令行里执行

1
npm install -g cnpm --registry=https://registry.npm.taobao.org

即可,具体可参考 http://npm.taobao.org

Install Github Client

Hexo 和 Github 一起使用就可以搭建一个免费的博客网站

  • Mac 安装 Github 客户端,进入 https://desktop.github.com 下载客户端
  • Windows 安装 Github 客户端,如果在线安装的话,由于网络的问题绝大多数时候都会安装失败,所以可以使用其他人提供的离线安装包,知乎这个帖子有好多个可选择 https://www.zhihu.com/question/23110947

提示: 安装 Github 客户端后,下面的操作最好是在 Git Shell 中进行,因为后面要用到 Git 的命令。Windows 中 安装 GitHub 客户端后会在桌面会创建一个 Git Shell 的快捷方式,或者 开始菜单 > 所有程序 > GitHub, Inc > Git Shell

Install Hexo and initialize Pages

1
2
3
4
5
$ npm install hexo-cli -g
$ hexo init Blog
$ cd Blog
$ npm install
$ hexo server

Create a new post

1
$ hexo new "My New Post"

Run server

本地运行我们的博客系统,方便查看效果,运行 hexo server 后浏览器里访问 http://127.0.0.1:4000 就可以了

1
$ hexo server

Generate static files

1
$ hexo generate

Deploy to git

  • 在 Github 创建一个名字为 xtuer.github.io 的仓库
  • 我们博客的网站自动为 http://xtuer.github.io
  • 安装 hexo 的 git 插件

    1
    $ npm install hexo-deployer-git --save
  • Blog/_config.yml 中配置 git

    1
    2
    3
    deploy:
    type: git
    repo: git@github.com:xtuer/xtuer.github.io.git
  • 发布时需要执行下面三步

    1
    2
    3
    $ hexo clean
    $ hexo generate
    $ hexo deploy

    注意,有时候发布时会提示你没有权限访问 Github 的仓库,那是因为 ssh 访问需要的验证文件无效了,需要更新一下,最简单的就是用 Github 的客户端先访问一下,然后再发布就可以了

  • 使用上面的命令发布好博客后,访问 http://xtuer.github.io,可以看到我们创建的博客能从网络上访问了

More info: Deployment

Use tag

  • One tag: tags: Programming
  • Multi tags: tags: [Programming, Java, Spring]

Use image

配置 Blog/_config.yml

1
post_asset_folder: true

Blog/source 下创建图片的目录,如 img,md 中引用图片

1
![](/img/post-asset.png)

主页显示摘要

在 md 中,摘要内容的后面跟上 <!--more-->,否则主页会显示文章的全部内容

用别名简化命令

1
2
alias hd='hexo clean; hexo generate; hexo deploy'
alias hs='hexo server -g'
  • 本地预览用 hs
  • 发布时使用 hd

自定义域名

博客发布到 Github 后访问的地址如上面的 http://xtuer.github.io 不是很好记忆,如果你买了一个新的域名如 qmake.win,可以把这个域名指向这个博客,以在万网买的域名为例:

  1. 在万网的域名解析中把 qmake.win 解析到 192.30.252.154
  2. 在 Hexo 博客的 source 目录下创建文件 CNAME,其内容为 qmake.win
  3. 发布博客到 Github

在 Github 上博客仓库的 Settings 中也可以设置自定义的域名,但是每次发布后会被重置,所以使用上面 CNAME 来保存域名就不用担心被重置了。

参考