From owner-freebsd-doc@FreeBSD.ORG Mon Sep 20 17:51:45 2004 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 B6ECB16A4CE for ; Mon, 20 Sep 2004 17:51:45 +0000 (GMT) Received: from shrike.submonkey.net (cpc2-cdif3-6-0-cust204.cdif.cable.ntl.com [81.103.67.204]) by mx1.FreeBSD.org (Postfix) with ESMTP id 0AB0F43D55 for ; Mon, 20 Sep 2004 17:51:45 +0000 (GMT) (envelope-from setantae@submonkey.net) Received: from setantae by shrike.submonkey.net with local (Exim 4.42 (FreeBSD)) id 1C9SKG-0004iI-3i; Mon, 20 Sep 2004 18:51:44 +0100 Date: Mon, 20 Sep 2004 18:51:44 +0100 From: Ceri Davies To: Remko Lodder Message-ID: <20040920175144.GI2493@submonkey.net> Mail-Followup-To: Ceri Davies , Remko Lodder , freebsd-doc@freebsd.org References: <414C2915.8000309@elvandar.org> Mime-Version: 1.0 Content-Type: multipart/signed; micalg=pgp-sha1; protocol="application/pgp-signature"; boundary="Tu8ztk+XgTAiG9Id" Content-Disposition: inline In-Reply-To: <414C2915.8000309@elvandar.org> X-PGP: finger ceri@FreeBSD.org User-Agent: Mutt/1.5.6i Sender: Ceri Davies cc: freebsd-doc@freebsd.org Subject: Re: Question regarding 'placeholders' (Translations) 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: Mon, 20 Sep 2004 17:51:45 -0000 --Tu8ztk+XgTAiG9Id Content-Type: multipart/mixed; boundary="54ZiyWcDhi/7bWb8" Content-Disposition: inline --54ZiyWcDhi/7bWb8 Content-Type: text/plain; charset=us-ascii Content-Disposition: inline Content-Transfer-Encoding: quoted-printable On Sat, Sep 18, 2004 at 02:24:53PM +0200, Remko Lodder wrote: > Hi there, >=20 > I asked in a reply to Xin Li and Denis Peplin, i want to define > a correct and global agreement on how we as translation teams > should use placeholders. >=20 > The Dutch Project follows the style of the German Project, > while the Russian Project does that in another way. >=20 > How do the German/Dutch projects handle the placeholders? >=20 > Like this: >=20 > > * Translated title >=20 > > >=20 > How does the Russian Project handle this? >=20 > > Translated title * >=20 > > >=20 > Can we please decide what works best, and use that globally? Well, the "correct" way to do this would be to use the releaseinfo element in the places concerned - I've attached an example diff for the French handbook (fr for very mundane reasons that I won't concern anyone with here). What's wrong with this? It doesn't currently produce any output to clearly differentiate the two. That, however, is a toolchain issue that could be corrected quite easily. What's good about this? Everyone is using the same, correct, way of marking up non-translated sections/chapters which keeps the sticklers happy. Even better, everyone can render it whichever way they damn well please, which keeps the anarchists from upsetting all of the "normals". Obviously, I'm not on a translation team (the only other language I speak well is "foul"), but these are the provisions that DocBook has made for this situation. Anything else will make transitioning to anything else a major PITA if/when it ever becomes necessary. Ceri --=20 It is not tinfoil, it is my new skin. I am a robot. --54ZiyWcDhi/7bWb8 Content-Type: text/plain; charset=us-ascii Content-Disposition: attachment; filename="fr.handbook.diff" Content-Transfer-Encoding: quoted-printable Index: mac/chapter.sgml =3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D= =3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D= =3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D RCS file: /home/ncvs/doc/fr_FR.ISO8859-1/books/handbook/mac/chapter.sgml,v retrieving revision 1.1 diff -u -r1.1 chapter.sgml --- mac/chapter.sgml 30 Jul 2004 07:33:45 -0000 1.1 +++ mac/chapter.sgml 20 Sep 2004 17:34:05 -0000 @@ -4,8 +4,11 @@ --> =20 + + Traduction en Cours + =20 - Mandatory Access Control ** Traduction en Cours ** + Mandatory Access Control =20 Synopsis Index: ppp-and-slip/chapter.sgml =3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D= =3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D= =3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D RCS file: /home/ncvs/doc/fr_FR.ISO8859-1/books/handbook/ppp-and-slip/chapte= r.sgml,v retrieving revision 1.8 diff -u -r1.8 chapter.sgml --- ppp-and-slip/chapter.sgml 10 Jul 2004 16:40:06 -0000 1.8 +++ ppp-and-slip/chapter.sgml 20 Sep 2004 17:32:02 -0000 @@ -116,7 +116,8 @@ =20 - Using User PPP ** Traduction en Cours ** + Traduction en Cours + Using User PPP =20 @@ -1086,7 +1087,8 @@ =20 - Using SLIP ** Traduction en Cours ** + Traduction en Cours + Using SLIP Index: printing/chapter.sgml =3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D= =3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D= =3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D RCS file: /home/ncvs/doc/fr_FR.ISO8859-1/books/handbook/printing/chapter.sg= ml,v retrieving revision 1.3 diff -u -r1.3 chapter.sgml --- printing/chapter.sgml 29 Jul 2002 17:53:40 -0000 1.3 +++ printing/chapter.sgml 20 Sep 2004 17:34:09 -0000 @@ -7,7 +7,10 @@ --> =20 - Printing ** Traduction en Cours ** + + Traduction en Cours + + Printing =20 Synopsis Index: security/chapter.sgml =3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D= =3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D= =3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D RCS file: /home/ncvs/doc/fr_FR.ISO8859-1/books/handbook/security/chapter.sg= ml,v retrieving revision 1.10 diff -u -r1.10 chapter.sgml --- security/chapter.sgml 1 Aug 2004 16:38:55 -0000 1.10 +++ security/chapter.sgml 20 Sep 2004 17:32:46 -0000 @@ -107,13 +107,15 @@ =20 - Introduction ** Traduction en Cours ** + Traduction en Cours + Introduction =20 =20 - Securing FreeBSD ** Traduction en Cours ** + Traduction en Cours + Securing FreeBSD =20 @@ -1249,7 +1251,8 @@ =20 - Firewalls ** Traduction en Cours ** + Traduction en Cours + Firewalls =20 Index: serialcomms/chapter.sgml =3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D= =3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D= =3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D RCS file: /home/ncvs/doc/fr_FR.ISO8859-1/books/handbook/serialcomms/chapter= =2Esgml,v retrieving revision 1.3 diff -u -r1.3 chapter.sgml --- serialcomms/chapter.sgml 29 Jul 2002 17:53:40 -0000 1.3 +++ serialcomms/chapter.sgml 20 Sep 2004 17:34:13 -0000 @@ -7,7 +7,10 @@ --> =20 - Serial Communications ** Traduction en Cours ** + + Traduction en Cours + + Serial Communications =20 Synopsis --54ZiyWcDhi/7bWb8-- --Tu8ztk+XgTAiG9Id Content-Type: application/pgp-signature Content-Disposition: inline -----BEGIN PGP SIGNATURE----- Version: GnuPG v1.2.6 (FreeBSD) iD8DBQFBTxivocfcwTS3JF8RAin1AJ9Uo4w/g/41NKADbz7NOhbaK5GRRQCghQZA OPOkqNQhJAza86NaDNK+Cx4= =H1CK -----END PGP SIGNATURE----- --Tu8ztk+XgTAiG9Id--