为什么用rst

rst，全称 reStructuredText ，也是一种标记文档。在Markdown异常流行的今天， 为什么还要选择rst呢？Markdown的标准太多了，而rst只有这一种，sphinx等自定义配置 的当然不算啦。

效果

.. image:: ./img/screenshot0.png .. image:: ./img/screenshot1.png

开始配置

首先我们需要把项目从Github拖下来::

$ git clone https://github.com/jiajunhuang/blog

我们来看一下项目的结构::

$ tree -d -L 1
.
├── controllers
├── posts
├── static
├── templates
└── utils

5 directories

其中 posts 就是我们存放rst的文件夹啦。其中所有的想列在首页的文章，必须符合 config.py 中定义的 filename_format = r"(\d{4}_\d{2}_\d{2})-.+\..+" 正则， 如果匹配不到，将忽略。当然，用户可以更改文件命名规范，但注意，目前的设置是 正则表达式需要用一个组把日期匹配出来，也仅仅可以匹配日期。

开始写作

上面把项目托下来以后，接下来删除本人的一些信息然后替换自己的信息，之后进行推送和 部署:

.. code:: bash

$ cd blog
$ rm -rf posts && mkdir posts  # 删除我的博客内容
$ rm static/favicon.ico static/img/avatar.png  # 删除我的头像
$ rm -rf .git/  # 删除我的git提交记录
$ git init

之后的操作就是写博客，然后其他的配置在 config.py 中都有注释说明。 阅读对应的条目，重新部署就可以生效啦～

部署

我们建议用一个Nginx挡在Tornado的前面，下面是我的Nginx配置的server部分::

server {
    listen       80;
    server_name  _;

    location / {
        proxy_pass http://localhost:8080;
    }

    #error_page  404              /404.html;

    # redirect server error pages to the static page /50x.html
    #
    error_page   500 502 503 504  /50x.html;
    location = /50x.html {
        root   /usr/share/nginx/html;
    }
}

在vps上只开了一个进程，并且该进程监听在8080端口上，如果有多个，则需要使用nginx的 upstream_ 模块。

.. _upstream: http://nginx.org/en/docs/http/ngx_http_upstream_module.html#upstream

原理

原理其实很简单，就是在启动的时候，Tornado读取 config.py 中指定的目录下的所有文件， 并且解析文件名，然后生成一个文件目录的列表，并且缓存（因为Config类是单例）。

另外配置了Tornado的autoreload项为True，并且添加了对posts目录的监听，所以只要该目录 有改动，进程就会自动重启。

本项目还添加了对github webhooks的支持，当在github设置了git push的hook时，本地推送 到github以后，github就会对配置的vps发起POST请求，然后项目会从github拉取代码并且重启 进程，这样就不需要手动去pull代码了。详见 这里 <2016_06_19-use-github-webhooks.rst>__ 。