Openbox:Contribute

From Openbox

(Difference between revisions)
Jump to: navigation, search
m
(Writing code)
 
(9 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://git.icculus.org/?p=mikachu/openbox.git;a=tree;f=po;hb=HEAD 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 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).
  
If you want to create a new translation from scratch, download the [http://git.icculus.org/?p=mikachu/openbox.git;a=blob_plain;f=po/openbox.pot;hb=HEAD current translation template] 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 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.
  
 
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 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.
  
 
[[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.
 
[[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.
 +
 +
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://git.icculus.org/?p=mikachu/openbox.git;a=tree;f=po;hb=HEAD Browse existing translations]
+
[http://git.icculus.org/?p=mikachu/openbox.git;a=tree;f=po;hb=work Browse existing translations for Openbox]
 +
 
 +
[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: you will get the opportunity to upload the file _after_ you create the entry, don't paste the file in the comments box)
+
[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 43: 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 19: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