把github page作为静态站点的做法

要使用 github page 作为站点，需要这么做：

• 创建一个名字为username.github.io的仓库, 在本地创建一个空仓库。
  

  $ mkdir username.github.io/
  $ cd username.github.io/
  $ git init
  $ git commit --allow-empty -m "Create master branch"
  $ git remote add origin git@github.com:username/username.github.io.git
  $ git push -u origin master

使用master作为发布分支。每次博客生成后推到master，但为了偷懒，可以选择使用持续集成服务(CircleCI)完成自动构建推送。

--------------

• 创建一个orphan分支来管理站点的源代码
  

  $ git checkout --orphan hakyll
  $ git submodule add git@github.com:username/username.github.io.git _site
  $ git commit -m "Create hakyll branch"
  $ git push -u origin hakyll

  Hakyll 会把站点生成到_site目录中，所以这里把_site目录作为 submodule，把_site中的内容推到master分支。

Hakyll 配置

使用下面命令完成 Hakyll 初始化,编译。

$ hakyll-init .
$ stack init
$ stack build

之后可以使用下面三条命令：

$ stack exec site build  // 生成站点
$ stack exec site watch  // 在 localhost:8000 查看站点
$ stack exec site clean  // 删除缓存，站点

在你完成配置，修改模板样式后，提交一次。记得在gitignore中添加_site,_cache和其他Haskell 忽略文件

$ git add --all
$ git commit -m "Configure Hakyll"
$ git push origin hakyll

CircleCI 配置

CircleCI 提供了持续集成服务，对 Haskell 的支持较好。配置文件如下：

machine:
  ghc:
    version: 7.10.1

dependencies:
  cache_directories:
    - "~/.stack"
    - ".stack-work"
  pre:
    - curl -L https://github.com/commercialhaskell/stack/releases/download/v1.1.2/stack-1.1.2-linux-x86_64.tar.gz | tar zx -C /tmp
    - sudo mv /tmp/stack-1.1.2-linux-x86_64/stack /usr/bin
  override:
    - stack setup
    - stack build

test:
  override:
    - echo "skip test command"
  post:
    - git submodule init
    - git submodule update
    - cd _site/ && git checkout master
    - stack exec site build

deployment:

  production:
    branch: hakyll
    commands:
      - git config --global user.email circleci@circleci
      - git config --global user.name CircleCI
      - cd _site/ && git status
      - cd _site/ && git add --all
      - cd _site/ && git commit -m "Update (`date '+%F %T %Z'`) [ci skip]"
      - cd _site/ && git push origin master

配置有以下几点：

• 由于 CircleCI 默认使用 cabal,并没有安装 stack,所以需要把 stack 的安装写进去。
• 需要把 stack 安装的包和 hakyll 编译的文件缓存下来，添加缓存目录~/.stack和.stack-work
• 跳过测试，把站点生成到_site
• 通过[ci skip]在推到master时跳过 ci。

CircleCI 配置完成后，提交到hakyll分支。

$ git add circle.yml
$ git commit -m "Configure CircleCI"
$ git push origin hakyll

CircleCI 第一次构建要花大约30分钟，之后你就可以访问你的站点了.

from http://birdgg.me/posts/2016-09-11-hakyll.html

相关帖子：http://briteming.blogspot.com/2017/01/create-github-page-with-hakyll-and.html