Github Page 搭建 jekyll 博客

編程語言 GitHub Ruby Windows 老郭的軟件開發之路 老郭的軟件開發之路 2017-08-28

申請Github帳號

點擊https://github.com/ 進入 Github,點擊 sign up for github 就可以了

利用gitpage 搭建靜態網站

先進入你的github主頁,這裡你可以查看和管理你的所有項目

Github Page 搭建 jekyll 博客

my github index

點擊綠色New按鈕,新建一個與你的github用戶名相同的 項目,如agmgh.github.io的項目即可。如下圖所示,xxx修改為你自己的github用戶名。

Github Page 搭建 jekyll 博客

agmgh.github.io

點擊 Create repository ,你自己的站點就創建好了。(https://yourgitname.github.io)然後是下載github的客戶端windows下 mac下(linux用命令行工具就不介紹了,略多不直觀),安 裝好後不同平臺會有不同,但是基本的還是一樣的.

Github Page 搭建 jekyll 博客

windows github

將剛剛創建好的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下來 的地址,記得解壓,你該看到大約是這樣

Github Page 搭建 jekyll 博客

agmgh.github.io

其中文件夾agmgh.github.io位置應該是你的項目位置

令行輸入cd XXXXX XXXX是你的項目位置,

命令行輸入bundle install

會自動給你安裝GEMfile中提到的幾個庫

這樣jekyll環境就算搭建好了

運行jekyll

配置_config

根據我的模板主頁的readme文檔設置

注意,本地試運行先把 production_url 改為http:\localhost:4000

Github Page 搭建 jekyll 博客

Hao's Blog

運行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

相關推薦

推薦中...