X-Original-To: pgsql-docs-postgresql.org@localhost.postgresql.org
Received: from localhost (mx1.hub.org [200.46.208.251])
	by postgresql.org (Postfix) with ESMTP id 68A5F9F9C1D
	for <pgsql-docs-postgresql.org@localhost.postgresql.org>;
	Thu,  4 May 2006 03:46:28 -0300 (ADT)
Received: from postgresql.org ([200.46.204.71])
	by localhost (mx1.hub.org [200.46.208.251]) (amavisd-new, port 10024)
	with ESMTP id 61304-03
	for <pgsql-docs-postgresql.org@localhost.postgresql.org>;
	Thu,  4 May 2006 03:46:22 -0300 (ADT)
X-Greylist: domain auto-whitelisted by SQLgrey-
Received: from nf-out-0910.google.com (nf-out-0910.google.com
 [64.233.182.188])
	by postgresql.org (Postfix) with ESMTP id 1654F9F9AFD
	for <pgsql-docs@postgresql.org>; Thu,  4 May 2006 03:46:21 -0300 (ADT)
Received: by nf-out-0910.google.com with SMTP id p48so215507nfa
	for <pgsql-docs@postgresql.org>; Wed, 03 May 2006 23:46:20 -0700 (PDT)
DomainKey-Signature: a=rsa-sha1; q=dns; c=nofws; s=beta; d=gmail.com;
	h=received:message-id:date:from:organization:user-agent:mime-version:to:subject:content-type:content-transfer-encoding;
	b=KQGlGYtCo5d3iZKJiPJH1bDsb1mj3xd7SkZF+gEHujChZxCrbZbUIiIjQWl1et7q0SRBePs49iHwhNO1qCM9NzKH1aRDFDEU4jl90+dn4RWPboX68VgJeHZhaoce4P6j7QP9aaPiDDjYMFsaVqsakcaFpbUXUls/fYi6ftapRbc=
Received: by 10.48.3.15 with SMTP id 15mr400210nfc;
	Wed, 03 May 2006 23:46:20 -0700 (PDT)
Received: from ?192.168.10.4? ( [83.112.72.56])
	by mx.gmail.com with ESMTP id n22sm1593746nfc.2006.05.03.23.46.17;
	Wed, 03 May 2006 23:46:20 -0700 (PDT)
Message-ID: <4459A4BC.7060809@gmail.com>
Date: Thu, 04 May 2006 08:52:44 +0200
From: Guillaume LELARGE <guillaume.lelarge@gmail.com>
Organization: traduc.org, postgresqlfr.org
User-Agent: Thunderbird 1.5 (X11/20060309)
MIME-Version: 1.0
To: pgsql-docs@postgresql.org
Subject: French PDF manual
Content-Type: text/plain; charset=ISO-8859-1
Content-Transfer-Encoding: 7bit
X-Virus-Scanned: Maia Mailguard 1.0.1
X-Archive-Number: 200605/5
X-Sequence-Number: 3532

Hi,

Michael Glaesemann asked me to share details about our toolchain to
build a french PDF manual. So here are the details.

We started by changing SGML files in a way that makes them syntactically
correct and valid with an XML toolchain :
 - add <?xml... on the beginning of each file ;
 - change </> tag with the correct ending one ;
 - add / for unitary tags (xref for example) ;
 - change <!entity with <!ENTITY ;
 - *delete* standalone ignore and include tags but keep some of the
   text ;
 - put all id, linkend, endterm in lowercase ;
 - etc (I probably have forgotten some).

Then we used XSLT stylesheets from the LFS project to build XHTML and
PDF manual. We used xsltproc and fop 0.20.5. And, after much tweaking
(to get good computeroutput, to fix columns' size of each table), we
finaly got this PDF :
  http://docs.postgresqlfr.org/pgsql-8.1.3-fr/pg813.pdf

Of course, you've seen the only problem for your move to XML : we
deleted standalone tags. But I think the result deserv some more work. I
would be glad to work on this if you think this could be a useful
addition to the project.

FYI, building the PDF file take me about 6 minutes on a Athlon 2.2 GHz
with 1 GB of RAM. I think this is good news :) Bad news is it takes
about half an hour to build the HTML one... pretty ugly... I don't
really know why it takes so much time.

If you're still interested on this work, should I work on 8.1 branch or
on HEAD ?

Hope you find this useful and forgive my bad english,

Regards.


-- 
Guillaume.