Skip to content
This repository has been archived by the owner on Jun 23, 2023. It is now read-only.

Rainway documentation formatter. ๐Ÿ“ƒ๐Ÿ”

License

Notifications You must be signed in to change notification settings

RainwayApp/rainway-doc-format

Repository files navigation

rainway-doc-format

Rainway documentation formatter.

Getting Started

  • npx rainway-doc-format --help
rainway-doc-format [options] -i <input> -i <output>
    Options:
      --xmldoc         Informs the formatter your input was sourced from xmldoc.
      --api-extractor  Informs the formatter your input was sourced from api-extractor.
      --src-lib        The name of the library your input was generated from.
      --dest-lib       The vanity name of the library you want docs to use.
      --index          The url of the root page for the docs.
      --home           The url of the overall docs homepage.
      -i               Input file(s) globs supported.
      -o               Output directory.

    Examples:
      rainway-doc-format --xmldoc -i csharp-docs/*.md -o docs/

GitHub Action

- uses: RainwayApp/[email protected]
  with:
    # Input file(s) globs supported. (required)
    input: *.md
    # Output directory. (required)
    output: docs/
    # The name of the library your input was generated from. (required)
    src-lib: my-lib
    # The vanity name of the library you want docs to use. (required)
    dest-lib: your-lib
    # Informs the formatter your input was sourced from xmldoc. (optional, default 'false')
    # xmldoc: 'false'
    # Informs the formatter your input was sourced from api-extractor. (optional, default 'true')
    # api-extractor: 'true'
    # The url of the root page for the docs. (optional, default '.')
    # index: .
    # The url of the overall docs homepage. (optional, default '.')
    # home: .