GNU bug report logs - #22651
Up: GNU Guix doc produces 404 page not found

Previous Next

Full log

Message #26 received at 22651 <at> debbugs.gnu.org (full text, mbox):

From: Gavin Smith <gavinsmith0123 <at> gmail.com>
To: Ludovic Courtès <ludo <at> gnu.org>
Cc: Texinfo <bug-texinfo <at> gnu.org>, 22651 <at> debbugs.gnu.org
Subject: Re: "Up (dir)" HTML link is 404
Date: Wed, 4 May 2016 19:07:20 +0100

On 3 May 2016 at 21:54, Ludovic Courtès <ludo <at> gnu.org> wrote:
> Hello,
>
> Following the “Up (dir)” from:
>
>   https://www.gnu.org/software/guix/manual/html_node/index.html#Top
>
> leads to:
>
>   https://www.gnu.org/software/guix/manual/dir/index.html
>
> which is 404.
>
> Can htmlxref.cnf specify what the “dir” URL should be?

It could do, but am not sure if it is a good idea. For one thing, a
page with a list of manuals is not a Texinfo manual, so having an
htmlxref.cnf line for this is an exception, which is slightly
confusing and could cause problems. For example, if you refer to the
node "(dir)Top" this would tend to go to a page called "index.html",
which may not be what the page is called. A more important problem is
that a page with a list of GNU manuals on it would only be an
appropriate "Up" link for GNU manuals.

The way to deal with this broken link at the moment is to use the
TOP_NODE_UP customization variable, like

 makeinfo --html -c TOP_NODE_UP_URL=/manual/ ...

https://www.gnu.org/software/texinfo/manual/texinfo/html_node/First-Node.html#First-Node


>
> If so, what about hosting a “dir” somewhere on gnu.org and have the
> default htmlxref.cnf that comes with Texinfo point to that?
>
> Thanks,
> Ludo’.
>

Previous Next

GNU bug tracking system
Copyright (C) 1999 Darren O. Benham, 1997,2003 nCipher Corporation Ltd, 1994-97 Ian Jackson.