facebook/hh-apidoc

此包已被废弃,不再维护。没有建议的替代包。

维护者

详细信息

github.com/hhvm/hh-apidoc

源代码

问题

安装次数: 12,978

依赖项: 0

建议者: 0

安全性: 0

星标: 10

关注者: 14

分支: 7

开放问题: 9

语言:Hack

v0.8.0 2022-01-10 18:47 UTC

This package is auto-updated.

Last update: 2023-08-24 23:50:54 UTC


README

Continuous Integration

Hack 文件 API 文档生成器。生成器适用于以 <?hh 开头的文件。

示例

HHAPIDoc 生成自己的 API 参考文档

项目状态

这是从 docs.hhvm.com 的文档生成器派生而来,并在那里使用了数月。

作为一个独立项目,它还不够成熟,是一个早期预览;需要在输出格式(美观度)、可用性和功能上做更多工作。查看 问题 开始。我们 欢迎贡献

安装 hh-apidoc

  1. 安装 hhvm
  2. 安装 composer
  3. composer.phar 移动到您希望的位置。许多人将其放在家目录或全局 bin 目录中。
  4. 克隆此存储库
  5. cd path/to/cloned/hh-apidoc
  6. hhvm path/to/composer.phar install
  7. 通过 hhvm bin/hh-apidoc --help 验证安装。您应该看到使用说明。

测试 hh-apidoc

运行 hh-apidoc 对自身进行测试是测试生成器的好方法

  1. hhvm bin/hh-apidoc -o /tmp/docs ./src -o 是输出结果的路径(请注意,给 -o 提供的路径目前必须是现有路径)。. 表示使用当前目录作为源。
  2. cd /tmp/docs
  3. 查看生成的 .html 文件。您可以在您喜欢的浏览器中打开 index.html 来查看生成的文档。

许可

hh-apidoc 是 MIT 许可的,如 LICENSE 文件中所述。