使用Tornado和rst来写博客

栏目: 后端 · 发布时间: 5年前

内容简介:rst,全称.. image:: ./img/screenshot0.png .. image:: ./img/screenshot1.png首先我们需要把项目从Github拖下来::

为什么用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> __ 。


以上所述就是小编给大家介绍的《使用Tornado和rst来写博客》,希望对大家有所帮助,如果大家有任何疑问请给我留言,小编会及时回复大家的。在此也非常感谢大家对 码农网 的支持!

查看所有标签

猜你喜欢:

本站部分资源来源于网络,本站转载出于传递更多信息之目的,版权归原作者或者来源机构所有,如转载稿涉及版权问题,请联系我们

理想主义者

理想主义者

[美] 贾斯汀·彼得斯 / 程静、柳筠 / 重庆出版社 / 2018-5-15 / 49.80元

2013年1月11日,年仅26岁的黑客亚伦·斯沃茨自杀身亡,此事在美国引起轩然大波。这不仅是因为在互联网领域,斯沃茨是一个可以与比尔·盖茨、马克·扎克伯格、理查德·斯托曼等齐名的人,更是因为此事揭露了传统世界与互联网世界的规则冲突。 在互联网思维下,信息是明码标价的商品。各种利益方用技术竖起了一道道藩篱,将支付不起费用但渴望用知识改变命运的人隔绝在外。于是,一大批希望改变这种模式的“理想主义......一起来看看 《理想主义者》 这本书的介绍吧!

RGB转16进制工具
RGB转16进制工具

RGB HEX 互转工具

XML 在线格式化
XML 在线格式化

在线 XML 格式化压缩工具

HSV CMYK 转换工具
HSV CMYK 转换工具

HSV CMYK互换工具