From mboxrd@z Thu Jan  1 00:00:00 1970
From: Rasmus <rasmus@gmx.us>
Subject: Re: Using org-mode to create an on-line manual for a software
 product
Date: Wed, 25 Feb 2015 17:25:52 +0100
Message-ID: <8761aqrm9b.fsf@gmx.us>
References: <54EC90F6.6070306@druidsoftware.com>
	<ir4oaoif0ti.fsf@lycastus.phy.bnl.gov>
Mime-Version: 1.0
Content-Type: text/plain; charset=utf-8
Content-Transfer-Encoding: 8bit
Return-path: <emacs-orgmode-bounces+geo-emacs-orgmode=m.gmane.org@gnu.org>
Received: from eggs.gnu.org ([2001:4830:134:3::10]:54529)
	by lists.gnu.org with esmtp (Exim 4.71)
	(envelope-from <geo-emacs-orgmode@m.gmane.org>) id 1YQemu-0001x6-Ox
	for emacs-orgmode@gnu.org; Wed, 25 Feb 2015 11:26:17 -0500
Received: from Debian-exim by eggs.gnu.org with spam-scanned (Exim 4.71)
	(envelope-from <geo-emacs-orgmode@m.gmane.org>) id 1YQemq-0006xx-OP
	for emacs-orgmode@gnu.org; Wed, 25 Feb 2015 11:26:16 -0500
Received: from plane.gmane.org ([80.91.229.3]:48842)
	by eggs.gnu.org with esmtp (Exim 4.71)
	(envelope-from <geo-emacs-orgmode@m.gmane.org>) id 1YQemq-0006w5-HJ
	for emacs-orgmode@gnu.org; Wed, 25 Feb 2015 11:26:12 -0500
Received: from list by plane.gmane.org with local (Exim 4.69)
	(envelope-from <geo-emacs-orgmode@m.gmane.org>) id 1YQemo-0007DV-Mw
	for emacs-orgmode@gnu.org; Wed, 25 Feb 2015 17:26:10 +0100
Received: from tsn109-201-152-244.dyn.nltelcom.net ([109.201.152.244])
	by main.gmane.org with esmtp (Gmexim 0.1 (Debian))
	id 1AlnuQ-0007hv-00
	for <emacs-orgmode@gnu.org>; Wed, 25 Feb 2015 17:26:10 +0100
Received: from rasmus by tsn109-201-152-244.dyn.nltelcom.net with local
	(Gmexim 0.1 (Debian)) id 1AlnuQ-0007hv-00
	for <emacs-orgmode@gnu.org>; Wed, 25 Feb 2015 17:26:10 +0100
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-bounces+geo-emacs-orgmode=m.gmane.org@gnu.org
To: emacs-orgmode@gnu.org

Brett Viren <bv@bnl.gov> writes:

> ciaran_mulloy <cmulloy@druidsoftware.com> writes:
>
>> I output the manual to latex (nearly 170 pages).
>>
>> The thought occurs to me that it might be possible to publish it to
>> html for use as an on-line manual that could be invoked from within
>> the application. Ideally it would be useful to be able to open the
>> relevant section in the manual in a browser.
>
> The bulk of this is just typing: C-c C-e h h.  Org's publishing feature
> can be applied to layer on more complex exporting rules.
>
> If I were doing this I'd then be faced with these two issues:
>
>  1) forming URLs in the app which correctly point to specific
>     headlines/sections in the HTML.
>
> For this I'd be sure to add a unique "<<label>>" after any headlines or
> other things I want to reference by URL and then form that URL by ending
> it with "#label".

For sections *I'd* use a custom-id property...

>  2) separating the full document into separate, per-section or maybe
>     per-subsection HTML files.

> In all exporting I've done, a single .org file gives a single .html
> file.  If this resulted in an HTML file that was too large to load
> quickly, then I'd look at how to split the export up into multiple HTML
> files, probably along section lines.  I don't know of a setting that
> would do this but one may exist.  I prefer having many, fine-grained
> .org files rather than fewer, more monolithic ones so I'd probably
> structure the document into individual, comfortably sized .org files.
> If I had to then distribute a single PDF from the LaTeX export I might
> join the individual section PDFs outside of org (eg, with pdfnup or
> something).

Have you checked the INCLUDE keyword?

—Rasmus

-- 
This is the kind of tedious nonsense up with which I will not put