]> git.donarmstrong.com Git - lilypond.git/blob - Documentation/fr/web/community.itexi
6030f8f882d7abf90260801daf07ac88e82be5ff
[lilypond.git] / Documentation / fr / web / community.itexi
1 @c -*- coding: utf-8; mode: texinfo; documentlanguage : fr -*-
2 @c This file is part of web.texi
3 @ignore
4    Translation of GIT committish: 6b8cabe379e8b4b945797a4e55759c56117223d4
5
6    When revising a translation, copy the HEAD committish of the
7    version that you are working on.  For details, see the Contributors'
8    Guide, node Updating translation committishes..
9 @end ignore
10
11 @c Translators: Jean-Charles Malahieude, John Mandereau
12 @c Translation checkers:
13
14
15 @include included/acknowledge.itexi
16 @include included/authors.itexi
17 @include included/helpus.itexi
18
19 @node Communauté
20 @unnumbered Communauté
21 @translationof Community
22
23 @divClass{link-headings}
24
25 @divClass{column-center-top}
26 @subheading Échanger avec la communauté
27 @c VO Interacting with the community
28
29 @itemize
30
31 @item
32 @ref{Contact} : obtenir de l'aide, discuter et rester en contact.
33
34 @item
35 @ref{Exemples minimalistes} : une nécessité lorsque l'on discute de
36 LilyPond.
37
38 @item
39 @ref{Signalement de bogue} : dysfonctionnement du programme.
40
41 @end itemize
42 @divEnd
43
44 @divClass{column-left-bottom}
45 @subheading Rendre LilyPond encore meilleur
46 @c VO Making LilyPond better
47
48 @itemize
49
50 @item
51 @ref{Participation} : pour les bonnes volontés qui se sentent
52 concernées.
53
54 @item
55 @ref{Mécénat} : pour ceux qui veulent contribuer financièrement.
56
57 @item
58 @ref{Développement} : pour ceux qui veulent contribuer et tester.
59
60 @item
61 @ref{Google Summer of Code} : liste des projets pour le Google Summer of
62 Code.
63
64 @item
65 @ref{Auteurs} : ceux qui ont permis à LilyPond d'être ce qu'il est
66 aujourd'hui.
67
68 @item
69 @ref{Remerciements} : projets et institutions soutenant LilyPond
70
71 @end itemize
72 @divEnd
73
74 @divClass{column-right-bottom}
75 @subheading Divers
76 @c VO Miscellaneous
77 @itemize
78
79 @item
80 @ref{Publications} : ce que nous avons écrit, et ce que l'on dit de
81 nous.
82
83 @item
84 @ref{Actualités} : archives des dépêches.
85
86 @item
87 @ref{Grenier} : annonces et recensement des modifications intervenues
88 aux cours des versions précédentes.
89
90 @end itemize
91 @divEnd
92
93 @divEnd
94
95 @divClass{hide}
96 @menu
97 * Contact::
98 * Exemples minimalistes::
99 * Signalement de bogue::
100 * Participation::
101 * Mécénat::
102 * Développement::
103 * Google Summer of Code::
104 * Auteurs::
105 * Remerciements::
106 * Publications::
107 * Actualités::
108 * Grenier::
109 @end menu
110 @divEnd
111
112
113 @node Contact
114 @unnumberedsec Contact
115 @translationof Contact
116
117
118 @divClass{column-left-bottom}
119 @subheading Discuter entre utilisateurs et demander de l'aide
120 @c VO User Discussions and Help
121 @subsubheading Liste de diffusion des utilisateurs : @code{lilypond-user@@gnu.org}
122
123 Cette liste de diffusion @strong{anglophone} est le lieu privilégié des
124 utilisateurs pour discuter et s'entraider.
125
126 @quotation
127 @uref{http://lists.gnu.org/mailman/listinfo/lilypond-user,
128 page de souscription à lilypond-user}
129
130 @uref{http://lists.gnu.org/archive/html/lilypond-user/,
131 archive1 de la liste},
132 @uref{http://www.mail-archive.com/lilypond-user@@gnu.org/,
133 archive2},
134 @uref{http://dir.gmane.org/gmane.comp.gnu.lilypond.general,
135 archive3}.
136
137 @uref{http://post.gmane.org/post.php?group=gmane.comp.gnu.lilypond.general,
138 poster sur lilypond-user à l'aide de gmane}
139 @end quotation
140
141 @warning{Lorsque vous posez une question, merci de fournir des
142 @ref{Exemples minimalistes} !}
143
144
145 @subsubheading LilyPond Snippet Repository
146
147 Le LilyPond Snippet Repository regroupe des exemples de situations
148 particulières auxquelles ont été confrontés les utilisateurs de LilyPond.
149 Ils sont librement réutilisables dans vos propres travaux.  N'hésitez
150 pas à apporter votre concours à cette banque de trucs et astuces !
151
152 @example
153 @uref{http://lsr.di.unimi.it}
154 @end example
155
156 Un certain nombre d'exemples issus du LSR et particulièrement pertinents
157 sont directement inclus dans la documentation, volume
158 @ref{Morceaux choisis}.
159
160
161 @subsubheading IRC
162
163 Vous pouvez obtenir quelque support au travers de notre canal IRC :
164
165 @example
166 @uref{irc://irc.freenode.net/lilypond, #lilypond@@irc.freenode.net}
167 @end example
168
169 Ce canal ne disposant pas d'archive publique, nous vous invitons à
170 plutôt utiliser les listes de diffusion pour toute question qui pourrait
171 intéresser d'autres utilisateurs.
172
173 @html
174 <form action="http://webchat.freenode.net"
175       method="get"
176       name="f_lily_irc"
177   <label>alias irc :
178     <input name="nick" type="text" size="15" value="">
179   </label>
180   <input name="channels" type="hidden" value="lilypond">
181   <input type="submit" value="Rejoindre #lilypond IRC Chat">
182 </form>
183
184 <script language="JavaScript" type="text/javascript">
185   var username = "web";
186   var lang = window.navigator.userLanguage ? window.navigator.userLanguage
187   : window.navigator.language;
188   username += '-' + lang.substr(0, 2);
189   username += '-' + navigator.appName.substr(0, 2);
190   username += navigator.appCodeName.replace (" ", "").substr(0, 2);
191   username += navigator.platform.replace (" ", "").replace("nux", "").replace("n32", "");
192   document.forms["f_lily_irc"].nick.value = username;
193 </script>
194 @end html
195
196 @subsubheading Autres langues
197
198 @quotation
199 @uref{http://www.lilypondforum.de/,
200 Forum germanophone}
201
202 @uref{http://www.lilypondforum.nl/,
203 Forum hollandais}
204
205 @uref{http://groups.google.com/group/lilypond-brasil,
206 Groupe des utilisateurs brésiliens}
207
208 @uref{http://lists.gnu.org/mailman/listinfo/lilypond-user-fr,
209 Liste de diffusion francophone}
210
211 @uref{http://lists.gnu.org/mailman/listinfo/lilypond-es,
212 Liste de diffusion hispanophone}
213 @end quotation
214
215 @divEnd
216
217
218 @divClass{column-right-top}
219 @subheading Le @emph{blog} de LilyPond
220
221 Le @emph{blog} de la communauté LilyPond, au titre de « Scores of
222 Beauty », est une ressource de grande valeur.
223
224 @example
225 @uref{http://lilypondblog.org}
226 @end example
227
228 @subsubheading Liste de diffusion des versions : @code{info-lilypond@@gnu.org}
229
230 Cette liste de diffusion est en lecture seule.  Son but est de notifier
231 la mise à disposition des versions.
232
233 @quotation
234 @uref{http://lists.gnu.org/mailman/listinfo/info-lilypond,
235 page de souscription à info-lilypond}
236
237 @uref{http://lists.gnu.org/archive/html/info-lilypond/,
238 archive1 de la liste},
239 @uref{http://www.mail-archive.com/info-lilypond@@gnu.org/,
240 archive2},
241 @uref{http://dir.gmane.org/gmane.comp.gnu.lilypond.announce,
242 archive3}
243
244 @c don't include gmane posting here.  -gp
245 @end quotation
246
247 @divEnd
248
249
250 @divClass{column-right-bottom}
251 @subheading Contacter les développeurs ou les traducteurs
252 @c VO Developer Discussions and Translations
253
254 @subsubheading Liste de diffusion des développeurs : @code{lilypond-devel@@gnu.org}
255
256 C'est sur cette liste que se tiennent les discussions ayant trait au
257 développement.  C'est aussi à cette liste que peuvent être adressés les
258 patches.
259
260 @quotation
261 @uref{http://lists.gnu.org/mailman/listinfo/lilypond-devel,
262 Page de souscription à lilypond-devel}
263
264 @uref{http://lists.gnu.org/archive/html/lilypond-devel/,
265 archive1 de la liste},
266 @uref{http://www.mail-archive.com/lilypond-devel@@gnu.org/,
267 archive2},
268 @uref{http://dir.gmane.org/gmane.comp.gnu.lilypond.devel,
269 archive3}.
270
271 @uref{http://post.gmane.org/post.php?group=gmane.comp.gnu.lilypond.devel,
272 poster sur lilypond-devel à l'aide de gmane}
273 @end quotation
274
275
276 @subsubheading Liste de diffusion des bogues : @code{bug-lilypond@@gnu.org}
277
278 Cette liste @strong{anglophone} est tout spécialement consacrée
279 signalements et discussions à propos des bogues ou limitations.  Elle
280 n'est pas destinée à recevoir des patches.
281
282 @quotation
283 @uref{http://lists.gnu.org/mailman/listinfo/bug-lilypond,
284 page de souscription à bug-lilypond}
285
286 @uref{http://lists.gnu.org/archive/html/bug-lilypond/,
287 archive1 de la liste},
288 @uref{http://www.mail-archive.com/bug-lilypond@@gnu.org/,
289 archive2},
290 @uref{http://dir.gmane.org/gmane.comp.gnu.lilypond.bugs,
291 archive3}.
292
293 @c don't include gmane posting here.  -gp
294 @end quotation
295
296 @warning{Les directives à suivre pour poster un message sur cette
297 liste sont répertoriées dans @ref{Signalement de bogue}.}
298
299
300 @subheading Liste de diffusion des traductions : @code{translations@@lilynet.org}
301
302 C'est sur cette liste que se tiennent les discussions ayant trait aux
303 traductions des manuels.  Merci de n'y adresser aucun patche.
304
305 @quotation
306 @uref{http://lilypond-translations.3384276.n2.nabble.com/,
307 Translation mailing list archive}
308 @end quotation
309
310 @divEnd
311
312
313 @node Exemples minimalistes
314 @unnumberedsec Exemples minimalistes
315 @translationof Tiny examples
316
317 @divClass{column-center-top}
318 @subheading Exemple minimaliste@dots{} mais qu'est-ce donc que cela ?
319
320 Un exemple minimaliste est un bout de code duquel @strong{plus rien} ne
321 peut être retiré.
322 @divEnd
323
324 @divClass{column-left-bottom}
325 @subheading Pourquoi être minimaliste ?
326
327 @divClass{keep-bullets}
328 @itemize
329
330 @item
331 Au plus l'exemple est simpliste, au plus vite ceux qui pourraient vous
332 aider comprendront votre propos et vous apporteront une réponse.
333
334 @item
335 Réduire l'exemple à sa plus simple expression indique que vous avez déjà
336 tenté par vous-même de trouver une solution.  Des tonnes de lignes
337 laissent à penser que celui qui les envoie se soucie guère de ce qui
338 arrive.
339
340 @item
341 La génération d'un exemple minimaliste permet de comprendre ce qui se
342 passe et évite la plupart du temps de signaler un problème qui, en
343 réalité, n'existe pas : lorsqu'un « bogue » ne peut être reproduit dans
344 le cadre d'un exemple minimal, il y a de fortes présomptions qu'il
345 s'agisse d'une inadéquation entre l'utilisateur et LilyPond plutôt que
346 réellement d'un « bogue ».
347
348 @end itemize
349 @divEnd
350
351 @divEnd
352
353
354 @divClass{column-right-bottom}
355 @subheading Comment être minimaliste@tie{}?
356
357 @divClass{keep-bullets}
358 @itemize
359
360 @item
361 Inclure une mention @code{\version} pour indiquer le numéro de version
362 utilisée.
363
364 @item
365 Être aussi bref et concis que possible.  Si des problèmes concernant les
366 espacements ou la mise en page peuvent nécessiter un certain nombre de
367 mesures, la plupart des litiges peuvent se cantonner à moins d'une
368 mesure.
369
370 @item
371 Lorsque vous créez un exemple minimal à partir de votre code, commencez
372 par commenter des portions de votre fichier -- à l'aide de @w{@code{%}
373 ou @code{%@{ @dots{} %@}}}.  Tout ce que vous mettez en commentaire et
374 qui ne nuit pas à la démonstration est superflu ; suprimez-le !
375
376 @item
377 Évitez autant que faire se peut toute notation, tonalité ou métrique
378 complexe, à moins que leur traitement ne soit précisément l'objet du
379 litige.
380
381 @item
382 N'utilisez pas les commandes @code{\override} ou @code{\set} à moins que
383 le problème ne soit directement lié à leur utilisation.
384
385 @item
386 Le cas échéant, joignez une image de ce à quoi vous voulez arriver.
387
388 @end itemize
389 @divEnd
390
391 @divEnd
392
393 @divClass{column-center-bottom}
394 @subheading Jusqu'où pousser le minimalisme@tie{}?
395
396 En voici un exemple :
397
398 @example
399 \version "2.14.1"
400 \include "english.ly"
401
402 \score @{
403   \new Staff @{
404     \key d \major
405     \numericTimeSignature
406     \time 2/4
407     <cs' d'' b''>16 <cs' d'' b''>8.
408     %% Ici : la liaison des ré est bizarre.
409     %% Trop haute ? Extrémité gauche décalée par rapport à celle du si ?
410     ~
411     <cs' d'' b''>8 [ <b d'' a''> ]
412   @}
413 @}
414 @end example
415
416 C'est vrai, ce n'est pas très long.  Mais on peut encore le réduire :
417
418 @example
419 \version "2.14.1"
420 @{
421   % la liaison du milieu est bizarre :
422   <c' d'' b''>8. ~ <c' d'' b''>8
423 @}
424 @end example
425
426 Les exemples minimalistes dépassant les dix lignes de code ne sont pas
427 légion -- quatre lignes suffisent bien souvent à indiquer le problème.
428
429 @divEnd
430
431
432 @node Signalement de bogue
433 @unnumberedsec Signalement de bogue
434 @translationof Bug reports
435
436 @divClass{heading-center}
437 Si votre saisie entraîne un crash ou une sortie erronée, c'est un bogue.
438 @divEnd
439
440
441 @divClass{column-center-top}
442 @subheading Étape 1 : Le bogue est-il déjà recensé ?
443
444 Un recensement des bogues non encore résolus est disponible sur notre
445 @emph{google bug tracker} ; suivez le lien
446
447 @example
448 @uref{http://sourceforge.net/p/testlilyissues/issues/}
449 @end example
450
451 @warning{Nous vous saurons gré de ne pas ajouter directement de
452 signalement sur le traceur de bogues.  Vous pourrez toujours, une fois
453 qu'il aura été dûment répertorié, y apporter vos commentaires et
454 compléments d'information.}
455
456 @divEnd
457
458
459 @divClass{column-left-bottom}
460 @subheading Étape 2 : Génération d'un signalement de bogue
461
462 Lorsque le dysfonctionnement que vous avez repéré n'est pas répertorié,
463 faites-le nous savoir en créant un signalement de bogue.
464
465 @warning{Nous n'acceptons les signalements de bogue que s'ils sont
466 rédigés sous la forme d'@ref{Exemples minimalistes}.  Nous ne disposons
467 pas de suffisamment de ressources pour traiter les rapports de bogue,
468 aussi tout exemple non minimaliste sera rejeté.  Dans la plupart des
469 cas, seules quelques notes suffisent à démontrer le dysfonctionnement.}
470
471 Voici ce à quoi devrait ressembler tout signalement de bogue :
472
473 @example
474 % Dans une liaison de prolongation
475 % seule la première note devrait porter
476 % l'altération accidentelle.
477 % Cette version l'ajoute partout.
478 \version "2.10.1"
479
480 \relative c'' @{
481  bes1 ~
482  bes1
483 @}
484 @end example
485
486 @divEnd
487
488 @divClass{column-right-bottom}
489 @subheading Étape 3 : Transmission d'un signalement de bogue
490
491 Après avoir vérifié que votre problème n'est pas déjà répertorié et
492 rédigé votre rapport de bogue, n'hésitez pas à nous le transmettre.
493
494 @divClass{keep-bullets}
495 @itemize
496
497 @item
498 Si vous êtes déjà inscrit à la liste de diffusion
499 @uref{mailto:bug-lilypond@@gnu.org,bug-lilypond@@gnu.org}, envoyez un
500 courriel comme à l'accoutumée.
501
502 @item
503 Si vous n'avez pas souscrit à la liste de diffusion, vous pouvez
504 cependant transmettre votre rapport de bogue au travers de
505 @uref{http://post.gmane.org/post.php?group=gmane.comp.gnu.lilypond.bugs,
506 l'interface gmane de lilypond.bugs}.
507
508 Nous tenons à préciser que l'interface gmane applique une politique
509 stricte de « no top-posting » bien souvent mise en défaut par les
510 fichiers LilyPond.  Aussi nous vous prions de bien vouloir ajouter une
511 ligne
512
513 @example
514 > I'm not top posting.
515 @end example
516
517 @noindent
518 sans oublier le @code{>} au tout début de votre message ; c'est
519 @strong{impératif}.
520
521 Si vous ne voulez ou ne pouvez pas envoyer un rapport de bogue selon les
522 instructions et en anglais, envoyez votre rapport ou posez votre
523 question sur la
524 @uref{http://lists.gnu.org/mailman/listinfo/lilypond-user-fr,
525 liste francophone} ; nous nous chargerons de transmettre un rapport
526 à la liste anglophone et assurerons le suivi.
527
528 @end itemize
529
530 @divEnd
531 @divEnd
532
533 @divClass{column-center-bottom}
534 @subheading Étape 4: Notification de prise en compte
535
536 Une fois le message reçu, nos « exterminateurs de bogues » analyseront
537 votre rapport et vous demanderont peut-être des informations
538 complémentaires avant de l'ajouter au traceur.  Dans la mesure où
539 l'équipe est réduite, merci de leur laisser quelques jours avant
540 qu'ils ne vous transmettent le numéro de référence de votre signalement
541 une fois qu'il aura été ajouté à la base.
542
543 Vous pourrez alors, après l'avoir « marqué », y apporter vos
544 commentaires et être automatiquement notifié du traitement apporté à ce
545 bogue, dès lors que vous avez un identifiant reconnu par google.
546 @divEnd
547
548 @divClass{column-center-bottom}
549 @subheading Information complémentaire : indication du comportement escompté
550
551 Une fois votre requête enregistrée, n'hésitez pas à nous indiquer le
552 résultat que vous escomptiez.  Qu'il s'agisse d'un bout de code ou d'une
553 image -- réalisée à partir de n'importe quel outil --, tant que cela nous
554 aide à voir ce que vous désirez obtenir.
555 @divEnd
556
557
558 @node Participation
559 @unnumberedsec Participation
560 @translationof Help us
561
562 @divClass{column-center-top}
563 @helpusNeed
564
565 @divEnd
566
567 @divClass{column-left-top}
568 @divClass{keep-bullets}
569 @helpusSimple
570
571 @divEnd
572 @divEnd
573
574 @divClass{column-right-top}
575 @helpusAdvanced
576
577 @divEnd
578
579
580 @node Mécénat
581 @unnumberedsec Mécénat
582 @translationof Sponsoring
583
584 @divClass{keep-bullets}
585 @divClass{column-left-top}
586 @subheading Primes
587
588 Il fut un temps où
589
590 @itemize
591 @item des utilisateurs ont payé pour de nouvelles fonctionnalités,
592 @item des développeurs ont ajouté des fonctionnalités moyennant finances.
593 @end itemize
594
595 Le projet LilyPond ne dispose d'aucune organisation quant à ces
596 « efforts » ; il n'est en aucun cas partie prenante dans ces
597 transactions ni ne saurait les interdire.  Tout contrat qui pourrait
598 intervenir entre personnes privées ne saurait nous impliquer.
599
600 @divEnd
601
602 @divClass{column-right-top}
603 @subheading Principes généraux
604 @c VO Guidelines
605
606 Tout utilisateur désireux de rétribuer un travail doit avoir à l'esprit
607 les points suivants :
608
609 @itemize
610 @item
611 Les développeurs de LilyPond peuvent parfois proposer leurs services
612 sur les différentes listes de diffusion.
613
614 @item
615 Tout entendement entre personnes privées requiert les mêmes précautions
616 de base que n'importe quelle transaction : qui paye, combien, par quel
617 moyen et dans quelles conditions.  Nous vous invitons à lever tout doute
618 ou ambiguïté à ce sujet, avant même que les travaux soient entamés.
619
620 @end itemize
621
622 @divEnd
623
624 @divClass{column-center-bottom}
625 @subheading Développeurs intéressés
626 @c VO Interested developers
627
628 Vous trouverez ci-dessous une liste des personnes ayant exprimé leur
629 intérêt pour une rémunération.  Notez bien que la somme de travail varie
630 selon les gens et dans le temps.  Nous ne saurions garantir que cette
631 liste soit à jour, ni les capacités des intéressés.  Le seul critère est
632 « XYZ a demandé à être mentionné sur cette page ».
633
634 Un aperçu de l'historique des sources de LilyPond peut vous aider à
635 déterminer l'activité et l'expérience des développeurs.  Les
636 statistiques s'arrêtent à la version @versionDevel{}.
637
638 @multitable @columnfractions .3 .3 .3
639 @item @uref{http://lilypond.org/~graham/gitstats-all/, depuis les origines}
640 @tab @uref{http://lilypond.org/~graham/gitstats-1year/, sur un an}
641 @tab @uref{http://lilypond.org/~graham/gitstats-3months/, sur un trimestre}
642 @end multitable
643
644 Développeurs intéressés :
645 @table @asis
646 @item @email{lilypond-devel@@gnu.org, Liste des développeurs de LilyPond}
647 Dans la mesure où aucun développeur ne s'est actuellement déclaré,
648 veuillez vous adresser directement à la liste de diffusion des développeurs.
649
650 @c Format
651 @c @item @email{name@@adress.domain, Name}
652 @c area of interest (256 chars max)
653
654 @end table
655
656 @divEnd
657 @divEnd
658
659
660 @node Développement
661 @unnumberedsec Développement
662 @translationof Development
663
664 @divClass{heading-center}
665 @ifclear web_version
666   @heading Développement pour LilyPond @version
667 @end ifclear
668 @ifset web_version
669   @heading Développement pour LilyPond @versionDevel
670 @end ifset
671
672
673 @c we normally don't allow named references, but in this case
674 @c it's good to emphasize the "stable" part.  -gp
675 @warning{Il s'agit des versions @emph{instables et de développement}.
676 Si vous avez le moindre doute quant à l'utilisation ou l'installation de
677 LilyPond, nous vous enjoignons à utiliser le
678 @ref{Téléchargement, téléchargement de la version stable} et la
679 lecture des @ref{Manuels, manuels pour la version stable}.}
680
681 @divEnd
682
683 @divClass{column-center-top}
684 @subheading Numérotation des versions
685 @c VO Release numbers
686
687 Il existe deux jeux de version pour LilyPond : des versions stables
688 et des versions instables de développement.  Les versions stables
689 comportent, en versionnage « mineur », un numéro pair (par ex. 2.8,
690 2.10 ou 2.12).  Les versions de développement, quant à elles,
691 comportent un versionnage « mineur » impair (par ex. 2.7, 2.9 ou 2.11).
692
693 @divEnd
694
695
696 @divClass{column-left-top}
697 @subheading Téléchargement
698 @c VO Download
699
700 Des instructions concernant @code{git} et la compilation sont exposées
701 dans le Guide du contributeur.
702
703 @quotation
704 @uref{http://git.sv.gnu.org/gitweb/?p=lilypond.git, dépôt git de LilyPond}
705 @end quotation
706
707 Les rédacteurs de la documentation ainsi que les testeurs préféreront
708 travailler à partir des binaires les plus à jour :
709
710 @quotation
711
712 @downloadDevelLinuxNormal
713
714 @downloadDevelLinuxBig
715
716 @downloadDevelLinuxPPC
717
718 @downloadDevelFreeBSDNormal
719
720 @downloadDevelFreeBSDBig
721
722 @downloadDevelDarwinNormal
723
724 @downloadDevelDarwinPPC
725
726 @downloadDevelWindows
727
728 @downloadDevelSource
729
730 @end quotation
731
732 @divEnd
733
734
735 @divClass{column-right-top}
736 @subheading Le guide du contributeur
737 @c VO Contributor's Guide
738
739 Le développement de LilyPond est relativement complexe.  Dans l'espoir
740 d'aider les nouveaux contributeurs, et dans le but de préserver au mieux
741 la stabilité de ce système, nous avons rédigé un manuel dédié aux
742 activités de développement.
743
744 @warning{Dans la mesure où les développeurs de LilyPond sont disséminés
745 sur la planète, il n'est pas prévu que ce document soit un jour
746 traduit@dots{}}
747
748 @docLinksBare{Guide du contributeur, contributor,
749   @rcontribnamed{Top,Guide du contributeur},
750   @manualDevelContributorSplit,
751   @manualDevelContributorBig, 500 kB,
752   @manualDevelContributorPdf, 2.8 MB}
753
754 @divEnd
755
756
757 @divClass{column-center-top}
758 @subheading Tests de régression
759 @c VO Regression tests
760
761 @divClass{keep-bullets}
762
763 @ifclear web_version
764
765 @itemize
766 @item
767 @uref{../../input/regression/collated-files.html, Tests de régression}
768 relatifs à ce niveau de mise à jour
769 (@uref{../../input/regression/collated-files.pdf, version pdf}).
770
771 @item
772 @uref{../../input/regression/musicxml/collated-files.html, Tests de MusicXML}
773 relatifs à ce niveau de mise à jour
774 (@uref{../../input/regression/musicxml/collated-files.pdf, version pdf}).
775
776 @item
777 @uref{../../input/regression/abc2ly/collated-files.html, Test de abc2ly}
778 relatifs à ce niveau de mise à jour
779 (@uref{../../input/regression/abc2ly/collated-files.pdf, version pdf}).
780
781 @item
782 @uref{../../input/regression/lilypond-book/collated-files.html,
783 Test de lilypond-book} relatifs à ce niveau de mise à jour
784 (@uref{../../input/regression/lilypond-book/collated-files.pdf, version pdf}).
785 @end itemize
786
787 @end ifclear
788
789 @ifset web_version
790 @subsubheading Version de développement
791 @c VO Development version
792
793 @itemize
794 @item @regtestDevel (@regtestDevelPdf{})
795
796 @item @regtestDevelXml (@regtestDevelXmlPdf{})
797
798 @item @regtestDevelAbc (@regtestDevelAbcPdf{})
799
800 @item @regtestDevelLilypondBook (@regtestDevelLilypondBookPdf{})
801 @end itemize
802
803 @subsubheading Version stable
804 @c VO Stable version
805
806 @itemize
807 @item @regtestStable (@regtestStablePdf{})
808
809 @item @regtestStableXml (@regtestStableXmlPdf{})
810
811 @item @regtestStableAbc (@regtestStableAbcPdf{})
812
813 @item @regtestStableLilypondBook (@regtestStableLilypondBookPdf{})
814 @end itemize
815 @end ifset
816
817
818 @subsubheading Toutes versions
819 @c VO All versions
820
821 @itemize
822 @item @uref{http://lilypond.org/test,
823 Comparaison entre différentes versions}
824
825 @item @uref{http://lilypond.org/downloads/binaries/test-output/,
826 Archive de tous les tests de régression}
827
828 @end itemize
829
830 @divEnd
831 @divEnd
832
833
834 @divClass{column-center-bottom}
835 @subheading Manuels
836 @c VO Manuals
837
838 @ifclear web_version
839 @warning{Il s'agit des manuels pour LilyPond @version{} ; la
840 dernière mouture est consultable sur @url{http://lilypond.org}}
841 @end ifclear
842
843 @divClass{normal-table}
844 @multitable @columnfractions .3 .3 .3
845 @headitem Introduction
846
847 @item
848 @docLinkSplit{Initiation,learning,@manualDevelLearningSplit-fr}
849 @tab
850 @docLinkBig{Initiation,learning,@manualDevelLearningBig-fr}
851 @tab
852 @docLinkPdf{Initiation,learning,@manualDevelLearningPdf-fr}
853
854 @item
855 @docLinkSplit{Glossaire,music-glossary,@manualDevelGlossarySplit}
856 @tab
857 @docLinkBig{Glossaire,music-glossary,@manualDevelGlossaryBig}
858 @tab
859 @docLinkPdf{Glossaire,music-glossary,@manualDevelGlossaryPdf}
860
861 @item
862 @docLinkSplit{Essai,essay,@manualDevelEssaySplit-fr}
863 @tab
864 @docLinkBig{Essai,essay,@manualDevelEssayBig-fr}
865 @tab
866 @docLinkPdf{Essai,essay,@manualDevelEssayPdf-fr}
867 @end multitable
868
869 @multitable @columnfractions .3 .3 .3
870 @headitem Utilisation courante
871
872 @item
873 @docLinkSplit{Notation,notation,@manualDevelNotationSplit-fr}
874 @tab
875 @docLinkBig{Notation,notation,@manualDevelNotationBig-fr}
876 @tab
877 @docLinkPdf{Notation,notation,@manualDevelNotationPdf-fr}
878
879 @item
880 @docLinkSplit{Utilisation,usage,@manualDevelUsageSplit-fr}
881 @tab
882 @docLinkBig{Utilisation,usage,@manualDevelUsageBig-fr}
883 @tab
884 @docLinkPdf{Utilisation,usage,@manualDevelUsagePdf-fr}
885
886 @item
887 @docLinkSplit{Morceaux choisis,snippets,@manualDevelSnippetsSplit}
888 @tab
889 @docLinkBig{Morceaux choisis,snippets,@manualDevelSnippetsBig}
890 @tab
891 @docLinkPdf{Morceaux choisis,snippets,@manualDevelSnippetsPdf}
892 @end multitable
893
894 @multitable @columnfractions .3 .3 .3
895 @headitem Utilisation ponctuelle
896
897 @item
898 @docLinkSplit{Web,web,@manualDevelWebSplit-fr}
899 @tab
900 @docLinkBig{Web,web,@manualDevelWebBig-fr}
901 @tab
902 @docLinkPdf{Web,web,@manualDevelWebPdf-fr}
903
904 @item
905 @docLinkSplit{Nouveautés,changes,@manualDevelChangesSplit}
906 @tab
907 @docLinkBig{Nouveautés,changes,@manualDevelChangesBig}
908 @tab
909 @docLinkPdf{Nouveautés,changes,@manualDevelChangesPdf}
910
911 @item
912 @docLinkSplit{Extension,extending,@manualDevelExtendingSplit-fr}
913 @tab
914 @docLinkBig{Extension,extending,@manualDevelExtendingBig-fr}
915 @tab
916 @docLinkPdf{Extension,extending,@manualDevelExtendingPdf-fr}
917
918 @item
919 @docLinkSplit{Références internes,internals,@manualDevelInternalsSplit}
920 @tab
921 @docLinkBig{Références internes,internals,@manualDevelInternalsBig}
922 @tab
923 @docLinkPdf{Références internes,internals,@manualDevelInternalsPdf}
924 @end multitable
925
926 @ifset web_version
927 @multitable @columnfractions .3
928 @headitem En téléchargement
929
930 @item
931 @doctarballDevel
932 @end multitable
933 @end ifset
934
935
936 @divEnd
937 @divEnd
938
939
940 @node Google Summer of Code
941 @unnumberedsec Google Summer of Code
942 @translationof Google Summer of Code
943
944
945 @divClass{column-center-top}
946 @subheading Le Google Summer of Code
947 @c VO What is Google Summer of Code?
948
949 Le @uref{https://developers.google.com/open-source/gsoc/, GSoC} est un
950 programme global, mis en place par Google, qui rémunère des étudiants
951 durant la période estivale pour travailler au profit de projets
952 @emph{open source}.  Il s'agit là d'une excellente opportunité pour des
953 étudiants de vivre une expérience réelle dans le développement de
954 logiciels et contribuer ainsi au bien de tous.  Ceci permet aussi de
955 recruter de nouveaux contributeurs à LilyPond et motiver des étudiants
956 qui y participent déjà d'y être encore plus impliqués.  LilyPond
957 participe à ce programme sous l'égide du
958 @uref{http://www.gnu.org/, projet GNU}.
959
960 Nous avons eu des participants aux sessions de 2012, 2015 et 2016, et
961 encourageons les étudiants à candidater pour les sessions à venir.
962
963 Si vous avez des questions à ce sujet ou avez envie d'y participer,
964 contactez-nous sur la liste des développeurs (voir @ref{Contact}).
965 @divEnd
966
967
968 @divClass{column-center-middle-color2}
969 @subheading Recensement de nos idées
970 @c VO Project Ideas List
971
972 Voici une liste de projets que nous avons proposés aux étudiants du GSoC
973 et à quiconque aurait envie d'améliorer LilyPond.@*
974 Dernière mise à jour : novembre 2016.
975
976 La disponibilité de tuteurs diffère selon les projets et les années.
977 Contactez-nous sur la liste des développeurs -- voir @ref{Contact} -- et
978 nous vous aiderons à trouver un mentor pour le projet qui correspond à
979 vos envies et aptitudes.
980
981 Si vous avez d'autres idées de projet dans le cadre du GSoC, n'hésitez
982 pas à nous en faire part.  Il y a bien d'autres choses à améliorer dans
983 LilyPond et les membres de l'équipe de développement aideront volontiers
984 ceux qui aimeraient s'y atteler.
985
986 Une liste exhaustive des problèmes est disponible
987 @uref{http://sourceforge.net/p/lilypond/issues/list, ici}.
988 @divEnd
989
990
991 @divClass{column-center-middle-color3}
992 @subheading Amélioration de la structure interne des accords
993 @c VO Improve internal chord structure
994
995 La structure interne des accords dans LilyPond n'est pas suffisamment
996 puissante pour tenir compte de la nomneclature des accords de jazz.
997 Pour l'instant, un accord comporte une fondamentale, une basse et un
998 renversement.  Il serait souhaitable d'arriver à gérer les amalgames ou
999 polyaccords, qu'ils soient majeur ou mineur, etc.  Seule le
1000 développement d'une représentation interne capable de capturer l'essence
1001 d'accords complexes permettra d'y parvenir.  Cette représentation
1002 interne une fois développée permettra par ailleurs d'améliorer le rendu
1003 des accords nommés.
1004
1005 @strong{Difficulté :} moyennement facile
1006 @strong{Préalables :} Scheme (Guile), mais le niveau nécessaire peut
1007 s'acquérir aisément.
1008 @strong{Connaissances appréciées :} Théorie des accords et de leur nommage
1009 @strong{Mentor :} Carl Sorensen
1010 @divEnd
1011
1012
1013 @divClass{column-center-middle-color3}
1014 @subheading Ajout de variantes pour certains glyphes
1015 @c VO Adding variants of font glyphs
1016
1017 @divClass{keep-bullets}
1018 @itemize
1019
1020 @item
1021 Ajout de variantes positionnables « sur une ligne » et « dans un
1022 interligne ».
1023
1024 @item
1025 Ajout de variantes plus courtes ou plus étroites pour certains glyphes
1026 comme les altérations. Autre exemple, dans le domaine de la notation
1027 ancienne, avec deux variantes de la brève, l'une avec un évidement plus
1028 important que l'autre.
1029 @end itemize
1030 @divEnd
1031
1032 @strong{Difficulté :} facile
1033 @strong{Préalables :} MetaFont, C++, une bonne vue pour les détails
1034 @strong{Connaissances appréciées :} les bases de LilyPond
1035 @strong{Mentor potentiel :} Werner Lemberg
1036 @divEnd
1037
1038
1039 @divClass{column-center-middle-color3}
1040 @subheading Notes d'ornement @emph{(grace notes)}
1041
1042 Résolution des problèmes de synchronisation des notes d'ornement.  Les
1043 notes d'ornement peuvent venir perturber LilyPond dans sa gestion du
1044 temps et entraîner des effets indésirables tout particulièrement
1045 lorsqu'elles interviennent dans une portée seulement.
1046 Il s'agit @uref{https://sourceforge.net/p/testlilyissues/issues/34/, là}
1047 de l'un des bogues les plus vieux et embarrassants pour LilyPond.
1048
1049 @strong{Difficulté :} moyenne
1050 @strong{Préalables :} C++, MIDI
1051 @strong{Connaissances appréciées :} familiarité avec les arcanes de
1052 LilyPond
1053 @strong{Mentors potentiels :} Mike Solomon (indisponible pour le GSoc
1054 2016), Carl Sorensen
1055 @divEnd
1056
1057
1058 @divClass{column-center-middle-color3}
1059 @subheading Amélioration du positionnement par défaut des ligatures
1060 @c VO Improve default beam positioning
1061
1062 Une ligature, qu'elle soit rectiligne, passe d'une portée à l'autre,
1063 discontinue ou coudée, devrait dépendre du contexte et des notes
1064 adjacentes (voir
1065 @uref{http://imslp.org/wiki/Repository_of_Music-Notation_Mistakes_%28Coulon%2C_Jean-Pierre%29,
1066 la section 2.2 de cet article}).  Dans la mesure du possible, raccourcir
1067 le temps de calcul nécessaire à la génération des ligatures.
1068
1069 @strong{Difficulté :} moyenne
1070 @strong{Préalables :} C++, expérience dans l'écriture d'heuristiques
1071 @strong{Connaissance appréciée :} sens de l'esthétique
1072 @strong{Mentors potentiels :} Mike Solomon (indisponible pour le GSoc
1073 2016), Carl Sorensen
1074 @divEnd
1075
1076
1077 @divClass{column-center-middle-color3}
1078 @subheading Aide à l'amélioration du comportement lors de la compilation
1079 @c VO Help improve compilation behavior
1080
1081 Les outils d'analyse comme @emph{valgrind} pour la détection de fuites
1082 de mémoire ou @emph{callgrind} pour le profilage du code, fournissent
1083 des informations précieuses quant à d'éventuelles faiblesses du
1084 code C++.  Faire le ménage dans tous ces messages nous permettrait de
1085 rejeter tout patch qui introduirait des messages superflus.
1086
1087 @strong{Difficulté :} moyenne
1088 @strong{Préalable :} C++
1089 @strong{Mentors potentiels :} Joe Neeman, Reinhold Kainhofer
1090 (indisponible pour le GSoc 2016)
1091 @divEnd
1092
1093
1094 @divClass{column-center-middle-color3}
1095 @subheading MusicXML
1096
1097 Amélioration des fonctionnalités d'import et d'export :
1098
1099 @divClass{keep-bullets}
1100 @itemize
1101
1102 @item
1103 L'exportation d'un minimum d'informations musicales tel que cela se
1104 pratique déjà au niveau du MIDI, autrement dit à l'aide de classes
1105 d'exportateurs dérivées de la classe @emph{translator} ;
1106
1107 @item
1108 Construction de l'arborescence XML d'après le contenu musical de base, et
1109 connexion des éléments musicaux à des balises XML ;
1110
1111 @item
1112 Faire en sorte que tous les graveurs LilyPond restent pleinement
1113 opérationnels ;
1114
1115 @item
1116 Ajout d'une capacité de lier tout objet de rendu -- autrement dit chaque
1117 stencil ou groupe de stencils -- à l'élément musical qui en est la
1118 cause et, par voie de conséquence, à la balise correspondante dans
1119 l'arborescence XML ;
1120
1121 @item
1122 Ajout d'un moteur de rendu XML qui pourrait alors inclure l'information
1123 de mise en forme pour tout objet de rendu dans les  balises XML.
1124
1125 @end itemize
1126 @divEnd
1127
1128 @strong{Difficulté :} moyenne
1129 @strong{Préalables :} MusicXML, Python, Scheme, les bases de LilyPond
1130 @strong{Mentors potentiels :} Reinhold Kainhofer, Mike Solomon (tous
1131 deux indisponibles pour le GSoc 2016)
1132
1133 La connaissance d'autres éditeurs de partition, dans un but de tests
1134 comparatifs, constituerait une aide.
1135
1136 @divEnd
1137
1138
1139 @divClass{column-center-middle-color3}
1140 @subheading Amélioration des liaisons
1141
1142 Le galbe par défaut des liaisons n'est souvent pas pleinement
1143 satisfaisant.  La « coupure » d'une liaison par un changement de clef ou
1144 de ligne n'est pas totalement fonctionnelle.  Ce projet comporte entre
1145 autres un recensement d'exemples de résultats défectueux, l'appréciation
1146 du résultat optimal et l'écriture du code approprié.
1147
1148 @strong{Difficulté :} difficile
1149 @strong{Préalables :} C++, expérience dans l'écriture d'heuristiques
1150 @strong{Connaissances appréciées :} LilyPond, sens de l'esthétique
1151 @strong{Mentor potentiel :} Mike Solomon, Janek Warchoł (tous deux
1152 indisponibles pour le GSoc 2016)
1153 @divEnd
1154
1155
1156
1157 @node Auteurs
1158 @unnumberedsec Auteurs
1159 @translationof Authors
1160
1161 @divClass{column-left-top}
1162 @subheading Équipe actuelle de développement
1163
1164 @divClass{keep-bullets}
1165 @developersCurrent
1166 @divEnd
1167 @divEnd
1168
1169 @divClass{column-right-top}
1170 @subheading Ceux qui ont participé dans le passé
1171
1172 @divClass{keep-bullets}
1173 @developersPrevious
1174 @divEnd
1175 @divEnd
1176
1177
1178 @divClass{column-center-top}
1179 @subheading Contributeurs actifs
1180
1181 @divClass{keep-bullets}
1182 @subsubheading Programmation
1183
1184 @coreCurrent
1185
1186 @subsubheading Fontes et polices
1187
1188 @fontCurrent
1189
1190 @subsubheading Documentation
1191
1192 @docCurrent
1193
1194 @subsubheading Résolution de bogue
1195
1196 @bugsquadCurrent
1197
1198 @subsubheading Support
1199
1200 @supportCurrent
1201
1202 @subsubheading Traduction
1203
1204 @translationsCurrent
1205
1206 @divEnd
1207 @divEnd
1208
1209
1210 @divClass{column-center-bottom}
1211 @subheading Ceux qui ont contribué
1212
1213 @divClass{keep-bullets}
1214 @subsubheading Programmmation
1215
1216 @corePrevious
1217
1218 @subsubheading Fontes et polices
1219
1220 @fontPrevious
1221
1222 @subsubheading Documentation
1223
1224 @docPrevious
1225
1226 @c    uncomment when we have any previous members -gp
1227 @c @subsubheading Résolution de bogue
1228
1229 @c @bugsquadCurrent
1230
1231 @subsubheading Support
1232
1233 @supportPrevious
1234
1235 @subsubheading Traduction
1236
1237 @translationsPrevious
1238
1239 @divEnd
1240 @divEnd
1241
1242
1243
1244 @node Remerciements
1245 @unnumberedsec Remerciements
1246
1247 @divClass{column-center-top}
1248 @subheading Remerciements
1249
1250 @divClass{keep-bullets}
1251 @acknowledgementsCurrent
1252 @divEnd
1253 @divEnd
1254
1255
1256 @node Publications
1257 @unnumberedsec Publications
1258 @translationof Publications
1259
1260 @divClass{column-center-top}
1261 @subheading Ce que nous avons écrit
1262
1263 @divClass{keep-bullets}
1264
1265 @include we-wrote.itexi
1266
1267 @divEnd
1268 @divEnd
1269
1270
1271 @divClass{column-center-bottom}
1272 @subheading Ce que certains ont fait avec LilyPond
1273
1274 @divClass{keep-bullets}
1275
1276 @include others-did.itexi
1277
1278 @divEnd
1279 @divEnd
1280
1281 @contactUsAbout{publications universitaires}
1282
1283
1284 @node Actualités
1285 @unnumberedsec Actualités
1286 @translationof News
1287
1288 @divClass{heading-center}
1289 @warning{Les vieilles annonces et informations de version sont rangées au
1290 @rwebnamed{Grenier,grenier}.}
1291 @divEnd
1292
1293 @include web/news-front.itexi
1294
1295 @include web/news.itexi
1296
1297
1298 @node Grenier
1299 @unnumberedsec Grenier
1300 @translationof Attic
1301
1302 @divClass{column-center-top}
1303 @subheading Annonces
1304
1305 Annonces et nouvelles, par version :
1306 @uref{http://lilypond.org/doc/v2.16/Documentation/web/index#Lilypond-2_002e16_002e0-released_0021-August-24_002c-2012-1,v2.16},
1307 @uref{http://lilypond.org/doc/v2.14/Documentation/web/index#LilyPond-2_002e14_002e0-released_0021-June-6_002c-2011,v2.14},
1308 @miscLink{announce-v2.12,v2.12},
1309 @miscLink{announce-v2.10,v2.10},
1310 @miscLink{announce-v2.8,v2.8},
1311 @miscLink{announce-v2.6,v2.6},
1312 @miscLink{announce-v2.4,v2.4},
1313 @miscLink{announce-v2.2,v2.2},
1314 @miscLink{announce-v2.0,v2.0},
1315 @miscLink{ANNOUNCE-1.2,v1.2 (2)},
1316 @miscLink{ANNOUNCE-1.0,v1.0},
1317 @miscLink{ANNOUNCE-0.1,v0.1}
1318
1319 Liste descriptive des évolutions, par version :
1320 @uref{http://lilypond.org/doc/v2.16/Documentation/changes/index.html,v2.16},
1321 @uref{http://lilypond.org/doc/v2.14/Documentation/changes/index.html,v2.14},
1322 @uref{http://lilypond.org/doc/v2.12/Documentation/topdocs/NEWS,v2.12},
1323 @uref{http://lilypond.org/doc/v2.10/Documentation/topdocs/NEWS,v2.10},
1324 @uref{http://lilypond.org/doc/v2.8/Documentation/topdocs/NEWS,v2.8},
1325 @uref{http://lilypond.org/doc/v2.6/Documentation/topdocs/NEWS,v2.6},
1326 @uref{http://lilypond.org/doc/v2.4/Documentation/topdocs/out-www/NEWS,v2.4},
1327 @uref{http://lilypond.org/doc/v2.2/Documentation/topdocs/out-www/NEWS,v2.2},
1328 @uref{http://lilypond.org/doc/v2.0/Documentation/topdocs/out-www/NEWS,v2.0},
1329 @uref{http://lilypond.org/doc/v1.8/Documentation/topdocs/out-www/NEWS,v1.8},
1330 @uref{http://lilypond.org/doc/v1.6/Documentation/out-www/NEWS,v1.6},
1331 @miscLink{NEWS-1.4,v1.4},
1332 @miscLink{NEWS-1.2,v1.2}
1333
1334 @divEnd
1335
1336 @divClass{column-center-bottom}
1337 @subheading Remerciements
1338
1339 Tous nos remerciements aux développeurs, contributeurs, chasseurs
1340 de bogue et à ceux qui nous ont fait part de leurs suggestions pour
1341 @miscLink{THANKS-2.16,v2.16},
1342 @miscLink{THANKS-2.14,v2.14},
1343 @miscLink{THANKS-2.12,v2.12},
1344 @miscLink{THANKS-2.10,v2.10},
1345 @miscLink{THANKS-2.8,v2.8},
1346 @miscLink{THANKS-2.6,v2.6},
1347 @miscLink{THANKS-2.4,v2.4},
1348 @miscLink{THANKS-2.2,v2.2},
1349 @miscLink{THANKS-2.0,v2.0},
1350 @miscLink{THANKS-1.8,v1.8}
1351
1352 @divEnd
1353
1354 @divClass{column-center-bottom}
1355 @subheading Journal des modifications
1356
1357 Notes des développeurs, par version :
1358 @miscLink{ChangeLog-2.10,v2.10},
1359 @miscLink{ChangeLog-2.3,v2.3},
1360 @miscLink{ChangeLog-2.1,v2.1},
1361 @miscLink{ChangeLog-1.5,v1.5 (1)},
1362 @miscLink{CHANGES-1.5,v1.5 (2)},
1363 @miscLink{CHANGES-1.4,v1.4},
1364 @miscLink{CHANGES-1.3,v1.3},
1365 @miscLink{CHANGES-1.2,v1.2},
1366 @miscLink{CHANGES-1.1,v1.1},
1367 @miscLink{CHANGES-1.0,v1.0},
1368 @miscLink{CHANGES-0.1,v0.1},
1369 @miscLink{CHANGES-0.0,v0.0}
1370
1371 @divEnd