博客搭建教程
博客搭建教程
本篇文章缝合了源自网络的多篇教程，主要目的是用来帮自己记住相关操作方法，类似备忘录。
（还有就是水文章，毕竟在博客里发布搭建博客的教程也是一种传统？）
前言
近些年来很多用户都喜欢使用 GitHub Pages 来搭建 Hexo 静态博客网站，其最吸引人的莫过于完全免费使用，并且非常稳定。
虽然搭建时比较麻烦，有点折腾，但是配置完成后，基本不需要操心维护的事，甚至放了几年都忘记了，打开来看文章依然还在。
本文就详细介绍下如何使用 Hexo + GitHub 搭建免费个人博客网站的教程。
简介
GitHub Pages 是什么？
GitHub Pages 是由 GitHub 官方提供的一种免费的静态站点托管服务，让我们可以在 GitHub 仓库里托管和发布自己的静态网站页面。
Hexo 是什么?
- 官网：hexo.io
Hexo 是一个快速、简洁且高效的静态博客框架，它基于 Node.js 运行，可以将我们撰写的 Markdown 文档解析渲染成静态的 HTML 网页。
Hexo + GitHub 文章发布原理
在本地撰写 Markdown 格式文章后，通过 Hexo 解析文档，渲染生成具有主题样式的 HTML 静态网页，再推送到 GitHub 上完成博文的发布。
优点和不足
**优点：**完全免费；静态站点，轻量快速；可按需求自由定制改造；托管在 GitHub，安全省心；迁移方便……
**不足：**发文不便，依赖于本地环境；更适合个人博客使用；GitHub 在国内访问速度有点不快。
1. 准备
注意事项
- 输入代码时，核对准确，最好切换成英文输入法；
- 将文中的 “用户名” 和 “邮箱” 替换为自己的 GitHub 账户名和绑定的邮箱；
- 统一使用 Git Bash 进行操作；
环境搭建
Hexo 基于 Node.js，搭建过程中还需要使用 npm（Node.js 已带） 和 git，因此先搭建本地操作环境，安装 Node.js 和 Git。
下载 Node.js 和 Git 程序并安装，一路点 “下一步” 按默认配置完成安装。
安装完成后，Win+R 输入 cmd 并打开，依次输入 node -v、npm -v 和 git --version 并回车，如下图出现程序版本号即可。
2. 连接 Github
使用邮箱注册 GitHub 账户，选择免费账户（Free），并完成邮件验证。
桌面按住shift右键 -> Git Bash Here，设置用户名和邮箱：
1 | git config --global user.name "GitHub 用户名" |
创建 SSH 密匙：
输入 ssh-keygen -t rsa -C "GitHub 邮箱"，然后一路回车。
添加密匙：
进入 [C:\Users\用户名\.ssh] 目录（要勾选显示“隐藏的项目”），用记事本打开公钥 id_rsa.pub 文件并复制里面的内容。
登陆 GitHub ，进入 Settings 页面，选择左边栏的 SSH and GPG keys，点击 New SSH key。
Title 随便取个名字，粘贴复制的 id_rsa.pub 内容到 Key 中，点击 Add SSH key 完成添加。
验证连接：
打开 Git Bash，输入 ssh -T git@github.com 出现 “Are you sure……”，输入 yes 回车确认。
显示 “Hi xxx! You’ve successfully……” 即连接成功。
3. 创建 Github Pages 仓库
GitHub 主页右上角加号 -> New repository：
- Repository name 中输入
用户名.github.io - 勾选 “Initialize this repository with a README”
- Description 选填
填好后点击 Create repository 创建。
创建后默认自动启用 HTTPS，博客地址为：https://用户名.github.io
4. 本地安装 Hexo 博客程序
新建一个文件夹用来存放 Hexo 的程序文件，如 Hexo-Blog。打开该文件夹，右键 -> Git Bash Here。
安装 Hexo
使用 npm 一键安装 Hexo 博客程序：
1 | npm install -g hexo-cli |
安装时间有点久（想要加快可以试试魔法），界面也没任何反应，耐心等待，安装完成后如下图。
4.2 Hexo 初始化和本地预览
新建一个文件夹作为你博客的仓库。你后面的工作将大部分在这个文件夹中完成。
初始化并安装所需组件：
在文件夹中按住shift右键，选择Git Bash Here（注意，以后的Git Bash最好也都这么启动）。输入下面的指令：
1 | hexo init # 初始化 |
完成后依次输入下面命令，启动本地服务器进行预览：
1 | hexo g # 生成页面 |
访问 http://localhost:4000，出现 Hexo 默认页面，本地博客安装成功！
**Tips：**如果出现页面加载不出来，可能是端口被占用了。Ctrl+C 关闭服务器，运行 hexo server -p 5000 更改端口号后重试。
Hexo 博客文件夹目录结构如下：
5. 部署 Hexo 到 GitHub Pages
本地博客测试成功后，就是上传到 GitHub 进行部署，使其能够在网络上访问。
首先安装 hexo-deployer-git：
1 | npm install hexo-deployer-git --save |
然后修改 _config.yml 文件末尾的 Deployment 部分，修改成如下：
1 | deploy: |
完成后运行 hexo d 将网站上传部署到 GitHub Pages。
完成！这时访问我们的 GitHub 域名 https://用户名.github.io 就可以看到 Hexo 网站了。
6. 开始使用
7.1 发布文章
进入博客所在目录，右键打开 Git Bash Here，创建博文：
1 | hexo new "My New Post" |
然后 source 文件夹中会出现一个 My-New-Post.md 文件，就可以使用 Markdown 编辑器在该文件中撰写文章了。
写完后运行下面代码将文章渲染并部署到 GitHub Pages 上完成发布。以后每次发布文章都是这两条命令。
1 | hexo g # 生成页面 |
也可以不使用命令自己创建 .md 文件，只需在文件开头手动加入如下格式 Front-matter 即可，写完后运行 hexo g 和 hexo d 发布。
1 | --- |
7.2 网站设置
包括网站名称、描述、作者、链接样式等，全部在网站目录下的 _config.yml 文件中，参考官方文档按需要编辑。
注意：冒号后要加一个空格！
7.3 更换主题
Hexo提供了非常多好看的主题（是的，经过美化后能够达各种效果），其中应用较为广泛的是Butterfly。关于更换主题和美化页面的教程，后面可能会单独写一篇文章。要是太着急的话，可以访问Hexo的官网寻找（他甚至还有简中，他真的，我哭死）。记住，最靠谱的永远是官方的手册！（RTFM, bro!）
7.4 常用命令
1 | hexo new "name" # 新建文章 |
8 常见问题
1、修改并部署后没有效果
使用 hexo clean 清理后重新部署。
2、开启 HTTPS 后访问网站显示连接不安全？
证书还未部署生效，等待一会儿，清除浏览器缓存再试。
3、npm 下载速度慢，甚至完全没反应
使用 npm 安装程序等待很久也没反应，或者下载速度很慢，可以更换 npm 源为国内 npm 镜像。
临时更换方法：在 npm 安装命令后面加上：
1 | --registry https://registry.npm.taobao.org |
结语
Hexo 是一种纯静态的博客，我们必须要在本地完成文章的编辑再部署到 GitHub 上，依赖于本地环境。不能像 WordPress 或 Typecho 那样的动态博客一样能直接在浏览器中完成撰文和发布。
可以说是一种比较极客的写博客方式，但是优势也是明显的——免费稳定省心，比较适合爱折腾研究的用户，或者没有在线发文需求的朋友。
如果在自己部署的过程中出现了问题，可以阅读官方的手册。心动不如行动，赶快行动起来吧！