[Top][All Lists]
[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
Re: broken links in Texinfo manual on www.gnu.org, Karl Berry, 2011/12/27