From owner-freebsd-doc Fri Jan 25 8:28:21 2002 Delivered-To: freebsd-doc@freebsd.org Received: from eos.ocn.ne.jp (eos.ocn.ne.jp [210.190.142.171]) by hub.freebsd.org (Postfix) with ESMTP id A3B5537B41E for ; Fri, 25 Jan 2002 08:28:05 -0800 (PST) Received: from mail.hrslab.yi.org (p5126-ip02funabasi.chiba.ocn.ne.jp [61.214.4.126]) by eos.ocn.ne.jp (OCN) with ESMTP id BAA16149; Sat, 26 Jan 2002 01:28:03 +0900 (JST) Received: from localhost (alph.hrslab.yi.org [192.168.0.10]) by mail.hrslab.yi.org (8.9.3/3.7W/DomainMaster) with ESMTP id BAA61695; Sat, 26 Jan 2002 01:25:38 +0900 (JST) (envelope-from hrs@eos.ocn.ne.jp) Date: Sat, 26 Jan 2002 01:24:53 +0900 (JST) Message-Id: <20020126.012453.104024536.hrs@eos.ocn.ne.jp> To: hitmaster2k@yahoo.com Cc: kuriyama@imgsrc.co.jp, doc@FreeBSD.ORG Subject: Re: Relative link in books From: Hiroki Sato In-Reply-To: <20020125152455.76580.qmail@web21108.mail.yahoo.com> References: <7msn8utw8z.wl@waterblue.imgsrc.co.jp> <20020125152455.76580.qmail@web21108.mail.yahoo.com> X-Mailer: Mew version 2.1 on Emacs 20.7 / Mule 4.0 (HANANOEN) 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 Hiten Pandya wrote in <20020125152455.76580.qmail@web21108.mail.yahoo.com>: hitmaster2k> I think the relative path is used for the reason that, hitmaster2k> when this book is distributed on mirrors, it goes to hitmaster2k> their local mirror's index.html; either way: hitmaster2k> hitmaster2k> URL: http://www.FreeBSD.org hitmaster2k> URL: / (just a slash) hitmaster2k> hitmaster2k> OK, as of the above, I think the relative path should hitmaster2k> only be a slash, and not something like ../../.. and hitmaster2k> stuff like that. One way or other it will go to the hitmaster2k> local mirror's index.html page. No, your idea is not always applicable. For example, Japanese mirror has http://www.jp.FreeBSD.org/www.FreeBSD.org/ as the base URI of them. Perhaps, to define a base URI as an entity (e.g. &wwwbase;) adaptively in the build process may be preferable. Assuming that the documents are built for www.FreeBSD.org, we can use a relative URI ("../../.." style) since there would be www/en tree together. And if not so, we can use an absolute one. For the both cases, we only need to write "&wwwbase;/index.html" into the document. Of course the build for www.FreeBSD.org is an exceptional case. I also think that any books should not depend upon the relative location of www/ hierarchy, and absolute path should be used basically for such reference. -- | Hiroki Sato | To Unsubscribe: send mail to majordomo@FreeBSD.org with "unsubscribe freebsd-doc" in the body of the message