typedoc-plugin-sourcefile-url

    1.0.6 • Public • Published

    typedoc plugin to set custom source file URL links.

    typedoc prints a Defined in statement showing the source file and line for all definitions. For projects hosted on GitHub this statement will automatically link to the source file.

    This plugin allows to create links to files hosted on other platforms and sites like Bitbucket, GitLab or any custom site. It adds a #L anchor to the URL, linking to any specific line.

    Installation

    npm install --save-dev typedoc-plugin-sourcefile-url
    

    typedoc will automatically detect and load the plugin from node_modules.

    Usage

    Simple Prefix

    typedoc --sourcefile-url-prefix "https://www.your-repository.org/"
    

    The --sourcefile-url-prefix option will create URLs by prefixing the given parameter in front of each source file.

    Defined in src/testfile.ts will link to https://www.your-repository.org/src/testfile.ts.

    Advanced Mappings

    Sometimes more complex URL rules may be required. For example when grouping documentation of multiple repositories into one documentation page.

    Advanced mappings are described in a JSON file.

    typedoc --sourcefile-url-map your-sourcefile-map.json
    

    The your-sourcefile-map.json structure is:

    [
      {
        "pattern": "^modules/module-one",
        "replace": "https://www.your-repository.org/module-one/"
      },     
      {
        "pattern": "^",
        "replace": "https://www.your-repository.org/main-project/"
      }
    ]
    

    pattern is a regular expression (without enclosing slashes). Each Defined in statement is matched against the pattern. On match the pattern is replaced with the string from replace to create the URL.

    There can be one or more mapping rules. For each Defined in only the first rule that matches is applied. In the above example the last rule would match all source files that did not start with modules/module-one. This compares to the Simple Prefix option.


    The options are mutually exclusive. It is not possible to use --sourcefile-url-prefix and --sourcefile-url-map at the same time.

    Install

    npm i typedoc-plugin-sourcefile-url

    DownloadsWeekly Downloads

    3,410

    Version

    1.0.6

    License

    MIT

    Unpacked Size

    9.42 kB

    Total Files

    5

    Last publish

    Collaborators

    • gdelmas