frontastic/apidocs

1.0.0-rc.3 2020-05-20 05:18 UTC

README

这个小巧的工具可以生成PHP(以及JavaScript)的API文档,以Markdown文件的形式,以便在Github和类似工具中正确渲染。该工具做了一些假设(例如:每个文件只包含一个类,类型提示优于内联文档等),以便生成的文档易于阅读。

文档目标

该工具的目标是创建简单、易读且紧凑的文档。这包括尽可能添加交叉引用,以便代码和文档易于发现。该工具试图关注相关信息,而不是尽可能输出尽可能多的信息。

我们自己的(非常无聊的)API文档也是使用此工具生成的。

配置文件

此工具的配置是通过默认名为.apidocs.yml的YAML文件进行的。您也可以在其他位置创建该文件,并将文件位置作为参数提供给bin/apidocs。配置文件中的所有路径都将相对于配置文件,如下所示:

name: "My Example project"
source: ../common/src
target: ../common/docs
autoloader: ../common/vendor/autoload.php
nameSpace: "\\My\\Example"
files: # Relative to `source`
 - php/My/Class.php
 - …