Extension:Score/fr

L’extension Score permet le rendu 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 wikicode en l’encadrant 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
Les paquets suivants sont recommandés :


 * LilyPond
 * Ghostscript
 * ImageMagick
 * FluidSynth
 * Firejail

Cette extension utilise Lilypond pour effectuer le rendu des images des partitions musicales, donc il faut que Lilypond soit installé et opérationnel (Special:Version affiche la version de LilyPond). Si vous installez LilyPond depuis un paquet logiciel, Ghostscript sera également installé puisque LilyPond dépend de Ghostscript. ImageMagic devrait être installé pour rogner les images, sinon elles contiendront des marges blanches excessives.

Pour des raisons de sécurité, il est vivement recommandé d’installer firejail pour restreindre davantage ce que peuvent faire LilyPond et Ghostscript si des utilisateurs non approuvés sont autorisés à modifier votre 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 est la méthode préférée pour convertir des fichiers MIDI en fichiers audio, cependant TiMidity++ est également pris en charge.



Problèmes de sécurité
Score utilise LilyPond en mode sûr, cependant il existe des vulnérabilités connues non résolues d’échappement au mode sûr, pouvant conduire à une exécution arbitraire.

Si vous ne pouvez faire confiance à quiconque qui dispose de privilèges de modification sur votre wiki, il est vivement recommandé de configurer le confinement de LilyPond en utilisant. Voir Shellbox#Server setup pour les détails sur la façon de configurer le serveur confiné et ci-dessous pour configurer MediaWiki afin qu’il l’utilise. Également, assurez-vous que vous utilisez une version récente de LilyPond (2.22.0+) ou un paquet de distribution (par exemple de Debian) qui fournit des correctifs de sécurité. Garder activé le mode sûr, même avec le confinement ajouté comme une couche supplémentaire de défense. Certaines fonctionnalités ne marcheront pas avec le mode sûr, le moyen de le corriger est de modifier LilyPond pour autoriser ces fonctionnalités en mode sûr.

Installation

 * See the extension's  for detailed installation instructions.

Configuration
Voici quelques un des paramètres globaux de configuration de l’extension :

$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 rognées avec ImageMagick. Si vous ne désirez pas ce rognage ou ne désirez pas installer ImageMagick, réglez   à   (faux).

$wgScoreAbc2Ly

 * Initialisez  avec le chemin de l’exécutable du convertisseur de notation ABC en 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 en les confinant avec Shellbox, qui fournit plus de sécurité. Si vous avez des erreurs de « mémoire insuffisante », 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 l’édition anglophone de Wikipédia]).



Voir également

 * Aide:Partitions sur Wikipédia et Wikisource:Partitions sur Wikisource donnent davantage d’exemples de la syntaxe LilyPond.
 * Vexflow Générateur open source de rendu en SVG / Canvas pour la musique
 * notation LilyPond
 * notation ABC
 * dépot Github pour vexflow