On 01Apr2018 23:55, sam varshavchik <mrsam@xxxxxxxxxxxxxxx> wrote:
Cameron Simpson writes:
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?
Well I was using Perl's POD format several years ago as my primary manual
writing syntax, generates man and html. Good HTML to XHTML might be an easy
transcription, I've not tried.
Not specificly recommending POD, it was just a good syntax for the time. Quite
low in features, but in many cases that is a good thing.
I need to revisit this sometime myself, as I've got a project that will need
man pages and fuller documentation as well.
But my basic point is that authoring syntax for humans needs to be light weight
so that the source looks a fair bit like ordinary prose. Tools can always be
written to generate specific outputs.
Cheers,
Cameron Simpson <cs@xxxxxxxxxx>
_______________________________________________
users mailing list -- users@xxxxxxxxxxxxxxxxxxxxxxx
To unsubscribe send an email to users-leave@xxxxxxxxxxxxxxxxxxxxxxx
