Cameron Simpson writes:
On 01Apr2018 18:19, sam varshavchik <mrsam@xxxxxxxxxxxxxxx> wrote:If this is your app and your documentation, I suggest you spend the time converting your app's documentation to Docbook XML, and then use docbook tools to generate both HTML and man page documentation from your docbook sources.I have to say I've very -1 on anything that uses XML as a source format for human written content. It is massively hostile to authoring by hand.
I had that reaction at first, but with Docbook XML, and the associated tools, I find it very easy to generate both web-ready content, and the associated man pages.
Plus I have a rich library of non-Docbook generic XML tools, like XSLT processors that lets me do things like insert Good Adword banner HTML boilerplate, into my generated content – working seamlessly with Docbook XML.
There are plenty of popular human friendly formats out there like markdown and restructured text etc which render to various output formats.
Which "human friendly" format can I use which already has tools to generate both well-formed XHTML and man-compatible troff content, from the same source?
Attachment:
pgp1DXtfhp3Vh.pgp
Description: PGP signature
_______________________________________________ users mailing list -- users@xxxxxxxxxxxxxxxxxxxxxxx To unsubscribe send an email to users-leave@xxxxxxxxxxxxxxxxxxxxxxx
