跳转到主要内容

使用sphinx的phpdocumentor的示例实现

项目描述

tk.phpautodoc

tk.phpautodoc是sphinx扩展,用于将PHPDocs嵌入到sphinx文档中。它类似于sphinx.ext.autodoc。

安装

安装此软件包并将“sphinxcontrib_phpautodoc”添加到扩展列表中

# in conf.py
extensions += ['sphinxcontrib.phpdomain', 'sphinxcontrib_phpautodoc']

这就完成了。

指令

phpautomodule

phpautomodule类似于sphinx.ext.autodoc中的automodule指令。它解析.php文件,然后从您的文档中提取函数、类和方法。

示例

.. phpautomodule::
   :filename: path/to/source_code.php
   :members:
   :undoc-members:

phpautoclass

phpautoclass类似于sphinx.ext.autodoc中的autoclass指令。它解析.php文件,然后从您的文档中提取类及其成员。

示例

.. phpautoclass:: MyClass,MySubClass
   :filename: path/to/source_code.php
   :members:
   :undoc-members:

如果您未指定任何类名,phpautoclass将选择.php文件中的所有类。

示例

.. phpautoclass::
   :filename: path/to/source_code.php
   :members:
   :undoc-members:

phpautofunction

phpautofunction类似于sphinx.ext.autodoc中的autofunction指令。它解析.php文件,然后从您的文档中提取函数。

示例

.. phpautofunction:: my_function
   :filename: path/to/source_code.php

LICENSE

Apache License 2.0

项目详情


下载文件

下载适用于您的平台的文件。如果您不确定要选择哪个,请了解有关安装包的更多信息。

源分发

tk.phpautodoc-1.2.1.tar.gz (31.5 kB 查看散列)

上传时间:

支持者

AWS AWS 云计算和安全赞助商 Datadog Datadog 监控 Fastly Fastly CDN Google Google 下载分析 Microsoft Microsoft PSF 赞助商 Pingdom Pingdom 监控 Sentry Sentry 错误记录 StatusPage StatusPage 状态页面