在GitHub上建Hexo博客

我遇到的坑都集中在配置_config.yml文件中。

Hexo官方文档中对网址配置的叙述

对于图中所述,网站存放在子目录的情况。
我想如果要把Hexo托管在GitHub上,那你的博客网站一定是在子目录中的,因为这个网站其实就是你的一个仓库(类似于https://github.com/username/yourrepo)。

所以配置这一块时,严格按照官网的步骤走。否则到时候部署(deploy)的时候,会出现一些其他问题(比如我遇到了无法加载cssjs的情况,原因是路径的问题,也就是因为没有严格走官网的流程)。


配置好相关文件之后,可以先在本地启动服务器看看效果:

➜  Blog git:(master) ✗ hexo server

会出现下面的提示:

➜  Blog git:(master) ✗ hexo server
INFO  Start processing
INFO  Hexo is running at http://localhost:4000/Blog/. Press Ctrl+C to stop.

如果想改变端口,或是在执行时遇到了 EADDRINUSE 错误,可以在执行时使用 -p 选项指定其他端口,如下:

➜  Blog git:(master) ✗ hexo server -p [newport]

没啥大问题之后,就可以和GitHub仓库进行关联,将你热乎乎的博客托管在GitHub上啦。
当然,在这之前你需要做:

  • 在GitHub上新建一个repo(不要创建README.md,所有工作做完之后再创建也来得及)
  • 安装 hexo-deployer-git来一键部署你的博客。
➜  Blog git:(master) ✗ npm install hexo-deployer-git --save
  • _config.yml配置文件中添加deployer,如Git。找到下面的模块,按下面的方式修改:
deploy:
  type: git
  repo: <repository url>
  branch: master

还有其他的参数,如message,是可以自定义提交信息的参数,你也可以去添加并设置它。

上面的步骤认真做完之后,就可以生成静态文件并部署了。
生成和部署大概有下面三种方式,选择一种喜欢的就行,作用都是一样的。

  1. 两步分开执行
➜  Blog git:(master) ✗ hexo g
➜  Blog git:(master) ✗ hexo d
  1. 下面两种是一起执行的,用一种即可
➜  Blog git:(master) ✗ hexo g -d
➜  Blog git:(master) ✗ hexo d -g

然后就静等自己的网站上传到GitHub吧。
那我要怎么访问你的博客呢?
还有最后一步。
在你博客的repo中,点击Settings。下拉至下图所示的位置:


GitHub Pages设置

然后按照图中的方式设置source,点击save即可。这时你就会看到博客的专属域名啦。

Just explore and enjoy it!

©著作权归作者所有,转载或内容合作请联系作者
平台声明:文章内容(如有图片或视频亦包括在内)由作者上传并发布,文章内容仅代表作者本人观点,简书系信息发布平台,仅提供信息存储服务。

推荐阅读更多精彩内容