From mboxrd@z Thu Jan  1 00:00:00 1970
From: Brett Viren <bv@bnl.gov>
Subject: Re: Using org-mode to create an on-line manual for a software
 product
Date: Wed, 25 Feb 2015 10:49:45 -0500
Message-ID: <ir4oaoif0ti.fsf@lycastus.phy.bnl.gov>
References: <54EC90F6.6070306@druidsoftware.com>
Mime-Version: 1.0
Content-Type: multipart/signed; boundary="=-=-=";
	micalg=pgp-sha1; protocol="application/pgp-signature"
Return-path: <emacs-orgmode-bounces+geo-emacs-orgmode=m.gmane.org@gnu.org>
Received: from eggs.gnu.org ([2001:4830:134:3::10]:51930)
	by lists.gnu.org with esmtp (Exim 4.71)
	(envelope-from <bviren@bnl.gov>) id 1YQeg2-00043E-4l
	for emacs-orgmode@gnu.org; Wed, 25 Feb 2015 11:19:11 -0500
Received: from Debian-exim by eggs.gnu.org with spam-scanned (Exim 4.71)
	(envelope-from <bviren@bnl.gov>) id 1YQefy-0004A3-2c
	for emacs-orgmode@gnu.org; Wed, 25 Feb 2015 11:19:10 -0500
Received: from smtpgw.bnl.gov ([2620:10a:0:3::30]:29581
	helo=iron3.sec.bnl.local) by eggs.gnu.org with esmtp (Exim 4.71)
	(envelope-from <bviren@bnl.gov>) id 1YQefx-00049o-VL
	for emacs-orgmode@gnu.org; Wed, 25 Feb 2015 11:19:06 -0500
In-Reply-To: <54EC90F6.6070306@druidsoftware.com> (ciaran mulloy's message of
	"Tue, 24 Feb 2015 14:55:50 +0000")
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: ciaran_mulloy <cmulloy@druidsoftware.com>
Cc: emacs-orgmode@gnu.org

--=-=-=
Content-Type: text/plain

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".

 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).


-Brett.

--=-=-=
Content-Type: application/pgp-signature

-----BEGIN PGP SIGNATURE-----
Version: GnuPG v1

iEYEARECAAYFAlTt7xoACgkQEixH2Z0dKCw9sACfZduVMYD+ve0iNGnJ9Tq2bsD5
FCgAnicHIXkCfJKUO1+uAJ1dSe0hYEfa
=Bo9Y
-----END PGP SIGNATURE-----
--=-=-=--