利用Hexo和GitHub搭建博客的最简单步骤

最近根据网上的教程,利用HexoGitHub搭建了自己的博客,准备记录下以后学习成长的点点滴滴。这篇博客总结了搭建博客的最简单步骤,安装环境为macOS 10.12。

准备工作

注册GitHub账号

首先需要注册GitHub的账号,假定用户名是username,新建一个repository,命名为username.github.io

安装homebrew、Git和Node.js

安装homebrew

$ /usr/bin/ruby -e "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/master/install)"

安装Git

$ brew install git

安装Node.js

$ brew install node

这一步有个小插曲(如果安装顺利可以忽略),在公司网速很快以及梯子具备的情况下, 安装 Node.js 之前需要安装的管理工具 npm 一直下载不成功,而用浏览器下载同样的内容很快下载完毕(npm-3.10.3.tgz,大概3M+)。因此一种曲线救国的方法是,在命令行输出内容中找到下载内容的路径(我的是 ~/Library/Caches/Homebrew/),打开该路径找到未下载成功的文件(node--npm-3.10.3.tgz.incomplete),将该文件替换为 npm-3.10.3.tgz 并重命名为 node--npm-3.10.3.tgz ,再次尝试即安装成功。

安装Hexo

准备好上述工具后,即可安装Hexo:

$ npm install hexo-cli -g

然后进入准备好的目录,例如.../Hexo/,执行命令:

$ hexo init
$ npm install

这样Hexo博客就在本地搭建完成了,可以在本地浏览(Ctrl+C退出):

$ hexo server

在浏览器打开http://localhost:4000/查看。

部署到GitHub

首先需要安装部署所需插件:

$ npm install hexo-deployer-git --save

为自己配置Git身份信息,执行命令:

$ git config --global user.name "username"
$ git config --global user.email "user email"

再打开.../Hexo/目录下的_config.yml文件(推荐编辑器Sublime Text),修改以下内容(注意将username替换为自己的用户名):

deploy:
  type: git
  repository: https://github.com/username/username.github.io
  branch: master

之后可以通过以下命令将本地博客文件部署到GitHub:

$ hexo deploy

按照提示输入自己的GitHub账号用户名和密码。部署完成后,就可以访问http://username.github.io查看自己的博客了。

发表新文章

.../Hexo/目录下通过执行命令来新建.md文件:

$ hexo n "my-new-post"

新建的文件位于.../Hexo/source/_posts/,推荐使用编辑器ulysses打开该文件,在开头处需要配置以下内容格式:

title: 新文章 #可以改成中文 
date: 2014-05-06
categories: blog #文章分类 
tags: [博客,blog] #文章标签,多于一项时用这种格式
---
#这里是正文,用Markdown写

再通过以下命令发布:

$ hexo d -g

进阶

配置Hexo

修改.../Hexo/目录下的_config.yml文件可以更改Hexo的配置,可以使用yamllint来保证自己的yaml语法正确。

具体参数及含义见https://hexo.io/docs/configuration.html,也可以参考http://www.jianshu.com/p/f935e5459c49

更换主题

官网主题:https://hexo.io/themes/

更多主题:https://github.com/hexojs/hexo/wiki/Themes

本博客主题为NexT

更改主题后,执行以下命令发布:

$ hexo clean
$ hexo g
$ hexo d

其他推荐

在线制作网站logo的网站:http://www.atool.org/ico.php

Markdown语法学习:http://www.jianshu.com/p/q81RER