Re: template for writing Emacs manuals in Org

[phillip.lord@russet.org.uk (Phillip Lord)]

Eric Abrahamsen <eric@ericabrahamsen.net> writes:

> "Thomas S. Dye" <tsd@tsdye.com> writes:
>
>> Aloha Eric,
>>
>> Eric Abrahamsen writes:
>>
>>> "Thomas S. Dye" <tsd@tsdye.com> writes:
>>>
>>>> Rasmus writes:
>>>>
>>>>> Once upon a time Tom ported the Org manual.  It's on his github, probably
>>>>> under tsdye.
>>>>
>>>> https://github.com/tsdye/orgmanual
>>>
> I remember where I originally saw this: it was a long thread on
> emacs.devel about moving documentation to HTML, which struck me as a
> terrible idea. I think Org was raised as a way of lowering the barrier
> to writing texinfo manuals for packages, so that we get the best of both
> worlds: write in Org, read in Info. I think it would be a great idea to
> facilitate that, if possible.


I still have a desire to take this forward, although lack the time to do
so on my own.

Having org generate texinfo that plugs directly into existing manuals
would be nice (as it would allow a piecemeal translation). Helping to
define a new HTML based representation (with adding semantics) that
would add the features of info to HTML (and the features of HTML to
info!) would be the ultimate. org-info.js is some of the way there
already.

Then we could use any kind of source (besides org) to generate the HTML,
and hopefully, have it all work together.

Phil