Differences between revisions 2 and 10 (spanning 8 versions)
Revision 2 as of 2012-01-17 19:15:50
Size: 2634
Editor: JustinBRye
Comment: proofreading
Revision 10 as of 2013-02-16 00:41:23
Size: 2760
Editor: ?David Prévot
Comment: Let's just use Git everywhere
Deletions are marked like this. Additions are marked like this.
Line 1: Line 1:
Line 3: Line 4:
Versions of this document fully translated into German and Italian are available. Incomplete translations exist for Norwegian Bokmål, French, Spanish and Chinese exist; [[http://maintainer.skolelinux.org/debian-edu-doc/|take a look here]] for your own language. Versions of this document fully translated into German, Italian, French and Danish are available. Incomplete translations exist for Norwegian Bokmål and Spanish; [[http://maintainer.skolelinux.org/debian-edu-doc/|take a look here]] for your own language.
Line 7: Line 8:
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-squeeze-manual-translations}}}. The svn-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. 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-squeeze-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.
Line 9: Line 10:
To commit your translations you need to be a member of the Alioth project {{{debian-edu}}}. To translate, you just need to check out some files from from svn (which can be done anonymously) and create patches. 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]]. You can find some [[http://bugs.debian.org|instructions on how to submit bugs]] here. To commit your translations you need to be a member of the Alioth project {{{debian-edu}}}. To translate, you just need to check out some files from from Git (which can be done anonymously) and create patches. 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]]. You can find some [[http://bugs.debian.org|instructions on how to submit bugs]] here.
Line 11: Line 12:
You can check out the {{{debian-edu-doc}}} source anonymously with the following command (you need to have the {{{subversion}}} package installed for this to work): 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):
Line 13: Line 14:
 {{{svn co svn://svn.debian.org/svn/debian-edu/trunk/src/debian-edu-doc}}}  {{{git clone git://anonscm.debian.org/debian-edu/debian-edu-doc.git}}}
Line 15: Line 16:
Then edit the file {{{documentation/debian-edu-squeeze/debian-edu-squeeze-manual.$CC.po}}} (replacing $CC with your language code). There are many tools for translating available; we suggest using {{{kbabel}}}. Then edit the file {{{documentation/debian-edu-squeeze/debian-edu-squeeze-manual.$CC.po}}} (replacing $CC with your language code). There are many tools for translating available; we suggest using {{{lokalize}}}.
Line 17: Line 18:
Then you either commit the file directly to svn (if you have the rights to do so) or send the file to the bugreport. Then you either commit the file directly to Git (if you have the rights to do so) or send the file to the bugreport.
Line 21: Line 22:
 {{{svn up}}}  {{{git pull}}}
Line 23: Line 24:
Read /usr/share/doc/debian-edu-doc/README.debian-edu-squeeze-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. Read /usr/share/doc/debian-edu-doc/README.debian-edu-squeeze-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.
Line 25: Line 26:
Basic information about Alioth (the host where our SVN repository is located) and SVN is available at [[http://wiki.debian.org/Alioth/Svn]]. Please keep in mind that this manual is still under development, so don't translate any string which contains "FIXME". /* status ignore */
Line 27: Line 28:
If you are new to SVN, look at the [[http://svnbook.org|SVN book]]; it has a chapter on the [[http://svnbook.red-bean.com/en/1.0/ch03s05.html|basic workflow with SVN]]. Also you might want to look at the {{{kdesvn}}} package if you prefer a GUI client for SVN instead of using the commandline client. 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.

Translations of this document

Versions of this document fully translated into German, Italian, French and Danish are available. Incomplete translations exist for Norwegian Bokmål and Spanish; take a look here for your own language.

HowTo translate this document

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-squeeze-manual-translations. The Git repository (see below) contains this file too. Take a look there and at the language specific conventions if you want to help translating this document.

To commit your translations you need to be a member of the Alioth project debian-edu. To translate, you just need to check out some files from from Git (which can be done anonymously) and create patches. Please file a bug against the debian-edu-doc package and attach the PO file to the bugreport. You can find some instructions on how to submit bugs here.

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-squeeze/debian-edu-squeeze-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-squeeze-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".

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 Pro Git book; it has a chapter on the recording changes to the repository. Also you might want to look at the gitk package that provides a GUI for Git.

Please report any problems.

CategoryPermalink