Modèle:Pre/Documentation

Ce modèle sert à insérer une balise HTML <pre>. Le contenu du modèle est évalué normalement par MediaWiki, contrairement à ce qui se passe lors de l'utilisation directe de la balise <pre>.

Utilisation modifier

Balisage Rendu
{{Pre|
Ce préformatage

peut ressembler

à ceci.
}} 
Ce préformatage

peut ressembler

à ceci.

Les différences principales comprennent:

  • Le fait que cela englobe le texte qui déborde de la page.
  • Le fait que cela permette les sauts à la ligne (mais pas de manière fiable).

Les limitations principales comprennent:

  • Si le texte n'est qu'un seul long mot, il ne sera pas englobé dans le cadre et va quand même déborder du côté droit de la page.
  • Le HTML et le Wikicode ne sont désactivés comme dans <pre> et sont affichés comme à l'ordinaire (par conséquent, si un paramètre contient du wikicode, insérez-le dans <nowiki>) ; de même, les espaces multiples sont traités comme étant un seul.
  • S'il n'y a que deux lignes, elles seront collées ensembles, même si le code source a une ligne vide entre elles.

Comme avec <pre> et <code>, {{pre}} affiche le texte dans la police spécifiée comme étant la police à chasse fixe dans les options du navigateur de l'utilisateur, ou celle qui est spécifiée dans les feuilles CSS de l'utilisateur.

Exemple modifier

Code source

{{Pre|
'''Première ligne, code fonctionne :''' et commentaire HTML <!--CACHÉ--> caché.

'''Deuxième ligne, inclusion d'un texte long :''' Lorem ipsum dolor sit amet, consectetur adipiscing elit, sed do eiusmod tempor incididunt ut labore et dolore magna aliqua. Ut enim ad minim veniam, quis nostrud exercitation ullamco laboris nisi ut aliquip ex ea commodo consequat. Duis aute irure dolor in reprehenderit in voluptate velit esse cillum dolore eu fugiat nulla pariatur. Excepteur sint occaecat cupidatat non proident, sunt in culpa qui officia deserunt mollit anim id est laborum

'''Troisième ligne avec une barre verticale | nue, qui est prise en charge''', mais l'espace avant la barre est perdu. Jusqu'à 19 barres verticales sont prises en charge, sinon il faut utiliser {{!}} et {{!}} cela {{!}} fonctionne.

'''Quatrième      ligne,     les espaces multiples s'affaissent en un seul''' comme en HTML et en Wikitexte.
'''Fifth line, stuck with the previous one''' if no blank line between them.

'''Dernière ligne''', est autonome, avec ou sans ligne vierge.
}}
Résultat
Première ligne, code fonctionne : et commentaire HTML  caché.

Deuxième ligne, inclusion d'un texte long : Lorem ipsum dolor sit amet, consectetur adipiscing elit, sed do eiusmod tempor incididunt ut labore et dolore magna aliqua. Ut enim ad minim veniam, quis nostrud exercitation ullamco laboris nisi ut aliquip ex ea commodo consequat. Duis aute irure dolor in reprehenderit in voluptate velit esse cillum dolore eu fugiat nulla pariatur. Excepteur sint occaecat cupidatat non proident, sunt in culpa qui officia deserunt mollit anim id est laborum

Troisième ligne avec une barre verticale| nue, qui est prise en charge, mais l'espace avant la barre est perdu. Jusqu'à 19 barres verticales sont prises en charge, sinon il faut utiliser {{!}} et | cela | fonctionne.

Quatrième      ligne,     les espaces multiples s'affaissent en un seul comme en HTML et en Wikitexte.
Fifth line, stuck with the previous one if no blank line between them.

Dernière ligne, est autonome, avec ou sans ligne vierge.

Voir aussi modifier

  • {{pre2}}, un modèle avec une fonction similaire mais qui rend l'inclusion des lignes et des barres de défilement facultatives.
  • <syntaxhighlight>
  • <pre>