Skip site navigation (1)Skip section navigation (2)
Date:      Tue, 7 May 2002 17:49:15 +0100
From:      Ceri Davies <setantae@submonkey.net>
To:        doc@FreeBSD.org
Subject:   Re: Links within the Handbook
Message-ID:  <20020507164915.GA55559@submonkey.net>
In-Reply-To: <20020507161357.GA15017@submonkey.net>
References:  <20020507161357.GA15017@submonkey.net>

next in thread | previous in thread | raw e-mail | index | archive | help
On Tue, May 07, 2002 at 05:13:57PM +0100, Ceri Davies wrote:
> 
> Lines 618-623 of /doc/en_US.ISO8859-1/books/handbook/ports/chapter.sgml :
> 
>       <para>Some ports have other files, such as
>         <filename>pkg-message</filename>.  The ports system uses these
>         files to handle special situations.  If you want more details
>         on these files, and on ports in general, check out the <ulink
>         url="../porters-handbook/index.html">FreeBSD Porter's
>         Handbook</ulink>.</para>
> 
> That link works if you follow the links to the handbook on the website.
> 
> However, it's broken if you access the handbook via
> http://www.FreeBSD.org/handbook.
> 
> Similarly, in the security chapter there is a link to the developers'
> handbook, and there are links to articles in the introduction which
> are broken in the same way.
> 
> What's the best way to fix this ?

Replying to my own post, but my previous one was unnecessarily brief.
Here are three easy options (I know someone will come up with something
better, but if I outline these ones it saves people thinking them up
before they hit the good solution ;) :

1) Make symlinks for all the books and articles like we do now for the
   FAQ and handbook (this really sucks);

2) Get wosch to redirect /FAQ and /handbook in httpd.conf instead of using
   symlinks, and expect everyone running a mirror to do the same (wooh, that
   bites);

3) Change all of these ulinks so that they're absolute and not relative,
   and then head back into doc/en_US..., and expect translators to fix
   this themselves when they do a translation (ouch).

I think 3 is the closest to what we'll eventually need to do, but all three
suck in different ways.

Ceri

-- 
get the cool shoe shine

To Unsubscribe: send mail to majordomo@FreeBSD.org
with "unsubscribe freebsd-doc" in the body of the message




Want to link to this message? Use this URL: <https://mail-archive.FreeBSD.org/cgi/mid.cgi?20020507164915.GA55559>