君は春の中にいる、かけがえのない春の中にいる.

你驻足于春色中,于那独一无二的春色之中.

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能被百度站长工具访问到,也会提示说 主域验证错误

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

原创文章,转载请注明: 转载自零の杂货铺