emacs + org-mode + octopress + github

静态博客（Static Blog）。。就是静态网页组成的博客。与之对比的动态博客，也就是页面是动态生成的，博客内容依存于数据库，国内各大网站提供的博客系统大都是动态博客。

静态博客的页面可以是手工通过制作html页面来维护，这样的话博客最基本的按日期管理、文章分类等特征都得手工完成，这么笨拙的办法可能没人喜欢。于是现在多是使用辅助工具帮助生成整个博客站点，文章自动按照日期管理、有类别或者TAG分类、还融合了留言板等其他技术，octopress就是其中一员。

说到 octopress，得先说说 jekyll。 jekyll 可以把以日期为文件名的 markdown 格式的文本文件转换为html的静态博客。

Jekyll is a simple, blog aware, static site generator. It takes a template directory (representing the raw form of a website), runs it through Textile or Markdown and Liquid converters, and spits out a complete, static website suitable for serving with Apache or your favorite web server.

可以理解为jekyll是实际转化生成静态站点的脚本程序，而octopress是套在jekyll外的一层封装，使得最终生成的站点上有更好的UI，更有风格，并且有更丰富的辅助功能（留言、代码展示、视频）。与octopress类似的还有bootstrip。 我在公司里记录一些东西也在用，只是觉得 octopress 对移动设备的支持更好，所以才打算在公开博客里使用它。

生成和更新服务器的命令大致如下,每次写完内容后要做的操作： ``` sh 生成＆更新博客的命令 rake generate #将source目录下的markdown文本生产为public目录下的blog rake preview #本地预览 localhost:4000 rake deploy #根据public目录生成_deploy目录并上传github #上边的操作已经更新了网站服务器，以下是保存代码改动到github服务器的其他branch git add . git commit -m "comments" git push ```

emacs 是一个拥有强大扩展能力的文本编辑器，扩展能力强大到可以浏览网页、发微博、调试程序、管理日程，总之什么都可以做。我本人并不是一个all-in-emacs控，我不会用emacs做发微博这类的事情，但是还是很喜欢用它工作。它有几个特点吸引我：

• 免费。
• 丰富的辅助开发功能，比如和SVN，GIT的融合，编译make的融合。
• 快捷键便利。
• 不断在更新，比如现在对多国语言的支持越来越好。
• 全球范围内强大的技术支持，网上资源很多。

{% img /rc/emacs.png 800 600 ' ' 'emacs 启动界面' %}

既然emacs这么好，如果熟悉它的话，自然写博客的时候也想用它了。单纯用emacs来写markdown格式的文本固然也可以，也有相应的emacs模式配合。但是寡人不熟悉markdown格式，相反对同类型的功能更强大的org-mode略知一二，所以就想用org格式来写博客。

org-mode 是emacs的一种扩展模式，是在 outline mode 基础上发展出来的一种文本编辑辅助模式。适合在编写大纲（outline）组织结构的文档时使用。orgmode拥有丰富的快捷键由于编辑文档，支持url link，有强大的TODO、Agenda功能用于组织计划、有方便的表格功能、可以快捷的将org文档导出成html、pdf、laTex等格式的文档。

{% img /rc/orgmode.jpg 800 600 ' ' '简单的org模式的界面' %}

这里重点说一下org模式下的html导出功能。org模式可以通过配置，将指定文件夹下的所有org文件导出到一个指定文件夹内（包括子文件的层级关系），org文件之间的link也会转化为html的link，因此直接使用这个功能就可以很方便的用org模式维护一个简单的静态网站。

{% codeblock org模式publish配置示例 %} (setq org-publish-project-alist '(("note-org" :base-directory "~/org/" :publishing-directory "~/pub/" :base-extension "org" :recursive t :publishing-function org-publish-org-to-html :headline-levels 3 :html-extension "html" :table-of-contents t :link-home "/index.html" :section-numbers t :style "" ) ("note-static" :base-directory "~/org/" :publishing-directory "~/pub/" :recursive t :base-extension "css\\|js\\|bmp\\|png\\|jpg\\|gif\\|pdf\\|mp3\\|swf\\|zip\\|gz\\|txt\\|el\\|pl\\|mht\\|log\\|bin_\\|bat\\|tst\\|doc\\|docx\\|gz" :publishing-function org-publish-attachment ) ("note" :components ("note-org" "note-static") :author "wangjingtian@xxx.com.cn" ))) {% endcodeblock %}

通过上边的设置我只需要一个快捷键就可以将 ~/org/ 下的org文件全部导成 html 存在 ~/pub 下。

• org子文件层级关系保留
• 可以为导出的html指定css格式
• org文件夹内的其他格式的文件，如图片也可以设置一并导入pub目录
• 可以自动生成org文件内的目录（TOC）

终于到了org与octopress整合的部分了。关于整合 orgmode 和 octopress（jekyll），可以找到几种方式：

• org 导出html，直接交给 jekyll 处理。这么做有个问题，org生成的html可能和 markdown 产生的html有差异，有的时候兼容性不好。比如，插入 <!--more--> 语句时，由于 org 生成的 html 充满了 div ，导致在有 headline 的情况下页面可能会乱掉。
• org 文件通过 emacs 的插件转换为 markdown 格式，再由 jekyll 处理。可以到这里 找到相关资源。
• org-ruby。 通过Ruby将 org 文件转化为 html，而不是通过emacs。
  

目前为止，我采用的还是第一种方法。

+ blog               # 博客根目录
   + org             # org文件根目录
      + _post
   + source          # org导出根目录，也是octopress本身用于生成blog的根目录
      + _post        # markdown或者org导出的html存在这里
      + _include     # 这里是一些octopress的UI template文件
      + _layouts     # 这里也是
      + rc           # 我的照片等资源的文件夹
      + video        # 我的视频文件夹
      + ...
   + public          # 通过命令 source下的内容会自动导出到 该目录，包括自定义的 rc、video
      + blog         # 内部的子文件按年月日排列
      + rc
      + video
      + ...
   + _deploy         #通过部署命令生产，为了更新github而产生
      + ...