Dear lists,
I'm proud to announce the 0.6 release of Pillar, a syntax and associated tools to write and generate documentation and books.
Pillar is currently used to write the Enterprise Pharo book (https://ci.inria.fr/pharo-contribution/job/PharoForTheEnterprise/) and other projects.
The attached screenshot shows a part of the Voyage documentation generated by Pillar (from https://github.com/SquareBracketAssociates/PharoForTheEnterprise-english/blo...).
Pillar has many features: - simple markup-based syntax with references, tables, pictures, captions... (this is the syntax of Pier) - export to HTML, LaTeX and markdown (more to come) - customization of the export through a dedicated STON configuration file - support of templates using the Mustache templating engine - syntax-highlighting of generated code blocks (not yet in LaTeX) - configurable numbering of section titles and figures - ...
Pillar has also: - a 5-minutes tutorial (https://github.com/DamienCassou/pillar-documentation/blob/master/README.md#1...) - a documentation (https://github.com/DamienCassou/pillar-documentation) (in progress) - a good test coverage (91% with more than a 1000 executed tests) - a continuous integration job (https://ci.inria.fr/pharo-contribution/job/Pillar/) - a command-line interface (https://github.com/DamienCassou/pillar-documentation#5--command-line-interfa...) - several existing use cases: https://github.com/DamienCassou/pillar-documentation#6--example-pillar-usage