From owner-freebsd-doc Thu Feb 20 14:23:35 2003
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 3192937B405
for <freebsd-doc@FreeBSD.org>; Thu, 20 Feb 2003 14:23:33 -0800 (PST)
Received: from crf-consulting.co.uk (pc-80-194-99-19-hy.blueyonder.co.uk [80.194.99.19])
by mx1.FreeBSD.org (Postfix) with ESMTP id 9467A43F3F
for <freebsd-doc@FreeBSD.org>; Thu, 20 Feb 2003 14:23:31 -0800 (PST)
(envelope-from nik@crf-consulting.co.uk)
Received: from clan.nothing-going-on.org (clan.nothing-going-on.org [192.168.1.20])
by crf-consulting.co.uk (8.12.3/8.12.3) with ESMTP id h1KMNRaw050485;
Thu, 20 Feb 2003 22:23:27 GMT
(envelope-from nik@catkin)
Received: from clan.nothing-going-on.org (localhost [127.0.0.1])
by clan.nothing-going-on.org (8.12.3/8.12.3) with ESMTP id h1KMNRm0060025;
Thu, 20 Feb 2003 22:23:27 GMT
(envelope-from nik@clan.nothing-going-on.org)
Received: (from nik@localhost)
by clan.nothing-going-on.org (8.12.3/8.12.3/Submit) id h1KMNQQj060020;
Thu, 20 Feb 2003 22:23:26 GMT
Date: Thu, 20 Feb 2003 22:23:26 +0000
From: Nik Clayton <nik@FreeBSD.org>
To: Jim Mock <mij@soupnazi.org>
Cc: Kerry Davis <kerryedavis@earthlink.net>, freebsd-doc@FreeBSD.org
Subject: Re: French?
Message-ID: <20030220222326.GN6403@clan.nothing-going-on.org>
References: <022801c2d856$1d525fc0$0200000a@desktop> <1B2B9CB1-446E-11D7-BF65-000393460DB2@soupnazi.org>
Mime-Version: 1.0
Content-Type: multipart/signed; micalg=pgp-sha1;
protocol="application/pgp-signature"; boundary="Zl+NncWK+U5aSfTo"
Content-Disposition: inline
In-Reply-To: <1B2B9CB1-446E-11D7-BF65-000393460DB2@soupnazi.org>
User-Agent: Mutt/1.4i
Organization: FreeBSD Project <URL:http://www.freebsd.org/>
Sender: owner-freebsd-doc@FreeBSD.ORG
Precedence: bulk
List-ID: <freebsd-doc.FreeBSD.ORG>
List-Archive: <http://docs.freebsd.org/mail/> (Web Archive)
List-Help: <mailto:majordomo@FreeBSD.ORG?subject=help> (List Instructions)
List-Subscribe: <mailto:majordomo@FreeBSD.ORG?subject=subscribe%20freebsd-doc>
List-Unsubscribe: <mailto:majordomo@FreeBSD.ORG?subject=unsubscribe%20freebsd-doc>
X-Loop: FreeBSD.org
--Zl+NncWK+U5aSfTo
Content-Type: text/plain; charset=us-ascii
Content-Disposition: inline
Content-Transfer-Encoding: quoted-printable
On Wed, Feb 19, 2003 at 04:56:12PM -0800, Jim Mock wrote:
> Look at the URL. You're requesting the English document.
>=20
> http://www.freebsd-fr.org/doc/fr_FR.ISO8859-1/books/handbook/index.html =
=20
> is in French.
Here's a thought.
When installing the docs, create an additional language code, called
'local'. So
/path/to/doc/local/books/handbook/index.html
works. Make 'local' a symlink to whatever the local language code is
(defaulting to English if not set).
Then, on the web site, use /doc/local/.../ to refer to anything that's
not explicitly supposed to be mentioned in the local language.
Hmm. That'll break when linking to documents that haven't been
translated in to the local language yet, because the files won't exist.
That could be solved with a more sophisticated link farm generator that
knew to create symlinks to fall back content as necessary.
/me ponders a bit.
Another idea I'll float (which also solves the 'why are some pages
index.html, others book.html, and still others article.html?' question)
would be to rename the top-level file for html-split documents to
something like top.html (eww, nasty name, but it'll do).
'index.html' is then a generic document that says something like:
This document is available in a number of formats and languages.
Please pick one.
[ Repeat the above in 'n' languages ]
English (en_US.ISO8859-1) [HTML] [Split] [PS] [PDF] [TXT] [RTF]
French (fr_FR.ISO8859-1) [HTML] [Split] [PS] [PDF] [TXT] [RTF]
...
But that's kind of ugly too, but it does make it explicit.
Or maybe it's time to bite the bullet and say something like 'Mirrors
must run Apache, here's the config file fragment you need for the part
of your website that's the mirror' and go from there?
Random musings.
N
--=20
FreeBSD: The Power to Serve http://www.freebsd.org/ (__)
FreeBSD Documentation Project http://www.freebsd.org/docproj/ \\\'',)
\/ \=
^
--- 15B8 3FFC DDB4 34B0 AA5F 94B7 93A8 0764 2C37 E375 --- .\._/=
_)
--Zl+NncWK+U5aSfTo
Content-Type: application/pgp-signature
Content-Disposition: inline
-----BEGIN PGP SIGNATURE-----
Version: GnuPG v1.2.1 (FreeBSD)
iD8DBQE+VVVek6gHZCw343URAk+VAJ4tkLZgVqunEezekzBoPmh8m2Pk/ACfevg8
YffhGG1QRFwvaNCEYsLmS00=
=DtYx
-----END PGP SIGNATURE-----
--Zl+NncWK+U5aSfTo--
To Unsubscribe: send mail to majordomo@FreeBSD.org
with "unsubscribe freebsd-doc" in the body of the message