emacs-orgmode
[Top][All Lists]
Advanced

[Date Prev][Date Next][Thread Prev][Thread Next][Date Index][Thread Index]

Re: [O] Using org-mode to create an on-line manual for a software produc


From: Rasmus
Subject: Re: [O] Using org-mode to create an on-line manual for a software product
Date: Wed, 25 Feb 2015 17:25:52 +0100
User-agent: Gnus/5.13 (Gnus v5.13) Emacs/25.0.50 (gnu/linux)

Brett Viren <address@hidden> writes:

> ciaran_mulloy <address@hidden> 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




reply via email to

[Prev in Thread] Current Thread [Next in Thread]