From owner-freebsd-doc@FreeBSD.ORG  Mon Jul 19 17:28:05 2004
Return-Path: <owner-freebsd-doc@FreeBSD.ORG>
Delivered-To: freebsd-doc@freebsd.org
Received: from mx1.FreeBSD.org (mx1.freebsd.org [216.136.204.125])
	by hub.freebsd.org (Postfix) with ESMTP
	id A1FCE16A4CE; Mon, 19 Jul 2004 17:28:05 +0000 (GMT)
Received: from volginfo.ru (ns.volginfo.ru [217.23.84.100])
	by mx1.FreeBSD.org (Postfix) with ESMTP
	id E126843D2F; Mon, 19 Jul 2004 17:28:04 +0000 (GMT)
	(envelope-from den@FreeBSD.org)
Received: from FreeBSD.org (llp-13.vistcom.ru [217.23.84.68])
	by volginfo.ru (Postfix) with ESMTP
	id 5DBFD2010; Mon, 19 Jul 2004 21:28:06 +0400 (MSD)
Message-ID: <40FC049D.4010902@FreeBSD.org>
Date: Mon, 19 Jul 2004 21:27:57 +0400
From: Denis Peplin <den@FreeBSD.org>
User-Agent: Mozilla/5.0 (X11; U; FreeBSD i386; en-US; rv:1.6) Gecko/20040205
X-Accept-Language: ru, en-us, en
MIME-Version: 1.0
To: Murray Stokely <murray@FreeBSD.org>
References: <20040719100354.GA90972@hub.freebsd.org>
In-Reply-To: <20040719100354.GA90972@hub.freebsd.org>
Content-Type: multipart/mixed;
 boundary="------------030401070005040004010705"
cc: Hiroki Sato <hrs@FreeBSD.org>
cc: doc@freebsd.org
Subject: Re: Creating an Admin Handbook
X-BeenThere: freebsd-doc@freebsd.org
X-Mailman-Version: 2.1.1
Precedence: list
List-Id: Documentation project <freebsd-doc.freebsd.org>
List-Unsubscribe: <http://lists.freebsd.org/mailman/listinfo/freebsd-doc>,
	<mailto:freebsd-doc-request@freebsd.org?subject=unsubscribe>
List-Archive: <http://lists.freebsd.org/pipermail/freebsd-doc>
List-Post: <mailto:freebsd-doc@freebsd.org>
List-Help: <mailto:freebsd-doc-request@freebsd.org?subject=help>
List-Subscribe: <http://lists.freebsd.org/mailman/listinfo/freebsd-doc>,
	<mailto:freebsd-doc-request@freebsd.org?subject=subscribe>
X-List-Received-Date: Mon, 19 Jul 2004 17:28:05 -0000

This is a multi-part message in MIME format.
--------------030401070005040004010705
Content-Type: text/plain; charset=us-ascii; format=flowed
Content-Transfer-Encoding: 7bit

Hello!

Murray Stokely wrote:
<skip>
> I can perform all of this work, ask for the repo copies, update all
> cross links between chapters to use new entities to link between
> volumes, and update the prefaces and frontmatter for both volumes.  I
> can do this in a single day so as to minimize disruption for others
> working on the Handbook(s).  The preface and frontmatter of the
> index.html at www.freebsd.org/handbook would contain a prominent
> pointer to the new volume so that people looking for content can still
> find it easily.
<skip>

Currently we have one small problem with links between books -
relative and absolute links. For example, in printed version of
Handbook I see something like: ../faq/some_url.html

Some work was recently done by hrs to solve this issue (Thanks again,
Hiroki!), but this work is not completely done.

Probably it will be better to solve this issue before handbook
splitting rather than after.

Initial support for urls entities can be simple (see attachment)


--------------030401070005040004010705
Content-Type: text/plain;
 name="urls.diff"
Content-Transfer-Encoding: 7bit
Content-Disposition: inline;
 filename="urls.diff"

Index: urls.ent
===================================================================
RCS file: /home/ncvs/doc/share/sgml/urls.ent,v
retrieving revision 1.4
diff -u -r1.4 urls.ent
--- urls.ent	7 Jul 2004 11:23:16 -0000	1.4
+++ urls.ent	19 Jul 2004 17:27:02 -0000
@@ -50,3 +50,6 @@
 
 <!ENTITY url.main "&url.relprefix;">
 <!ENTITY url.base "&url.relprefix;">
+
+<!ENTITY url.articles "&url.base;/doc/en_US.ISO8859-1/articles">
+<!ENTITY url.books "&url.base;/doc/en_US.ISO8859-1/books">

--------------030401070005040004010705--