Extension:Poem

This code base is maintained by the Reader Experience team. Code review only for UBNs or security fixes.

Manuel des extensions MediaWiki

Poem État de la version : stable
Implémentation	Balise
Description	Ajoute la balise ‎<poem> pour la mise en forme de poème
Auteur(s)	Nikola Smolenskidiscussion
Dernière version	mises à jour continues
MediaWiki	1.25+
Modifie la base de données	Non
Balises ‎<poem>
Accroches utilisées ParserFirstCallInit
Licence	Licence Creative Commons Zero v1.0 Universal
Téléchargement	Télécharger l'extension Git [?]: parcourir le dépôt (Phabricator · GitHub) relecture Gerrit du code historique Git des validations (commits) Télécharger le tarball source
Traduire l’extension Poem sur translatewiki.net si elle y est disponible
Problèmes	Tâches ouvertes · Signaler un bogue

L'extension Poem permet de mettre en forme facilement des poèmes ou du matériel similaire à l'intérieur de Wikitexte . Une fois l'extension activée, vous pouvez mettre n'importe quel bloc de texte entre des balises ‎<poem>‎</poem> et obtenir les effets suivants :

• toutes les nouvelles lignes sont préservées en les convertissant en balises ‎<br />
• le bloc de texte est encadré avec des balises ‎<p>...‎</p> (ainsi qu'un div de classe poem)
• les virgules du début de ligne sont converties en indentation de 1em.
• Les espaces de début de ligne sont conservés et n'appellent plus la balise ‎<pre>

L'extension préserve les liens wiki, la mise en gras, etc. s'ils sont présents dans le poème.

Wikisource fournit le meilleur modèle d'utilisation pour cette extension. Il utilise plusieurs modèles et un module pour créer les indentations, les numéros de lignes, etc. Voir Wikisource:Help:Poetry pour une explication sur la manière dont il y est utilisé. Cela nécessite Extension:Scribunto et Extension:TemplateStyles , qui sont maintenant livrés en standard.

<poem>
In [[Wikipedia:Xanadu|Xanadu]] did Kubla Khan
A stately pleasure-dome decree:
Where Alph, the sacred river, ran
Through caverns measureless to man
Down to a sunless sea.

So twice five miles of fertile ground
With walls and towers were girdled round:
And there were gardens bright with sinuous rills,
Where blossomed many an incense-bearing tree;
And here were forests ancient as the hills,
Enfolding sunny spots of greenery.
</poem>

<poem>
Une terre au flanc maigre, âpre, avare, inclément
Où les vivants pensifs travaillent tristement, 
::Et qui donne à regret à cette race humaine
Un peu de pain pour tant de labeur et de peine ; 
::Des hommes durs, éclos sur ces sillons ingrats ; 
Des cités d’où s’en vont, en se tordant les bras, 
::La charité, la paix, la foi, sœurs vénérables ; 
L’orgueil chez les puissants et chez les misérables ; 
</poem>

Le texte du poème est encadré avec div, qui n'a pas de style par défaut; mais hérite de toute option style ou class passée au poème.

Par exemple, si le texte indenté peut être utilisé pour des exemples simples pour empêcher le remplissage et dessiner une belle boîte bleue, il peut être difficile à lire dans certains cas, car les longues lignes ne sont pas fractionnées. Un effet similaire mais un peu meilleur, peut être obtenu avec :

<poem style="border: 2px solid #d6d2c5; color: var(--color-base, #202122); background-color: var(--background-color-warning-subtle, #fdf2d5); padding: 1em;">

Lorsqu'il est appliqué à l'exemple ci-dessus, le résultat est le suivant :

En appliquant la balise ‎<poem> avec l'option compact à un texte de plus de deux lignes, chaque ligne devient un paragraphe séparé. (c'est-à-dire qu'il permet un marquage plus compact, sans réduire la sortie pour autant).

L'utilisation ultérieure de la balise ‎<poem> avec l'option compact avec jusqu'à deux passages à la ligne intermédiaires génère seulement une nouvelle ligne entre les textés, et non pas un nouveau paragraphe.

Ainsi, lorsqu'il est appliqué aux textes de plus de deux lignes chacun, chaque ligne devient un paragraphe distinct, sauf que la dernière ligne de chaque texte et la première ligne du texte suivant sont combinées en un paragraphe.

<poem>
One,
Two.
</poem>
<poem>
Three?
Four!
</poem>

<poem compact>
One,
Two.
</poem>
<poem compact>
Three?
Four!
</poem>

<poem>
One,
Two.
Extra.
</poem>
<poem>
Three?
Four!
Extra.
</poem>

<poem compact>
One,
Two.
Extra.
</poem>
<poem compact>
Three?
Four!
Extra.
</poem>

• Les variables et ParserFunctions fonctionnent dans le conteneur ‎<poem>...‎</poem>, mais PAS dans la balise <poem ... > elle-même; cela évite les modèles avec du code tel que <poem style="{{{1}}}">.
• Une solution est d'utiliser <div style="{{{1}}}"><poem> ... </poem></div> à la place.
• Une autre façon est d'utiliser le mot magique #tag : {{#tag:poem| ... |style="{{{1}}}"}}.
  • NB : cependant, cela ne semble pas fonctionner avec l'option compact.

<poem style="{{{1|border: 1px solid Black;}}}">
One,
{{{2|Two.}}}
</poem>

<div style="{{{1|border: 1px solid Black;}}}">
<poem>
One,
{{{2|Two.}}}
</poem>
</div>

{{#tag:poem|
One,
{{{2|Two.}}}
|style="{{{1|border: 1px solid Black;}}}"
}}

• Téléchargez et placez le(s) fichier(s) dans un répertoire appelé Poem dans votre dossier extensions/.
  Les développeurs et les contributeurs au code doivent à la place installer l'extension à partir de Git en utilisant:

  cd extensions/
  git clone https://gerrit.wikimedia.org/r/mediawiki/extensions/Poem
  

• Ajoutez le code suivant à la fin de votre fichier LocalSettings.php  :

  wfLoadExtension( 'Poem' );
  

• Fait – Accédez à Special:Version sur votre wiki pour vérifier que l'extension a bien été installée.

Installer Vagrant :

• Si vous utilisez Vagrant , installez avec vagrant roles enable poem --provision

Cette extension est utilisée par au moins un des projets Wikimédia. Cela signifie probablement que l’extension est assez stable et fonctionnelle pour être utilisée sur des sites à fort trafic. Recherchez le nom de cette extension dans le CommonSettings.php de Wikimédia et dans le fichier de configuration InitialiseSettings.php pour situer les endroits où elle est installée. Une liste complète des extensions installées sur un Wiki donné peut être visualisée sur la page Special:Version de ce wiki.

Cette extension est incluse dans les fermes de wikis ou les hôtes suivants et / ou les paquets : BlueSpice Canasta Debian Fandom Miraheze MyWikis ProWiki semantic::core ShoutWiki Telepedia Weird Gloop wiki.gg