采用hexo将github设置为个人博客

0、预先说明

• 用node.js和hexo工具，利用node.js下载插件，并通过hexo搭建博客，最后部署在github上。
• Hexo官方安装配置文档
• Hexo的部署目录，即根目录blog，若不想要可以删除，之后重新建一个目录，hexo init即可，若已安装过Hexo，则无需再安装。

1、安装

1.1、准备工具

• 在node.js官网下载node.js：node.js
  由于node.js安装时会自动在环境变量中配置好路径，因此我们可以直接在cmd中输入命令，安装所需插件
• 打开cmd，按照hexo官网的下载指令，输入npm install hexo-cli -g进行安装
  • 如果安装卡住了，可以选择一个镜像地址作为npm的安装源：
    npm config set registry https://registry.npm.taobao.org

1.2、初始化hexo

• 新建一个文件夹blog，作为hexo的根目录，在控制台中将路径调至此文件夹路径下
• 输入命令： hexo init

1.3、安装hexo

• hexo install

1.4、安装部署服务器插件

• 安装并写入package.json的"dependencies"中： npm install hexo-deployer-git --save
• 如果要删除xxx插件：npm uninstall xxx ；

1.5、修改hexo根目录下的_config.yml配置文件

• node.js的书写规范：配置文件中，要有 空格 隔开值
• 文件中，我们配置的是git提交路径，因此我们本机电脑需要配置好git
  • 输入的命令需要在git-bash.exe中敲；
  • 也可以在cmd中敲，只要配置好git的环境变量即可（例：Path:D:\application\PortableGit\cmd;）

2、部署

• 生成网站静态文件到默认设置的 public 文件夹：hexo generate( 缩写：hexo g)

  • 手动部署网站，便于查看网站生成的静态文件
  • 若如果使用自动部署，则不需要先执行该命令

• 自动生成网站静态文件，并将hexo中的博客部署到github设定的仓库上：
  hexo deploy （缩写：hexo d）

3、成功访问

• 这里是默认主题

4、关于博客

4.1、博客存放位置

• 博客文件都为md格式

4.2、博客内容

• 用markdown文档结构描述语言进行博客内容写作
• title后的文章标题 会被收录在 目录 中
• 更改过博客文章内容后，保存；
• 并在命令行的blog文件路径下，重新部署：hexo g -d

5、设置个性化主题

• hexo开源主题
• 1、选好主题后，在 Hexo部署目录blog 下的/themes文件夹内，下载主题的压缩包在themes下进行解压，或者将主题的仓库地址在themes下克隆安装；
  • 例：git clone https://github.com/litten/hexo-theme-yilia.git themes/yilia (主题为yilia)
• 2、修改 Hexo根目录 下的 _config.yml配置文件的主题

• 3、清空：hexo clean
• 4、重新生成：hexo g
• 5、重新启动：hexo s
• 6、重新部署到仓库：hexo d

6、hexo其他指令

• hexo server：

  • 启动本地服务器，可用于预览主题，同时可以修改文章内容，保存后刷新即可
  • 当Hexo 根目录 _config.yml 修改后，需要重启本地服务器

• hexo new "文章标题"：

  • 新建文章
  • 文章标题也可以在对应的md文件中修改

• hexo new page 网页名：

  • 例：hexo new page welcome
  • 新建一个标题名为welcome的页面，默认连接地址：主页地址/welcome/
  • 此页面不会出现在首页文章列表和归档中，也不支持设置分类和标签

• hexo clean：

  • 清除缓存文件db.json和已生成的静态文件夹public
  • 网站显示异常时可执行此命令

• 参考文章：Hexo常用指令

7、CNAME问题

• 如果绑定域名，则github的仓库根目录下会自动新建CNAME文件，然后每次Hexo成功新部署后CNAME会消失，需要重新在仓库自定义域名。
  • CNAME文件的第一行为绑定的域名
  • 解决：将CNAME文件放在hexo项目的source目录下，先hexo clean，再hexo generate