From owner-freebsd-doc@FreeBSD.ORG Sun Feb 20 19:29:05 2005 Return-Path: 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 2593116A4CE; Sun, 20 Feb 2005 19:29:05 +0000 (GMT) Received: from mail.allbsd.org (vlsi00.si.noda.tus.ac.jp [133.31.130.32]) by mx1.FreeBSD.org (Postfix) with ESMTP id 4A7A043D49; Sun, 20 Feb 2005 19:29:04 +0000 (GMT) (envelope-from hrs@FreeBSD.org) Received: from delta.allbsd.org (p19097-adsau14honb8-acca.tokyo.ocn.ne.jp [220.106.55.97]) (authenticated bits=128) by mail.allbsd.org (8.13.1/8.13.1) with ESMTP id j1KJSMQr099368; Mon, 21 Feb 2005 04:28:23 +0900 (JST) (envelope-from hrs@FreeBSD.org) Received: from localhost (alph.allbsd.org [192.168.0.10]) by delta.allbsd.org (8.13.1/8.13.1) with ESMTP id j1KJODpA051382; Mon, 21 Feb 2005 04:24:15 +0900 (JST) (envelope-from hrs@FreeBSD.org) Date: Mon, 21 Feb 2005 04:23:22 +0900 (JST) Message-Id: <20050221.042322.77065372.hrs@allbsd.org> To: remko@elvandar.org From: Hiroki Sato In-Reply-To: <20050220130659.GA96515@elvandar.org> References: <20050220130659.GA96515@elvandar.org> X-PGPkey-fingerprint: BDB3 443F A5DD B3D0 A530 FFD7 4F2C D3D8 2793 CF2D X-Mailer: Mew version 4.2 on Emacs 21.3 / Mule 5.0 (SAKAKI) Mime-Version: 1.0 Content-Type: Multipart/Signed; protocol="application/pgp-signature"; micalg=pgp-sha1; boundary="--Security_Multipart(Mon_Feb_21_04_23_22_2005_047)--" Content-Transfer-Encoding: 7bit X-Virus-Scanned: ClamAV 0.82/716/Sun Feb 20 23:40:34 2005 on gatekeeper.allbsd.org X-Virus-Status: Clean cc: doc@FreeBSD.org cc: simon@FreeBSD.org Subject: Re: XML version of the Usergroups (Diff attached) X-BeenThere: freebsd-doc@freebsd.org X-Mailman-Version: 2.1.1 Precedence: list List-Id: Documentation project List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , X-List-Received-Date: Sun, 20 Feb 2005 19:29:05 -0000 ----Security_Multipart(Mon_Feb_21_04_23_22_2005_047)-- Content-Type: Text/Plain; charset=us-ascii Content-Transfer-Encoding: 7bit Remko Lodder wrote in <20050220130659.GA96515@elvandar.org>: r> Recently i have been toying with merging the usergroups to XML. r> I did the migration based on Josef El-Rayes' commercial version. r> r> I would like you all to review the attached patch and send comments. r> Note that i do not know very much about XML so changes like: r> r> "Make it one page, or group on " cannot be handled by me r> yet. So i hope that for a change like that someone is going to help r> me. Hmmm, I think the concept is good, but making the XSLT stylesheet more translator-friendly is needed. Specifically, at least, usergroups/entries.xsl should be added into the language independent directory, and the XML databases can be partially overriden by using the localized ones. Also, usergroups.html can be automatically generated from the databases. IMHO, we should not use "Fill-in-the-blanks Stylesheet" without sufficient content/style separation. Scattering of similar XSLT code limits reuse of data and results in making the maintenance and translation very difficult... I am not against your idea, but worrying about the impact of it on maintainability. -- | Hiroki SATO ----Security_Multipart(Mon_Feb_21_04_23_22_2005_047)-- Content-Type: application/pgp-signature Content-Transfer-Encoding: 7bit -----BEGIN PGP SIGNATURE----- Version: GnuPG v1.4.0 (FreeBSD) iD8DBQBCGOOrTyzT2CeTzy0RAgvHAJ9hKC7a0a3VaTADXEXtJEdO/E8TjwCgi6w0 r35d5n/k7/X2vB9XOxBq0XY= =9omg -----END PGP SIGNATURE----- ----Security_Multipart(Mon_Feb_21_04_23_22_2005_047)----