[Date Prev][Date Next][Thread Prev][Thread Next][Date Index][Thread Index]
Re: HTML templates and GNU manual pages
From: |
Per Bothner |
Subject: |
Re: HTML templates and GNU manual pages |
Date: |
Sun, 17 Nov 2013 00:37:10 -0800 |
User-agent: |
Mozilla/5.0 (X11; Linux x86_64; rv:24.0) Gecko/20100101 Thunderbird/24.0 |
On 11/16/2013 11:49 PM, John Darrington wrote:
Is there a way that makeinfo --html could be made to use a "boilerplate" such
as the
one at http://www.gnu.org/server/standards/boilerplate.html ?
An alternative is to use makeinfo --docbook. This is more work, but more
amenable to quite general postprocessing.
The contents of the Kawa home page:
http://www.gnu.org/software/kawa/index.html
is derived from kawa.texi, translated by makeinfo --docbook,
then fed through xsltproc, using the standard docbook-xsl
stylesheets with some extra kawa-specific rules.
Look for the rules for 'kawa.xml' and 'manual' here:
http://www.gnu.org/software/kawa/Makefile
One non-obvious neat feature: If you open a page in a narrow
window, it switches to single-column mode. The idea is to
better support small screens, like on a cell-phone. (The execution
could do with some polishing - the big initial menu is probably
not desirable on small screens, bt at least it's easy to scroll.)
--
--Per Bothner
address@hidden http://per.bothner.com/