实现通用标记语言的模板筛选器的集合。
django-markwhat的Python项目详细描述
实现通用标记语言的模板筛选器的集合。
提供实现以下标记的模板筛选器 语言:
- textile–实现Textile–需要PyTextile
- markdown–实现Markdown–需要Python-markdown
- commonmark–实现CommonMark–需要CommonMark-py
- reStructuredText–实现reStructuredText –需要docutils
在每种情况下,筛选器都要求格式化标记为字符串,并且 返回表示标记文本的字符串。例如, textilefilter转换以纺织格式标记的文本 到HTML。
Supported Python versions
django-crequest当前可以在多个python版本上运行:
- Python2(2.7)
- Python3(3.5,3.6)
- 皮比
Installation
django-markwhat在pypi上可用:
http://pypi.python.org/pypi/django-markwhat
很容易通过pip:
安装pip install django-markwhat
或通过easy_install
$ easy_install django-markwhat
另一种方法是克隆django-markwhat'sgit repo:
git clone git://github.com/Alir3z4/django-markwhat.git
然后运行:
$ python setup.py install
Configuration
若要激活这些筛选器,请将'django_markwhat'添加到 INSTALLED_APPS设置。一旦你做到了,用 {% load markup %}在模板中,您将可以访问这些筛选器。
警告
标记筛选器的输出被标记为“安全”,并且在 在模板中呈现。始终小心地清理输入并 确保您不会让自己容易受到跨站点脚本或 其他类型的攻击。
reStructuredText
使用reStructuredText标记筛选器时,可以定义 重新构造文本过滤器设置 重写默认写入程序设置。有关这些设置的详细信息,请参见reStructuredText writer settings。
警告
structuredtext具有允许包含原始html的特性,并且 允许包含任意文件。这些可能会导致XSS漏洞 泄露私人信息。你有责任检查 此库的功能并进行适当配置以避免此问题。见 Deploying Docutils Securely文档。
Markdown
python标记库支持名为“安全模式”和 “启用属性”。两者都关系到输出的安全性。同时启用 选项串联,标记筛选支持“安全”参数。
{{ markdown_content_var|markdown:"safe" }}
警告
2.1之前的python标记库版本不支持 可选禁用属性,默认情况下