基于Hexo和Github搭建博客

搭建本身的我的博客。包括如下步骤：

准备工做

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

$ node -v
$ npm -v

安装hexo

安装hexo

$ npm install -g hexo

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

$ hexo v

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

npm install hexo --no-optional

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

$ cd blog
$ hexo init

npm安装package.json中的依赖包

$ npm install

生成博客文件

$ hexo g

启动本地博客

$ hexo s

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

查看hexo帮助

$ 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
   

2. 在跳转界面填写信息
   

生成测试页面

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

建立ssh keys

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

$ ls -al ~/.ssh

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

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

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

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

$ cat ~/.ssh/id_rsa.pub

给github仓库添加ssh keys

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

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

测试链接

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

$ ssh -T git@github.com

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

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

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

1. 安装hexo-deployer-git

$ npm install hexo-deployer-git --save

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

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

$ hexo g

1. 发布

$ hexo d

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

切换主题

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

1. 下载TKL主题

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

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

而后，hexo g，再hexo d，便可正常访问。
注：图片url填写，图片文件夹img应放在source文件目录下，url直接写为/img/图片.png便可。

写一篇博客

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 搭建博客