前言

写这个评注系统是因为最新写书,想找个更顺畅的和编辑沟通的方式,提高工作效率。 学 Django 的同学应该都访问过:http://djangobook.py3k.cn/, 它和 Djangobook 官网 有个很重要的功能:评注系统。在这里先向 VCC 致敬,虽然很久没有继续维护,但是这个评注的功能还是很不错的。

我也翻了 Djangobook 的 Git 提交记录,没有找到实现的方式。 而且最重要的是,它是通过 ReStructuredText 生成的静态页面,不符合我的需求。所以有了今天说的 Aiglos

可以看 Heroku 上的 Demo 看看效果,其中的文档使用了https://github.com/GitbookIO/markdown

功能

  1. 在线浏览渲染的本地 Markdown 文件。
  2. 提供 http://djangobook.py3k.cn/2.0/ 那样的评注系统。
  3. 评注支持 Markdown 语法。

使用的技术

Flask : Web 框架 Mako : 模板语言 Flask-Mako : Mako 支持的 Flask 扩展 Flask-SQLAlchemy : SQLAlchemy 的 Flask 扩展 mistune : Markdown 渲染 cython : Python 转化到 C 的编译器,可以让 mistune 渲染更快

使用说明

❯ git clone https://github.com/dongweiming/aiglos
❯ cd aiglos
❯ virtualenv-2.7 venv
❯ source venv/bin/activate
❯ pip install -r requirements.txt
❯ touch local_settings.py  # 增加BOOK_DIR (Markdown文件存放目录), SQLALCHEMY_DATABASE_URI等配置
❯ gunicorn -w 3 run:app -b 0.0.0.0:8000