bug-texinfo
[Top][All Lists]
Advanced

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

Re: broken links in Texinfo manual on www.gnu.org


From: Sergey Poznyakoff
Subject: Re: broken links in Texinfo manual on www.gnu.org
Date: Tue, 27 Dec 2011 21:07:39 +0200

Paul Eggert <address@hidden> ha escrit:

> This is the "normal" way for one GNU manual to cite another, but it's
> not working on the web.  What's a good way to fix this?

That depends a great deal on what tool is used to create the HTML.
If you use makeinfo, there's no way to fix it.  However, this
will change pretty soon when the new makeinfo, which is now being
developed, is ready.  If you use texi2html, then the usual way is by
creating an "xref translation file" htmlxref.cnf, which specifies URLs
corresponding to each used info-file-name (i.e. the 4th argument to an
@xref-like command). For example, here's a fragment of my htmlxref.cnf:

automake mono http://www.gnu.org/software/automake/manual/automake.html
automake split  http://www.gnu.org/software/automake/manual/html_node
gzip    mono    http://www.gnu.org/software/gzip/manual/gzip.html
gzip    split   http://www.gnu.org/software/gzip/manual/html_node

The "mono" and "split" keywords refer to the type of html version
they refer to (monolithic or split by node). Thus, for instance,
when generating a split html, @pxref{Top,,,gzip,Gzip} will be replaced
with http://www.gnu.org/software/gzip/manual/html_node.

If I'm not mistaken, new makeinfo is going to use the same
method (Patrice, am I right?)

Regards,
Sergey



reply via email to

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