Le 25/12/15 17:02, Saša Janiška a écrit :
Hiya,
I see that Pharo project has embraced Pillar system for documentation purposes and my first question was "Why Pillar?" since, iirc, comparison was made with e.g Markdown which is, obviously, not sufficient for eg. authoring books, but there are more capable markups with 'standard' implementations like rst/Sphinx and Asciidoc(tor).
Then I thought it must be some deeper reason, iow. something suitable to work more closely with Pharo itself.
Now I have two questions:
1) Can someone answer in more detail "Why Pillar?" and
Pillar exists before Markdown. We did pillar syntax back in 2002.
2) For some time I was considering whether to settle on using rst or AsciiDoc for *all* my writings, which means blog posts, my study notes, preparing books, writing articles etc.
We do that with Pillar because we have the control over it and because we have it since long time. The seaside book was fully written in pillar.
Since I've settled to use Python-powered static-site-generator (Nikola) along with reStructuredText markup which can call external 'compilers' to process blog posts written in specific markup, I wonder if it would be possible to use Pillar markup with it since it seems there is cli for it?
Check Ecstatic (we should do another pass on it). The idea is to use pillar + mustache to generate static web pages.
Sincerely, Gour