前言

写这个评注系统是因为最新写书, 想找个更顺畅的和编辑沟通的方式, 提高工作效率。
学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渲染更快

使用说明

1
2
3
4
5
6
7
❯ 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