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

Re: documentation build problem

Denis Barbier (barbier@linuxfr.org) wrote:
> On Tue, Apr 16, 2002 at 09:11:33PM -0500, Ardo van Rangelrooij wrote:
> [...]
> > Well, I suggest you read the following:
> > 
> >   http://www.w3.org/TR/html401/types.html#type-links
> > 
> > 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?
> [I did not find time to check your last uploads, so I apologize if I
> misunderstand your point]
> I can't see how it is related to having all links in all splitted files and in
> index and ToC. Could you enlighten me?

To give the user easy access to all parts of a document from each part
of that same document.  View it like an pop-up ToC.

> If it is so nice, could you also explain why this option has been disabled when generating online manuals on debian.org?

First of all, debian.org runs potato and this <link> functionality has
just been introduced.  He, I didn't know this <link> stuff even existed
until a few weeks ago!  So, we're talking about "brand new stuff" here.

Further, I don't think this <link> stuff should just be put in each and
every document without some kind of overall plan.  The fact that I added
these <link>s by default initially was just part of the learning process.

Finally, you should ask this question on the debian-doc mailing list.  I
would also suggest you write a proposal for using <link>s, gather some
volunteers and start working on it.

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: