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(a)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/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
<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