@atscm/transformer-help
v0.1.0
Published
A transformer that generates help for displays and scripts
Downloads
6
Maintainers
Readme
@atscm/transformer-help
This module is still under development
A transformer that generates help for displays and scripts.
Usage
This module is not yet published! You'll have to install it manually in the meantime: Install from source with
npm i --save-dev github:atscm/transformer-help
, then runnpm install
andnpm run build
inside it's directory.
- Install the package with npm:
npm i --save-dev @atscm/transformer-help
. - Add it to your Atviseproject's transformers. (See ./example/Atviseproject.js for an example).
- Run
atscm push
to generate help documents
Note that this will override any custom help documents.
How it works
atscm creates a json file for every display and script describing the parameters available. This transformer reads this information when running atscm push
and creates an HTML help file for every node pushed.
Possible improvements
- [ ] Add a custom description from a markdown file (e.g. src/AGENT/DISPLAYS/Main.display/help.md) to the generated help document.
- [ ] Support multiple languages
- [ ] Wrap the code to provide type-safe access to parameters. (Currently, when a parameter with name "test" is set to be a number, webMI.query.test is equal to
"13"
instead of13
) - [ ] Any ideas/thoughts? -> Create an issue