HTML Comments

When trying to add HTML comments to Gatsby, they get removed or encoded as string.

This plugin adds comments after Gatsby's build process finishes, replacing specificied custom tags with whatever code the user needs.

This was created after the need to insert SSI comments inside Gatsby

How to install

yarn add gatsby-plugin-html-comments or npm install gatsby-plugin-html-comments

Usage:

Add the plugin to your gatsby-config.js file, preferably at the last, after (almost) every other plugin.

``javascript
module.exports = {
{
resolve: gatsby-plugin-html-comments,
options: {
files: ['./public/*/.html', './public/*.html'],
comment: [
{
regexp: /(.*?)<\/custom-tag>/g,
comment: ,
},
]
}
}
}
`

$3

- files: Array of filepaths. The replacer will look on each of these and replace the custom tag with the comment.
- comment: Array of objects.
- regexp: Regular expression with a chosen custom tag. Important: always lowercase and hyphen separated to avoid issues.
- comment: The comment or code you want to insert in the final file.

You can add as many objects as you see fit, depending on how many substitutions you need to make.

Example:

$3

Original code:

`javascript
return (



)
`

Result: or the comment gets fuzzy...

`html



`

or the comment gets removed entirely.

$3

Config in gatsby-config.js:

`javascript
module.exports = {
{
resolve: gatsby-plugin-html-comments,
options: {
files: ['./public/*/.html', './public/*.html'],
comment: [
{
regexp: /(.*?)<\/keep-this-comment-tag>/g,
comment: ,
},
]
}
}
}
`

Original code:

`javascript
return (



)
`

Result:

`html



``

Contributions

... are accepted through Github, from improvements on the code itself to making this readme better.