基于 Github 的博客搭建

这篇文章整理了我在搭建我自己的博客网站的时候用到的素材和教程。本文主要分六部分：网页导航、博客功能扩展、常用指令、博客搭建过程一览、遇到的问题、小知识点。

想要尽快开始搭建自己的博客的读者，请移步到博客搭建过程一览。

网页导航

• 我的博客网址。
• Hexo 官方 Github 仓库。
• 一个比较好的 Hexo theme。
• Hexo 官网的安装和部署教程。
• Blog 和 Markdown 文件的预设操作，使用 Hexo 的各种功能。

博客功能扩展

1. 添加看板娘。
2. 添加标签和分类。

常用命令

• $ hexo init 在当前文件夹初始化一个 Hexo 博客项目。
• $ hexo new [layout] <title> 新建一个名字是 title 的博客文档。layout 一般都是 blog。
• $ hexo server 将博客部署到本地，默认本地连接
• $ hexo clean 清除缓存，能够解决一些问题。
• $ hexo d -g 部署到 Github 上。

博客搭建过程一览

1. 在 Github 上创建一个名为 name.github.io 的仓库，name 是你的用户名。
2. 克隆一份 name.github.io 到本地作为接下来操作的目录。所有的变化都要在这个目录下完成。
3. 了解一下 Node.js、Hexo、Markdown、Html (知道什么是超文本标记语言)。
4. 在网上阅读安装说明后，依次安装 npm、Node.js、Hexo-cli。
5. $ hexo init 初始化一个博客。
6. 在网上寻找一个比较好看的 theme (皮肤) 按照说明放到 theme 文件夹下。
7. 仔细阅读并修改博客主目录下的 config.yml 文件，修改 theme 文件夹中的 _config.yml 文件。调试过程中使用$ hexo server命令测试效果。
8. 使用常用命令开始使用博客。
9. Markdown 格式的博客文件在$ cd source/_posts/下。

遇到的问题

1. 利用 OAuth 的 Gitment 无法登录的问题解决，这个在 Github issue 里讨论了很多，是 http 和 https 的差别导致的问题。详情见链接。
2. Hexo Markdown 插入图片问题，这个已经研究过了，详见我的文章。

小知识点

1. .ico 结尾的是图标格式的文件。
2. OAuth 是 Github 的一个小型服务器，免费，但是性能很差。学长有说过这是个坑，未来感兴趣可以更多的了解了解。
3. Hexo 的配置文件是 _config.yml。