Openbox:Contribute

From Openbox

(Difference between revisions)
Jump to: navigation, search
(Translations: make the template link text/plain)
(Writing code)
 
(18 intermediate revisions by 2 users not shown)
Line 7: Line 7:
 
Translations are done through "po" files. The easiest way to edit these files is to use [http://kbabel.kde.org KBabel], which is a part of KDE (in the kdesdk package).
 
Translations are done through "po" files. The easiest way to edit these files is to use [http://kbabel.kde.org KBabel], which is a part of KDE (in the kdesdk package).
  
If you want to update an existing translation, [http://svn.icculus.org/openbox/trunk/po browse through] our latest translations. You can download and modify the translation from there (just click on the revision number beside the appropriate language).
+
If you want to update an existing translation, [http://git.icculus.org/?p=mikachu/openbox.git;a=tree;f=po;hb=backport browse through] our latest translations. You can download and modify the translation from there (right click on the "raw" link and select "save as" or the equivalent).
  
[[Image:Important.png| Important]] If you see a lot of strings marked "fuzzy" the translation is really out of date, and you should use the template instructions below instead of just updating the file. A lot of Openbox translations are in this state right now as we changed a lot of strings since the last version.
+
If you want to create a new translation from scratch, download the current [http://git.icculus.org/?p=mikachu/openbox.git;a=blob_plain;f=po/openbox.pot;hb=backport translation template for Openbox] or the [http://git.icculus.org/?p=dana/obconf.git;a=blob_plain;f=po/obconf.pot;hb=HEAD translation template for ObConf] and add your translations to it. Download the file and run the command <code>msginit --locale LL_CC</code> where LL_CC is the appropriate code for your language. For example ru for Russian, sv for swedish or en_CA for the Canadian variant of English. If you don't have the msginit command, you can save the file directly as <code>LL_CC.po</code> and fill in the header yourself, using an existing translation as a template.
  
If you want to create a new translation from scratch, download the [http://svn.icculus.org/*checkout*/openbox/trunk/po/openbox.pot?content-type=text%2Fplain current translation template] and add your translations to it. Save the file as "locale.po", for example <code>ru.po</code> for the Russian locale, or "locale_COUNTRY.po", for example <code>en_CA.po</code> for the Canadian variant of English.
+
When you've completed a new translation, you can submit it to the bugzilla to have it included in the next release. To submit a translation, follow the link below and fill out the template to create a bug report. After the bug report has been created, attach your new "po" file to the bug. If you for some reason don't want to use bugzilla, you can also try to send the translation to the mailing list or contact us directly on IRC but these methods are less reliable and the translation might get lost.
  
When you've completed a new translation, you can submit it to the bugzilla to have it included in the
+
[[Image:Important.png| Important]] Please make sure to specify the character encoding properly or Openbox won't be able to read the strings, UTF-8 is preferable.
next release. To submit a translation, follow the link below and fill out the template to create a bug
+
report. After the bug report has been created, attach your new "po" file to the bug.
+
  
[[Image:Important.png| Important]] Please make sure to use the UTF-8 character encoding or Openbox won't be able to translate the strings.
+
If you have any questions about what the english text means, or anything else is unclear, please don't hesitate to contact us via the [[Openbox:Community_portal|mailing list or on IRC]].
  
 
Thank you for your help!
 
Thank you for your help!
  
[http://svn.icculus.org/openbox/trunk/po/ Browse existing translations]
+
[http://git.icculus.org/?p=mikachu/openbox.git;a=tree;f=po;hb=work Browse existing translations for Openbox]
  
[http://bugzilla.icculus.org/enter_bug.cgi?product=Openbox&component=Translations&form_name=enter_bug Submit a new or updated translation]
+
[http://mika.l3ib.org/ob_translation_status See how many strings are translated for a language in Openbox]
 +
 
 +
[http://git.icculus.org/?p=dana/obconf.git;a=tree;f=po;hb=HEAD Browse existing translations for ObConf]
 +
 
 +
[http://bugzilla.icculus.org/enter_bug.cgi?product=Openbox&component=Translations&form_name=enter_bug Submit a new or updated translation] (Note: use the "attach a file" button, don't paste the whole file in the comment box)
 
</div>
 
</div>
  
Line 47: Line 49:
  
 
[http://bugzilla.icculus.org/enter_bug.cgi?product=Openbox&component=general&bug_severity=enhancement&form_name=enter_bug Submit a new feature request]
 
[http://bugzilla.icculus.org/enter_bug.cgi?product=Openbox&component=general&bug_severity=enhancement&form_name=enter_bug Submit a new feature request]
 +
</div></div>
 +
 +
<div style="clear:left;">
 +
== Writing code ==
 +
[[Image:Development-72.png|left|Translate]]
 +
 +
Openbox development is done using git. See the [[Help:UsingGit]] page for details on how to check out the latest code and send your changes back upstream.
 +
 +
<div style="margin-left: 80px;">
 +
[http://github.com/mikachu/openbox Browse the Openbox git repo on GitHub.com]
 
</div></div>
 
</div></div>

Latest revision as of 18:19, 7 March 2015

Contents

[edit] Translations

Translate

Help translate Openbox! Any improvements to existing translations, or translations to new languages would be greatly appreciated by your fellow users.

Translations are done through "po" files. The easiest way to edit these files is to use KBabel, which is a part of KDE (in the kdesdk package).

If you want to update an existing translation, browse through our latest translations. You can download and modify the translation from there (right click on the "raw" link and select "save as" or the equivalent).

If you want to create a new translation from scratch, download the current translation template for Openbox or the translation template for ObConf and add your translations to it. Download the file and run the command msginit --locale LL_CC where LL_CC is the appropriate code for your language. For example ru for Russian, sv for swedish or en_CA for the Canadian variant of English. If you don't have the msginit command, you can save the file directly as LL_CC.po and fill in the header yourself, using an existing translation as a template.

When you've completed a new translation, you can submit it to the bugzilla to have it included in the next release. To submit a translation, follow the link below and fill out the template to create a bug report. After the bug report has been created, attach your new "po" file to the bug. If you for some reason don't want to use bugzilla, you can also try to send the translation to the mailing list or contact us directly on IRC but these methods are less reliable and the translation might get lost.

Important Please make sure to specify the character encoding properly or Openbox won't be able to read the strings, UTF-8 is preferable.

If you have any questions about what the english text means, or anything else is unclear, please don't hesitate to contact us via the mailing list or on IRC.

Thank you for your help!

Browse existing translations for Openbox

See how many strings are translated for a language in Openbox

Browse existing translations for ObConf

Submit a new or updated translation (Note: use the "attach a file" button, don't paste the whole file in the comment box)

[edit] Bug reports

Translate

Important When submitting a bug report, please make sure to explain to the developers how to reproduce your problem. If we can't reproduce it, we probably can't fix it.

Browse existing bug reports

Submit a new bug report

[edit] Writing code

Translate

Openbox development is done using git. See the Help:UsingGit page for details on how to check out the latest code and send your changes back upstream.

Personal tools