megadoc-cli
v7.2.1
Published
## Filtering with tags
Downloads
19
Readme
Megadoc CLI
Filtering with tags
It is possible to perform a partial compilation of only a subset of the sources defined in your configuration file. The following command-line options help you perform such filtering:
-t, --only
for compiling only the sources with the specified tags-e, --exclude
for skipping the sources with the specified tags
Tags may be explicitly specified in the source declaration:
config.sources = [{
include: [ 'lib/*.js' ],
tags: [ 'js', 'api' ]
}]
Or, when unspecified and an id
is specified for a source, an implicit tag
of that id is created for you:
config.sources = [{
id: 'js',
include: [ 'lib/*.js' ]
}]
// tags => [ 'js' ]
The exclusion tags have precedence over the inclusion tags. For example, the following invocation will cause only "bar" to be compiled and "foo" to be skipped even though it was specified in the whitelist:
megadoc build --only foo --only bar --exclude foo
Examples
Compile only the "js" source:
megadoc build -t js
Compile everything except the "js" source:
megadoc build -e js