写这个评注系统是因为最新写书, 想找个更顺畅的和编辑沟通的方式, 提高工作效率。 学Django的同学应该都访问过: http://djangobook.py3k.cn/ , 它和 Djangobook官网 有个很重要的功能: 评注系统。在这里先向 VCC 致敬, 虽然很久没有继续维护,但是这个评注的功能还是很不错的。
我也翻了Djangobook的Git提交记录, 没有找到实现的方式。 而且最重要的是, 它是通过ReStructuredText生成的静态页面, 不符合我的需求。所以有了今天说的 Aiglos
可以看 Heroku上的Demo 看看效果, 其中的文档使用了 https://github.com/GitbookIO/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