Hexo blog 创建指导手册

Github 仓库建站

1. 仓库建站

• 进入个人 github

• Your Repositories

• Create a new repository

• 仓库名：wangjstu.github.io

• 点击创建

1. 配置 SSH keys

• cd ~/.ssh

• ssh-keygen -t rsa -C "wangjstu@gmail.com" //一路回车

• ssh-add id_rsa //添加秘钥

• cat id_rsa.pub //输出公钥，并添加到 github 上

• 完毕

1. 初始化本地仓库

• mkdir wangjstu.github.io && cd wangjstu.github.io

• echo "# wangjstu.github.io" >> README.md

• git init

• git add README.md

• git commit -m "first commit"

• git remote add origin https://github.com/wangjstu/wangjstu.github.io.git

• git push -u origin master

4. 验收

• 访问 https://wangjstu.github.io

Node.js 安装

1. 安装 node，有多种方法，我使用了第二种：

• 参考官网教程，但是这个方法，我因为家里路由没有过墙梯放弃了

• 执行命令curl -o- https://raw.githubusercontent.com/nvm-sh/nvm/v0.35.3/install.sh | bash
  

• command -v nvm

• nvm install node

• 使用brew install node一键安装，我选择了这个方法

Hexo 安装

1. 安装 hexo

• 执行命令 npm install -g hexo-cli
  

1. 初始化 blog

• 切换到wangjstu.github.io目录上一级，并执行命令hexo init blog，先将 blog 文件初始化到一个 blog 目录。建议先单独放一个目录，后面有用。

• cd blog
  

• npm istall
  

1. 本地测试

• hexo g

• hexo server

• 打开浏览器，访问http://localhost:4000 就可以看到效果

1. 目录略讲

• node_modules: 依赖包

• public：存放生成的页面

• scaffolds：生成文章的一些模板

• source：用来存放你的文章

• themes：主题

• _config.yml: 博客的配置文件

1. 命令略讲解

• hexo g //生产静态文件

• hexo server //启动服务

• hexo clean //清除了你之前生成的东西

• hexo generate //顾名思义，生成静态文章，可以用 hexo g 缩写

• hexo deploy //部署文章，可以用 hexo d 缩写

部署到 github

1. 执行命令 hexo clean
   

2. cp -R blog/ wangjstu.github.io/

3. cd wangjstu.github.io

4. npm install

5. 编辑配置文件 _config.yml
   

# Deployment## Docs: https://hexo.io/docs/deployment.htmldeploy:  type: 'git'  repo: https://github.com/wangjstu/wangjstu.github.io.git  branch: master

1. npm install hexo-deployer-git --save //一定要在wangjstu.github.io目录下执行，不如执行后面 deploy 命令会报错

2. 执行以下命令部署

• hexo clean

• hexo generate

• hexo deploy

1. 访问https://wangjstu.github.io 查看效果

写文章及提交流程

1. hexo new "hello"

2. 编辑source/_posts/hello.md
   

3. hexo clean

4. hexo g

5. hexo d //可以先 hexo s，本地看下效果再执行提交

Hexo 主题修改

1. 修改主题流程

• 择主题

• 按照自己主题的 github 上或官网文档进行修改

1. 实际操作

• 我个人选择了主题 pure
  

• 安装主题

 git clone https://github.com/cofess/hexo-theme-pure.git themes/pure

• 更新主题

cd themes/puregit pull

• 打开站点配置文件，找到 theme 字段，将其值更改为 pure
  

# vim wangjstu.github.io/_config.ymltheme: pure

• 安装主题需要的插件

• npm install hexo-wordcount --save

• npm install hexo-generator-json-content --save

• npm install hexo-generator-feed --save

• npm install hexo-generator-sitemap --save

• npm install hexo-generator-baidu-sitemap --save

• npm install hexo-neat --save

• 主题配置

• 修改 wangjstu.github.io/_config.yml
  

 language: zh-CN

• 修改 wangjstu.github.io/themes/pure/_config.yml
  

双分支保存源文件

1. 创建分支并上传 blog 源代码，执行以下命令：

• cd wangjstu.github.io

• rm -r themes/pure/.git

• hexo clean

• git add . //一定要确保代码只有源代码文件，其他不要

• git stash //将源文件保存到 stash

• git status //这里检查一定要是干净的没有变化的

• git checkout -b Hexo

• git stash pop

• git commit -m "add Hexo branch to save source file"

• git push -u origin Hexo:Hexo

1. 到 github 上，将默认分支修改成 Hexo

2. 更换新工作环境后操作

• 初始化仓库

• git clone https://github.com/wangjstu/wangjstu.github.io.git

• cd wangjstu.github.io

• npm install hexo

• npm install hexo-deployer-git --save

• 安装其他对应主题需要的插件

• 提交文章

• hexo clean

• hexo g

• hexo d