Hexo搭建GitHub个人博客

准备工作

• 安装Node.js
• 安装Git
• 远程连接GitHub
• 安装Hexo
• Hexo的本地配置
• 博客相关指令

安装Node.js

Node.js就是一个用于创建服务器端应用程序的运行系统，它可以轻松构建网络或其他事件驱动的应用程序服务器。

进入Node.js官网下载对应版本的安装包，默认设置安装。
安装完成后进入终端检查是否安装成功，按Win+R进入cmd输入node -v和npm -v，如果出现版本号，则证明安装成功。

npm (Node Package Manager) NodeJS包管理和分发工具
(可选) - 添加镜像（进入cmd，以阿里为例）
npm config set registry https://registry.npm.taobao.org

安装Git

Git是一个开源的分布式版本控制系统，可以有效、高速地处理从很小到非常大的项目版本管理，帮助我们把本地网页上传到Github。

进入Git官网下载，默认设置安装。
安装完成之后在cmd中使用git --version验证是否安装成功。

远程连接GitHub

生成密钥

# git bash中设置user.name和user.email
git config --global user.name "GitHub用户名"
git config --global user.email "GitHub注册邮箱"
# 生成密钥
ssh-keygen -t rsa -C "注册邮箱"
# 将公钥id_rsa.pub添加到GitHub
github -> settings -> ssh and gpg keys
# 测试本地连接
ssh -T git@github.com

安装Hexo

Hexo是一款基于Node.js的静态博客框架，依赖少易于安装使用，可以方便的生成静态网页托管在GitHub和Heroku，是搭建博客的首选框架。

进入cmd输入npm安装命令

# 安装指令 -g 表示全局安装
npm install hexo-cli -g
# 验证指令
hexo -v

Hexo的本地配置

初始化
在Git Bash中执行

# 创建存放博客文件夹
mkdir myBlog
# 初始化
hexo init myBlog

看到Start blogging with Hexo则表示初始化成功。
部署到GitHub
安装必要插件：

npm install hexo-deployer-git --save  #安装自动部署Github插件

修改配置文件_config.yml

# Deployment
## Docs: https://hexo.io/docs/one-command-deployment
deploy:
  type: git
  repo: git@github.com:seeyourmind/seeyourmind.github.io
  branch: master

更换主题
以aomori为例

git clone https://github.com/lh1me/hexo-theme-aomori.git themes/aomori

博客相关指令

常用指令
hexo new post “article title”
hexo s
hexo clean && hexo g -s
hexo clean && hexo g -d

文章书写

hexo new [layout] <title> 或 hexo n [layout] <title>
# layout: 
#  post(默认，存于source/_posts)
#  draft(草稿，存于source/_drafts，可以使用publish指令将其推送到_posts)
#  page(页面)
-p --path 自定义新文章
-r --replece 替换同名文章
-s --slug 文章的slug，作为新文章的文件名和发布后的URL
# 示例
hexo new page --path about/me "About me"

生成静态文件

hexo generate 或 hexo g
-d --deploy 文件生成后部署网站
-w --watch 监视文件变动
-b --bail 生成过程中出现异常时抛出
-f --force 强制重新生成文件
-c --concurrency 最大同时生成文件数量，默认无限制

发布草稿

hexo publish [layout] <filename>

启动服务器
hexo server 或 hexo s 启动服务器，ctrl+c 结束，默认地址为：http://localhost:4000/
部署网站

hexo deploy 或 hexo d
-g 或--generate 部署之前写成静态文件

渲染文件

hexo render <file1> [file2]
-o或--output 设置输出路径

清除缓存文件

hexo clean

列出网站资料

hexo list <type>

显示草稿

hexo --deaft

自定义当前工作目录

hexo --cwd /path/to/cwd

Hexo添加公式支持

在主题文件中添加公式渲染器

将下面一段代码复制到主题文件中themes\主题名\layout\_partial\head.ejs

<!--将该代码放入博客模板的head中即可-->
<script type="text/x-mathjax-config">
    MathJax.Hub.Config({
    tex2jax: {
        inlineMath: [['$','$'], ['\\(','\\)']],
        processEscapes: true
    }
    });
</script>
<!--latex数学显示公式-->
<script type="text/javascript" src="https://cdn.mathjax.org/mathjax/latest/MathJax.js?config=TeX-AMS-MML_HTMLorMML"></script>