Commenting is a small module that allows you to wrap text in to a comment format which is suitable for the supplied extension. This can be useful if you do not want to trigger content errors for 404 routes on static assets so you can put your reason inside a comment instead of returning HTML. But it can also be used a development tool to inject build information in to your files for example.
Module is released in the public npm registry and can be installed by running:
npm install --save commenting
The module exposes a single function as API. This function accepts the text as string or array as first argument and an options object as last argument. The following options are supported:
- extension: The file extension, which is used to figure out which comment style should be used.
- style: Override default extension mapping and provide a comment style your self (should be an object with start, body and end properties which contains the comment styles).
'use strict';var commenting =comment;comment = ;/*** hello world*/comment = ;//// hello// world//
The following extensions are supported:
- html, html: Uses HTML comments.
- js, css, less, sass: Uses
- coffee: Uses
- jade: Uses
Empty files or extension option with
'' as value is automatically mapped to a
# based comment style. This is because things like
.gitignore don't have have extensions that we can track.