基于静态文件的新博客

Posted by yangchw on May 26, 2013

周五浏览网页时偶然看到别人用 Liquidluck 搭建的静态博客站点:利用 GitHub 的webhook功能进行自动部署,同时支持 Markdown 文件,可将其自动输出为静态文件,此外还支持一些博客常见的功能,如标签、分类、归档等,非常吸引人。

于是,周末两天折腾,部署上之后,自己还做了套主题 liquidluck-theme-moodpo ,就是现在这个样子。期间遇到各种问题,趁还没忘记录下来。

一、安装过程

在安装 Liquidluck 之前需要安装 distribute 和 seuptools ,以便使用 pip 安装 Liquidluck。

$ wget http://pypi.python.org/packages/source/d/distribute/distribute-0.6.28.tar.gz

$ tar xvzf distribute-0.6.28.tar.gz

$ cd distribute-0.6.28

$ python setup.py install

$ wget https://pypi.python.org/packages/2.4/s/setuptools/setuptools-0.6c11-py2.4.egg

$ wget https://raw.github.com/pypa/pip/master/contrib/get-pip.py

$ python get-pip.py

$ pip -U install liquidluck
`</pre>

## 二、部署 Liquidluck

部署的过程相对简单,但还是有一些细节 [Liquidluck 文档](http://liquidluck.readthedocs.org/en/latest/)中没有写:

### 1\. 在 GitHub 上建立博客的 repo

使用 webhook 的话一般直接把整个部署目录都放在 hook 范围之内,因此先使用 git 把目录下载下来,当然在此之前你应该在 GitHub 上先建立一个 repo,repo的大致内容如下:

<pre>`blog
    -- content
        -- helloword.md
        -- media
            -- author.jpg
    -- settings.py # 你可以到 Liquidluck 的 GitHub 地址去下载一份 然后改一下相关配置
    -- README.md
`</pre>

然后 git 这个 repo:

<pre>`$ git clone git://github.com/user/repo blog
`</pre>

### 2\. 配置 webhook

首先在 GitHub 上配置好 webhook,具体操作可以看[这里](http://liquidluck.readthedocs.org/en/latest/),然后启动本地 webhook 服务:

<pre>`$ cd blog

$ liquidluck webhook start -p 9876
`</pre>

这样就完成了 webhook 的配置,你可以先 push 一个文件到 GitHub 上,看有没有同步过来。

需要注意的一点是,如果你要安装主题,不要再 webhook 的目录内 git ,否则 webhook 功能将失效

### 3\. 部署 Liquidluck

部署并启动服务:

<pre>`$ cd blog

$ liquidluck bulid

$ liquidluck server -p 80

$ nohup liquidluck server -p 80 &gt; access.log 2&gt;&amp;1 &amp;             #后台运行

关于 Liquidluck 的安装与部署的细节就是这些,更详细的内容请看官方文档

Update: Liquidluck 文件名、标签和分类不支持中文!