On 10/24/2010 9:10 PM, Adam Murdoch wrote:
On 24/10/2010, at 7:40 AM, Paul Speed wrote:
While not really in plug-in form, I've played with generating content
from textile markup like Confluence, etc. uses. I find this to be a
more natural way to write documentation but different people have
different needs, I guess.
If you are curious what I've done, you can look here:
http://filament.svn.sourceforge.net/viewvc/filament/trunk/site/build.gradle?revision=380&view=markup
<http://filament.svn.sourceforge.net/viewvc/filament/trunk/site/build.gradle?revision=380&view=markup>
It's doing more than just content transformation as it also applies a
site template, etc... but hopefully it's readable. Maybe gives some
additional ideas to someone. Someday I will get back to making these
things more pluggable.
This might be useful as 2 plugins:
* A general-purpose website plugin which takes care of the templating
and bundling.
* A textile plugin which contributes a textile -> html converter for the
website plugin.
We could also split up the jdocbook plugin into a couple of pieces:
* A general-purpose documentation plugin which introduces concepts such
as books, translations and formats, and the plumbing for these things.
* A docbook plugin which contributes docbook -> html, singleHtml, pdf
converters.
This way, you could generate a website using plain html, textile or
docbook or any combination. And similarly, you could generate a
userguide using any of these formats. And to support more formats, we'd
only need to implement a converter plugin.
Agreed. In my own tinkering, this is sort of where I was heading though
it's all admittedly a little crude. It's just that my only source
content was either html or textile because writing documentation in XML
makes me want to scratch my eyes out. :)
As it is, my script allows addition of additional formats it's just not
very gradle-y.
-Paul
---------------------------------------------------------------------
To unsubscribe from this list, please visit:
http://xircles.codehaus.org/manage_email
