如何使用Hexo在Github上搭建一个博客

发表于

原文：http://zirho.github.io/2016/06/04/hexo/

Hexo + Github = Blog
你只需要复制与粘贴下面的代码就可以创建一个博客了。
相关链接：

前提条件

安装Git

  • Windows：下载与安装git。
  • Mac：使用Homebrew，MacPorts或者installer安装。
  • Linux(Ubuntu,Debian)：sudo apt-get install git-core
  • Linux (Fedora, Red Hat, CentOS): sudo yum install git-core

安装Node.js

使用nvm安装Node.js是最好选择。
cURL：

1
$ curl https://raw.github.com/creationix/nvm/master/install.sh | sh

Wget：

1
$ wget -qO- https://raw.github.com/creationix/nvm/master/install.sh | sh

安装好nvm后，重新打开terminal然后运行下面的命令安装Node.js：

1
$ nvm install 4

或者，下载并运行安装包。

安装Hexo

完成上面的安装后，你就可以使用nvm安装Hexo了：

1
$ npm install -g hexo-cli

创建一个github repository

你应该修改{blogname}为你最想要的词。
创建一个github repo并命名为{blogname}.githu.io。例如：zirho.github.io。
https://github.com/zirho/zirho.github.io

创建Github上的Hexo

创建一个博客

1
2
3
4
$ hexo init {blogname}
$ cd {blogname}
$ npm i
$ git init

这将会生成一个{blogname}的文件夹与安装一些依赖文件。

安装主题

浏览这里获得一些比较酷的主题。
选择好之后，fork并定制它或者从theme信息中获取github repo url。
例如：https://github.com/ppoffice/hexo-theme-minos

1
$ git submodule add {theme-github-url} themes/{theme-name}

复制 _config.yml.example 到 _config.yml

1
$ cp themes/{theme-name}/_config.yml.example themes/{theme-name}/_config.yml

Some themes may differ on _config.yml.example file name
Refer to the theme docs

更新_config.yml去使用最新安装好的主题。（别混淆了主题配置文件）

1
$ vi _config.yml

找到theme属性并修改它。例如：theme: hueman

1
$ theme: {theme-name}

设置博客的部署信息

编辑根目录下的_config.yml。（注意别混淆了主题配置文件）

1
$ vi _config.yml

配置你想要的博客信息。
下面是我自己的一个例子。

1
2
3
4
5
6
title: CodePaste 
subtitle:
description:
author: Joshua Youngjae Ji
language: en
timezone: America/Los_Angeles

添加下列代码到配置文件的底部用于部署到github repo 。

1
2
3
4
5
deploy:
  type: git
  repo: {your github repo url}
  branch: master
  message: "Site updated: {{ now('YYYY-MM-DD HH:mm:ss') }}"

部署博客

1
2
$ npm i -S hexo-deployer-git
$ hexo deploy

到这里，你打开http://{blogname}.github.io可以浏览你的博客了。

添加源码到github repository(可选)

维护你的代码版本，你可以制造另一个分支并且push the commits。

1
2
3
$ git remote add origin {your-git-repo-url}
$ git checkout -b source 
$ git push origin source

发布新的文章

生成一篇新的文章

1
$ hexo new {postname}

编写新文章

1
$ vi source/_posts/{postname}.md

重新生成并发布博客文件

1
$ hexo generate -d

愉快的发布你的文章吧！