Re: présentation du code (je me mêle de ce qui me regarde pas)

[Olivier Albiez]

Bonjour,

Je suis développeur et je forme des développeurs. La forme d'un code source est pour moi importante dans la transmission des intentions.

J'y vois en plus une analogie entre la précision de la gravure d'une partition qui est à destination du musicien et la précision de son code source à l'intention des "mainteneur" de la partition.

Bien sincèrement.

Le lun. 11 févr. 2019 à 09:36, Christian LE BARS <address@hidden> a écrit :

bonjour a tous.

Voila j'ai programmé pendant une quinzaine d'année, dans une entreprise.
(il y a longtemps)

Et la production logicielle nous obligeait à produire un code avec
toujours les mêmes règles de présentation.

Le programme principal se trouvait toujours en fin de listing.

chaque fonction écrite ne traitait que d'un seul sujet et n’excédait pas
une page.

chaque fonction,  avait une entête dans laquelle on trouvait une phrase
courte de description.

le libellé des variable utilisée. les différentes modifications datées,
apportées .

Si j'applique les règles au code Lilypond voila ce que cela donne:

je prends  pour exemple le code de Valentin (qui est tout bon, je
travaille sur la forme pas le contenu)

accords = \chordmode {
  d1:m6 f:m e:m9
}

mélodie = \relative c' {
  a'4_( b a' b)
  g,_( as g' as)
  fis,_( g fis'2)
}

\score {
  \header { piece = "Solo" }
  <<
    \new ChordNames \accords
    \new Staff \mélodie
  >>
}

\score {
  \header { piece = "Piano" }
  <<
    \new Staff \mélodie
    \new PianoStaff <<
      \new Staff \relative c' {
        <b f' a>1 <c f as> <b d fis g>
      }
      \new ChordNames \accords
      \new Staff \relative c {
        \clef bass
        d1 f2 c e,1
      }
    >>
  >>
}
Maintenant j'applique les règles que l'on m'a apprisent

accords =
\chordmode
{
  d1:m6 f:m e:m9
}
%---------------------------------------------
mélodie =
\relative c'
 {
  a'4_( b a' b)
  g,_( as g' as)
  fis,_( g fis'2)
 }
%---------------------------------------
\score
{
  \header { piece = "Solo" }
  <<
    \new ChordNames \accords
    \new Staff \mélodie
  >>
}
%------------------------------------------
\score
 {
  \header { piece = "Piano" }
  <<
    \new Staff
     \mélodie
    \new PianoStaff
     <<
      \new Staff
       \relative c' {<b f' a>1 <c f as> <b d fis g> }
      \new ChordNames
       \accords
      \new Staff
       \relative c
       {
        \clef bass
        d1 f2 c e,1
       }
    >>
  >>
}
une accolade qui s'ouvre
doit toujours avoir son accolade fermante au même niveau

Voila ce que j'ai appris. Mais peut être que cela est hors sujet.
c'est un détail, et ce forum est vraiment performant.
J'ai toujours eu de bonne réponse.
et merci à ceux qui accepte de répondre
Cordialement
Christian


_______________________________________________
liste de diffusion lilypond-user-fr
address@hidden
https://lists.gnu.org/mailman/listinfo/lilypond-user-fr