]> git.donarmstrong.com Git - lilypond.git/blob - Documentation/fr/web/community.itexi
Doc-fr: fix bad commitishes
[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: 88a5dbc589b0d0434f8e640467b5ab57d14dc461
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{Archives} : 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 * Archives::
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{dak@@gnu.org, David Kastrup (le contacter en anglais)}
647 Vos contributions me permettront de continuer mon activité à temps plein
648 sur LilyPond.  Je me concentre sur la modélisation des interfaces entre
649 l'utilisateur et le programme -- cohérence, implémentation,
650 simplification, documentation et débogage.
651
652 @c Format
653 @c @item @email{name@@adress.domain, Name}
654 @c area of interest (256 chars max)
655
656 @end table
657
658 @divEnd
659 @divEnd
660
661
662 @node Développement
663 @unnumberedsec Développement
664 @translationof Development
665
666 @divClass{heading-center}
667 @ifclear web_version
668   @heading Développement pour LilyPond @version
669 @end ifclear
670 @ifset web_version
671   @heading Développement pour LilyPond @versionDevel
672 @end ifset
673
674
675 @c we normally don't allow named references, but in this case
676 @c it's good to emphasize the "stable" part.  -gp
677 @warning{Il s'agit des versions @emph{instables et de développement}.
678 Si vous avez le moindre doute quant à l'utilisation ou l'installation de
679 LilyPond, nous vous enjoignons à utiliser le
680 @ref{Téléchargement, téléchargement de la version stable} et la
681 lecture des @ref{Manuels, manuels pour la version stable}.}
682
683 @divEnd
684
685 @divClass{column-center-top}
686 @subheading Numérotation des versions
687 @c VO Release numbers
688
689 Il existe deux jeux de version pour LilyPond : des versions stables
690 et des versions instables de développement.  Les versions stables
691 comportent, en versionnage « mineur », un numéro pair (par ex. 2.8,
692 2.10 ou 2.12).  Les versions de développement, quant à elles,
693 comportent un versionnage « mineur » impair (par ex. 2.7, 2.9 ou 2.11).
694
695 @divEnd
696
697
698 @divClass{column-left-top}
699 @subheading Téléchargement
700 @c VO Download
701
702 Des instructions concernant @code{git} et la compilation sont exposées
703 dans le Guide du contributeur.
704
705 @quotation
706 @uref{http://git.sv.gnu.org/gitweb/?p=lilypond.git, dépôt git de LilyPond}
707 @end quotation
708
709 Les rédacteurs de la documentation ainsi que les testeurs préféreront
710 travailler à partir des binaires les plus à jour :
711
712 @quotation
713
714 @downloadDevelLinuxNormal
715
716 @downloadDevelLinuxBig
717
718 @downloadDevelLinuxPPC
719
720 @downloadDevelFreeBSDNormal
721
722 @downloadDevelFreeBSDBig
723
724 @downloadDevelDarwinNormal
725
726 @downloadDevelDarwinPPC
727
728 @downloadDevelWindows
729
730 @downloadDevelSource
731
732 @end quotation
733
734 @divEnd
735
736
737 @divClass{column-right-top}
738 @subheading Le guide du contributeur
739 @c VO Contributor's Guide
740
741 Le développement de LilyPond est relativement complexe.  Dans l'espoir
742 d'aider les nouveaux contributeurs, et dans le but de préserver au mieux
743 la stabilité de ce système, nous avons rédigé un manuel dédié aux
744 activités de développement.
745
746 @warning{Dans la mesure où les développeurs de LilyPond sont disséminés
747 sur la planète, il n'est pas prévu que ce document soit un jour
748 traduit@dots{}}
749
750 @docLinksBare{Guide du contributeur, contributor,
751   @rcontribnamed{Top,Guide du contributeur},
752   @manualDevelContributorSplit,
753   @manualDevelContributorBig, 500 kB,
754   @manualDevelContributorPdf, 2.8 MB}
755
756 @divEnd
757
758
759 @divClass{column-center-top}
760 @subheading Tests de régression
761 @c VO Regression tests
762
763 @divClass{keep-bullets}
764
765 @ifclear web_version
766
767 @itemize
768 @item
769 @uref{../../input/regression/collated-files.html, Tests de régression}
770 relatifs à ce niveau de mise à jour
771 (@uref{../../input/regression/collated-files.pdf, version pdf}).
772
773 @item
774 @uref{../../input/regression/musicxml/collated-files.html, Tests de MusicXML}
775 relatifs à ce niveau de mise à jour
776 (@uref{../../input/regression/musicxml/collated-files.pdf, version pdf}).
777
778 @item
779 @uref{../../input/regression/abc2ly/collated-files.html, Test de abc2ly}
780 relatifs à ce niveau de mise à jour
781 (@uref{../../input/regression/abc2ly/collated-files.pdf, version pdf}).
782
783 @item
784 @uref{../../input/regression/lilypond-book/collated-files.html,
785 Test de lilypond-book} relatifs à ce niveau de mise à jour
786 (@uref{../../input/regression/lilypond-book/collated-files.pdf, version pdf}).
787 @end itemize
788
789 @end ifclear
790
791 @ifset web_version
792 @subsubheading Version de développement
793 @c VO Development version
794
795 @itemize
796 @item @regtestDevel (@regtestDevelPdf{})
797
798 @item @regtestDevelXml (@regtestDevelXmlPdf{})
799
800 @item @regtestDevelAbc (@regtestDevelAbcPdf{})
801
802 @item @regtestDevelLilypondBook (@regtestDevelLilypondBookPdf{})
803 @end itemize
804
805 @subsubheading Version stable
806 @c VO Stable version
807
808 @itemize
809 @item @regtestStable (@regtestStablePdf{})
810
811 @item @regtestStableXml (@regtestStableXmlPdf{})
812
813 @item @regtestStableAbc (@regtestStableAbcPdf{})
814
815 @item @regtestStableLilypondBook (@regtestStableLilypondBookPdf{})
816 @end itemize
817 @end ifset
818
819
820 @subsubheading Toutes versions
821 @c VO All versions
822
823 @itemize
824 @item @uref{http://lilypond.org/test,
825 Comparaison entre différentes versions}
826
827 @item @uref{http://lilypond.org/download/binaries/test-output/,
828 Archive de tous les tests de régression}
829
830 @end itemize
831
832 @divEnd
833 @divEnd
834
835
836 @divClass{column-center-bottom}
837 @subheading Manuels
838 @c VO Manuals
839
840 @ifclear web_version
841 @warning{Il s'agit des manuels pour LilyPond @version{} ; la
842 dernière mouture est consultable sur @url{http://lilypond.org}}
843 @end ifclear
844
845 @divClass{normal-table}
846 @multitable @columnfractions .3 .3 .3
847 @headitem Introduction
848
849 @item
850 @docLinkSplit{Initiation,learning,@manualDevelLearningSplit-fr}
851 @tab
852 @docLinkBig{Initiation,learning,@manualDevelLearningBig-fr}
853 @tab
854 @docLinkPdf{Initiation,learning,@manualDevelLearningPdf-fr}
855
856 @item
857 @docLinkSplit{Glossaire,music-glossary,@manualDevelGlossarySplit}
858 @tab
859 @docLinkBig{Glossaire,music-glossary,@manualDevelGlossaryBig}
860 @tab
861 @docLinkPdf{Glossaire,music-glossary,@manualDevelGlossaryPdf}
862
863 @item
864 @docLinkSplit{Essai,essay,@manualDevelEssaySplit-fr}
865 @tab
866 @docLinkBig{Essai,essay,@manualDevelEssayBig-fr}
867 @tab
868 @docLinkPdf{Essai,essay,@manualDevelEssayPdf-fr}
869 @end multitable
870
871 @multitable @columnfractions .3 .3 .3
872 @headitem Utilisation courante
873
874 @item
875 @docLinkSplit{Notation,notation,@manualDevelNotationSplit-fr}
876 @tab
877 @docLinkBig{Notation,notation,@manualDevelNotationBig-fr}
878 @tab
879 @docLinkPdf{Notation,notation,@manualDevelNotationPdf-fr}
880
881 @item
882 @docLinkSplit{Utilisation,usage,@manualDevelUsageSplit-fr}
883 @tab
884 @docLinkBig{Utilisation,usage,@manualDevelUsageBig-fr}
885 @tab
886 @docLinkPdf{Utilisation,usage,@manualDevelUsagePdf-fr}
887
888 @item
889 @docLinkSplit{Morceaux choisis,snippets,@manualDevelSnippetsSplit}
890 @tab
891 @docLinkBig{Morceaux choisis,snippets,@manualDevelSnippetsBig}
892 @tab
893 @docLinkPdf{Morceaux choisis,snippets,@manualDevelSnippetsPdf}
894 @end multitable
895
896 @multitable @columnfractions .3 .3 .3
897 @headitem Utilisation ponctuelle
898
899 @item
900 @docLinkSplit{Web,web,@manualDevelWebSplit-fr}
901 @tab
902 @docLinkBig{Web,web,@manualDevelWebBig-fr}
903 @tab
904 @docLinkPdf{Web,web,@manualDevelWebPdf-fr}
905
906 @item
907 @docLinkSplit{Nouveautés,changes,@manualDevelChangesSplit}
908 @tab
909 @docLinkBig{Nouveautés,changes,@manualDevelChangesBig}
910 @tab
911 @docLinkPdf{Nouveautés,changes,@manualDevelChangesPdf}
912
913 @item
914 @docLinkSplit{Extension,extending,@manualDevelExtendingSplit-fr}
915 @tab
916 @docLinkBig{Extension,extending,@manualDevelExtendingBig-fr}
917 @tab
918 @docLinkPdf{Extension,extending,@manualDevelExtendingPdf-fr}
919
920 @item
921 @docLinkSplit{Références internes,internals,@manualDevelInternalsSplit}
922 @tab
923 @docLinkBig{Références internes,internals,@manualDevelInternalsBig}
924 @tab
925 @docLinkPdf{Références internes,internals,@manualDevelInternalsPdf}
926 @end multitable
927
928 @ifset web_version
929 @multitable @columnfractions .3
930 @headitem En téléchargement
931
932 @item
933 @doctarballDevel
934 @end multitable
935 @end ifset
936
937
938 @divEnd
939 @divEnd
940
941
942 @node Google Summer of Code
943 @unnumberedsec Google Summer of Code
944 @translationof Google Summer of Code
945
946
947 @divClass{column-center-top}
948 @subheading Le Google Summer of Code
949 @c VO What is Google Summer of Code?
950
951 Le @uref{https://developers.google.com/open-source/gsoc/, GSoC} est un
952 programme global, mis en place par Google, qui rémunère des étudiants
953 durant la période estivale pour travailler au profit de projets
954 @emph{open source}.  Il s'agit là d'une excellente opportunité pour des
955 étudiants de vivre une expérience réelle dans le développement de
956 logiciels et contribuer ainsi au bien de tous.  Ceci permet aussi de
957 recruter de nouveaux contributeurs à LilyPond et motiver des étudiants
958 qui y participent déjà d'y être encore plus impliqués.  LilyPond
959 participe à ce programme sous l'égide du
960 @uref{http://www.gnu.org/, projet GNU}.
961
962 Nous avons eu des participants aux sessions de 2012 et 2015, et
963 encourageons les étudiants à candidater pour les sessions à venir.
964
965 Si vous avez des questions à ce sujet ou avez envie d'y participer,
966 contactez-nous sur la liste des développeurs (voir @ref{Contact}).
967
968 @divEnd
969
970
971 @divClass{column-center-middle-color2}
972 @subheading Recensement de nos idées
973 @c VO Project Ideas List
974
975 Voici les projets que nous avons proposés aux étudiants du GSoC 2012.
976 Nous avons décidé de maintenir en ligne cette page du site, comme source
977 d'inspiration pour ceux qui seraient intéressés au développement de
978 LilyPond.  Des membres de l'équipe de développement aideront volontiers
979 ceux qui aimeraient s'attaquer à l'un de ces projets.
980
981 Il y a bien d'autres choses à améliorer dans LilyPond et les membres de
982 l'équipe de développement aideront volontiers ceux qui aimeraient s'y
983 atteler.
984
985 Une liste exhaustive des problèmes est disponible
986 @uref{http://sourceforge.net/p/lilypond/issues/list, ici}.
987
988 @divEnd
989
990 @divClass{column-center-middle-color3}
991 @subheading ScholarLY
992
993 ScholarLY est une bibliothèque de
994 @uref{https://github.com/openlilylib/snippets, openLilyLib} qui fournit
995 des fonctionnalités permettant de gérer diresctement dans le contexte de
996 la partition le flux de travail d'une « édition savante ».  Il est à ce
997 jour possible de saisir différents types d'annotations, produire des
998 messages cliquables en console et exporter du texte dans des fichiers
999 @LaTeX{}.
1000
1001 Un certain nombre de demandes d'extension permettraient de transformer
1002 cette bibliothèque en un outil encore plus puissant et complet, par
1003 exemple par l'insertion d'exemples musicaux, la production de notes de
1004 bas de page ou l'application de styles particuliers -- mise en pointillé
1005 d'une liaison, mise entre parenthèses d'un altération, etc. -- ou la
1006 création de rapports avec des liens inter-documents.  Pour une
1007 description complète des suggestions autour de ce projet, visitez
1008 @uref{https://github.com/openlilylib/scholarly/wiki/GSoC}.
1009
1010 @strong{Difficulté :} moyenne
1011 @strong{Préalables :} Scheme, peut-être @LaTeX{}, (Python optionnel)
1012 @strong{Recommandé :} Expérience ou intérêt dans l'édition critique et
1013 les flux collaboratifs.
1014 @strong{Mentor potentiel :} Urs Liska
1015
1016 @divEnd
1017
1018 @divClass{column-center-middle-color3}
1019 @subheading Notes d'ornement @emph{(grace notes)}
1020
1021 Résolution des problèmes de synchronisation des notes d'ornement.  Les
1022 notes d'ornement peuvent venir perturber LilyPond dans sa gestion du
1023 temps et entraîner des effets indésirables tout particulièrement
1024 lorsqu'elles interviennent dans une portée seulement.
1025
1026 @strong{Difficulté :} moyenne
1027 @strong{Préalables :} C++, MIDI
1028 @strong{Recommandé :} familiarité avec les arcanes de LilyPond
1029 @strong{Mentors potentiels :} Mike Solomon, Carl Sorensen
1030
1031 @divEnd
1032
1033
1034 @divClass{column-center-middle-color3}
1035 @subheading MusicXML
1036
1037 Amélioration des fonctionnalités d'import et d'export :
1038
1039 @divClass{keep-bullets}
1040 @itemize
1041
1042 @item
1043 L'exportation d'un minimum d'informations musicales tel que cela se
1044 pratique déjà au niveau du MIDI, autrement dit à l'aide de classes
1045 d'exportateurs dérivées de la classe @emph{translator} ;
1046
1047 @item
1048 Construction de l'arborescence XML d'après le contenu musical de base, et
1049 connexion des éléments musicaux à des balises XML ;
1050
1051 @item
1052 Faire en sorte que tous les graveurs LilyPond restent pleinement
1053 opérationnels ;
1054
1055 @item
1056 Ajout d'une capacité de lier tout objet de rendu -- autrement dit chaque
1057 stencil ou groupe de stencils -- à l'élément musical qui en est la
1058 cause et, par voie de conséquence, à la balise correspondante dans
1059 l'arborescence XML ;
1060
1061 @item
1062 Ajout d'un moteur de rendu XML qui pourrait alors inclure l'information
1063 de mise en forme pour tout objet de rendu dans les  balises XML.
1064
1065 @end itemize
1066 @divEnd
1067
1068 @strong{Difficulté :} moyenne
1069 @strong{Préalables :} MusicXML, Python, les bases de LilyPond
1070 @strong{Mentors potentiels :} Reinhold Kainhofer, Mike Solomon
1071
1072 La connaissance d'autres éditeurs de partition, dans un but de tests
1073 comparatifs, constituerait une aide.
1074
1075 @divEnd
1076
1077
1078 @divClass{column-center-middle-color3}
1079 @subheading Amélioration des liaisons
1080
1081 Le galbe par défaut des liaisons n'est souvent pas pleinement
1082 satisfaisant.  La « coupure » d'une liaison par un changement de clef ou
1083 de ligne n'est pas totalement fonctionnelle.  Ce projet comporte entre
1084 autres un recensement d'exemples de résultats défectueux, l'appréciation
1085 du résultat optimal et l'écriture du code approprié.
1086
1087 @strong{Difficulté :} difficile
1088 @strong{Préalables :} C++, expérience dans l'écriture d'heuristiques
1089 @strong{Connaissances appréciées :} LilyPond, sens de l'esthétique
1090 @strong{Mentor potentiel :} Mike Solomon
1091
1092 @divEnd
1093
1094
1095 @divClass{column-center-middle-color3}
1096 @subheading Ajout de variantes pour certains glyphes
1097
1098 Il s'agit ici de pouvoir disposer de variantes, sur la ligne ou entre
1099 deux lignes, plus courts ou plus étroits, pour certains glyphes -- les
1100 altérations par exemple -- ainsi que d'une infrastructure générique de
1101 gestion.  Autre exemple, dans le domaine de la notation ancienne, avec
1102 deux variantes de la brève, l'une avec un évidement plus important que
1103 l'autre.
1104
1105 @divClass{keep-bullets}
1106 @itemize
1107
1108 @item
1109 Ajout de variantes positionnables « sur une ligne » et « dans un
1110 interligne ».
1111
1112 @end itemize
1113 @divEnd
1114
1115
1116 @strong{Difficulté :} facile
1117 @strong{Préalables :} MetaFont, C++, une bonne vue pour les détails
1118 @strong{Connaissance appréciée :} les bases de LilyPond
1119 @strong{Mentor potentiel :} Werner Lemberg
1120
1121 @divEnd
1122
1123
1124 @divClass{column-center-middle-color3}
1125 @subheading Amélioration du positionnement par défaut des ligatures
1126
1127 Une ligature, qu'elle soit rectiligne, passe d'une portée à l'autre,
1128 discontinue ou coudée, devrait dépendre du contexte et des notes
1129 adjacentes (voir
1130 @uref{http://icking-music-archive.org/lists/sottisier/sottigra.pdf,
1131 la section 2.2 de cet article}).  Dans la mesure du possible, raccourcir
1132 le temps de calcul nécessaire à la génération des ligatures.
1133
1134 @strong{Difficulté :} moyenne
1135 @strong{Préalables :} C++, expérience dans l'écriture d'heuristiques
1136 @strong{Connaissance appréciée :} sens de l'esthétique
1137 @strong{Mentors potentiels :} Mike Solomon, Carl Sorensen
1138
1139 @divEnd
1140
1141
1142 @divClass{column-center-middle-color3}
1143 @subheading Aide à l'amélioration du comportement lors de la compilation
1144
1145 Les outils d'analyse comme @emph{valgrind} pour la détection de fuites
1146 de mémoire ou @emph{callgrind} pour le profilage du code, fournissent
1147 des informations précieuses quant à d'éventuelles faiblesses du
1148 code C++.  Faire le ménage dans tous ces messages nous permettrait de
1149 rejeter tout patch qui introduirait des messages superflus.
1150
1151 @strong{Difficulté :} moyenne
1152 @strong{Préalable :} C++
1153 @strong{Mentors potentiels :} Joe Neeman, Reinhold Kainhofer
1154
1155 @divEnd
1156
1157
1158 @node Auteurs
1159 @unnumberedsec Auteurs
1160 @translationof Authors
1161
1162 @divClass{column-left-top}
1163 @subheading Équipe actuelle de développement
1164
1165 @divClass{keep-bullets}
1166 @developersCurrent
1167 @divEnd
1168 @divEnd
1169
1170 @divClass{column-right-top}
1171 @subheading Ceux qui ont participé dans le passé
1172
1173 @divClass{keep-bullets}
1174 @developersPrevious
1175 @divEnd
1176 @divEnd
1177
1178
1179 @divClass{column-center-top}
1180 @subheading Contributeurs actifs
1181
1182 @divClass{keep-bullets}
1183 @subsubheading Programmation
1184
1185 @coreCurrent
1186
1187 @subsubheading Fontes et polices
1188
1189 @fontCurrent
1190
1191 @subsubheading Documentation
1192
1193 @docCurrent
1194
1195 @subsubheading Résolution de bogue
1196
1197 @bugsquadCurrent
1198
1199 @subsubheading Support
1200
1201 @supportCurrent
1202
1203 @subsubheading Traduction
1204
1205 @translationsCurrent
1206
1207 @divEnd
1208 @divEnd
1209
1210
1211 @divClass{column-center-bottom}
1212 @subheading Ceux qui ont contribué
1213
1214 @divClass{keep-bullets}
1215 @subsubheading Programmmation
1216
1217 @corePrevious
1218
1219 @subsubheading Fontes et polices
1220
1221 @fontPrevious
1222
1223 @subsubheading Documentation
1224
1225 @docPrevious
1226
1227 @c    uncomment when we have any previous members -gp
1228 @c @subsubheading Résolution de bogue
1229
1230 @c @bugsquadCurrent
1231
1232 @subsubheading Support
1233
1234 @supportPrevious
1235
1236 @subsubheading Traduction
1237
1238 @translationsPrevious
1239
1240 @divEnd
1241 @divEnd
1242
1243
1244
1245 @node Remerciements
1246 @unnumberedsec Remerciements
1247
1248 @divClass{column-center-top}
1249 @subheading Remerciements
1250
1251 @divClass{keep-bullets}
1252 @acknowledgementsCurrent
1253 @divEnd
1254 @divEnd
1255
1256
1257 @node Publications
1258 @unnumberedsec Publications
1259 @translationof Publications
1260
1261 @divClass{column-center-top}
1262 @subheading Ce que nous avons écrit
1263
1264 @divClass{keep-bullets}
1265
1266 @include we-wrote.itexi
1267
1268 @divEnd
1269 @divEnd
1270
1271
1272 @divClass{column-center-bottom}
1273 @subheading Ce que certains ont fait avec LilyPond
1274
1275 @divClass{keep-bullets}
1276
1277 @include others-did.itexi
1278
1279 @divEnd
1280 @divEnd
1281
1282 @contactUsAbout{publications universitaires}
1283
1284
1285 @node Archives
1286 @unnumberedsec Archives
1287 @translationof Old news
1288
1289 @divClass{heading-center}
1290 @warning{Les vieilles annonces et informations de version sont rangées au
1291 @rwebnamed{Grenier,grenier}.}
1292 @divEnd
1293
1294 @include web/news-front.itexi
1295
1296 @include web/news.itexi
1297
1298
1299 @node Grenier
1300 @unnumberedsec Grenier
1301 @translationof Attic
1302
1303 @divClass{column-center-top}
1304 @subheading Annonces
1305
1306 Annonces et nouvelles, par version :
1307 @uref{http://lilypond.org/doc/v2.16/Documentation/web/index#Lilypond-2_002e16_002e0-released_0021-August-24_002c-2012-1,v2.16},
1308 @uref{http://lilypond.org/doc/v2.14/Documentation/web/index#LilyPond-2_002e14_002e0-released_0021-June-6_002c-2011,v2.14},
1309 @miscLink{announce-v2.12,v2.12},
1310 @miscLink{announce-v2.10,v2.10},
1311 @miscLink{announce-v2.8,v2.8},
1312 @miscLink{announce-v2.6,v2.6},
1313 @miscLink{announce-v2.4,v2.4},
1314 @miscLink{announce-v2.2,v2.2},
1315 @miscLink{announce-v2.0,v2.0},
1316 @miscLink{ANNOUNCE-1.2,v1.2 (2)},
1317 @miscLink{ANNOUNCE-1.0,v1.0},
1318 @miscLink{ANNOUNCE-0.1,v0.1}
1319
1320 Liste descriptive des évolutions, par version :
1321 @uref{http://lilypond.org/doc/v2.16/Documentation/changes/index.html,v2.16},
1322 @uref{http://lilypond.org/doc/v2.14/Documentation/changes/index.html,v2.14},
1323 @uref{http://lilypond.org/doc/v2.12/Documentation/topdocs/NEWS,v2.12},
1324 @uref{http://lilypond.org/doc/v2.10/Documentation/topdocs/NEWS,v2.10},
1325 @uref{http://lilypond.org/doc/v2.8/Documentation/topdocs/NEWS,v2.8},
1326 @uref{http://lilypond.org/doc/v2.6/Documentation/topdocs/NEWS,v2.6},
1327 @uref{http://lilypond.org/doc/v2.4/Documentation/topdocs/out-www/NEWS,v2.4},
1328 @uref{http://lilypond.org/doc/v2.2/Documentation/topdocs/out-www/NEWS,v2.2},
1329 @uref{http://lilypond.org/doc/v2.0/Documentation/topdocs/out-www/NEWS,v2.0},
1330 @uref{http://lilypond.org/doc/v1.8/Documentation/topdocs/out-www/NEWS,v1.8},
1331 @uref{http://lilypond.org/doc/v1.6/Documentation/out-www/NEWS,v1.6},
1332 @miscLink{NEWS-1.4,v1.4},
1333 @miscLink{NEWS-1.2,v1.2}
1334
1335 @divEnd
1336
1337 @divClass{column-center-bottom}
1338 @subheading Remerciements
1339
1340 Tous nos remerciements aux développeurs, contributeurs, chasseurs
1341 de bogue et à ceux qui nous ont fait part de leurs suggestions pour
1342 @miscLink{THANKS-2.16,v2.16},
1343 @miscLink{THANKS-2.14,v2.14},
1344 @miscLink{THANKS-2.12,v2.12},
1345 @miscLink{THANKS-2.10,v2.10},
1346 @miscLink{THANKS-2.8,v2.8},
1347 @miscLink{THANKS-2.6,v2.6},
1348 @miscLink{THANKS-2.4,v2.4},
1349 @miscLink{THANKS-2.2,v2.2},
1350 @miscLink{THANKS-2.0,v2.0},
1351 @miscLink{THANKS-1.8,v1.8}
1352
1353 @divEnd
1354
1355 @divClass{column-center-bottom}
1356 @subheading Journal des modifications
1357
1358 Notes des développeurs, par version :
1359 @miscLink{ChangeLog-2.10,v2.10},
1360 @miscLink{ChangeLog-2.3,v2.3},
1361 @miscLink{ChangeLog-2.1,v2.1},
1362 @miscLink{ChangeLog-1.5,v1.5 (1)},
1363 @miscLink{CHANGES-1.5,v1.5 (2)},
1364 @miscLink{CHANGES-1.4,v1.4},
1365 @miscLink{CHANGES-1.3,v1.3},
1366 @miscLink{CHANGES-1.2,v1.2},
1367 @miscLink{CHANGES-1.1,v1.1},
1368 @miscLink{CHANGES-1.0,v1.0},
1369 @miscLink{CHANGES-0.1,v0.1},
1370 @miscLink{CHANGES-0.0,v0.0}
1371
1372 @divEnd