python的jinja24doc

jinja24doc的Python项目详细描述


什么是Jinja24doc

jinja24doc是用于python模块的轻量级文档生成器 Jinja2模板。它是poor http组工具(wsgi连接器, wsgi/http服务器和mod_python连接器)。它可以加载模块并 其项目的文档。不需要配置,只需要Jinja2 模板。您的或来自Jinja2doc的包裹。

它更有powerful pydoc,具有您想要的样式。你可以格式化 通过wiki格式化,您的文档字符串带有一些简单的字符,其中 类似于asciidoc。或者可以使用标准的structuredText格式。两者 其中的标记分析器支持突出显示和创建自动链接 发送到pep

几秒钟内完成文档记录

有三种工具供您使用: rst24docwiki24docjinja24doc。 您可以使用中的工具rst24doc和wiki24doc生成这样的简单页面 一个命令:

# if your module use reStructuredText formating in documentation strings
~$ rst24doc -O your_module.html --embed-stylesheet your_module.py
# or if your module use wiki formating in documentation strings
~$ rst24doc -O your_module.html --embed-stylesheet your_module.py

或者您可以创建自己的模板,该模板从 Jinja24doc.您的template.html可以看到如下:

{%settitle='Your Module'%}{%setapi=load_module('your_module')%}{%include'_reference.html'%}

用正确的参数调用jinja24doc工具 python模块可用:

~$ jinja24doc --embed-stylesheet template.html > your_module.html

Jinja24doc作为库

有三个子模块您可以感兴趣:

  • apidoc哪个 包含用于读取python模块和创建模块列表的基本apidoc类 按方法加载模块的项。
  • rst包含 基于apidoc的rst类来解析structuredtext文档。
  • wiki包含 基于apidoc的wiki类来解析wiki格式的文档。
  • context哪个 包含基于rst和wiki的上下文类以耦合所有功能 使用Jinja2模板。
  • frontend哪个 包含一些易于创建命令工具的函数,如rst24doc、wiki24doc 还有Jinja24doc。

获取Jinja24doc

jinja24doc需要jinja2、docutils和distutils tinyhtmlwriter包 用于安装的生成和/或。所以你必须先安装它。

源tarball

~$ wget https://pypi.python.org/packages/source/j/jinja24doc/jinja24doc-1.3.3.tar.gz
~$ tar xzf jinja24doc-1.3.3.tar.gz
~$ cd jinja24doc-1.3.3
~$ python setup.py install

来源于git

~$ git clone https://github.com/PoorHttp/Jinja24Doc.git
~$ cd Jinja24Doc
~$ python setup.py install

从pypi安装

~$ pip install jinja24doc

不稳定版本

来自Git不稳定分支:

~$ git clone clone https://github.com/PoorHttp/Jinja24Doc.git
~$ cd Jinja24Doc
~$ git checkout unstable
~$ python setup.py install

或从压缩包:

~$ wget https://github.com/PoorHttp/Jinja24Doc/archive/unstable.zip
~$ unzip unstable.zip
~$ cd Jinja24Doc-unstable
~$ python setup.py install

欢迎加入QQ群-->: 979659372 Python中文网_新手群

推荐PyPI第三方库


热门话题
java Jetty是否有请求缓存?   数组中的java 2值与我的数据帧中的2列对应   对象序列化期间的java DbUtils类型转换问题   java根面板中不显示所有单独的面板   java通过代理或SSH隧道连接Hbase API   java困惑:与经典MVC控制器相比,JSF2中bean的角色   java在我的Triangle类中“找不到符号错误”   java在Android中设置从路径到自定义按钮的图像   java不绕轨道旋转椭圆   AES在socket上搞砸了序列化/反序列化。无效的流标头。JAVA   java在数组中搜索term和if语句   线程“main”java中出现异常。util。正则表达式。PatternSyntaxException:在索引0附近悬挂元字符“*”*   Websphere上的java Google反射无法打开url连接   java为什么inc/dec频道什么都不做?   java KeyListener无法访问keyPressed方法