github使用hexo搭建个人博客

1. 环境准备

1.1. 安装node.js

  • 官网下载最新node.js版本
  • win按步骤安装即可，linux则解压后配置.bashrc，命令行测试是否安装成功：
    1
    2
    $ node -v
    $ npm -v

1.2. github准备

  • 创建新的Repository，Repository name的格式必须如：your_user_name.github.io，其中your_user_name为你的github账户用户名

2. hexo搭建博客

2.1. 安装hexo

  • 打开terminal，输入命令：

    1
    $ npm install -g hexo

  • 创建一个文件夹如：

    1
    $ mkdir ~/blog

  • 在新创建的文件夹中输入init命令，Hexo随后会自动在目标文件夹建立网站所需要的文件。然后按照提示，运行 npm install：

    1
    2
    3
    4
    5
    $ cd ~/blog
    $ hexo init
    INFO Copying data
    INFO You are almost done! Dont forget to run `npm install` before you start b logging with Hexo!
    $ npm install

2.2. 本地启动

  • 安装hexo server

    1
    $ npm install hexo-server

  • 启动hexo server，完成本地部署

    1
    2
    3
    4
    $ cd ~/blog
    $ hexo server
    INFO  Start processing
    INFO  Hexo is running at http://localhost:4000/. Press Ctrl+C to stop.

  • 创建新博文

    1
    2
    3
    $ cd ~/blog
    $ hexo new "My First Post"
    INFO  File created at ~blog/source/_posts/My-First-Post.md

注意：
在hexo new “My First Post” 时，如果没有停止运行hexo server（按Ctrl+C将hexo server停掉），则博文会被创建两次，所以在hexo new文章时，需要stop server。

  • 编辑博文
    hexo new “My First Post”会在~blog/source/_posts目录下生成一个markdown文件：My-First-Post.md我们可以使用一个支持markdown语法的编辑器（比如 Sublime Text 3与插件OmniMarkupPreviewer）来编辑该文件。
  • 生成博文静态页面
    1
    2
    $ cd ~/blog
    $ hexo generate

该命令执行完后，会在 ~/blog/public/目录下生成一系列html，css等文件。

2.3. 发布到github

  • 部署准备
    部署到Github前需要配置_config.yml文件，首先找到下面的内容，并修改：
    1
    2
    3
    4
    # Deployment
    ## Docs: http://hexo.io/docs/deployment.html
    deploy:
      type:
1
2
3
4
5
6
7
# Deployment
## Docs: https://hexo.io/docs/deployment.html
deploy:
        type: git
        repo: https://github.com/your_user_name/your_user_name.github.io.git 
        branch: master
        message: "blog deploy"

注意Repository格式：
SSH：git@github.com:your_usr_name/your_usr_name.github.io.git 这时候需要添加ssh key到Settings->Deploy keys->Add deploy key处（详情参考)
HTTPS：https://github.com/your_usr_name/your_usr_name.github.io.git 则每次需要填写github用户名和密码

  • 部署博客（每次部署都需要执行），部署成功后访问博客首页
    1
    2
    3
    4
    5
    6
    7
    $ hexo clean
    INFO  Deleted database.
    INFO  Deleted public folder.
    $ hexo generate
    ...
    INFO  30 files generated in 3.8 s
    $ hexo deploy

2.4. 其他说明

本文参考自Hexo搭建Github静态博客