Re: documentation build problem
Denis Barbier (firstname.lastname@example.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: email@example.com
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 firstname.lastname@example.org
with a subject of "unsubscribe". Trouble? Contact email@example.com