Skip to main content

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.

This project is hosted on https://code.eutychia.org/kay/readme-manager.

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)

Suggestion

If you are going to be using this for many repositories you might want tot setup a git template folder and add a precommit hook that runs the readme-manager.

Templating

The templating engine use is https://deno.land/x/eta@v1.12.3.

More information about it can be found on their documentation.

Issues

New issues can be submitted by mailing eutychia.gitlab+kay-readme-manager-67-issue-@gmail.com

Once an issue is open and approved you are able to submit pull requests via email also if desired.


made with love by k