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 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
Note that I also started to write/hack a TextMate bundle :P 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
Excellent work, Damien! In case someone wants to load Pillar in a Pharo image, here is a load snipper: Gofer new smalltalkhubUser: 'Pier' project: 'Pillar'; configuration; load. (Smalltalk globals at: #ConfigurationOfPillar) load (I updated the http://www.smalltalkhub.com/#!/~Pier/Pillar description) Cheers, Doru On Wed, Jan 15, 2014 at 6: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
-- www.tudorgirba.com "Every thing has its own flow"
On 15 Jan 2014, at 23:21, Tudor Girba <tudor@tudorgirba.com> wrote:
Gofer new smalltalkhubUser: 'Pier' project: 'Pillar'; configuration; load. (Smalltalk globals at: #ConfigurationOfPillar) load
Even shorter: Gofer new smalltalkhubUser: 'Pier' project: 'Pillar'; configuration; loadStable. ;-)
On Wed, Jan 15, 2014 at 6:17 PM, Damien Cassou <damien.cassou@gmail.com> wrote:
I'm proud to announce the 0.6 release of Pillar, a syntax and associated tools to write and generate documentation and books.
I forgot to say who where the contributors, sorry about that: - Lukas Renggli created Pier a long time ago from which I extracted the document model, parser and many unit tests - Benjamin van Ryseghem contributed the Mardown exporter - Benjamin van Ryseghem helped me a lot about the command-line interface, the STON configuration interpreter and many other stuffs - Guillermo Polito fixed a bug - Steph for its continuous feedback from the beginning of the project and his original idea -- Damien Cassou http://damiencassou.seasidehosting.st "Success is the ability to go from one failure to another without losing enthusiasm." Winston Churchill
Am 15.01.2014 um 18:17 schrieb Damien Cassou <damien.cassou@gmail.com>:
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.
Great! This sounds really useful. I need to check this out.
Pillar is currently used to write the Enterprise Pharo book (https://ci.inria.fr/pharo-contribution/job/PharoForTheEnterprise/) and other projects.
Btw. the chapters 9 and 11 are nearly duplicates. Well done, norbert
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>_______________________________________________ Magritte, Pier and Related Tools ... https://www.iam.unibe.ch/mailman/listinfo/smallwiki
participants (6)
-
Benjamin -
Damien Cassou -
Johan Fabry -
Norbert Hartl -
Sven Van Caekenberghe -
Tudor Girba