From owner-freebsd-doc Tue May 7 9:49:25 2002 Delivered-To: freebsd-doc@freebsd.org Received: from rhadamanth.submonkey.net (pc4-card4-0-cust162.cdf.cable.ntl.com [80.4.14.162]) by hub.freebsd.org (Postfix) with ESMTP id 35D5437B406 for ; Tue, 7 May 2002 09:49:17 -0700 (PDT) Received: from setantae by rhadamanth.submonkey.net with local (Exim 3.36 #1) id 17589M-000F6H-00 for doc@FreeBSD.org; Tue, 07 May 2002 17:49:16 +0100 Date: Tue, 7 May 2002 17:49:15 +0100 From: Ceri Davies To: doc@FreeBSD.org Subject: Re: Links within the Handbook Message-ID: <20020507164915.GA55559@submonkey.net> Mail-Followup-To: Ceri Davies , doc@FreeBSD.org References: <20020507161357.GA15017@submonkey.net> Mime-Version: 1.0 Content-Type: text/plain; charset=us-ascii Content-Disposition: inline In-Reply-To: <20020507161357.GA15017@submonkey.net> User-Agent: Mutt/1.3.28i Sender: owner-freebsd-doc@FreeBSD.ORG Precedence: bulk List-ID: List-Archive: (Web Archive) List-Help: (List Instructions) List-Subscribe: List-Unsubscribe: X-Loop: FreeBSD.org 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 : > > Some ports have other files, such as > pkg-message. 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 url="../porters-handbook/index.html">FreeBSD Porter's > Handbook. > > 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