HACKING.fr.txt

   1 Compiler la version svn
   2 =======================
   3 grep Build-Depends debian/control permet d'afficher une liste de paquets
   4 (Debian) nécessaires à la compilation.
   5
   6 inkscape.spec.in contient une liste partielle de spécifications :
   7
   8   grep Requires inkscape.spec.in
   9
  10 Au moment où ce texte est écrit, il n'y a qu'un paquet ; si vous utilisez une
  11 distribution basée sur des RPM, pensez à mettre à jour les lignes
  12 Requires/BuildRequires afin d'aider les autres utilisateurs de votre
  13 distribution. Si vous n'avez pas d'accès en écriture au SVN, vous pouvez
  14 soumettre un patch auprès de
  15 <https://bugs.launchpad.net/inkscape>.
  16
  17
  18 Consulter http://wiki.inkscape.org/wiki/index.php/CompilingInkscape pour des
  19 remarques plus complètes sur la compilation, comprenant des explications sur
  20 comment trouver les paquets nécessaires pour votre distribution et des
  21 suggestions pour les développeurs.
  22
  23
  24 Contribuer à Inkscape
  25 =====================
  26 Inkscape accepte volontiers vos contributions pour aider à en faire un
  27 programme de dessin totalement conforme à la norme SVG pour la communeauté du
  28 logiciel libre.
  29
  30 Alors que beaucoup de développeurs travaillent sur la correction de bugs et la
  31 création de nouvelles fonctionnalités, il est important de noter que même les
  32 non-programmeurs peuvent contribuer à la puissance et au succès d'Inkscape.
  33 Vous avez probablement une idée d'une chose sur laquelle vous aimeriez
  34 travailler. Sinon, voivi quelques façons d'apporter votre aide :
  35
  36    * Sélectionner un bug, le corriger et envoyer un path ("diff -uNrp" ou
  37    "cvs diff -up")
  38    * Choisir une fonctionnalité que vous aimeriez développer et la coder
  39    * Si vous maîtrisez une langue en plus de l'anglais, travailler sur le
  40    fichier i18n de celle-ci dans le répertoire /po
  41    * Trouver un nouveau bug et le rapporter
  42    * Aider à répondre aux questions des nouveaux "Inkscapeurs" sur Jabber, IRC
  43    ou les mailing lists
  44    * Ecrire un article pour la promotion d'Inkscape
  45    * Ecrire un HOWTO décrivant une astuce ou technique que vous avez trouvé
  46
  47
  48 Accès SVN
  49 =========
  50 Consultez http://inkscape.org/svn.php pour voir comment accéder au SVN, y
  51 compris depuis un navigateur web.
  52 Nous donnons un accès en écriture au SVN à toute personne ayant démontré une
  53 motivation pour aider à développer le code. Prouver votre motivation est très
  54 simple : fournir deux contributions et demander un accès.
  55
  56
  57 Décisions de patch
  58 ==================
  59 Notre ligne de conduite quant aux modifications du code est "coder d'abord,
  60 poser les questions ensuite". Quand quelqu'un a une idée, plutôt que de la
  61 débattre sans fin, nous encourageons les gens à aller de l'avant et coder
  62 quelquechose (même un prototypage). Ce code est ensuite incorporé dans la
  63 branche de développement afin de l'essayer, le tester, le pousser et
  64 l'améliorer. Nous pensons que la meilleure façon de vérifier qu'une idée est
  65 bonne est de la tester en conditions réelles.
  66
  67
  68 Style de codage
  69 ===============
  70 Veuillez consulter les recommandations de style de codage
  71 (http://www.inkscape.org/doc/coding_style.php) si vous avez des questions
  72 spécifiques quant au style à utiliser dans le code. Si lire ces recommandations
  73 ne vous intéresse pas, inspirez-vous du style du code environnant, de façon à
  74 rester au moins cohérent.
  75
  76
  77 Makefiles
  78 =========
  79 Les fichiers Makefiles du répertoire src sont plus ou moins fusionnés dans le
  80 fichier src/Makefile.am qui fournit les informations nécessaires aux fichiers
  81 Makefile_insert de chaque répertoire.
  82
  83 Notez que cela ne reste logiquement qu'un fichier, donc les définitions de
  84 variables (comme les INCLUDES etc.) sont partagées, et les variables définies
  85 dans un Makefile_insert peuvent être utilisées dans un autre.
  86
  87 En conséquence, envisagez soit d'ajouter un préfixe `blah_' au nom de toutes
  88 les variables que vous définiriez dans blah/Makefile_insert (si cela doit
  89 rester local pour ce Makefile_insert), ou en mettre la définition dans
  90 src/Makefile.am.  En particulier, les fichiers check_PROGRAMS, DISTCLEANFILES,
  91 etc sont dans src/Makefile.am.