From owner-freebsd-doc Sun Apr 18 15:53:32 1999 Delivered-To: freebsd-doc@freebsd.org Received: from baerenklau.de.freebsd.org (baerenklau.de.freebsd.org [195.185.195.14]) by hub.freebsd.org (Postfix) with ESMTP id BE79B14F2B; Sun, 18 Apr 1999 15:53:22 -0700 (PDT) (envelope-from wosch@panke.de.freebsd.org) Received: (from uucp@localhost) by baerenklau.de.freebsd.org (8.8.8/8.8.8) with UUCP id AAA24361; Mon, 19 Apr 1999 00:50:55 +0200 (CEST) (envelope-from wosch@panke.de.freebsd.org) Received: (from wosch@localhost) by paula.panke.de.freebsd.org (8.9.3/8.8.8) id AAA56265; Mon, 19 Apr 1999 00:47:55 +0200 (CEST) (envelope-from wosch) Message-ID: <19990419004755.56652@panke.de.freebsd.org> Date: Mon, 19 Apr 1999 00:47:55 +0200 From: Wolfram Schneider To: Nik Clayton Cc: nik@FreeBSD.ORG, wosch@cs.tu-berlin.de, freebsd-doc@FreeBSD.ORG Subject: Re: docs/6508: sgmlfmt does not expand relative URLs References: <199904092125.OAA32384@freefall.freebsd.org> <19990411194126.48734@panke.de.freebsd.org> <19990412221539.A62203@catkin.nothing-going-on.org> Mime-Version: 1.0 Content-Type: text/plain; charset=us-ascii X-Mailer: Mutt 0.89i In-Reply-To: <19990412221539.A62203@catkin.nothing-going-on.org>; from Nik Clayton on Mon, Apr 12, 1999 at 10:15:39PM +0100 Sender: owner-freebsd-doc@FreeBSD.ORG Precedence: bulk X-Loop: FreeBSD.org On 1999-04-12 22:15:39 +0100, Nik Clayton wrote: > On Sun, Apr 11, 1999 at 07:41:26PM +0200, Wolfram Schneider wrote: > > On 1999-04-09 14:25:14 -0700, nik@FreeBSD.org wrote: > > > Synopsis: sgmlfmt does not expand relative URLs > > > > > > State-Changed-From-To: open->closed > > > State-Changed-By: nik > > > State-Changed-When: Fri Apr 9 14:24:15 PDT 1999 > > > State-Changed-Why: > > > You can't use relative URLs in the Handbook / FAQ, because you don't > > > know where it's going to be installed relative to the rest of the > > > website (or even *if* it's going to be installed with the rest of > > > the website). > > > > ??? > > > > The location of the handbook (/handbook/) and the FAQ (/FAQ/) > > is well known on the web site. The same is true for ports > > projects, releases etc. > > True, but; > > > Our web mirrors *require* relative paths. Even a 155Mbit/s > > Internet link is easy to overload. > > Only if you assume that everything will > > a) be mirroring the website and the handbook, Yes, our mirrors should be complete. > b) have a mirror of the form http://www.foo.bar/, and not > http://www.foo.bar/mirrors/FreeBSD/ (for example). both should work, without modification, if you mirror the pages or build the pages yourself from the sources. http://www.foo.bar/ http://www.foo.bar/mirrors/FreeBSD/ > I think the correct solution is to enforce absolute paths in the website, > coupled with the &base; entity (which we already do). The FAQ, Handbook, > and tutorials need to be treated differently (because they are independent > of the website, and can be installed without the website). I fail to see why absolute paths in the website are better than relative links. Most FreeBSD mirrors update their pages with cvsup. Only 2 or 3 build the mirror from the sources. > For those we need a similar entity (but possibly called something like > &FreeBSDURL;, because &base; is too vague) that points to wherever they > want references to the website to resolve to. > > For most people, this would probably be > > > > For someone like yourself, who probably has a local copy of the website > permanently installed somewhere, and a webserver running, you could > have > > > > or even > > > > Each URL that refers to the site in the Handbook and FAQ then looks > something like; > > the search pages > > Does that make sense? Looks good. > I can submit this as a separate PR, if you want. Ok. -- Wolfram Schneider http://wolfram.schneider.org To Unsubscribe: send mail to majordomo@FreeBSD.org with "unsubscribe freebsd-doc" in the body of the message