申請Github帳號
點擊https://github.com/ 進入 Github,點擊 sign up for github 就可以了
利用gitpage 搭建靜態網站
先進入你的github主頁,這裡你可以查看和管理你的所有項目
點擊綠色New按鈕,新建一個與你的github用戶名相同的 項目,如agmgh.github.io的項目即可。如下圖所示,xxx修改為你自己的github用戶名。
點擊 Create repository ,你自己的站點就創建好了。(https://yourgitname.github.io)然後是下載github的客戶端windows下 mac下(linux用命令行工具就不介紹了,略多不直觀),安 裝好後不同平臺會有不同,但是基本的還是一樣的.
將剛剛創建好的github.io項目,clone 到本地就可以了。
本地配置 jekyll
安裝ruby環境
window 下這裡下載ruby,安裝好後順手把rails一起安了吧~
安裝完成後記得設置環境變量, 具體就是把安裝好的ruby位置放到環境變量裡去。
win+R 調出運行,然後輸入cmd 呼出terminal,敲入gem install rails等待安裝完成吧~~
命令行輸入gem install bundler等待安裝完,
命令行輸入gem install jekyll等待安裝完,
接下來下載我的模板(https://github.com/agmgh/agmgh.github.io) 到你clone下來 的地址,記得解壓,你該看到大約是這樣
其中文件夾agmgh.github.io位置應該是你的項目位置
令行輸入cd XXXXX XXXX是你的項目位置,
命令行輸入bundle install
會自動給你安裝GEMfile中提到的幾個庫
這樣jekyll環境就算搭建好了
運行jekyll
配置_config
根據我的模板主頁的readme文檔設置
注意,本地試運行先把 production_url 改為http:\localhost:4000
運行jekyll
命令行依然cd到你的項目目錄,輸入jekyll build,運行完了後再輸入jekyll serve。 tips:沒事terminal不要關。
瀏覽器裡輸入地址http:\localhost:4000你就能看到博客主頁了 (不過這個時候搜索功能無法使用)!
可能會遇到的問題彙總
安裝github客戶端時,如果網絡狀況不佳,可能無法通過clickone 安裝github Windows 客戶端,建議從網上搜索別人做好的離線安裝包。
安裝ruby後,如果沒有替換為 淘寶源時,會出現無法安裝jekyll的情況。
切換淘寶源:
刪除默認的官方源
gem sources -r https://rubygems.org/
添加淘寶源
gem sources -a https://ruby.taobao.org/
查看當前源
gem sources -l # https://ruby.taobao.org
安裝我的模板時,需要安裝以下模塊:
gem install jekyll-seo-tag
gem install jekyll-feed
gem install jekyll-sitemap
執行gem install bundler 時出現ssl 證書驗證錯誤。
下載cacert.pem ,將文件放在C盤根目錄下
PS: cacert.pem 文件可自行百度
set SSL_CERT_FILE=C:\cacert.pem