README

仅生成公共API的Markdown文档的phpDocumentor模板。它将跳过所有抽象类和非公共方法。

此模板的主要用途是生成简单且外观优美的使用文档，然后可以发布在GitHub上。

例如，一个小型库可以在DocBlock注释中记录其公共API，使用此模板生成Markdown文档，并将其与库一起提交到GitHub，以便为其他开发者创建易于查看的文档。

使用此模板生成的文档示例：https://github.com/spaceonfire/bitrix-tools/tree/master/docs

安装

使用composer安装

composer require spaceonfire/phpdoc-markdown-public

用法

运行phpDocumentor并将模板设置为vendor/spaceonfire/phpdoc-markdown-public/data/templates/markdown-public。

使用命令行参数的示例

./vendor/bin/phpdoc --directory=src/ --target=docs/ --template="vendor/spaceonfire/phpdoc-markdown-public/data/templates/markdown-public" --title="My Project Documentation"

有关可用参数的更多信息，请参阅运行phpDocumentor。

使用配置文件的示例

将名为phpdoc.xml的文件添加到项目的根目录，并使用不带参数的phpdoc命令调用它。修改配置以适应您的项目。

<?xml version="1.0" encoding="UTF-8" ?>
<phpdoc>
    <title>My Project Documentation</title>
    <parser>
        <target>build</target>
    </parser>
    <transformer>
        <target>docs</target>
    </transformer>
    <transformations>
        <template name="vendor/spaceonfire/phpdoc-markdown-public/data/templates/markdown-public" />
    </transformations>
    <files>
        <directory>src</directory>
        <ignore>test/*</ignore>
    </files>
</phpdoc>

有关配置phpDocumentor的更多信息。

spaceonfire / phpdoc-markdown-public

维护者

详细信息

README

安装

用法