src/psensor/contribute.adoc

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