基于Hexo和Github搭建博客

搭建自己的个人博客。

准备工作

确保电脑需要已下载安装node和npm。查看安装是否成功，windows只需在命令行输入以下两条命令即可。

1 2	$ node -v $ npm -v

安装hexo

1	$ npm install -g hexo

检测hexo版本来确保hexo是否成功安装

$ hexo v

注：可能报错，可以试试执行

1	npm install hexo --no-optional

进入本地工程目录，初始化hexo

1 2	$ cd blog $ hexo init

npm安装package.json中的依赖包

1	$ npm install

生成博客文件

$ hexo g

启动本地博客

$ hexo s

此时在浏览器输入http://localhost:4000即可访问默认主题的hexo博客

查看hexo帮助

1	$ hexo help

修改全局配置文件

对本地blog目录下的_congig.yml进行修改配置即可。

网站

参数	描述
`title`	网站标题
`subtitle`	网站副标题
`description`	网站描述
`author`	您的名字
`language`	网站使用的语言
`timezone`	网站时区。Hexo 默认使用您电脑的时区。时区列表。比如说：`America/New_York`,`Japan`, 和 `UTC` 。

网址

参数	描述	默认值
`url`	网址
`root`	网站根目录
`permalink`	文章的永久链接格式	`:year/:month/:day/:title/`
`permalink_default`	永久链接中各部分的默认值

参数	描述	默认值
`source_dir`	资源文件夹，这个文件夹用来存放内容。	`source`
`public_dir`	公共文件夹，这个文件夹用于存放生成的站点文件。	`public`
`tag_dir`	标签文件夹	`tags`
`archive_dir`	归档文件夹	`archives`
`category_dir`	分类文件夹	`categories`
`code_dir`	Include code 文件夹	`downloads/code
`i18n_dir`	国际化（i18n）文件夹	`:lang`
`skip_render`	跳过指定文件的渲染，您可使用 glob 表达式来匹配路径。

文章

参数	描述	默认值
`new_post_name`	新文章的文件名称	:title.md
`default_layout`	预设布局	post
`auto_spacing`	在中文和英文之间加入空格	false
`titlecase`	把标题转换为 title case	false
`external_link`	在新标签中打开链接	true
`filename_case`	把文件名称转换为 (1) 小写或 (2) 大写	0
`render_drafts`	显示草稿	false
`post_asset_folder`	启动 Asset 文件夹	false
`relative_link`	把链接改为与根目录的相对位址	false
`future`	显示未来的文章	true
`highlight`	代码块的设置

分类 & 标签

参数	描述	默认值
`default_category`	默认分类	`uncategorized`
`category_map`	分类别名
`tag_map`	标签别名

日期 / 时间格式

Hexo 使用 Moment.js 来解析和显示时间。

参数	描述	默认值
`date_format`	日期格式	`MMM D YYYY`
`time_format`	时间格式	`H:mm:ss`

分页

参数	描述	默认值
`per_page`	每页显示的文章量 (0 = 关闭分页功能)	`10`
`pagination_dir`	分页目录	`page`

扩展

参数	描述
`theme`	当前主题名称。值为`false`时禁用主题
`deploy`	部署部分的设置

配置github

新建仓库

登录github，点击右上角加号，点击new respository

在跳转界面填写信息

生成测试页面

进入新建的仓库，点击右上角的settings，在跳转页面点击 launch automatic page generator，在跳转页面点击continue to layouts，接着选择主题，生成页面，约15min后，访问https://syd1992.github.io，即可显示生成测试页面

创建ssh keys

检测ssh keys是否已存在，即id_rsa，id_resa.pub是否存在

1	$ ls -al ~/.ssh

生成ssh keys（若ssh keys不存在）

1	$ ssh-keygen -t rsa -C "847909475@qq.com"

输入命令后，会提示输入ssh keys保存位置，一般无需改，直接回车即可；接着提示输入密码，并确认再次输入密码，这个密码后面会有使用，一定要记住！

查看生成的ssh keys中的公钥

1	$ cat ~/.ssh/id_rsa.pub

给github仓库添加ssh keys

点击创建的仓库右上侧的settings，在跳转页面左下侧点击deploy keys

在跳转页面点击add deploy keys，title随意填，在key部分将创建ssh keys步骤中的id_rsa.pub内容粘贴在该部分

测试连接

执行命令，输入命令后，问yes/no，输入yes即可，提示输入密码，则输入生成ssh keys时设置的密码

1	$ ssh -T git@github.com

最后提示如下内容，表示成功

1	Hi, 用户名/用户名.github.io! You've successfully authenticated, but GitHub does notprovide shell access.

配置根目录下的_config.yml文件并发布

安装hexo-deployer-git

1	$ npm install hexo-deployer-git --save

修改_config.yml的deploy内容，如下图

生成博客文件，每次修改本地文件后，都要执行该命令

$ hexo g

发布

$ hexo d

此时，访问https://syd192.github.io.git即可看到自己的辛勤劳动成果咯！！

切换主题

默认主题是landscape，如果不太喜欢，可以访问这里获取更多的主题。本人选择主题是TKL，具体切换方法如下：

下载TKL主题

1	$ git clone https://github.com/SuperKieran/TKL.git theme/TKL

然后，hexo g，再hexo d，即可正常访问。

注：图片url填写，图片文件夹img应放在source文件目录下，url直接写为/img/图片.png即可。

写一篇博客

新建博客

1	$ hexo new "newBlog"

在根目录下source文件夹下找到对应的newBlog.md文件，按照markdown规则，编写博客。

在该newBlog.md文件的头部，可以对该博客进行配置，如博客标题title，博客创建时间date，所属分类categories，标签tags

然后，hexo g，再hexo d，即可正常访问。

最后来张成果图，继续加油咯~~~~

参考链接