仿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渲染更快

    使用说明

1
2
3
4
5
6
7
8

❯ 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

版权声明：本文由 董伟明 原创，未经作者授权禁止任何微信公众号和向掘金(juejin.im)转载，技术博客转载采用 保留署名-非商业性使用-禁止演绎 4.0-国际许可协议
python