Jekyll搭建github我的博客

1、安裝ruby環境

Windows下載地址: http://rubyinstaller.org/

Ruby官網: http://www.ruby-lang.org/zh_cn/

下載安裝便可

環境配置

安裝好以後必須配置環境變量

在環境變量中PATH字段中增長 你的安裝路徑\Ruby22-x64\bin 好比 : D:\ProgramFiles\Ruby22-x64\bin

除此以外還必須新增一個字段 SSL_CERT_FILE，內容爲cacert.pem所在路徑，好比D:\ProgramFiles\Ruby22-x64\cacert\cacert.pem

cacert.pem下載地址: https://curl.haxx.se/ca/cacert.pem

檢測安裝

ruby -v

gem -v

若是順利打印出版本號則安裝成功

替換rubyGem庫地址

若是使用gem安裝軟件較慢，能夠嘗試替換gem源爲國內的源

gem sources --remove https://rubygems.org/
gem sources -a https://gems.ruby-china.org/
gem sources -l

淘寶源:

gem sources -a https://ruby.taobao.org/

遇到 SSL 證書問題

若是遇到 SSL 證書問題，你又沒法解決，請直接用 http://gems.ruby-china.org 避免 SSL 的問題

D:\MyBlog\RubyDevKit>gem sources -l
*** CURRENT SOURCES ***

http://gems.ruby-china.org/

2、安裝RubyDevKit

DevKit是windows平臺下編譯和使用本地C/C++擴展包的工具。它就是用來模擬Linux平臺下的make,gcc,sh來進行編譯。可是這個方法目前僅支持經過RubyInstaller安裝的Ruby

下載地址: http://rubyinstaller.org/downloads/

雙擊運行解壓到D:\MyBlog\RubyDevKit (路徑可自行定義)。

打開終端cmd，輸入以下命令進行安裝：

cd D:\MyBlog\RubyDevKit
ruby dk.rb init

接下來須要在D:\MyBlog\RubyDevKit\config.yml 這個文件裏面配置Ruby的路徑，以下：

- D:/ProgramFiles/Ruby22-x64/bin

在cmd中執行以下命令進行安裝：

ruby dk.rb install

3、安裝必要的gem包

gem install jekyll
gem install rails
gem install bundler

4、建立jekyll博客

jekyll new myBlog
cd myBlog
jekyll server

在瀏覽器輸入http://127.0.0.1:4000/

報錯排查

端口被佔用

D:\GarryBlog>jekyll server
Configuration file: D:/GarryBlog/_config.yml
Configuration file: D:/GarryBlog/_config.yml
            Source: D:/GarryBlog
       Destination: D:/GarryBlog/_site
 Incremental build: disabled. Enable with --incremental
      Generating...
                    done in 0.252 seconds.
  Please add the following to your Gemfile to avoid polling for changes:
    gem 'wdm', '>= 0.1.0' if Gem.win_platform?
 Auto-regeneration: enabled for 'D:/GarryBlog'
Configuration file: D:/GarryBlog/_config.yml
jekyll 3.3.1 | Error:  Permission denied - bind(2) for 127.0.0.1:4000

解決方案:

這個錯誤是告訴咱們4000端口被佔用，解決方法是：
在_config.yml文件的末尾加上port: 5000，改成5000端口便可。
這樣在瀏覽器中輸入http://127.0.0.1:5000/ 就能夠看到本身的博客了。

5、安裝git環境

下載地址: https://git-for-windows.github.io/
安裝完成後運行Git Bash。在打開的窗口中輸入以下命令設置你的git用戶名和郵箱：

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

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

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

一路敲回車便可，在C:\Users\admin.ssh 目錄下會生成id_rsa 和 id_rsa.pub 兩個文件，其中 id_rsa 是私鑰，須要保密， id_rsa.pub 是公鑰，無需保密。
在瀏覽器中登陸你的github賬號，點擊右上角的Setting-SSH and GPG keys，在SSH Key中添加 id_rsa.pub裏的內容，而後點擊addkey便可，這樣SSH配置就完成了。

6、部署到GitHub Pages

建議基於jekyll的我的博客有兩種路線：

• 本身學習Jekyll教程和網頁設計，設計絕對自我基因的網頁。

• Fork已有的開源博客倉庫，在巨人的肩膀上進行符合自個人創做。

  ​

路線一

1. 新建一個與本身github用戶名相同的倉庫，倉庫名爲 {github用戶名}.github.io

   如 : quanzaiyu.github.io

1. 配置github pages

2. 選擇本身喜歡的github主題

3. 在瀏覽器輸入 {github用戶名}.github.io 便可訪問本身的我的博客

   好比: https://quanzaiyu.github.io/

4. 若是想要使用jekyll搭建我的博客，先將此倉庫clone到本地，使用上述方法建立我的博客再發布到github便可

路線二

1. 在網上搜索jekyll 網站模版，挑選一個你看上的，好比

   https://github.com/leopardpan/leopardpan.github.io

    https://github.com/mzlogin/mzlogin.github.io 

   https://github.com/dapengyou/dapengyou.github.com

   http://jekyllthemes.org/

2. 點擊連接進入後，點擊左上角的fork

3. 在你的主頁中點擊剛fork的分支，點擊進入

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

   • 注意: 必定必須是本身的Github用戶名

   此時你會發現已經能夠經過 https://{你的Github用戶名}.github.io

好比個人: https://quanzaiyu.github.io/

 

7、同步博客

同步倉庫

在Git Bash中切換到你想存放blog文件的目錄下：

cd D:\GarryBlog

輸入以下命令，將遠程倉庫克隆到本地：

git clone https://github.com/Garry2016/garry2016.github.io.git

撰寫博文

打開本地倉庫的 _posts 文件夾，你的全部博文都將放在這裏，寫新博文只須要新建一個標準文件名的文件，在文件中編寫文章內容。 好比咱們fork的模版中 _posts 文件夾裏有一篇 2016-03-23-hello-world.markdown，你的文件命名也要嚴格遵循 年-月-日-文章標題.文檔格式 這樣的格式，尤爲要注意月份和日期必定是兩位數。
推薦使用Markdown語言寫文章，windows下推薦MarkdownPad這個軟件編寫Markdown文本。
最開始寫能夠直接模仿別人的博文語法，更多Markdown語法可參考 認識與入門Markdown。

提交修改

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

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

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

$ git add .
$ git commit -am "statement"   //此處statement填寫這次提交修改的內容，做爲往後查閱
$ git push origin master

實時查看本地修改的內容

咱們本地已經安裝好了jekyll環境，咱們能夠輸入 jekyll server啓動服務，而後在瀏覽器中查看本地修改內容，方便快捷！

---

好了，使用jekyll搭建我的博客就寫完了，還涉及一些內容這裏沒講，好比評論，分享等功能。咱們fork的博客裏面已經實現了這些功能，你們去看源碼應該就能夠知道了。