Use Hexo for blogging in github pages

Install

NPM

sudo pacman -S npm

China mirror

sudo npm config set registry https://registry.npm.taobao.org

Hexo

As pacman install the npm in the /usr path.^[1] We need root priveledge to install Hexo. But this will make running npm and Hexo need root previledge.

##npm config get prefix

sudo npm install hexo-cli -g[^fn2]

Setup a blog

$ sudo hexo init blog

Need root priveledge, and the current directory need to not be in NTFS or FAT filesystem. As it will make symbolic link. And then you should better change the ownership.

1 $ sudo chown -R vagrant:vagrant blog

I use vagrant:vagrant here, you should set yourself userName:groupName.

Hexo plugin

git^[2]

1 $ npm install hexo-deployer-git --save

This will install it in the local directory, the blog directory.

Edit settings. _config.yml

1
2
3
4 deploy:
  type: git
  repo: <repository url>
  branch: [branch]

mathjax^[3]^[4]

1 $ npm install hexo-math --save

footnote

Hexo’s default markdown render don’t support footnote. use hexo-renderer-markdown-it^[5] instead.

install

1
2 $ npm un hexo-renderer-marked --save
$ npm i hexo-renderer-markdown-it --save

configure^[6]

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17 markdown:
  render:
    html: true
    xhtmlOut: false
    breaks: false
    linkify: true
    typographer: true
    quotes: '“”‘’'
  plugins:
     - markdown-it-footnote
     - markdown-it-abbr
 anchors:
     level: 1
     collisionSuffix: 'v'
     permalink: true
     permalinkClass: header-anchor
     permalinkSymbol: ' '

If under the footnote, there has some block, such as code block. The code block will be act as footnote. You should put the footnote to the end of the article Or use the Horizontal rule/line to cut them.

Attention: the Horizontal rule/line break is *** here. Not ---.

comment [Todo]

Use

Create a new post

$ sudo hexo new "Hello Hexo"

Generate static files

$ sudo hexo generate

$ sudo hexo g

Deploy

$ sudo hexo deploy

$ sudo hexo d

or with generate

$ sudo hexo d -g

If it didn’t pop up the input hint to input name/password. You should manually git push.

$ cd blog/.deploy_git
$ git push

Backup (Use hexo-git-backup)

Use git and .gitignore to backup other source directory to another branch. Make a shell script.

Or use https://github.com/coneycode/hexo-git-backup

$ npm install hexo-git-backup --save

You should configure this plugin in _config.yml.

backup:
    type: git
    repository:
       github: git@github.com:xxx/xxx.git,branchName
       gitcafe: git@github.com:xxx/xxx.git,branchName

$ hexo backup

$ hexo b

删除文章

https://joilence.github.io/2016/07/14/improve-blog/ 在使用 hexo new 生成新文章之后，想要删除，如果只是直接在 /source/_post 中将相关 md 文件删除，可能在生成网页后还会重现。删除文章比较完备的步骤如下：

在 /source/_post 中删除相关 md 文件在博客根目录下使用 sudo hexo clean 删除博客根目录下的 db.json 文件再重新生成网页就可以了。

Todo

comment

use Travis CI to auto-build the output

For writing blog on another machine. Don’t need to setup the build environment in Linux.

Docker???

refer to: http://notes.iissnan.com/2016/publishing-github-pages-with-travis-ci/ https://djw8605.github.io/2017/02/08/deploying-docs-on-github-with-travisci/ important https://github.com/alrra/travis-scripts/blob/master/doc/github-deploy-keys.md

half50Mac OS 10.12.0Chrome 50.0.2661.75 这篇文章可以有更好的实现方式文章的方式是使用 personal_token 可以对所有项目进行读写等行为现在 github 上每个项目有 deploy_key 对该项目有读写权限（push 需要打勾）

我优化后的部署配置流程是

用命令 ssh-keygen -t rsa 生成密钥
复制公钥 id_rsa.pub 内容添加到项目的 deploy_key 并打勾写权限
将密钥 id_rsa 通过 travis 加密工具加密并提交到 master 分支
在 travis 上自动部署的时候用 ssh-agent bash -c 'ssh-add /path/to/id_rsa; git push -f -q git@github.com/repo.git master:gh-pages'

TOC(Topic of content)

font, CSS, javaScript

http://crazymilk.github.io/2015/12/28/GitHub-Pages-Hexo搭建博客/#more

2016-10-26