Aide:Modèles

Un modèle est un ensemble de texte, d'images, de format et de mise en page qui peut être réutilisé sur plusieurs pages.

Pour des informations plus générales sur l’utilisation des modèles dans les projets Wiki, voyez Aide:Modèle sur Wikipédia.

Modèle et documentationModifier

Le code du modèle est dans l'espace de nom Modèle:. En cliquant sur « Modifier », on peut modifier le modèle. Contrairement aux autres projets, Wikisource en français ne contient pas de modèles protégés.

Le modèle est accompagné par une description présente dans la sous-page « /documentation ». Cette documentation présente le cas d'utilisation, la syntaxe, la liste de ses paramètres et des exemples.

Pour en savoir plus sur comment rédiger une documentation, consulter : Aide:Documentation des modèles.

Le contenu de la page de modèle :

  • pourra commencer par <includeonly> (sans aucun saut de ligne de part et d'autre) et se finir par </includeonly> (sans aucun saut de ligne de part et d'autre), s'il n'est pas possible d'en faire une visualisation immédiate sans erreurs générées, du fait de l'absence de certains paramètres (mais c'est déconseillé, on devrait toujours pouvoir afficher la page du modèle sans erreur, ce qui permet ensuite en cas de modifications ultérieure de prévisualiser immédiatement les modifications sans avoir d'abord à modifier la documentation) ;
  • devra ensuite être suivie immédiatement de <noinclude>{{Documentation}}</noinclude>.

CatégorisationModifier

La catégorisation d'un modèle se fera non pas dans le modèle principal mais dans sa sous-page « /documentation » (à l'emplacement mentionné par le modèle affiché qui invite à créer cette documentation), uniquement à la fin de cette sous-page entre les balises <includeonly> et </includeonly>). Ainsi placées, ces catégories indiquées pour le modèle principal n'auront aucun effet pour la sous-page de documentation elle-même.

Fonction d'un modèleModifier

Un modèle peut remplir différentes fonctions :

  • modifier la mise en forme du texte : gras, taille de police…
  • modifier la mise en page du texte : alignement, largeur de l'espace occupé, flottant…
  • ajouter une indication sur le texte : langue…
  • insérer un élément : séparateur, pointillés, tableau, image…

Pour en savoir plus sur les modèles existants, consulter : Aide:Liste des modèles.

Portée du modèleModifier

Wikisource est réparti dans plusieurs espaces de noms. Il y a notamment :

Problèmes liés à l’utilisation des modèlesModifier

En cas d’utilisation très importante des modèles sur une même page, le logiciel Mediawiki cesse d’insérer le texte produit par les modèles. Dans ce cas, le nom des modèles non exécutés apparaît directement sur la page (« Modèle:… »). Cette difficulté ne se rencontre que rarement, par exemple dans une page qui assure la transclusion d’un grand nombre de pages d'un livre qui, elles-mêmes, font un usage abondant des modèles. Il est alors nécessaire, soit de réduire l’utilisation des modèles, soit de transclure un nombre moins élevé de pages (par exemple en découpant le livre en chapitres et sections à un niveau plus fin).

Pour plus d’informations sur ce problème, voyez Aide:Limites de taille d’inclusion de modèles. Les pages concernées par ce problème sont catégorisées automatiquement dans Catégorie:Pages contenant trop d’inclusions de modèles.

Voir aussiModifier