summary-more
v3.5.0
Published
summary-more is a tool that search for all *.md files in your project and list them in the README.md file.
Downloads
92
Maintainers
Readme
summary-more
summary-more is a tool that search for all *.md files in your project and list them in the README.md file. What summary-more specifically does is to search in the folder (current or provided one) all the *.md files and list their links one by one inside a provided section of the README.md file. This is a fast and automatic way to quickly link all the documents inside of a project in the main README.md and it is pretty useful for massive or big documented projects.
The outcome of this application is visible in the example README.md.
Requirements
- node 10.12+
- npm 6.0+
Installation
summary-more can be installed as a global tool:
$ npm install -g summary-more
$ yarn global add summary-more
or as a devDependency:
$ npm install -D summary-more
$ yarn add --dev summary-more
Help
$ summary-more --help
Usage: summary-more [options] <option>
Options:
-v, --version output the version number
-s, --docsSection [docsSection] * section title where documentation will be listed in README.md
-b, --baseFolder [baseFolder] base folder where README.md is located
-d, --docsFolder [docsFolder] subfolder of the basefolder where documentation is located
-l, --headingLevel [headingLevel] heading level of the section title within README.md
-h, --help output usage information
* Mandatory
Usage
$ summary-more -s 'documentation'
$ summary-more -d 'docs' -s 'Summary'
$ summary-more -b 'manual' -d 'docs' -s 'Summary'
$ summary-more -b 'manual' -d 'docs' -s 'Summary' -l 2