readme-manager
A command line application to handle templating your READMEs.
Define a template directory and write a README template for your project then compile it into a proper README.
Installation
$ deno install --name readme-manager --reload --allow-all https://deno.land/x/readme-manager/mod.ts
Usage
On the first run without any arguments a setup will happen :
match
corresponds to the name the README template will have inside the repository it is created on first start but you can always recreate it with--setup
(default.README.template.md
)templates
corresponds to the path where the rendering function is stored it is boostrapped on first start but you can always access it with--bootstrap
(default$USER_CONFIG_DIR/readme-manager
)
$ readme-manager
# Will guide you through setup on first run
$ readme-manager
# Will create readme in current directory with template and config
$ readme-manager my-project
# Will create readme in my-project directory with template and config
$ readme-manager [...] --templates [path]
# Will create a readme with config match and overriden template directory
$ readme-manager [...] --match [name]
# Will create a readme with config template directory and overriden match name
$ readme-manager [...] --templates [path] --match [name]
# Will create a readme and bypass configuration (if it exists)
There are also some other commands :
$ readme-manager --help
# Will print the help page
$ readme-manager --setup
# Re-run setup step and backup old config
$ readme-manager --bootstrap
# Re-run templates boostrapping step and backup old directory
There is also a debug flag available that can be added to any command :
$ readme-manager [...] --debug
# Will print more information to console and save all logs to the log file (instead of only errors by default)
Templating
The templating engine use is https://deno.land/x/eta@v1.12.3.
More information about it can be found on their documentation.
made with love by k