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

Re: documentation build problem

Denis Barbier (barbier@linuxfr.org) wrote:
> On Thu, Apr 04, 2002 at 10:25:37PM -0600, Ardo van Rangelrooij wrote:
> [...]
> > > But changing this now give them very few time to implement it :(
> > > You could at least add an option to debiandoc2html to disable these links,
> > 
> > That's what the wislist is about.  Will be implemented for woody.
> Thanks a lot, I did read this wishlist bug only after sending this mail.
> > > I guess many people will be annoyed by them.
> > > 
> > > Moreover, have a look at http://www.w3.org/TR/html401/
> > > There are only 2 links:
> > >   <link rel="next" href="about.html">
> > >   <link rel="contents" href="cover.html#minitoc">
> > > because it does not make sense to make all these links available.
> > 
> > Well, apparently the people to wrote the standard thought otherwise...
> I disagree.  From
>          http://www.w3.org/TR/html401/struct/links.html#edef-LINK
>      This example illustrates how several LINK definitions may appear in
>      the HEAD section of a document. The current document is
>      "Chapter2.html". The rel attribute specifies the relationship of the
>      linked document with the current document. The values "Index", "Next",
>      and "Prev" are explained in the section on link types.
>         "http://www.w3.org/TR/html4/strict.dtd";>
>   <HTML>
>   <HEAD>
>   <TITLE>Chapter 2</TITLE>
>   <LINK rel="Index" href="../index.html">
>   <LINK rel="Next"  href="Chapter3.html">
>   <LINK rel="Prev"  href="Chapter1.html">
>   </HEAD>
> I can't see in HTML specs what makes you think that all documents should
> be linked from every page.

Well, I suggest you read the following:


That gives a clear explanation of the various link types and what they can be
used for.  I can various uses for these various link types in the Debian docs,
e.g. a search engine, easy access to glossary or index, etc.  The possibilities
are definitely not limited to a simple 'prev', 'next', 'up'.  Why not unleash
the power these link types give us to make the Debian documentation set much
more easy accessible for our users?

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: