Need to document your project with schemas (UML, Graphs, ...), a PDF report or slides? Skjöl is for you! Skjöl allows you to scaffold the needed configuration into your project to be able to generate documentation only based on simple text files.
Skjöl is a group of generators and contains the following:
kroki: scaffolds adocker-composestack that uses kroki to generate diagrams and schemas from text filesslides: scaffolds a slide show based on Markdown and ouputs a reveal.js presentation with pandocreport: scaffolds adocker-composestack that usespandocto generate a PDF from a Markdown file
Now you can wonder why this generator is named skjöl. Simply because skjöl means documents in icelandic. That might be disappointing but that's why!
To install this generators on your system, run
npm install --global generator-skjol.
You can then call the generators using Yeoman.
To scaffold slides documentation in a folder named my-slides,
run yo skjol:slides my-slides.
To scaffold diagrams documentation in a folder named my-diagrams,
run yo skjol:kroki my-diagrams.
To scaffold a report documentation in a folder named my-report,
run yo skjol:report my-report.