Github pages + jekyll 博客快速搭建

Github Pages + Jekyll 方案的優勢：

　　· 免費

　　· 有版本管理，修改方便

　　· 支持markdown

缺點：

· 它生成的是靜態網頁，添加動態功能必須使用外部服務，好比評論功能要使用第三方服務（如disqus）。

· 它不適合大型網站，由於沒有用到數據庫，每運行一次都必須遍歷所有的文本文件，網站越大，生成時間越長。

 

步驟：

1.註冊Github

2.域名

　　1）去買域名

　　2）用Github pages提供的免費域名

http://{username}.github.io //用你的Github用戶名替換網址中的{username}`

　　後面有詳細說明。

3.安裝Git環境

　　現討論window環境的。這裏能夠下載：https://git-for-windows.github.io/

　　工做須要，這個是舊版的：

 

　　新版的圖標比較好看。

　　在打開的命令行窗口（Shell）內執行如下命令，設置你的git用戶名和郵箱：

$ git config --global user.name "{username}"          // 用你的用戶名替換{username}

$ git config --global user.email "{name@site.com}"    // 用你的郵箱替換{name@site.com}

 

4.SSH配置

　　爲了和Github的遠程倉庫進行傳輸，須要進行SSH加密設置。

　　在剛纔打開的Shell內執行：

$ ssh-keygen -t rsa -C"{name@site.com}"    // 用你的郵箱替換{name@site.com}

　　能夠不輸入其餘信息，一直敲回車直到命令完成。 這時你的用戶目錄（win7以上系統默認在C:\Users\你的計算機用戶名）內會出現名爲 .ssh 的文件夾，點進去能看到 id_rsa 和 id_rsa.pub兩個文件，其中 id_rsa 是私鑰，不能讓怪人拿走， id_rsa.pub 是公鑰，無需保密。

　　接下來用你的瀏覽器登陸Github，點擊右上角的「Settings」：

 

　　用文字處理軟件打開剛纔的 id_rsa.pub 文件，複製所有內容。
　　點擊「SSH and GPG Keys」，

　　點擊「New SSH Key」，將複製的內容粘貼在Key中，點「Add Key」肯定。

 

 

5.建立項目

　　1）Fork（Git系統的建立分支，簡單來講是把當前倉庫複製一份到你的倉庫，你能夠進行修改，由於你的倉庫是原來倉庫的新的分支）已有的開源博客倉庫，在巨人的肩膀上進行符合自個人創做（找個大神的做品本身改改）。

　　能夠去這裏挑：

　　https://github.com/jekyll/jekyll/wiki/sites

　　http://jekyllthemes.org/

　　這個就挺好，知乎上看到的：https://github.com/Huxpro/huxpro.github.io

　　而後點fork：

　　去主頁裏找到剛纔fork的分支：

 

　　點擊「Settings」，將「Repository name」改成 {你的Github用戶名}.github.io，點擊「Rename」。

 

　　此時就能夠經過 http://{你的Github用戶名}.github.io 訪問你fork下來的網站了。

　　2）自建

　　自建比較慢，之後討論。

 

6.寫東西

　　1）克隆

　　再次打開Git Bash，輸入如下命令切換到你想放置本地代碼倉庫的位置：

$ cd {本地路徑}     // 好比：cd d:/hahah

　　或者隨便找個地方右鍵Git Bash。

　　clone（克隆）你本身的遠程倉庫：

$ git clone https://github.com/{username}/{username}.github.io.git     // 用你的Github用戶名替換{username}

　　失敗的話多是打錯了或者網很差，網很差的話能夠找工具tiao牆，網慢就等一會：

 

　　2）寫博客

　　打開本地的 _posts 文件夾，你的全部博文都將放在這裏，寫新博文只須要新建一個標準文件名的文件，在文件中編寫文章內容。 好比咱們fork的模版中 _posts 文件夾裏有一篇2014-01-29-hello-2015.markdown，你的文件命名也要嚴格遵循 年-月-日-文章標題.文檔格式 這樣的格式，注意月份和日期是兩位數。

　　推薦使用Markdown語言寫文章，windows下推薦MarkdownPad這個軟件編寫Markdown文本。

　　最開始寫能夠直接模仿別人的博文語法，更多Markdown語法可參考 認識與入門Markdown。

　　3）修改和提交

　　當你使用Git Bash對你的本地倉庫進行操做時，先用 cd 命令將你的工做目錄設置到你要操做的本地倉庫

$ cd {你剛纔clone下來的項目文件夾路徑}

 

　　每當你對本地倉庫裏的文件進行了修改，只需在Bash中依次執行如下三個命令便可將修改同步到Github，刷新網站頁面就能看到修改後的網頁：

$ git add .

$ git commit -m "statement"   //此處statement填寫這次提交修改的內容，做爲往後查閱

$ git push origin master

　　報錯的狀況會單獨討論。

 

7.搭建本地環境

　　1）.先安裝Ruby：

 

 

　　x64對應64位系統，挑一個順眼的。

　　記得勾選添加到環境變量PATH，忘了就卸載重安。

　　2）.安裝 RubyGems

　　windows下下載ZIP格式較爲方便，下好後解壓到本地任意路徑，下面以 {unzip-path} 代替你解壓的路徑。 打開windows的cmd終端（按win+R快捷鍵打開「運行」，輸入cmd，肯定），輸入命令:

$ cd {unzip-path}  //若是你沒有解壓在C盤，windows的終端切換到其餘盤須要寫爲 cd /d {unzip-path}$ ruby setup.rb

　　3）.安裝Jekyll

　　在終端裏輸入

$ gem install jekyll

　　4）.安裝jekyll-paginate

　　在終端裏輸入

$ gem install jekyll-paginate

　　如遇到如下錯誤，說明網絡不通：

ERROR:  While executing gem ... (Gem::RemoteFetcher::FetchError)Errno::ECONNRESET: An existing connection was forcibly closed by the remote host.

　　其餘錯誤度娘或google，忘了當時報的什麼錯了。

 

8.開啓本地預覽

　　上一小節的安裝都完成之後，在終端中輸入命令

$ cd {local repository} // {local repository}替換成你的本地倉庫的目錄

$ jekyll serve

　　若是沒有報錯，在瀏覽器地址欄輸入 http://localhost:4000/ 回車就能夠預覽了。不過 jekyll serve 服務須要一直開着。

 

摘取自：http://playingfingers.com/2016/03/26/build-a-blog/

擴展閱讀：

　　Github Pages
　　Git教程 - 廖雪峯
　　Jekyll中文文檔
　　認識與入門Markdown
　　Ruby和Gem
　　使用Github Pages建獨立博客
　　搭建一個免費的，無限流量的Blog—-github Pages和Jekyll入門