On 15 Jan 2014, at 22:40, Benjamin <benjamin.vanryseghem.pharo@gmail.com> wrote:
Note that I also started to write/hack a TextMate bundle :P
So: can I help you? :) Uko
Ben
On 15 Jan 2014, at 16:11, Johan Fabry <jfabry@dcc.uchile.cl> wrote:
Pillar is cool.
I have been using it and found that it works quite well. The html output is very pretty and the markdown format is quite handy as well.
Damien forgot to say that Pillar / Pier also has an emacs major mode (pier-mode.el) which helps a lot when writing. :-) See https://github.com/DamienCassou/pier-cl
On Jan 15, 2014, at 2:17 PM, Damien Cassou <damien.cassou@gmail.com> wrote:
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
-- Damien Cassou http://damiencassou.seasidehosting.st
"Success is the ability to go from one failure to another without losing enthusiasm." Winston Churchill <pillar-voyage.png>
---> Save our in-boxes! http://emailcharter.org <---
Johan Fabry - http://pleiad.cl/~jfabry PLEIAD lab - Computer Science Department (DCC) - University of Chile