Plugin Lilyspip

Insérer des notations musicales dans vos articles

Le plugin Lilyspip permet d’insérer des notations musicales dans les articles et les forums d’un site sous SPIP en utilisant le logiciel libre Lilypond.

Site exemple : Musicorum.

Ce plugin est développé sur la zone et donc disponible par svn ou dans les snapshots.

Inspiré de la gestion des formules mathématiques de SPIP, il fonctionne en client/serveur avec un système de double cache.

Le serveur

Pour une question de sécurité la commande Lilypond est exécutée en mode safe ce qui en limite les fonctionnalités (include et importations de variables impossibles).

Le serveur ainsi que la procédure d’installation sont disponibles dans le dossier « install_server » du plugin. Si vous mettez en place votre propre serveur et souhaitez le rendre public, merci de le signaler sur le forum ci-dessous.

Les fichiers images PNG et MIDI sont générés par la commande puis sauvegardés dans le dossier cache du serveur.

Le client

Il faut spécifier l’adresse du serveur dans les paramètres du plugin et une image de test avec la version de Lilypond installée sur le serveur doit s’afficher :

Le code doit être saisi de la façon suivante :

<lilypond>
\score{
{a b c d}
\layout{}
\midi{}
}
</lilypond>

Si le serveur est installé en mode safe, il est nécessaire d’utiliser la notation anglaise pour le nom des notes :

Do Mi Fa Sol La Si
c d e f g a b

Une documentation partiellement traduite de Lilypond est accessible ici.

L’image apparait avec un lien vers le fichier MIDI et le code lilypond dans la description de l’image (attribut alt). Tous les fichiers sont conservés dans le dossier « local/cache-Lilypond » pour que le plugin ne fasse pas appel au serveur à chaque actualisation.


Pour encadrer et centrer l’image obtenue vous pouvez ajouter à votre feuille de style les lignes suivantes :

.lilypond {
	text-align:center;
	padding: 5px; 
	}
			
.lilypond img{
	border: 1px solid #BFBFBF;
	} 

Discussion

Aucune discussion

Ajouter un commentaire

Avant de faire part d’un problème sur un plugin X, merci de lire ce qui suit :

  • Désactiver tous les plugins que vous ne voulez pas tester afin de vous assurer que le bug vient bien du plugin X. Cela vous évitera d’écrire sur le forum d’une contribution qui n’est finalement pas en cause.
  • Cherchez et notez les numéros de version de tout ce qui est en place au moment du test :
    • version de SPIP, en bas de la partie privée
    • version du plugin testé et des éventuels plugins nécessités
    • version de PHP (exec=info en partie privée)
    • version de MySQL / SQLite
  • Si votre problème concerne la partie publique de votre site, donnez une URL où le bug est visible, pour que les gens puissent voir par eux-mêmes.
  • En cas de page blanche, merci d’activer l’affichage des erreurs, et d’indiquer ensuite l’erreur qui apparaît.

Merci d’avance pour les personnes qui vous aideront !

Par ailleurs, n’oubliez pas que les contributeurs et contributrices ont une vie en dehors de SPIP.

Qui êtes-vous ?
[Se connecter]

Pour afficher votre trombine avec votre message, enregistrez-la d’abord sur gravatar.com (gratuit et indolore) et n’oubliez pas d’indiquer votre adresse e-mail ici.

Ajoutez votre commentaire ici

Ce champ accepte les raccourcis SPIP {{gras}} {italique} -*liste [texte->url] <quote> <code> et le code HTML <q> <del> <ins>. Pour créer des paragraphes, laissez simplement des lignes vides.

Ajouter un document

Suivre les commentaires : RSS 2.0 | Atom