2015年3月12日 星期四

Github Pages 使用jekyll安裝與設定,及連結多個github專案

第一個github pages

在github建立一個repository 名稱為<username>.github.io

好了,剛建立好等一陣子,打開瀏覽器進入<username>.github.io,就可以看到空白網站了

<username>.github.io git clone下來,隨便加個index.html就可以看到結果了

連結其他的github專案

每個github專案都可以自己管理自己的github pages,不用都放在剛剛那個<username>.github.io裡面。

譬如你還有一個github專案,名稱為project,則在project裡面再開啟一條branch命名為gh-pages,那麼連結<username>.github.io/project,就可以連到project裡面了。

只是gh-pages這條分支,都只會用來做專案的網頁呈現,所以我們會將它設定為獨立分支,不從master裡面分出來,所以開啟分支時,使用

git checkout --orphan gh-pages

就可以開啟獨立的分支,沒有任何parent的分支,這時候再把原本的檔案都刪掉,這條分支就專心做網頁就好。

使用jekyll

從HTML慢慢刻出一個網頁有點累,github pages大多是用jekyll這個框架來產生部落格網站。

怎麼安裝,jekyll-quick-start 已經講得很清楚了,這邊說一下,連結其他github專案時要特別設定的地方

在jekyll根目錄有個_config.yml檔案,找到BASE_PATH :這一行。如果沒有修改的話,在網頁裡面預設的連結都會連回<username>.github.io,而不是你目前的<username>.github.io/project,這裡使用絕對路徑或相對路徑都可以

絕對路徑

BASE_PATH : <username>.github.io/project

相對路徑

BASE_PATH : /project

這樣子預設的連結就不會亂跑了,我一開始找不到,只好傻傻的去改模板,越改越覺得不對勁,不可能要使用者用這麼智障的方法,仔細再看一次_config.yml檔,才發現可以設定