README for translators of the debian-edu-etch-manual -------------------------------------------- Before you start: ----------------- Install the build dependencies of the package plus some extra packages (which are needed for working on the translations, the package itself builds fine without them): sudo apt-get build-dep debian-edu-doc sudo apt-get install po4a texlive-latex-recommended texlive-latex-extra \ texlive-fonts-recommended texlive-fonts-extra dblatex wget libxml2-utils Please note: pdflatex depends on ($texlive-packages | $tetex-packages) - we need the texlive packages. For the following commands it's assumed your in the directory debian-edu-doc/documentation/debian-edu-etch How to start a translation -------------------------- This only needs to be done _once_ per language: $ make start_new_translation LANGUAGE=da # create a new danish .po file $ svn add debian-edu-etch-manual.da.po # add it to svn $ vi debian-edu-etch-manual.da.po # better use kbabel for this :) $ svn ci debian-edu-etch-manual.da.po # commit the new translation for the first time How to update the translations ------------------------------ Update the translations every time before you start translating some new strings: $ svn up # update from svn, maybe someone else # translated something $ vi debian-edu-etch-manual.da.po # again, better use kbabel $ svn ci debian-edu-etch-manual.da.po # commit your changes How to build the html version ----------------------------- $ make For technical reasons, related to the localized images, the pdf version is only build when the debian package is build. But for checking your translation as you work on it, just having the html should be fine. Translating notes ----------------- Don't translate FIXMEs, that's unfinished text and needs fixing. Don't translate tags. In the string "attachment:network-arch.png " also don't translate "attachment". Don't translate URLs - be careful: some wiki-URLs might be harder to notice they are URLs. To "translate" images, add them to SVN into the images/$CC/ directory, where $CC is your language. They will be picked up automatically. If you spot errors in the english version or see how it could be improved, please do contribute to the english version too. Just edit the wiki at http://wiki.debian.org/DebianEdu/Documentation/Etch/ - an user account is needed to edit these pages, so you will probably need to create a wiki user first (via the login link). If you cannot commit your work to svn directly, please file a bug against the debian-edu-doc package, see http://bugs.debian.org/debian-edu-doc and attach the .po file to the bugreport. Instructions how to submit bugs are available at http://bugs.debian.org -- Holger Levsen, holger@debian.org, last updated: 2009-10-31