bug-texinfo
[Top][All Lists]
Advanced

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

Concept clash of gendocs.sh and HTML Xref links


From: Ralf Angeli
Subject: Concept clash of gendocs.sh and HTML Xref links
Date: Tue, 02 Jan 2007 23:23:24 +0100
User-agent: Gnus/5.110006 (No Gnus v0.6) Emacs/22.0.92 (gnu/linux)

Hi,

in the AUCTeX project we have to manuals written in Texinfo referring
to each other.  This works fine in Info, but fails with HTML output.
The HTML output is generated using the gendocs.sh script on each of
the manuals.  Because the script creates an index.html file for each
manual referring to the different formats this implies that each
manual has to have its own directory.  The advice in HTML Xref links,
however, advises to use a single directory for all manuals:

,----[ (info "(texinfo)HTML Xref Link Basics") ]
|   The DIR and FILE parts are more complicated, and depend on the
| relative split/mono nature of both the manual being processed and the
| manual that the cross-reference refers to.  The underlying idea is that
| there is one directory for Texinfo manuals in HTML, and each manual is
| either available as a monolithic file `manual.html', or a split
| subdirectory `manual/*.html'.  Here are the cases:
`----

(I assume instead of "manual.html","<name_of_package>.html" is meant.)

Using the AUCTeX and preview-latex manuals as an example, on the page
<URL:http://www.gnu.org/software/auctex/manual/html_node/index.html>
there is a cross-reference to the top node of the preview-latex
manual.  According to the Texinfo logic this points to
<URL:http://www.gnu.org/software/auctex/manual/preview-latex/index.html#Top>.
The preview-latex manual, however, is located at
<URL:http://www.gnu.org/software/auctex/preview-manual/> in order for
gendocs.sh to be able to do its magic and set up an index page for the
various output formats.

Is there a way around this?

-- 
Ralf




reply via email to

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