Cookbook: Docbook vs. LaTeX

[Matthew East]

-----BEGIN PGP SIGNED MESSAGE-----
Hash: SHA1

Hi Nicolas,

* Nicolas Pettiaux:
> 2006/6/13, Matthew East <mdke at ubuntu.com>:
>> Yes, please join the docteam and get your work going in that context.
>> The advantages:
>> 1. kubuntu and xubuntu do it
>> 2. you just adopt our build system so you get pretty html docs on
>> doc.ubuntu.com (example -
>> http://doc.ubuntu.com/edubuntu/school-advocacy/C/index.html)
> 
> going on with this example, could you please let us know how to
> translate this document into any other language, as simply as
> possible. (I would like to help with the translation of this very
> document for example)
> 
> Is it registered in rosetta ? can the usual gettext tool chain be used
> (= use kbabel or gtranslate) to speed ?

The process which we have used successfully for ubuntu, kubuntu and
xubuntu documentation is converting the xml into po using "xml2po" (from
gnome-doc-utils) and registering the templates in Rosetta.

The same approach could be set up for the school-advocacy document, when
it is completed.

>> 3. the docteam can help you with content and formatting
>> 4. collaboration = good
> 
>> By the way - note that if you continue working on the wiki for now, you
>> will be able to take advantage of the Moin2Docbook processor which will
>> instantly and reliably transform the work into a docbook book or
>> article. This is part of a summer of code project which is already
>> working really well.
> 
> where can I find more information about this tool Moin2Docbook ?
> Google has only 10 entries that lead to now usable code.

I wrote about it on my blog, and included an example of an article from
the wiki I converted to docbook:

http://www.mdke.org/blog/Wiki2Docbook.html

Matt
-----BEGIN PGP SIGNATURE-----
Version: GnuPG v1.4.2.2 (GNU/Linux)
Comment: Using GnuPG with Mozilla - http://enigmail.mozdev.org

iD8DBQFEjvNntSaF0w5rBv8RApsFAJ9Vv1IQm4wAaW2cgsVeQLCpuCvyFQCdGaw1
lrOixF6gueIDsG83K2Whcrg=
=+yn4
-----END PGP SIGNATURE-----