Le 20/02/2020 à 23:23, André Malo a écrit :
Rich Bowen wrote:
On 1/9/20 2:14 AM, André Malo wrote:
If you'd ask me, I'd rather kill XML/XSLT entirely, as the promises both
for Java and XML/XSLT clearly don't hold anymore. However this also
requires time and effort...
Revisiting a thread that somewhat died out ... I would also be very much
in favor of moving away from XML/Docbook, and towards something
Markdown-based.
Markdown is not powerful enough (by design, but well). I'd suggest
restructured text instead. It needs some getting used to, but it should be
able to map all features we need and/or want.
Cheers,
Hi,
I also had some looks at RST, but IMHO some functionalities available
with our current framework are not possible with RST.
does RST or RST->HTML generator have the following functionalities:
- sorting: our directives are sorted in the generated files
- "theming": I like the way we display links to modules and
directives with different CSS. Can the same be achieved with RST? (not
that important anyway, just a mater of taste)
- "syntax checking": XML and underlying DTD have the big advantage
to check that the input file is correct (i.e. all fields associated to
the description of a directive are there, and in the correct order for
example). Can the same "checks" can be achieved one way or another with RST?
What generator do you have in mind? Sphinx?
A good point I see is the ability to use gettext with rst files. This
would change our translation process a lot, but would provided a much
easier one, IMHO.
CJ
---------------------------------------------------------------------
To unsubscribe, e-mail: docs-unsubscr...@httpd.apache.org
For additional commands, e-mail: docs-h...@httpd.apache.org
