Github Pages + Hexo の設定

Github Pages

  • アクセス制限やビルド制限など Usage limits に注意.
  • Jekyll がデフォルトなので, 最初の設定では Jekyll でサイトを構築する.
    root directory に _config.yml, _layouts/default.html (ブランチ作成時とは別の手順で作成), LICENSE, README.md, .gitignore (Jekyll) は残しておく.

Hexo

  • master repo の下に _hexo フォルダを作成してインストールする.
  • MathJax は, npm install hexo-renderer-mathjax --save でインストールする.
  • Hexo のインストール
1
$ npm install -g hexo
  • Github Pages と連携したインストール
1
2
3
4
5
6
7
8
$ git clone https://github.com/{users}/{users}.git
$ cd {users}
$ git checkout -b hexo         # hexoブランチを作成
$ hexo init _hexo
$ cd _hexo
$ npm install
$ npm install hexo-deployer-git --save
$ npm install hexo-renderer-mathjax --save

  • _hexo/node_modules/hexo-renderer-mathjax/mathjax.html を編集する. 

    1
    2
    -<script src="http://cdn.mathjax.org/mathjax/latest/MathJax.js?config=TeX-AMS-MML_HTMLorMML"></script>
    +<script src="//cdn.mathjax.org/mathjax/latest/MathJax.js?config=TeX-AMS-MML_HTMLorMML"></script>
1
2
3
$ git add .
$ git commit -m 'installed hexo'
$ git push origin hexo         # remote:hexo に push
  • _config.tml を編集

  • サイト情報

    1
    2
    3
    4
    5
    6
    7
    8
    # Site
    title: How do you like Quantum ?
    subtitle: 量子計算/量子情報の徒然なブログ
    description:
    keywords: quantum computing, quantum information
    author: kyamaz
    language: ja
    timezone: Japan

  • URLの変更

    1
    2
    3
    4
    5
    # URL
    url: http://{user}.github.io/{user}
    root: /{user}/
    permalink: :year/:month/:day/:title/
    permalink_defaults:

  • deployの設定

    1
    2
    3
    4
    5
    6
    # Deployment
    deploy:
      type: git
      repo: https://github.com/{user}/{user}.git
      branch: master
      message: updated by hexo deployer

新規記事の追加

1
2
$ cd _hexo
$ hexo new post 新規ページ

( YYYYMMDD_AA_any_strings.md として管理すると便利. )

deploy 操作

master に直接 commit する. 更に, HEAD から master push される.

1
2
3
4
5
6
7
8
$ git checkout hexo

$ cd _hexo
$ hexo deploy -g

$ git add source
$ git commit -m 'updated _posts'
$ git push origin hexo