src/psensor/contribute.adoc

   1 = How to contribute to psensor
   2 :docinfo2:
   3
   4 == Translations
   5
   6 Psensor is fully translatable, and contributions to the translation
   7 for any language are welcome.
   8
   9 === Directly update the translation files
  10
  11 You can modify the .po files which are available in the
  12 GIT repository: http://git.wpitchoune.net/psensor.git and send it to
  13 jeanfi@gmail.com.
  14
  15 link:http://poedit.net[poedit] or any text editors supporting UTF-8
  16 can be used to edit the translation files .
  17
  18 If the `.po` file does not exist for your language, send me an email, I
  19 will add it.
  20
  21 === Use Launchpad
  22
  23 WARNING: Currently, you must NOT use this way. Due to a link:https://bugs.launchpad.net/ubuntu/+source/bzr-git/+bug/1084403[bug] which
  24 prevents to import GIT repository to Bazaar branch, it is impossible
  25 to synchronize the translations.
  26
  27 The easiest way is probably to use the Launchpad translation Web
  28 service available at:
  29 https://translations.launchpad.net/psensor/trunk/+translations.
  30
  31 If you did not already use it, you can read some documentation at:
  32 https://help.launchpad.net/Translations. The LP translations are
  33 periodically merged in the Psensor source repository and systematicaly
  34 before each release.
  35
  36 == Source code
  37
  38 Patch fixing bugs or adding features are welcome.
  39
  40 The code modification must be submitted as a patch file on the SVN
  41 ‘trunk’:
  42
  43 . Checkout the source code: `git clone http://git.wpitchoune.net/psensor.git`
  44
  45 . Modify the files
  46
  47 . Generate the patch file: `git diff >/tmp/mypatch.diff`
  48
  49 . Verify that it respects the coding style: `make check`
  50
  51 . Send the patch file by email to jeanfi@gmail.com
  52
  53 If it concerns a bug which does not exist on the ‘master’ GIT branch,
  54 the patch must be done on the appropriate GIT branch:
  55 http://git.wpitchoune.net/gitweb/?p=psensor.git;a=summary.
  56
  57 == Icons
  58
  59 Psensor is using 3 differents icons:
  60
  61 * link:http://git.wpitchoune.net/gitweb/?p=psensor.git;a=blob_plain;f=icons/hicolor/scalable/psensor.svg;hb=HEAD[an application icon]
  62
  63 * link:http://git.wpitchoune.net/gitweb/?p=psensor.git;a=blob_plain;f=icons/hicolor/scalable/psensor_normal.svg;hb=HEAD[a status icon]
  64
  65 * link: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]
  66
  67 and provides icons for 3 different themes:
  68
  69 * link:http://git.wpitchoune.net/gitweb/?p=psensor.git;a=tree;f=icons/hicolor/scalable;hb=HEAD[hicolor, the default theme for most desktop environment]
  70
  71 * link:http://git.wpitchoune.net/gitweb/?p=psensor.git;a=tree;f=icons/ubuntu-mono-dark;hb=HEAD[the default ubuntu monochrome dark theme]
  72
  73 * link:http://git.wpitchoune.net/gitweb/?p=psensor.git;a=tree;f=icons/ubuntu-mono-light;hb=HEAD[the default ubuntu monochrome light theme]
  74
  75 The status icons for Ubuntu themes have been provided by Christoph
  76 Buchner and are nice but definitively not the application icon.
  77
  78 Contributions to the icons are welcome for the already existent themes
  79 or others. To submit a new icon it must:
  80
  81 * be an original work (not confusing with another application icons)
  82   and released under GPL v2 license.
  83
  84 * use the .SVG format.
  85
  86 * be sent to me by email (jeanfi@gmail.com).
  87