Not logged in. · Lost password · Register
Forum: Community › Documentation RSS
How To Translate

Announcement

11-16-2005, 12:33 by halr9000
Subject: Psi Groupchat (new address)
Join us at the Psi Groupchat (MUC)! Room name: psi@conference.psi-im.org
Avatar
cRaYoN 09-11-2004, 10:58 #1
Member since 04/2003 · 169 posts · Location: Belgium
Group memberships: Members
Show profile · Link to this post
How do we get the sources of the doc? just by downloading by hand each page?
Step 1: You can find the Docbook sources on http://bytewarrior.madoka.be/jabber/psi_do...ocbook/sources/.  Download all the .xml files ("psi.xml", "introduction.xml", "installation.xml", "basic.xml" and "advanced.xml").

And then we translate the text with an html editor?
Step 2: Just open the .xml-file with an editor (notepad, vim, ...) and start translating (don't translate the tags). You don't have to worry about the markup as long as you leave the Docbook-tags in place. If the translation is finished, we can use the translated source to create the HTML/PDF/etc.

Step 3: Put the translated sources online (if that's possible of course) and we'll do the rest.

If you want to know more about Docbook:
- Jabber.org's Quick Quide to Docbook XML
- Docbook: The Definitive Guide
- Writing Documentation Using Docbook
- Frequently used Docbook styles
Ben
~ branders.name
Avatar
minipouss 09-11-2004, 12:13 #2
Member since 01/2004 · 570 posts · Location: Chateauroux (France)
Group memberships: Members
Show profile · Link to this post
thanks cRaYoN as usual when I need help for translation you come  :-D  (I started to translate Psi in January with your advices)

ok I'll get the xml files and modifie them with my html editor SciTE

then I'll ask you what to do with it (I don't have time for now to read anything on Docbook).

thanks I'm going to work  :-p
French Translator - Traducteur de Psi en français
Avatar
minipouss 09-11-2004, 13:13 #3
Member since 01/2004 · 570 posts · Location: Chateauroux (France)
Group memberships: Members
Show profile · Link to this post
Another question : What is that big compressed file in the directory?

you can answer : "get it and look at it"

I made that but I'm on windows and don't have a tool to unbz2 (I just have Izarc for de/compressing files). so I ask for it :D

edit : replace untar with unbz2
French Translator - Traducteur de Psi en français
This post was edited on 09-11-2004, 13:16 by Unknown user.
Avatar
cRaYoN 09-11-2004, 13:17 #4
Member since 04/2003 · 169 posts · Location: Belgium
Group memberships: Members
Show profile · Link to this post
Quote by minipouss on 09-11-2004, 08:13:
Another question : What is that big compressed file in the directory?
That's everything, zipped up. Docbook sources, images, generated files (HTML), stylesheets, etc.

BTW: You can use 7Zip for opening that archive...
Ben
~ branders.name
This post was edited on 09-11-2004, 13:19 by Unknown user.
Avatar
minipouss 09-11-2004, 13:29 #5
Member since 01/2004 · 570 posts · Location: Chateauroux (France)
Group memberships: Members
Show profile · Link to this post
thanks I'll take a look at 7Zip (I wanted to do it for a while but didn't take the time)
French Translator - Traducteur de Psi en français
Avatar
minipouss 09-12-2004, 09:58 #6
Member since 01/2004 · 570 posts · Location: Chateauroux (France)
Group memberships: Members
Show profile · Link to this post
the problem was that when downloading with Firefox the name of the compressed file went from psi.tar.bz2 to psi.tar.bz2.tar so Izarc had some problem understanding the file format.

I modified the name back to psi.tar.bz2 and no problem now :)

but why did you tell me just to download the .xml files, I don't need to translate the html ones?
French Translator - Traducteur de Psi en français
Avatar
cRaYoN 09-12-2004, 10:15 #7
Member since 04/2003 · 169 posts · Location: Belgium
Group memberships: Members
Show profile · Link to this post
Quote by minipouss on 09-12-2004, 04:58:
but why did you tell me just to download the .xml files, I don't need to translate the html ones?
The XML files are the Docbook source files, they contain only the contents (with some tags).

The HTML files are automatically generated out the XML files. Once you have the Docbook XML sources, you can also make a (X)HTML without chunks (in one page, with no seperate chapters), PDF, etc. All this can be done with a few commandline switches. That's why Docbook is often used to write documentation for software: large documents are easier to maintain (you don't have to edit every file, just the sources).

Especially for you I searched some documentation about Docbook in French:
- Quelques notes sur la création de documents avec Docbook
- Aide Docbook
- Manuel Docbook
- Exemple de document Docbook
Ben
~ branders.name
Avatar
minipouss 09-12-2004, 10:19 #8
Member since 01/2004 · 570 posts · Location: Chateauroux (France)
Group memberships: Members
Show profile · Link to this post
thanks for the french links :)

I'm used to read scientific articles in englich but that's easier to read something in my mother language :D

I'll read all this week, thanks again  B)
French Translator - Traducteur de Psi en français
JessicaW 11-06-2007, 09:43 #9
Member since 11/2007 · 1 post
Group memberships: Members
Show profile · Link to this post
cRaYoN, thanks for links.
I'll going to translate in CN :)
This post was edited on 11-06-2007, 22:21 by Kev.
Edit reason: Removing linkspam.
Close Smaller – Larger + Reply to this post:
Smilies: :mellow: :huh: ^_^ :o ;) :P :D :lol: B) :rolleyes: -_- <_< :) :wub: :angry: :( :unsure: :wacko: :blink: :ph34r:
Special characters:

Go to forum
Unclassified NewsBoard devel of 20051113 © 2003-5 by Yves Goergen
Current time: 05-17-2008, 13:44:58 (UTC -04:00)