develop-translate.php

   1 <?php
   2 $title='Help Translate Openbox';
   3 $breadcrumb=array('Home', '.', 'Develop', 'develop.php');
   4 ?>
   5
   6 <html>
   7   <?php include('head.php') ?>
   8   <link rel="stylesheet" type="text/css" href="css/develop.css" />
   9 </head>
  10
  11 <?php include('top.php') ?>
  12
  13 <?php splash_title('images/splash/translate.png', $title); ?>
  14
  15 <?php include('content.php') ?>
  16
  17 <div id="col1" class="widecol">
  18 <dl>
  19 <dt><img src="images/icons/openbox_logo.png" alt="openbox"/></dt>
  20 <dd><a href="http://git.icculus.org/?p=mikachu/openbox.git;a=tree;f=po;hb=backport">
  21   Openbox Translations</a><br />
  22   Browse existing translations for Openbox, and see the
  23   <a href="http://git.icculus.org/?p=mikachu/openbox.git;a=blob_plain;f=po/openbox.pot;hb=backport">
  24   translation template</a>.</dd>
  25 </dl>
  26
  27 <dl>
  28 <dt><img src="images/icons/status.png" alt="status"/></dt>
  29 <dd><a href="http://mika.l3ib.org/ob_translation_status">
  30   Openbox Translation Status</a><br />
  31   See how many strings are translated for a language in Openbox.</dd>
  32 </dl>
  33
  34 <dl>
  35 <dt><img src="images/icons/obconf.png" alt="obconf"/></dt>
  36 <dd><a href="http://git.icculus.org/?p=dana/obconf.git;a=tree;f=po;hb=HEAD">
  37   ObConf Translations</a><br />
  38   Browse existing translations for ObConf, and see the
  39   <a href="http://git.icculus.org/?p=dana/obconf.git;a=blob_plain;f=po/obconf.pot;hb=HEAD">
  40   translation template</a>.</dd>
  41 </dl>
  42
  43 <dl>
  44 <dt><img src="images/icons/share.png" alt="share"/></dt>
  45 <dd><a href="http://bugzilla.icculus.org/enter_bug.cgi?product=Openbox&component=Translations&form_name=enter_bug">
  46   Share Your Work</a><br />
  47   Submit a new or updated translation.<br/>
  48   <div class="clear"></div>
  49   <img class="emblem" src="images/importantsmall.png" alt="!"/>
  50   <strong>Note:</strong> you will get the opportunity to upload the file
  51   <strong>after</strong> you create the entry, don't paste the file in the
  52   comments box.
  53 </dd>
  54 </dl>
  55
  56 </div>
  57
  58 <div id="col2" class="widecol">
  59 <h3>
  60 Help us translate Openbox! Any improvements to existing translations,
  61 or translations to new languages would be greatly appreciated by your fellow users.
  62 </h3>
  63
  64 <p>
  65 Translations are done through "po" files. The easiest way to edit these files is to use <a href="http://kbabel.kde.org/">KBabel</a>, which is a part of KDE (in the kdesdk package).
  66 </p>
  67
  68 <p>
  69 If you want to update an existing translation,
  70 <a href="http://git.icculus.org/?p=mikachu/openbox.git;a=tree;f=po;hb=backport">browse through</a>
  71 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).
  72 </p>
  73 <p>
  74 If you want to create a new translation from scratch, download the current
  75 <a href="http://git.icculus.org/?p=mikachu/openbox.git;a=blob_plain;f=po/openbox.pot;hb=backport">translation template for Openbox</a>
  76 or the
  77 <a href="http://git.icculus.org/?p=dana/obconf.git;a=blob_plain;f=po/obconf.pot;hb=HEAD">translation template for ObConf</a>
  78 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.
  79 </p>
  80 <p>
  81 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.
  82 </p>
  83 <p>
  84 <img class="emblem" src="images/importantsmall.png" />
  85 Please make sure to specify the character encoding properly or Openbox won't be able to read the strings.  UTF-8 is preferable.
  86 </p>
  87 <p>
  88 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
  89 <a href="discuss.php">mailing list or on IRC</a>.
  90 </p>
  91 <h3>Thank you for your help!</h3>
  92 </div> <!-- col2 -->
  93
  94 <?php include('bottom.php') ?>