Re: to pitch or not to...

[John Mandereau]

Le mercredi 13 janvier 2010 à 12:18 +0100, John Mandereau a écrit :
> En tout cas merci pour
> cette contribution ; je m'excuse pour le retard, je vais l'examiner et
> l'intégrer dans la documentation existante dès que possible.

Il y a des idées intéressantes, j'ai ajouté mes commentaires sous forme
de notes dans le document ODT joint, si quelq'un a des difficultés à les
lire, je les reproduirai en texte brut par courriel.

Vu la taille de la documentation de LilyPond par rapport au temps de
travail disponible pour la maintenir et continuer à la développer, il
est indispensable, pour le meilleur et pour le pire, de respecter un tas
de règles que les développeurs et éditeurs de la doc ont approuvées, qui
sont données dans le Guide des contributeurs (en anglais).  Dans le
cadre de cette contribution cependant, deux règles suffiront :

- si on explique comment représenter un aspect de la notation musicale
avec LilyPond, il faut l'accompagner immédiatement d'un exemple -- cette
règle s'applique au manuels d'initiation et de notation ;

- il est préférable de modifier directement le fichier original, ça nous
facilite le travail, et vu le peu de temps de travail disponible pour
LilyPond c'est en pratique nécessaire pour intégrer ta contribution ;
essaie d'écrire du texte formaté en source Texinfo en t'inspirant du
code que ce que tu modifies, éventuellement en regardant ce que ça donne
en comparant avec la documentation déjà compilée, et sans jamais
chercher à tout comprendre ; si la moindre chose te rebute dans le
langage Texinfo, écris simplement du texte brut, je m'occuperai du
formatage.

Tu peux trouver le fichier source Texinfo à modifier sur
http://git.savannah.gnu.org/gitweb/?p=lilypond.git;a=blob_plain;f=Documentation/fr/learning/tutorial.itely;hb=c6bb7920c063448a48efc61c0137c273e3beaec7
et éventuellement (si tu veux voir où on parle des noms de notes en
italien)
http://git.savannah.gnu.org/gitweb/?p=lilypond.git;a=blob_plain;f=Documentation/fr/learning/common-notation.itely;hb=c6bb7920c063448a48efc61c0137c273e3beaec7

j'attends que tu nous renvoies le tutoriel avec tes modifications
d'après ta contribution initiale et les commentaires.  N'hésite pas à
abuser de la fonction rechercher de ton éditeur de texte favori pour
naviguer dans ces longs fichiers.


> > Je ne me rappelle pas si cette liste accepte les pièces jointes.
> 
> Oui, cf. la page d'infos sur la liste, dont l'adresse est indiquée en
> bas de chaque message qui parvient sur la liste.

Par contre, pourriez-vous tous à l'avenir envoyer des pièces jointe dans
un format ouvert s'il-vous-plaît ?  Si besoin, allez voir une définition
officielle en France sur
http://formats-ouverts.org/blog/2004/07/01/12-un-article-de-loi-definit-ce-que-sont-les-formats-ouverts
et plus à propos de ce site sur
http://formats-ouverts.org/blog/2006/03/15/742-c-est-votre-premiere-visite

Salutations lilyesques,
John

introduction_LilyPond_hauteurs.odt
Description: application/vnd.oasis.opendocument.text

signature.asc
Description: Ceci est une partie de message numériquement signée