From owner-freebsd-doc Thu May 16 8: 0: 4 2002 Delivered-To: freebsd-doc@freebsd.org Received: from pittgoth.com (14.zlnp1.xdsl.nauticom.net [209.195.149.111]) by hub.freebsd.org (Postfix) with ESMTP id 03A9A37B40C; Thu, 16 May 2002 07:59:50 -0700 (PDT) Received: from unknown (lcl234.zbzoom.net [208.236.36.234]) by pittgoth.com (8.12.3/8.12.3) with SMTP id g4GExl4T008498; Thu, 16 May 2002 10:59:48 -0400 (EDT) (envelope-from trhodes@FreeBSD.org) Date: Thu, 16 May 2002 11:02:13 -0400 From: Tom Rhodes To: Ceri Davies Cc: nik@FreeBSD.org, doc@FreeBSD.org Subject: Re: Links within the Handbook Message-Id: <20020516110213.02112bd8.trhodes@FreeBSD.org> In-Reply-To: <20020516122731.GA23677@submonkey.net> References: <20020507161357.GA15017@submonkey.net> <20020507164915.GA55559@submonkey.net> <20020509075553.B83030@canyon.nothing-going-on.org> <20020515212819.GA2665@submonkey.net> <20020516122731.GA23677@submonkey.net> X-Mailer: Sylpheed version 0.7.5claws (GTK+ 1.2.10; i386-portbld-freebsd4.6) Mime-Version: 1.0 Content-Type: text/plain; charset=US-ASCII Content-Transfer-Encoding: 7bit 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 Thu, 16 May 2002 13:27:31 +0100 Ceri Davies wrote: > On Wed, May 15, 2002 at 10:28:19PM +0100, Ceri Davies wrote: > > On Thu, May 09, 2002 at 07:55:53AM +0100, Nik Clayton wrote: > > > > > > I wonder whether, instead of symlinking FAQ/ and handbook/, we could > > > just install index.html files that have the necessary META headers to > > > redirect the user to ../doc/en_US.ISO8859-1/books/... as necessary? > > > > > > That should do the right thing, and it should work irrespective of the > > > web server configuration. > > > > Agreed. I'm working on it, although it may prove too much for me (I expect > > to need help on the Makefile stuff). > > Attached is a patch which does this, and works (for a new installation). > > However, it doesn't attempt to deal with the fact that existing installations > have a symlink at /FAQ and this version makes a directory at /FAQ. > Is this something that install can deal with on it's own ? I don't know how > to deal with this, and am not sure that it's safe for me to try given that I > don't really understand make yet. > > Also, I'm not sure how long the redirect should be. I've gone for 3 seconds > because anything higher seemed too long, and anything lower seemed, well, too > short. > > Oh, and I fully admit to having thrown this together. > > Anyway, comments appreciated, but patches would be best. > > Ceri > > -- > get the cool shoe shine > Can't we, as in the doc project, include an entity such as: then in all links to the FAQ in the build do &faq;/this page here? I've experimented with this in the www build, using includes.sgml as a map to follow and it seems to work... I think we also already have an &base; entity definition. Ceri, I don't know if you've played with that in any way, but I really hope it helps... Right now I lack the time to look this over, I promise to get with you on it. While your at this, what should we do about packages without pkg-descr files, I spoke to dirk, who cares for mkisofs. Apperently the current way they generate this makes it very difficult to add a pkg-descr file. I was thinking, of course, that perhaps we could just create the files ourselves and link them internally as part of -doc, but thats something I'm trying to avoid. Another solution is to add another filename roll (I debate on this) which could be like: but this still seems like we will be creating the pkg-descr files ourselves. Perhaps mkisofs can link to cdrtools, as its the "mother" port. I'll write up some kind of more formal notice to -doc asking for opinions later... -- Tom (Darklogik) Rhodes www.FreeBSD.org -The Power To Serve www.Pittgoth.com -Pittgoth Discussion Portal trhodes@{Pittgoth.com, FreeBSD.org} PGP key by www: http://www.pittgoth.com/~darklogik/darklogik.key To Unsubscribe: send mail to majordomo@FreeBSD.org with "unsubscribe freebsd-doc" in the body of the message