基于Hexo和Github搭建博客

搭建自己的个人博客。

准备工作

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

1 2	$ node -v $ npm -v

安装hexo

安装hexo

1	$ npm install -g hexo

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

1

$ hexo v

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

1	npm install hexo --no-optional

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

1 2	$ cd blog $ hexo init

npm安装package.json中的依赖包

1	$ npm install

生成博客文件

1

$ hexo g

启动本地博客

1

$ 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

新建仓库

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

1. 在跳转界面填写信息

生成测试页面

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

创建ssh keys

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

1	$ ls -al ~/.ssh

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

1	$ ssh-keygen -t rsa -C "[e-mail]"

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

1. 查看生成的ssh keys中的公钥

1	$ cat ~/.ssh/id_rsa.pub

给github仓库添加ssh keys

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

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

测试连接

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

1	$ ssh -T [e-mail]

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

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

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

1. 安装hexo-deployer-git

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

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

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

1

$ hexo g

1. 发布

1

$ hexo d

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

切换主题

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

1. 下载TKL主题

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

1. 配置根目录下的_config.yml文件

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

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

写一篇博客

1. 新建博客

1	$ hexo new "newBlog"

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

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

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

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

参考链接

1. 史上最详细的Hexo博客搭建图文教程
2. 使用hexo搭建github.io博客(一)
3. 基于 Hexo 和 GitHub Pages 搭建博客