最近根据网上的教程,利用Hexo和GitHub搭建了自己的博客,准备记录下以后学习成长的点点滴滴。这篇博客总结了搭建博客的最简单步骤,安装环境为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://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