www/psensor/contribute.html

   1 <!DOCTYPE html>
   2 <html lang="en">
   3 <head>
   4 <meta charset="UTF-8">
   5 <!--[if IE]><meta http-equiv="X-UA-Compatible" content="IE=edge"><![endif]-->
   6 <meta name="viewport" content="width=device-width, initial-scale=1.0">
   7 <meta name="generator" content="Asciidoctor 1.5.4">
   8 <title>How to contribute to psensor</title>
   9 <link rel="stylesheet" href="./../style.css">
  10 <link rel="stylesheet" href="https://cdnjs.cloudflare.com/ajax/libs/font-awesome/4.5.0/css/font-awesome.min.css">
  11 <script src="https://ajax.googleapis.com/ajax/libs/jquery/2.2.4/jquery.min.js"></script>
  12 <script src="nav.js"></script>
  13 <link rel="stylesheet" href="font-awesome/css/font-awesome.min.css">
  14 </head>
  15 <body class="article">
  16 <div id="header">
  17 <h1>How to contribute to psensor</h1>
  18 </div>
  19 <div id="content">
  20 <div class="sect1">
  21 <h2 id="_translations">Translations</h2>
  22 <div class="sectionbody">
  23 <div class="paragraph">
  24 <p>Psensor is fully translatable, and contributions to the translation
  25 for any language are welcome.</p>
  26 </div>
  27 <div class="sect2">
  28 <h3 id="_directly_update_the_translation_files">Directly update the translation files</h3>
  29 <div class="paragraph">
  30 <p>You can modify the .po files which are available in the
  31 GIT repository: <a href="http://git.wpitchoune.net/psensor.git" class="bare">http://git.wpitchoune.net/psensor.git</a> and send it to
  32 <a href="mailto:jeanfi@gmail.com">jeanfi@gmail.com</a>.</p>
  33 </div>
  34 <div class="paragraph">
  35 <p><a href="http://poedit.net">poedit</a> or any text editors supporting UTF-8
  36 can be used to edit the translation files .</p>
  37 </div>
  38 <div class="paragraph">
  39 <p>If the <code>.po</code> file does not exist for your language, send me an email, I
  40 will add it.</p>
  41 </div>
  42 </div>
  43 <div class="sect2">
  44 <h3 id="_use_launchpad">Use Launchpad</h3>
  45 <div class="admonitionblock warning">
  46 <table>
  47 <tr>
  48 <td class="icon">
  49 <i class="fa icon-warning" title="Warning"></i>
  50 </td>
  51 <td class="content">
  52 Currently, you must NOT use this way. Due to a <a href="https://bugs.launchpad.net/ubuntu/+source/bzr-git/+bug/1084403">bug</a> which
  53 prevents to import GIT repository to Bazaar branch, it is impossible
  54 to synchronize the translations.
  55 </td>
  56 </tr>
  57 </table>
  58 </div>
  59 <div class="paragraph">
  60 <p>The easiest way is probably to use the Launchpad translation Web
  61 service available at:
  62 <a href="https://translations.launchpad.net/psensor/trunk/+translations" class="bare">https://translations.launchpad.net/psensor/trunk/+translations</a>.</p>
  63 </div>
  64 <div class="paragraph">
  65 <p>If you did not already use it, you can read some documentation at:
  66 <a href="https://help.launchpad.net/Translations" class="bare">https://help.launchpad.net/Translations</a>. The LP translations are
  67 periodically merged in the Psensor source repository and systematicaly
  68 before each release.</p>
  69 </div>
  70 </div>
  71 </div>
  72 </div>
  73 <div class="sect1">
  74 <h2 id="_source_code">Source code</h2>
  75 <div class="sectionbody">
  76 <div class="paragraph">
  77 <p>Patch fixing bugs or adding features are welcome.</p>
  78 </div>
  79 <div class="paragraph">
  80 <p>The code modification must be submitted as a patch file on the branch
  81 <code>master</code> of the GIT repository:</p>
  82 </div>
  83 <div class="olist arabic">
  84 <ol class="arabic">
  85 <li>
  86 <p>Checkout the source code: <code>git clone <a href="http://git.wpitchoune.net/psensor.git" class="bare">http://git.wpitchoune.net/psensor.git</a></code></p>
  87 </li>
  88 <li>
  89 <p>Modify the files</p>
  90 </li>
  91 <li>
  92 <p>Generate the patch file: <code>git diff &gt;/tmp/mypatch.diff</code></p>
  93 </li>
  94 <li>
  95 <p>Verify that it respects the coding style: <code>make check</code></p>
  96 </li>
  97 <li>
  98 <p>Send the patch file by email to <a href="mailto:jeanfi@gmail.com">jeanfi@gmail.com</a></p>
  99 </li>
 100 </ol>
 101 </div>
 102 <div class="paragraph">
 103 <p>If it concerns a bug which does not exist on the ‘master’ GIT branch,
 104 the patch must be done on the appropriate GIT branch:
 105 <a href="http://git.wpitchoune.net/gitweb/?p=psensor.git;a=summary" class="bare">http://git.wpitchoune.net/gitweb/?p=psensor.git;a=summary</a>.</p>
 106 </div>
 107 </div>
 108 </div>
 109 <div class="sect1">
 110 <h2 id="_icons">Icons</h2>
 111 <div class="sectionbody">
 112 <div class="paragraph">
 113 <p>Psensor is using 3 differents icons:</p>
 114 </div>
 115 <div class="ulist">
 116 <ul>
 117 <li>
 118 <p><a href="http://git.wpitchoune.net/gitweb/?p=psensor.git;a=blob_plain;f=icons/hicolor/scalable/psensor.svg;hb=HEAD">an application icon</a></p>
 119 </li>
 120 <li>
 121 <p><a href="http://git.wpitchoune.net/gitweb/?p=psensor.git;a=blob_plain;f=icons/hicolor/scalable/psensor_normal.svg;hb=HEAD">a status icon</a></p>
 122 </li>
 123 <li>
 124 <p><a href="http://git.wpitchoune.net/gitweb/?p=psensor.git;a=blob_plain;f=icons/hicolor/scalable/psensor_hot.svg;hb=HEAD">a status icon when there is a sensor alert</a></p>
 125 </li>
 126 </ul>
 127 </div>
 128 <div class="paragraph">
 129 <p>and provides icons for 3 different themes:</p>
 130 </div>
 131 <div class="ulist">
 132 <ul>
 133 <li>
 134 <p><a href="http://git.wpitchoune.net/gitweb/?p=psensor.git;a=tree;f=icons/hicolor/scalable;hb=HEAD">hicolor, the default theme for most desktop environment</a></p>
 135 </li>
 136 <li>
 137 <p><a href="http://git.wpitchoune.net/gitweb/?p=psensor.git;a=tree;f=icons/ubuntu-mono-dark;hb=HEAD">the default ubuntu monochrome dark theme</a></p>
 138 </li>
 139 <li>
 140 <p><a href="http://git.wpitchoune.net/gitweb/?p=psensor.git;a=tree;f=icons/ubuntu-mono-light;hb=HEAD">the default ubuntu monochrome light theme</a></p>
 141 </li>
 142 </ul>
 143 </div>
 144 <div class="paragraph">
 145 <p>The status icons for Ubuntu themes have been provided by Christoph
 146 Buchner and are nice but definitively not the application icon.</p>
 147 </div>
 148 <div class="paragraph">
 149 <p>Contributions to the icons are welcome for the already existent themes
 150 or others. To submit a new icon it must:</p>
 151 </div>
 152 <div class="ulist">
 153 <ul>
 154 <li>
 155 <p>be an original work (not confusing with another application icons)
 156 and released under GPL v2 license.</p>
 157 </li>
 158 <li>
 159 <p>use the .SVG format.</p>
 160 </li>
 161 <li>
 162 <p>be sent to me by email (<a href="mailto:jeanfi@gmail.com">jeanfi@gmail.com</a>).</p>
 163 </li>
 164 </ul>
 165 </div>
 166 </div>
 167 </div>
 168 </div>
 169 <div id="footer">
 170 <div id="footer-text">
 171 Last updated 2016-06-14 15:29:45 CEST
 172 </div>
 173 </div>
 174 </body>
 175 </html>