Re: documentation build problem
Richard Hirst (rhirst@linuxcare.com) wrote:
> Hi,
> cvs b-f, ia64, after a build I have
>
> documentation/install.html/install.en.html
>
> which starts off like this:
>
> > <!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 3.2//EN">
> >
> > <html>
> >
> > <head>
> >
> > <meta http-equiv="content-type" content="text/html; charset=iso-8859-1">
> >
> > <title>Installing Debian GNU/Linux 3.0 For IA-64</title>
> >
> > <link href="install.en.html" rel="start">
> > <link href="ch-administrivia.en.html" rel="prev">
> > <link href="ch-welcome.en.html" rel="next">
> > <link href="install.en.html#contents" rel="contents">
> > <link href="install.en.html#copyright" rel="copyright">
> > <link href="ch-welcome.en.html" rel="chapter" title="1 Welcome to Debian">
> > <link href="ch-hardware-req.en.html" rel="chapter" title="2 System Requirements">
> > <link href="ch-preparing.en.html" rel="chapter" title="3 Before Installing Debian GNU/Linux">
> > <link href="ch-install-methods.en.html" rel="chapter" title="4 Obtaining System Installation Media">
> > <link href="ch-rescue-boot.en.html" rel="chapter" title="5 Booting the Installation System">
> > <link href="ch-partitioning.en.html" rel="chapter" title="6 Partitioning for Debian">
>
>
> i.e. with dozens of links in the html <head>, not the <body>. These
> links are not visible with mozilla, but viewing the files with lynx
> gives you gives screens of links at the top of each file.
>
> If you look at the archive for this file, you'll see i386 and ia64 files
> are very different. For example, ia64 has this at the top of the contents
> page:
>
> [ previous ] [ Contents ] [ 1 ] [ 2 ] [ 3 ] [ 4 ] [ 5 ] [ 6 ] [ 7 ] [ 8 ] [ 9 ] [ 10 ] [ 11 ] [ 12 ] [ next ]
>
> while i386 has this:
>
> [ Abstract ] [ Copyright Notice ] [ Contents ]
>
> Also the contents is constructed differently; compare ia64:
>
> <li><a href="ch-welcome.en.html#s-debian">1.1 What is Debian?</a></li>
>
> with i386:
>
> <li><a href="ch-welcome.en.html#s-debian">1.1</a> What is Debian?
>
> Looking at 3.0.21 for other archs, it seems most match ia64; I only found
> alpha in the style of i386 (not an exhaustive check though). Anyone know
> what is going on?
>
> Cheers,
> Richard
Hi,
Yes, what's going on is a new version of the debiandoc-sgml package which
introduces several new things (and yes, I'm to blame for all this :-):
- a reorg of the navigation bar to make it easier to move around in the
document
- expanding the contents links to make them easier clickable
- addition of the <links> in the header so browsers that support them can
make use of it
Unfortunately, the text based browsers 'links' and 'lynx' don't support the
option to view these latter links optionally, like e.g. Mozilla can. There's
already a wishlist filed to add an option to debiandoc2html to add these links
only if indicated. And wishlists have been filed against 'links' and 'lynx'
to support <link>s.
Thanks,
Ardo
--
Ardo van Rangelrooij
home email: ardo@debian.org
home page: http://people.debian.org/~ardo
GnuPG fp: 3B 1F 21 72 00 5C 3A 73 7F 72 DF D9 90 78 47 F9
--
To UNSUBSCRIBE, email to debian-boot-request@lists.debian.org
with a subject of "unsubscribe". Trouble? Contact listmaster@lists.debian.org
Reply to: