JSPM

gatsby-transformer-keepachangelog

2.0.0
  • ESM via JSPM
  • ES Module Entrypoint
  • Export Map
  • Keywords
  • License
  • Repository URL
  • TypeScript Types
  • README
  • Created
  • Published
  • 0
  • Score
    100M100P100Q18754F
  • License MIT

Gatsby transformer plugin for files in the keepachangelog format

Package Exports

  • gatsby-transformer-keepachangelog

This package does not declare an exports field, so the exports above have been automatically detected and optimized by JSPM instead. If any package subpath is missing, it is recommended to post an issue to the original package (gatsby-transformer-keepachangelog) to support the "exports" field. If that is not possible, create a JSPM override to customize the exports field for this package.

Readme

gatsby-transformer-keepachangelog

Parses files which are written in the keepachangelog format.

Every file with the name CHANGELOG.md is picked up by the transformer.

Install

npm install --save gatsby-transformer-keepachangelog

Note: You also need to have gatsby-source-filesystem installed and configured so it points to your files.

How to use

In your gatsby-config.js

module.exports = {
  plugins: [
    `gatsby-transformer-keepachangelog`,
    {
      resolve: `gatsby-source-filesystem`,
      options: {
        path: `./src/data/`,
      },
    },
  ],
}

Where the source folder ./src/data/ contains the CHANGELOG.md files.

How to query

You can query the nodes using GraphQL, like from the GraphiQL browser: http://localhost:8000/___graphql.

{
  allChangelog {
    nodes {
      versions {
        tag
        date
        changes {
          html
        }
      }
    }
  }
}

Which would return:

{
  "data": {
    "allChangelog": {
      "nodes": [
        {
          "versions": [
            {
              "tag": "1.0.0",
              "date": "2020-04-09T00:00:00.000Z",
              "changes": {
                "html": "<h3>Fixed</h3>..."
              }
            },
            {
              "tag": "1.0.0-RC1",
              "date": "2020-03-26T00:00:00.000Z",
              "changes": {
                "html": "<h3>Added</h3>..."
              }
            }
          ]
        }
      ]
    }
  }
}