One Markup to rule them all.
Pillar is a mark-up language that we use to generate our books in multiple format: tex, html, markdown…. The seaside book http://book.seaside.st was edited and written in pillar format as part of the Pier CMS (developed by L. Renggli). Now Damien Cassou enhanced Pillar and made it a nice standalone application. Here is the latest announce about pillar.
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. You can get some pdfs of the new book at: https://ci.inria.fr/pharo-contribution/job/PharoForTheEnterprise/lastSuccessfulBuild/artifact/
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
- emacs style
Pillar has also:
- a 5-minutes tutorial: https://github.com/DamienCassou/pillar-documentation/blob/master/README.md#1-5-minutes-tutorial
- nice cheat page: http://www.cheatography.com/benjaminvanryseghem/cheat-sheets/pillar/
- a documentation: https://github.com/DamienCassou/pillar-documentation
- 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-interface
- several existing use cases: https://github.com/DamienCassou/pillar-documentation#6–example-pillar-usage
I updated the http://www.smalltalkhub.com/#!/~Pier/Pillar description
You can load it using
Gofer new
smalltalkhubUser: ‘Pier’ project: ‘Pillar’;
configuration;
loadStable.
Have fun and now you are ready to write nice chapters for the forthcoming books