Node's Pastoral Musicians

    changelog-to-html

    0.6.0 • Public • Published

    npm version build status

    Goal

    This package provides a CLI to convert a CHANGELOG.md file following the Keep a Changelog convention to a static web page with permalinks and a GitHub look and feel.

    It will mostly be useful for closed source libraries where customers do not have access to the source code and thus cannot benefit from the Markdown viewer built into GitHub.

    Screenshot

    The generated HTML page looks like this:

    Screenshot of a generated HTML page from one CHANGELOG.md

    Permalinks

    This package generates permanent links for each section.

    Let's take a changelog example:

    ## [0.3.0] - 2003-03-03
     
    ### Added
     
    * A bullet.
     
    ## [0.2.0] - 2002-02-02
     
    ### Added
     
    * Another bullet.
     
    ## [0.1.0] - 2001-01-01
     
    ### Added
     
    * Last bullet.

    GitHub will generates these URLs:

    • 030---2003-03-03
      • added
    • 020---2002-02-02
      • added-1
    • 010---2001-01-01
      • added-2

    This makes the added anchors ephemeral. Indeed, when you release another version of your package, all the existing anchors will change because GitHub will increment their trailing number:

    • 040---2004-04-04
      • added
    • 030---2003-03-03
      • added-1 (used to be added)
    • 020---2002-02-02
      • added-2 (used to be added-1)
    • 010---2001-01-01
      • added-3 (used to be added-2)

    On the other hand, this package will generate these anchors:

    • 0.3.0
      • 0.3.0-added
    • 0.2.0
      • 0.2.0-added
    • 0.1.0
      • 0.1.0-added

    By prefixing the type of changes section anchor with the release name, we guarantee that the link will be permanent.

    Usage

    1. Add this package to your dependencies: npm install --save-dev changelog-to-html
    2. Add "changelog-to-html": "changelog-to-html" to your package.json scripts.

    You can get the command help by running npm run changelog-to-html -- --help.

    Install

    npm i changelog-to-html

    DownloadsWeekly Downloads

    172

    Version

    0.6.0

    License

    MIT

    Last publish

    Collaborators

    • nouzbe
    • jbe789
    • tibdex