date: 2016-11-29
個(gè)人搭建的博客地址：https://yiweiwoshiniya.github.io
如果你不熟悉建站各種編碼語(yǔ)言返咱，也不想花很多錢蛮穿，卻很想擁有一個(gè)獨(dú)立的個(gè)人博客，那Github Pages是你絕佳的選擇抓谴。github作為現(xiàn)在最流行的代碼倉(cāng)庫(kù)戳气，已經(jīng)得到了很多大公司和項(xiàng)目的青睞。github推出的Github Pages服務(wù)不僅可以方便的為項(xiàng)目建立介紹站點(diǎn)慧邮，也可以用來建立個(gè)人博客。跟著本博的順序舟陆，你將順利搭建自己的博客误澳。
Github Pages
創(chuàng)建倉(cāng)庫(kù)
登錄你自己的
github賬號(hào)，接下來去這個(gè)頁(yè)面去創(chuàng)建一個(gè)新倉(cāng)庫(kù)https://github.com/new
這個(gè)新倉(cāng)庫(kù)就是存放你博客的地方
注意一點(diǎn)秦躯，你的倉(cāng)庫(kù)名字格式應(yīng)為：用戶名.github.io
建完倉(cāng)庫(kù)忆谓，進(jìn)入你剛創(chuàng)建的倉(cāng)庫(kù)，找到設(shè)置踱承，進(jìn)入設(shè)置頁(yè)面
在設(shè)置頁(yè)面倡缠，一般都默認(rèn)就好，在
github pages那欄點(diǎn)擊launch automatic page generator
編輯用戶界面
到這一步茎活，就是編輯的博客頁(yè)面展示信息
Page name 頁(yè)面的標(biāo)題
tagline 頁(yè)面副標(biāo)題(描述)
body 正文
一般都默認(rèn)就可以了昙沦，反正當(dāng)前只是創(chuàng)建一個(gè)demo頁(yè)面，后續(xù)還得自己改
载荔，直接點(diǎn)擊下面的綠色按鈕continue to layouts
公布頁(yè)面
隨便選擇一個(gè)主題模板（不用糾結(jié)盾饮，這里的主題很少，一般都是
jekyll或者hexo的主題）,然后點(diǎn)擊Publish page懒熙，你的頁(yè)面就出來了丘损。可以直接在瀏覽器中輸入你的博客地址:用戶名.github.io就可以看到效果了工扎。
克隆倉(cāng)庫(kù)
使用
git工具或者命令行來git到本地徘钥，然后做自己的修改就可以了，換主題請(qǐng)往后看肢娘。
Jekyll
jekyll是一個(gè)基于ruby開發(fā)的呈础，專用于構(gòu)建靜態(tài)網(wǎng)站的程序。它能夠?qū)⒁恍﹦?dòng)態(tài)的組件：模板蔬浙、liquid代碼等構(gòu)建成靜態(tài)的頁(yè)面集合猪落，Github-Page全面引入jekyll作為其構(gòu)建引擎，這也是學(xué)習(xí)jekyll的主要?jiǎng)恿Τ氩Ｍ瑫r(shí)笨忌，除了jekyll引擎本身，它還提供一整套功能俱病，比如web server官疲。我們用jekyll –server啟動(dòng)本地調(diào)試就是此項(xiàng)功能袱结。讀者可能已經(jīng)發(fā)現(xiàn)，在啟動(dòng)server后途凫，之前我們的項(xiàng)目目錄下會(huì)多出一個(gè)_site目錄垢夹。jekyll默認(rèn)將轉(zhuǎn)化的靜態(tài)頁(yè)面保存在_site目錄下，并以某種方式組織维费。使用jekyll構(gòu)建博客是十分適合的果元，因?yàn)槠鋬?nèi)建的對(duì)象就是專門為blog而生的，在后面的逐步介紹中讀者會(huì)體會(huì)到這一點(diǎn)犀盟。但是需要強(qiáng)調(diào)的是而晒，jekyll并不是博客軟件，跟workpress之類的完全兩碼事阅畴，它僅僅是個(gè)一次性的模板解析引擎倡怎，它不能像動(dòng)態(tài)服務(wù)端腳本那樣處理請(qǐng)求。
更多關(guān)于jekyll請(qǐng)看
github: https://github.com/jekyll/jekyll
靜態(tài)博客地址：https://jekyllrb.com/
中文靜態(tài)博客地址：http://jekyllcn.com/
選擇主題
剛才只是搭建好你的倉(cāng)庫(kù)贱枣，現(xiàn)在你該考慮你的博客風(fēng)格了监署，到這個(gè)網(wǎng)站選擇你喜歡的模板http://jekyllthemes.org/
找到喜歡的主題下載到本地解壓，將本地倉(cāng)庫(kù)除了
.git隱藏文件夾的都刪除纽哥，钠乏，將下載下來的主題的文件全部復(fù)制出來到git倉(cāng)庫(kù)
jekyll是如何工作的
在jekyll解析你的網(wǎng)站之前，需要確保網(wǎng)站有以下目錄結(jié)構(gòu)：
|-- _config.yml
|-- _includes
|-- _layouts
| |-- default.html
| |-- post.html
|-- _posts
| |-- 20011-10-25-open-source-is-good.html
| |-- 20011-04-26-hello-world.html
|-- _site
|-- index.html
|-- images
|-- css
|-- style.css
|-- javascripts
_config.yml：保存配置昵仅，該配置將影響jekyll構(gòu)造網(wǎng)站的各種行為缓熟。
_includes：該目錄下的文件可以用來作為公共的內(nèi)容被其他文章引用，就跟C語(yǔ)言include頭文件的機(jī)制完全一樣摔笤，jekyll在解析時(shí)會(huì)對(duì){ % include file.ext %}標(biāo)記擴(kuò)展成對(duì)應(yīng)的在_includes文件夾中的文件。
_layouts：該目錄下的文件作為主要的模板文件垦写。
_posts：文章或網(wǎng)頁(yè)應(yīng)當(dāng)放在這個(gè)目錄中吕世，但需要注意的是，文章的文件名必須是YYYY-MM-DD-title梯投。
_site：上面提到過命辖，這是jekyll默認(rèn)的轉(zhuǎn)化結(jié)果存放的目錄。
images：這個(gè)目錄沒有強(qiáng)制的要求分蓖，主要目的是存放你的資源文件尔艇，圖片、樣式表么鹤、腳本等终娃。
以上就是大概的簡(jiǎn)介，可以在_config.yml文件中修改網(wǎng)站以及自己的個(gè)人信息蒸甜，_posts文件夾放你的博文棠耕，切記文件名格式余佛，更多詳細(xì)的語(yǔ)法上面貼出來的jekyll的官方博客以及github可以參考。
現(xiàn)在可以將改動(dòng)提交到遠(yuǎn)端倉(cāng)庫(kù)窍荧，提交后請(qǐng)求：用戶名.github.io看看是不是變了辉巡。
Jekyll安裝本地服務(wù)
如果每次改動(dòng)都需要提交到遠(yuǎn)端倉(cāng)庫(kù)才能看到效果的話，那就太麻煩了蕊退，有時(shí)候我們需要在本地測(cè)試好了郊楣，才提交上去，這就需要我們安裝Jekyll本地服務(wù)瓤荔。
注意：
- ruby版本痢甘，macOS自帶了ruby,但是不建議用。
- 由于國(guó)內(nèi)網(wǎng)絡(luò)茉贡，gem官方的源可能不好用塞栅，切換成國(guó)內(nèi)的忘晤。
Ruby安裝
- jekyll本身基于Ruby開發(fā)身冀，想要本地搭建測(cè)試環(huán)境需要有Ruby環(huán)境。
雖然macOS有自帶ruby寺擂，但是不推薦愉粤。我們使用rvm來管理ruby砾医。
rvm官網(wǎng)：https://rvm.io/ 安裝有介紹。
\curl -sSL https://get.rvm.io | bash -s stable --ruby
- 安裝完成查看版本
rvm -v
-
rvm list known查看可用的ruby版本
- 找到最新的版本（不一定是非要安裝最新的）
rvm install 版本號(hào)(如2.2.0)
- 因?yàn)橄到y(tǒng)自帶ruby衣厘，我們需要切換成我們自己的ruby版本
rvm use 2.2.0 --default
- 查看
rvm list就可以看到當(dāng)前默認(rèn)的是我們自己的ruby版本如蚜。ruby -v也可以看到是我們自己的的ruby版本。
安裝jekyll
- 首先影暴，我們需要切換rubygem倉(cāng)庫(kù)鏡像地址
sudo gem sources --remove http://rubygems.org/
sudo gem sources -a https://gems.ruby-china.org/
- 更新gem自身版本
gem update --system
- 執(zhí)行下面的命令安裝jekyll
gem install jekyll
如果有報(bào)錯(cuò)提示權(quán)限問題的話错邦，在Mac OS X El Capitan或者更高版本下
gem install -n /usr/local/bin jekyll
- 待安裝成功后，終端文件夾路徑切到本地倉(cāng)庫(kù)下型宙，執(zhí)行
jekyll server
如果報(bào)錯(cuò)撬呢，看下報(bào)錯(cuò)信息（原諒我當(dāng)時(shí)沒有保存報(bào)錯(cuò)信息），如果有提到bundler的話妆兑。
gem install bundler
待成功后繼續(xù)執(zhí)行
jekyll server
如果還是報(bào)錯(cuò)魂拦，如果有提到 bundle install 的話,執(zhí)行：
bundle install
繼續(xù)執(zhí)行
jekyll server
控制臺(tái)提示: Server address: http://127.0.0.1:4000/，將這個(gè)地址粘貼到瀏覽器中請(qǐng)求看看搁嗓，你的博客出來了芯勘。
這樣就可以本地測(cè)試，如果修改了腺逛，啟動(dòng)jekyll服務(wù)進(jìn)行本地測(cè)試荷愕，測(cè)試沒有問題再提交到遠(yuǎn)端github倉(cāng)庫(kù)。
域名綁定
購(gòu)買域名，國(guó)內(nèi)路翻，國(guó)外的域名服務(wù)商都可以狈癞。我自己在阿里云買的域名。
假如你現(xiàn)在購(gòu)買成功了如：abc.com
你需要在阿里云后臺(tái)去配置這個(gè)域名的解析
ping 用戶名.github.io 在終端執(zhí)行茂契，會(huì)看到一個(gè)IP蝶桶，記住這個(gè)IP
在git本地倉(cāng)庫(kù)下，新建一個(gè)CNAME文件掉冶，里面寫上你購(gòu)買的域名真竖，保存提交。過一會(huì)厌小，就可以在你的github的倉(cāng)庫(kù)設(shè)置中看到你的域名已經(jīng)配置上去了恢共。
這下可以在瀏覽器中訪問abc.com就可以看到你的博客了。
總結(jié)
至此就搭建完成璧亚，可以愉快的寫作了讨韭！搭建的過程挺不順利的，安裝本地測(cè)試服務(wù)的時(shí)候遇到各種版本癣蟋、路徑透硝、權(quán)限問題，不過都解決了疯搅。大家如果有什么問題濒生，歡迎留言。
感謝幫過我的各個(gè)博主幔欧。
http://www.ezlippi.com/
http://baixin.io/
http://cyzus.github.io/