HEXO+github搭建博客总结

用hexo+github搭建个人博客，有许多坑值得去填，这里就把从各个博客学到的填坑方式在这里说一下。

另外，有许多资料都是针对hexo2.x版本的，我现在的版本是3.1.1。查找资料的时候一定要注意。这里只是列出问题查找的方向，根据这个方向更便于在网上找到解决的方法。

0x01 准备

1.github账号：安装git，申请github账号，设置好ssh。再新建一个项目，然后在项目的setting中设置为个人页面。

2.安装node.js，使用npm命令安装hexo，后面还会大量的用到npm来安装。

npm install -g hexo

0x02 搭建基本框架

在本地电脑新建一个文件夹a，在a里使用git bash初始化一个hexo项目。

hexo init

这时会生成许多文件夹，在输入

npm install

安装一些必要包。

执行

hexo generate
hexo server -p 8080

这时候应该可以在本地用http://localhost:8080打开原始框架页面了

注意：

-p后面的端口要根据自己的情况来写，网上大多使用默认的4000，可是我的4000端口已经用了，这样就会导致网页打不开。

在本地打开成功后，就可以开始上传到github上了。

打开a里的_config.yml,推荐使用sublime，如果使用其他工具，请注意要保存时格式应为utf-8

找到deploy一栏，修改如下：

deploy:
  type: git
  repository: https://github.com/你的github名/你的github名.github.io.git
  branch: master

注意，这里作为个人页面的github项目一定要和用户名相同。

然后在git bash中输入

hexo deploy

这里注意有两种deploy的方式，https://的方式会要求你输入github的账号密码；ssh的方式只要事先设置好密钥就不再需要多余的操作了。

这时，就可以用你的github名.github.io来访问

0x03 打磨博客

1.发表博文
使用

hexo new “文章名”

新建博文，这时会在a/source/_post下生成相应的.md文件，打开编辑。
在——下面就可以使用markdown语法写博文。

写好后，保存，执行

hexo generate

就可以在a/public中相应的位置生成博文。

那么以后的程式化操作就是

hexo new “  ” 写博文
hexo clean 清除public
hexo generate 编译
hexo server -p 8080 本地测试
hexo deploy 部署到远程服务器

2.装饰博客
基本框架布置好，装饰的事大家就各显神通了。

通常会在以下几个点进行修改

a/_config.yml

这里修改博客主页的名字，源信息，子页面url格式等

最重要的是主题的选用，插件的使用都在这里编辑完成。
如果你要使用rss、sitemap、更改deploy的对象就需要在这里修改

a/themes/
存放你找来的各种主题b、c、d……

a/themes/b/_config.yml
负责单个主题的框架修改，
包括网页的logo图片选择、框架中主菜单显示的文本及连接

a/public
静态生成的网页，也就是会上传到github上的文件。

网上有很多教程，而且如果前面都部署成功了，后面就可以自己慢慢geek了

0x04 其他的一些坑

github的博客可以被google站长收录，但是baidu被禁止爬去github，所以，如果想让baidu也能搜得到你，就部署在gitcafe上。

如果hexo generate报错，多半是两个地方的_config.yml更改的有问题，所以一是要备份yml文件或者从git上拉取之前部署成功的文件，二是要边改边generate在本地查看，一点点琢磨不同位置的属性。

a/_config.yml中的url设置如果没有购买域名的话，看似没有作用，但会影响生成的sitemap中的路径，所以在多个平台（github、gitcafe）部署的时候，不仅要修改deploy，还要根据需要修改url。

否则，即便sitemap能被百度站长工具访问到，也会提示说 主域验证错误

因为是事后总结，暂时想到的就这么多，其他还有什么安装过程中的问题可以直接博客留言，见即回 ：）

原创文章，转载请注明： 转载自零の杂货铺