Cameron Simpson writes:
On 01Apr2018 18:19, sam varshavchik <mrsam(a)courier-mta.com>
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?