rest框架api的模块化文档生成器

djangorestframework-apidoc的Python项目详细描述


django rest framework apidoc
==


library以改进django rest framework的文档系统。


<;=2.3.8,您需要对其进行修补。在第一次加载的模型模块中添加这一行。代码::python
来自rest_-apidoc.monkey导入patch_-api_-view;patch_-api_-view()

然后必须配置“rest_-framework”的“view_-description”函数
设置以使用rest_-apidoc版本:

。代码::python
rest_framework={
…,
'查看描述函数':'rest_framework_apidoc.apidoc.get_view_description',
…,
}



,然后可以配置apidoc默认的文档器类:

。代码::python
apidoc_default_documenter_classes=['rest_framework_apidoc.apidoc.mddocstringdocumenter']

apidoc_default_documenter_classes`默认值是`['rest_framework_apidoc.apidoc.mddocstringsdocumenter']`

如果使用基于文件的文档,您可以设置文档文件的路径:

代码::Python
ApIDOCOA文档路径=“我的API文档”
BR/>“APIDOCCADIONTRONATORATION PATH”默认值为“APIDOC”
BR/> APIDoc Mixins
----BR/> BR/>文档者类由2种混合类型组成,内容混合
和过程MIXIN。内容混合获取文档文本,而BR/>过程混合在另一个事物中转换文本。
BR/>内容混合< BR/> ~~~~~~~~~~~~~~~~~~~Br/>< BR/> *FieleCon。MIXIN **:从一个名为URLLNEX+*BR/>扩展属性的文件中获取内容(如果存在),在
'APIDOCKOCEDATIONSORATION'中。
BR/>进程混合><~-~~~~~~~~~~~~~~~~~Br/>< BR/> *MARPUPPROCEPROMIXIN **:使用Django标记转换为HTML内容,基于BRU/>的标记类属性。< BR/**NoPuffixIn *>:不做任何事情。BR/***AuthPurialPixin in **:马克是安全的内容。
Documenter Classes > BR/> ----BR/>< BR> > RSTFilesDocumenter
> ~~~~~~~~~~~~~~~~~~~~~~~b/>由FieleCon和Mayin组成,MarkupProcessMixin用扩展=“.rST”和标记=RSTDocStringsDocumenter(Br/>)
>~~~~~~~~~~~~~~~~~~~~~~~~(b/>),由DOCSTRIN CONTION COMIN和MarkupProcessMixin标记为“重构结构”BR/> BR/> MDFilesDocumenter
~~~~~~~~~~~~~~~~~~~~~
由FieleCon和Mixin组成。MDDocStringsDocumenter(Br/>)Br/>>~~~~~~~~~~~~~~~~~~~~~~~(b/>),由DOCSTRIN CONTION COMIN和MarkupProcessMixin标记为“标记”Br/> Br/T>“纺织品”Br//> Br/Orth-OrthsReoprordPrimult
~~~~~~~~~~~~~~~~~~~~~~~~~
由DoStrink Cordon Mixin和MarkupProcessMixin标记为“纺织品”
Br/> TxtFilesDocumenter
~~~~~~~~~~~~~~~~~~~~b/>由FieleCon混合和NoPuffixIn组成。“TXT”<Br/>>TxtDocStringsDocumenter < Br>>~~~~~~~~~~~~~~~~~~~~~~~~~~
由BrgEngutoMin组成的
< BR> > HtmlFilesDocumenter
~~~~~~~~~~~~~~~~~~~
。SuffCuffMIXIN与扩展名=“.html”
BR/> HtmlDocStringsDocumenter
~~~~~~~~~~~~~~~~~~~~~~~~
由DOCTRIN CONTION CONTIN COMIN和Suffice PROCESSIN组成

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

推荐PyPI第三方库


热门话题
java嵌套循环打印一个数字,旁边有相同数量的星号   java JodReports替代方案   java如何将模型类parcelable对象从片段传递到活动?   java JCS缓存删除功能不删除特定元素   如何打开。Java的dll文件。   java在这种情况下如何选择聚合根?   java从CellEditorListener获取编辑的TreeNode   Java到web服务和mysql   从openssl ec在Java中创建公钥时出现加密无效密钥异常   Java数组:添加多个数组的元素时忽略空数组   java在初始化后向fragment发送数据   JButtons的java数组正在返回void   若联接列不包含特定值,则java JPA条件生成器仅返回实体   java ActionBar问题:NPE   java Portlet是被广泛使用还是非常罕见?