From: Guillaume LELARGE <guillaume.lelarge@gmail.com>
To: pgsql-docs@postgresql.org
Subject: French PDF manual
Date: Thu, 04 May 2006 08:52:44 +0200
Message-ID: <4459A4BC.7060809@gmail.com> (raw)
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.
Reply instructions:
You may reply publicly to this message via plain-text email
using any one of the following methods:
* Reply to all the recipients using the --to and --cc options:
reply via email
To: pgsql-docs@postgresql.org
Cc: guillaume.lelarge@gmail.com
Subject: Re: French PDF manual
In-Reply-To: <4459A4BC.7060809@gmail.com>
* Save the following mbox file, import it into your mail client,
and reply-to-all from there: mbox
This inbox is served by DDX for PostgreSQL; see mirroring instructions
for how to clone and mirror all data and code used for this inbox