From mboxrd@z Thu Jan  1 00:00:00 1970
From: phillip.lord@russet.org.uk (Phillip Lord)
Subject: Re: template for writing Emacs manuals in Org
Date: Tue, 17 May 2016 14:24:06 +0100
Message-ID: <87d1okbyx5.fsf@russet.org.uk>
References: <87eg955clk.fsf@ericabrahamsen.net> <87wpmt7u5i.fsf@gmx.us>
	<m2k2it7spp.fsf@tsdye.com> <87a8jph6ry.fsf@ericabrahamsen.net>
	<m27fet741n.fsf@tsdye.com> <87inyd8gkl.fsf@ericabrahamsen.net>
Mime-Version: 1.0
Content-Type: text/plain
Return-path: <emacs-orgmode-bounces+geo-emacs-orgmode=m.gmane.org@gnu.org>
Received: from eggs.gnu.org ([2001:4830:134:3::10]:35387)
	by lists.gnu.org with esmtp (Exim 4.71)
	(envelope-from <phillip.lord@russet.org.uk>) id 1b2ezd-0003Gi-05
	for emacs-orgmode@gnu.org; Tue, 17 May 2016 09:25:06 -0400
Received: from Debian-exim by eggs.gnu.org with spam-scanned (Exim 4.71)
	(envelope-from <phillip.lord@russet.org.uk>) id 1b2ezV-0003KZ-Ny
	for emacs-orgmode@gnu.org; Tue, 17 May 2016 09:24:59 -0400
Received: from cloud103.planethippo.com ([31.216.48.48]:45764)
	by eggs.gnu.org with esmtp (Exim 4.71)
	(envelope-from <phillip.lord@russet.org.uk>) id 1b2ezV-0003Ef-Du
	for emacs-orgmode@gnu.org; Tue, 17 May 2016 09:24:53 -0400
In-Reply-To: <87inyd8gkl.fsf@ericabrahamsen.net> (Eric Abrahamsen's message of
	"Tue, 17 May 2016 12:16:26 +0800")
List-Id: "General discussions about Org-mode." <emacs-orgmode.gnu.org>
List-Unsubscribe: <https://lists.gnu.org/mailman/options/emacs-orgmode>,
	<mailto:emacs-orgmode-request@gnu.org?subject=unsubscribe>
List-Archive: <http://lists.gnu.org/archive/html/emacs-orgmode/>
List-Post: <mailto:emacs-orgmode@gnu.org>
List-Help: <mailto:emacs-orgmode-request@gnu.org?subject=help>
List-Subscribe: <https://lists.gnu.org/mailman/listinfo/emacs-orgmode>,
	<mailto:emacs-orgmode-request@gnu.org?subject=subscribe>
Errors-To: emacs-orgmode-bounces+geo-emacs-orgmode=m.gmane.org@gnu.org
Sender: "Emacs-orgmode"
	<emacs-orgmode-bounces+geo-emacs-orgmode=m.gmane.org@gnu.org>
To: Eric Abrahamsen <eric@ericabrahamsen.net>
Cc: emacs-orgmode@gnu.org

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