折腾Hexo笔记

之前的blog是用jeykll建的,但是看见Hexo后,喜欢上了!

第一步:安装node环境,安装Hexo命令行

1
npm install hexo-cli -g

第二步:初始化Hexo,安装主题

  • 初始化Hexo,最后一个参数是要初始化的目录名称

    1
    2
    3
    hexo init Hexo
    cd Hexo
    npm install
  • 添加’主题’子模块

    1
    git add submodule https://github.com/iissnan/hexo-theme-next.git

踩过的坑:
直接把next主题作为git项目放在主项目下,这样其实是可以的,但是并不好。
更严重的坑,直接把网站push到github上,对静态网站不是很了解,需要generate之后,在deploy到github上。

  • 验证
    通过如下命令启动Hexo,访问locahost:4000
1
hexo server

踩过的坑:4000端口被Foxit服务占用

第三步:部署

在部署之前需要先设置好git的ssh-key和hexo的部署方式
具体部署如下

1
2
3
4
deploy: 
type: git
repository: git@github.com:username/username.github.io.git
branch: master

然后在生成静态网站,把静态网站部署到github上。

1
2
3
hexo clean
hexo generate
hexo deploy

踩过的坑:
fatal: could not read Username for ‘https://github.com‘: No such file or directory
解决办法:
你应该写「git@github.com:xxx/yyy」。使用 git remote set-url origin xxx 来修改成正确的地址。或者直接编辑 .git/config 文件。refrence

第四步:提笔写文章

执行下面命令来添加一篇新文章,然后把写好的文章在部署到github上就ok了。

1
hexo new [options] <title>

补充说明

  1. hexo一般分为两部分,一部分是hexo主体部分,另外一部分是hexo的主题。二者都有配置文件_config.yml
  2. 更新hexo的时候也分为两部分,一部分是更新主题,cd到theme相应的主题下,git pull,更新的时候,因为改过一些配置文件,所以需要先备份配置文件,在更新。

第五步

一些参考
markdown 语法
hexo 写作
hexo 写作语法

参考文档:

Hexo Doc
Next theme
hexo-theme-next wiki
hexo-theme-next
git submodule
使用 GitHub Pages + Hexo 基础教程