Differences between revisions 2 and 6 (spanning 4 versions)
Revision 2 as of 2018-05-30 12:05:59
Size: 3392
Editor: HolgerLevsen
Comment: add a FIXME, this needs to be rewritten, alioth is gone tomorrow
Revision 6 as of 2021-02-27 22:54:54
Size: 932
Editor: ?FransSpiesschaert
Comment: add Portugese as it has reached the 15% translated treshold
Deletions are marked like this. Additions are marked like this.
Line 3: Line 3:
Versions of this document translated into German, Italian, French, Danish, Dutch, Norwegian Bokmål and Japanese are available. Incomplete translations exist for Spanish, Polish and Simplified Chinese. There is an [[https://jenkins.debian.net/userContent/debian-edu-doc/|online overview of shipped translations]]. Versions of this document translated into German, Italian, French, Danish, Dutch, Norwegian Bokmål and Japanese are available. Incomplete translations exist for Spanish, Polish, Portuguese and Simplified Chinese. There is an [[https://jenkins.debian.net/userContent/debian-edu-doc/|online overview of shipped translations]].
Line 9: Line 9:
As in many free software projects, translations of this document are kept in PO files. More information about the process can be found in {{{/usr/share/doc/debian-edu-doc/README.debian-edu-buster-manual-translations}}}. The Git repository (see below) contains this file too. Take a look there and at the [[DebianEdu/Contribute/Translation/Conventions|language specific conventions]] if you want to help translating this document.

FIXME: To commit your translations you need to be a member of the Alioth project {{{debian-edu}}}. If your Alioth username differs from your local one, create or edit {{{~/.ssh/config}}}. Add a config block like this:
{{{
Host git.debian.org
User <your-alioth-username>
}}}
Then check out the {{{debian-edu-doc}}} source using ssh access: {{{git clone git+ssh://git.debian.org/git/debian-edu/debian-edu-doc.git}}}

If you only want to translate, you need to check out only a few files from Git (which can be done anonymously). Please file a bug against the debian-edu-doc package and attach the PO file to the [[http://bugs.debian.org/debian-edu-doc|bugreport]]. See [[http://bugs.debian.org|instructions on how to submit bugs]] for more information.

You can check out the {{{debian-edu-doc}}} source anonymously with the following command (you need to have the {{{git}}} package installed for this to work):

 {{{git clone git://anonscm.debian.org/debian-edu/debian-edu-doc.git}}}

Then edit the file {{{documentation/debian-edu-buster/debian-edu-buster-manual.$CC.po}}} (replacing $CC with your language code). There are many tools for translating available; we suggest using {{{lokalize}}}.

Then you either commit the file directly to Git (if you have the rights to do so) or send the file to the bugreport.

To update your local copy of the repository use the following command inside the {{{debian-edu-doc}}} directory:

 {{{git pull}}}

Read /usr/share/doc/debian-edu-doc/README.debian-edu-buster-manual-translations to find information how to create a new PO file for your language if there isn't one yet, and how to update translations.

Please keep in mind that this manual is still under development, so don't translate any string which contains "FIXME". /* status ignore */

Basic information about Alioth (the host where our Git repository is located) and Git is available at [[http://wiki.debian.org/Alioth/Git]].

If you are new to Git, look at the [[http://git-scm.com/book|Pro Git]] book; it has a chapter on the [[http://git-scm.com/book/en/Git-Basics-Recording-Changes-to-the-Repository|recording changes to the repository]]. Also you might want to look at the {{{gitk}}} package that provides a GUI for Git.
As in many free software projects, translations of this document are kept in PO files. More information about the process can be found in {{{/usr/share/doc/debian-edu-doc/README.debian-edu-buster-manual-translations}}}.

Translations of this document

Versions of this document translated into German, Italian, French, Danish, Dutch, Norwegian Bokmål and Japanese are available. Incomplete translations exist for Spanish, Polish, Portuguese and Simplified Chinese. There is an online overview of shipped translations.

HowTo translate this document

Translate using PO files

As in many free software projects, translations of this document are kept in PO files. More information about the process can be found in /usr/share/doc/debian-edu-doc/README.debian-edu-buster-manual-translations.

Translate online using a web browser

Some language teams have decided to translate via Weblate. See https://hosted.weblate.org/projects/debian-edu-documentation/debian-edu-buster/ for more information.

Please report any problems.

CategoryPermalink