转载

仿Djangobook的Markdown文章评注系统

前言

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

原文  http://dongweiming.github.io/blog/archives/fang-djangobookde-markdownwen-zhang-ping-zhu-xi-tong/
正文到此结束
Loading...