Code

Add option to either suppress path flash for items with LPE (e.g., spiro splines...
[inkscape.git] / 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.
6 inkscape.spec.in contient une liste partielle de spécifications : 
8   grep Requires inkscape.spec.in
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 RPMs, 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 <http://sourceforge.net/tracker/?group_id=93438&atid=604308>.
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.
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.
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 :
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é
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.
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.
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.
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.
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.
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.