Extension:Score/fr

L'extension Score permet l'affichage de partitions musicales en tant qu'images PNG en utilisant LilyPond et peut aussi les transformer en fichier audio ou MIDI.

Remerciements

 * La version originale de a été écrite par Johannes E. Schindelin.
 * Cette extension est basée sur une revue du code de l' par Tim Starling.
 * La version originale de a été écrite par River Tarnell.

Utilisation
Après l'installation, vous pouvez intégrer du code LilyPond simple dans votre wikitext en l'entourant avec des balises . Par exemple :

donne :

Vous pouvez aussi préciser les attributs dans les balises score, sous la forme générale

.

Par exemple :

donne :

Les attributs suivants sont disponibles :

Le langage LilyPond
Les paroles peuvent être ajoutées de cette manière :

Pour les utilisateurs avancés, la commande peut être utilisée pour faire jouer un autre instrument MIDI.

Pré-requis
The following packages are recommended:


 * LilyPond
 * Ghostscript
 * ImageMagick
 * FluidSynth
 * Firejail

Cette extension utilise Lilypond pour générer les images des partitions de musique, donc vous il faut que Lilypond soit installé et opérationnel (Special:Version affiche la version de LilyPond). If you install LilyPond from a package, Ghostscript will also be installed, since LilyPond depends on Ghostscript. ImageMagick should be installed to trim the images, otherwise they will contain an excessive amount of whitespace.

For security reasons, it is highly recommended to install firejail to further restrict what LilyPond and Ghostscript can do if untrusted users are allowed to edit your wiki.

L'extension est également capable de créer des fichiers audio à partir des fichiers MIDI générés par Lilypond. Si vos souhaitez utiliser cette fonctionnalité, vous devez installer.

FluidSynth is the preferred method to convert MIDI files to audio files, however TiMidity++ is also supported.

Security concerns
Score uses LilyPond in safe mode, however there are known unfixed safe mode escape vulnerabilities leading to arbitrary execution.

If you don't absolutely trust everyone who has editing privileges on your wiki, it is strongly recommended to set up containment of lilypond using. See Shellbox#Server setup for details on how to set up the contained server, and below for configuring MediaWiki to use it. Also, ensure you're using a recent version of LilyPond (2.22.0+) or a distribution package (e.g. from Debian) that has security fixes. Keep safe mode enabled, even with containment as an extra layer of defense. Certain functionality will not work in safe mode, the fix for that is to modify LilyPond to allow that functionality in safe mode.

Installation

 * See the extension's  for detailed installation instructions.

Configuration
L'extension possède actuellement les paramètres de configuration globaux suivants.

$wgScoreLilyPond
Initialisez la variable  avec le chemin de votre exécutable LilyPond (typiquement   ou  ).

$wgScoreTrim
La variable  est un booléen qui a par défaut la valeur de. S'il est à  (vrai), les images PNG de la partition résultante sont retaillées avec ImageMagick. Si vous ne désirez pas de recadrage ou ne désirez pas installer ImageMagick, réglez  à   (faux).

$wgScoreAbc2Ly
Initialisez  avec le chemin de l'exécutable du convertisseur ABC vers LilyPond (typiquement   ou  ).

$wgScoreFluidsynth
Initialisez  avec le chemin de votre exécutable Fluidsynth (typiquement   ou  ).

$wgScoreSoundfont
Initialisez  avec le chemin de votre fichier soundfont (typiquement   ou  ).

$wgScoreLame
Initialisez  avec le chemin de votre exécutable Lame (typiquement   ou  ). Nécessaire si le fichier audio généré doit être au format MP3.

Remarques
Cette extension exécute divers binaires dans un shell. Si vous avez des erreurs de dépassement mémoire, il faudra peut-être augmenter la valeur de.

Rechercher des partitions
Les pages incluant des partitions ont la propriété de page « score » activée. Vous pouvez rechercher les pages incluant une partition en utilisant la Special:PagesWithProp ([//en.wikipedia.org/wiki/Special:PagesWithProp?propname=score&propname-other= Exemple de recherche pour la Wikipédia anglophone]).

Voir également

 * Help:Score sur la Wikipedia anglophone et la Partition musicale sur Wikisource donnent plus d'exemples de syntaxe LilyPond.
 * Vexflow Générateur de musique SVG/Canvas open source
 * notation LilyPond
 * notation ABC
 * dépot github vexflow