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/bl…).
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#…)
- 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-interf…)
- several existing use cases:
https://github.com/DamienCassou/pillar-documentation#6--example-pillar-usage
--
Damien Cassou
http://damiencassou.seasidehosting.st
"Success is the ability to go from one failure to another without
losing enthusiasm."
Winston Churchill