AsciiDoc with GitLab Pages

13 Apr 2018

Why?

原本使用的是Github Pages，但是才沒用多久就發現畫面壞掉，經過查證後發現是個bug， Github Pages 沒辦法在 _config.yml 裡面設定 baseurl ，這導致網頁上的路徑會出錯
Github Pages 原生不支援 AsciiDoc ，有人送了 ticket 出去，但是看來沒有回應，但我想用

改用GitLab Pages，但是說真的其實我沒有去查過Github Pages有沒有別的做法
GitLab並不是內建支援某一種特別的framework，而是單純的讓你放一個靜態網頁，這意思是說：
1. 你可以用各種不同的Framework，只要最後輸出結果是靜態網頁即可
2. GitLab提供了各種不同的example project，可以去 GitLab Pages examples 找看看有沒有習慣的，我個人還是使用與 Github 相同的 jekyll
3. 透過 artifacts 將輸出結果存起來即可，需注意 path 的名稱是 public
使用免費的 shared runner 來編譯
1. 使用docker runner來編譯，可自行準備相關環境，因此可以額外掛上 jekyll-asciidoc ，細節可參考 Gemfile
2. 我有備好的 docker image 可供使用: shihta/jekyll-asciidoc:gitlab，細節可參考 Dockerfile

: AsciiDoc