samwilson/console-readme-generator

用于添加命令文档的工具

0.3.3 2024-05-04 16:24 UTC

This package is auto-updated.

Last update: 2024-09-04 17:09:27 UTC


README

一个小工具,用于将 Symfony Console 命令文档添加到项目的 Readme 文件中。

配置

  1. 在您的 Readme 中添加一个 ## 使用 标题(此部分的名称可以配置;请见下文)。
  2. generate-readme 命令添加到您的应用程序中,例如在 ./bin/console
    $application->add(new \Samwilson\ConsoleReadmeGenerator\Command\ReadmeGenCommand());
  3. 运行命令,例如 ./bin/console generate-readme

这将修改您的 README.md 文件。下面的使用文档是输出示例。

CI

使用

generate-readme

为 Readme 文件生成命令文档。

generate-readme [-i|--include INCLUDE] [-r|--readme README] [-u|--usage USAGE]
  • --include -i — 明确包含一个命令(例如 "app:foo")或命名空间(例如 "app:" 结尾带有冒号)。此选项可以多次提供。
  • --readme -r — 要修改的 README 文件的路径(包括文件名)。默认:'[当前工作目录]/README.md'
  • --usage -u — 要在其中插入文档的 README 文件中的部分名称。默认:'使用'

许可证:MIT

版权所有 © 2021 Sam Wilson。

特此授予任何获取本软件及其相关文档文件("软件")副本的任何人,免费使用软件的权利,不受任何限制,包括但不限于使用、复制、修改、合并、发布、分发、再许可和/或销售软件副本的权利,并允许软件提供者使用软件进行此类操作,前提是遵守以下条件

上述版权声明和本许可声明应包含在软件的所有副本或主要部分中。

软件按“原样”提供,不提供任何形式的保证,明示或暗示,包括但不限于适销性、适用于特定目的和无侵犯性的保证。在任何情况下,作者或版权所有者均不对任何索赔、损害或其他责任负责,无论此类责任是基于合同、侵权或其他原因,无论此类责任是否源于、源自或与软件或软件的使用或其他方式有关。