把博客放在Github


故事是這樣的,我開始想要在vim寫博客,找到Markdown是寫技術博客的很好用的一種標記語言, 同時發現Github Pages可以托管用Markdown寫的博客站點,然后就嘗試在Github寫博客。

Markdown

Markdown 是一種輕量級標記語言,創始人為John Gruber和Aaron Swartz。它允許人們“使用易讀易寫的純文本格式編寫文檔, 然后轉換成有效的XHTML(或者HTML)文檔”。這種語言吸收了很多在電子郵件中已有的純文本標記的特性。 Github的README.md文件就是用Markdown格式寫的。在這里了解Markdown語法的語法,學習10分鍾就可以用它寫博客了,是不是很簡單。

Github Pages

然后很自然的了解到了Github Pages。Github設計了Pages功能,允許用戶自定義用戶首頁,和項目首頁。也就是說, 用戶可以把靜態頁面托管到Github。當然,Github Pages的功能不止是托管靜態頁面,否則用html寫博客,同時還要關注樣式那是無法接受的。 Github Pages同時提供了模板功能,可以用解析引擎是Jekyll。

一句話教程:

在gh-pages分支add一個index.html文件,push到github,訪問http://username.github.com/projectname/就可以看見你發布的網頁了。

很重要一點,Github Pages支持綁定域名

Jekyll

Jekyll是一個靜態站點生成器,它會根據網頁源碼生成靜態文件。它提供了模板、變量、插件等功能,不需要數據庫,文章可以使用Markdown、HTML、Textile格式的文件保存。 Github可以解析符合Jekyll規范的網站源碼。

使用上面說的仨,你就可以建立很酷的博客了,這個博客的特點是:

  • 完善的版本管理,你可以找回你每一次新增、修改的信息。
  • 在Github你可以有免費、無限的流量。
  • 使用你喜歡的編輯器寫博客,使用簡潔的Markdown,不必在忍受在線編輯器。
  • 綁定自己的域名。
  • 當然,這樣做很酷。

Octopress

使用上面的方案你就可以DIY你個人博客的每一部分。 從零開始不是多數人的選擇,你可以參考開源的Jekyll模板。 當然,你還可以選擇Octopress。使用Octopress的方案也用到了上面的仨,不一樣的地方在於Jekyll生成靜態頁面的過程發生在本地。使用它提供的發布命令rake deploy即可發布到github。 這樣做帶來的好處有:

  • 有一系列便捷的命令負責生成、預覽、發布、新建文章、新建頁面等等。
  • 有本地預覽功能。
  • 有一套還算美觀的模版,這個模板修改起來還是很方便的。
  • 網站源碼和靜態頁面分離。可以在git以不同分支管理。

搭建Octopress參考官方文檔即可,在Linux下搭建還是很簡單的。 在windows下,我的選擇是在Cygwin下搭建, 中途出了點小問題,如果你要這樣做,建議參考下: 在Cygwin搭建Octopress, 這是在windows下的一個選擇。直接在Windows安裝也是可以的,只是我不喜歡使用Windows那爛得不行的Cmd。

社會化評論

大家或許想到了,靜態頁面怎么能有評論功能?一個答案就是社會化評論系統。 社會話評論系統的好處是方便管理,降低網站復雜度,分享功能有助網站推廣。 壞處也很明顯,數據不可控。當下,社會化評論是一個趨勢。 這是我在Octopress使用社會化評論的過程。

域名

訪問部署在github的頁面使用的網站是:http://username.github.com/projectname/。你也可以綁定自己的域名。 在Github Pages使用域名很方便。步驟如下:

  1. 讓網站根目錄,也就是gh-pages分支的根目錄,新建一個叫CNAME的文件,里面寫上自己的域名。
  2. 如果綁定頂級域名,新建A記錄指向204.232.175.78(這是Github的文檔給出的,也許已經改變)
  3. 如果綁定二級域名,修改CNAME指向username.github.com即可。

再補充一點

按照Github的文檔建立一個與用戶名相同的倉庫,把頁面傳到master分支,就可以用http://username.github.com/訪問, 不過我試了下,沒有成功(404),有誰能指導下嗎?我理解錯了,是建立一個名為username.github.com的倉庫 (把username替換成你的用戶名),把頁面放在master分支,就可以用http://username.github.com訪問。 已試驗成功。

好嘞,博客搭建完成。請在這里看下效果:http://hswg.info

如果你有興趣,也可以參考阮一峰的博客: 搭建一個免費的,無限流量的Blog—-github Pages和Jekyll入門

對了,這篇文章就是用Markdown寫的。


免責聲明!

本站轉載的文章為個人學習借鑒使用,本站對版權不負任何法律責任。如果侵犯了您的隱私權益,請聯系本站郵箱yoyou2525@163.com刪除。



 
粵ICP備18138465號   © 2018-2025 CODEPRJ.COM