起因
工作后,我一直在博客園寫博客,不過這幾年一共只寫了幾篇。分析其中的原因:
-
不夠專注
工作和生活上的事情有很多,很難一次性寫完一篇長的博客; 常常會沒有思路,或者突如其來的一些事情打斷了寫作。
-
更喜歡用本地工具
使用本地編輯器習慣了,在網頁里面寫總會感到別扭。
-
喜歡純文本格式
喜歡reStructuredText,以及Markdown;不願意在調整格式上,花太多時間。
-
其實更喜歡寫代碼
作為程序員,寫代碼的時候很快樂,而寫文檔的時候很痛苦。
轉向Github
雖然很早就聽說了Git,但是2011年才開始學習和使用Git, 主要還是因為公司要將版本管理工具從Synergy轉向Git。 在學習過程中接觸到了Github。我眼中的大牛劉未鵬的文章《怎樣花兩年時間去面試一個人》, 讓我認識到Github是程序員展示自己的最佳網站。 而蔣鑫老師的文章用 Git 維護博客?酷!啟發了我使用Git Page服務來展示自己的博客。
使用Git Page
在Github上創建個人主頁非常方便,只要創建一個名為(user-id).github.com的版本庫, 並將自己編寫的網頁文件推送到master分支即可。
用 Git 維護博客?酷!中有成熟的解決方案Jekyll,不過本人厭惡生成過程, 更懶得裝Ruby環境(本人是堅定的Python擁護者),就自己寫了個簡單的靜態頁面, 通過javascript代碼動態加載markdown格式的博客文章,在前台轉換成html展示。 這樣只需要文本編輯器和Git即可方便的進行維護(在添加新博文時,需要手動維護index.json)。
對網頁樣式一直很苦惱,第一不熟悉,第二做不到美觀,借用了蔣鑫老師的部分樣式,希望不要介意 :)
優點
- 使用Markdown格式,感覺有點像寫代碼,而且不容易因為格式調整打斷思路。
- 可以寫一部分提交一次,git保存了完整的提交歷史,讓自己的思路更有延續性。
- 使用寫字板和git就可以維護此博客。
部分細節
-
導航
本博客的文章使用Markdown格式保存在post目錄下,路徑(path)的命名格式為(date)-(title).md。 使用jQuery hashChange插件獲取hashChange事件, 並且通過location.hash來判斷應該顯示某篇文章還是博客目錄。
-
顯示目錄: (頁面地址)
-
使用Tag過濾(顯示同時有Tag1,Tag2,...標簽的文章): (頁面地址)+(#!)+(@Tag1)+(@Tag2)+...
-
顯示某篇文章: (頁面地址)+(#!)+(path)
-
-
如果當前需要顯示某篇文章,通過location.hash獲取文章路徑。 請求后,使用showdown.js進行轉換,並插入到頁面中。
-
評論
采用Disqus評論系統。參照Universal Code,在頁面中添加相應代碼即可。 另外就是切換文章時,需要參照Using Disqus on AJAX sites,重新加載Disqus thread。
-
代碼高亮
使用highlight.js,文章加載完成后,高亮所有代碼模塊:
$('pre code').each(function(i, e) {hljs.highlightBlock(e, ' ')});
題外話
本人在工作中一直使用C/C++,網頁開發可以說剛剛入門。如果博客上有什么Bug,請及時指出,萬分感謝。 對博客樣式有什么改進意見的,更加歡迎。 另外如果大家對以下話題感興趣,盡可以找我討論:
- Git
- C/C++
- Python
- Javascript
