Jump to content

Manuel:Création de pages avec du texte préchargé

From mediawiki.org
This page is a translated version of the page Manual:Creating pages with preloaded text and the translation is 100% complete.

Le préchargement de wikitexte présente à l'utilisateur une page partiellement créée, éventuellement avec des instructions en ligne pour l'organisation du contenu, plutôt qu'une page vierge. Cette technique est particulièrement utile lorsque le wiki contient une ou plusieurs catégories d'articles, avec beaucoup de texte pro-forma ou les informations qui doivent être collectées pour de tels articles sont un mélange de données structurées et de texte de forme libre.

La création de pages avec du texte préchargé est un processus en trois étapes :

  1. Concevoir le fichier de préchargement et ses modèles supportés
  2. Créer des pages pour les fichiers de préchargement et les modèles supportés
  3. Configurer le déclencheur pour charger le fichier de préchargement

Conception du fichier de préchargement

Le fichier de préchargement est souvent un article avec un modèle intégré. Par exemple, si vous souhaitez un article pour chaque client ou contact commercial, vous souhaiterez peut-être précharger un texte ressemblant à l'exemple ci-dessous.

   <!-- Veuillez saisir les coordonnées de votre client après le signe égal.
        Si vous avez besoin d'aide pour téléverser les images de la carte de visite, veuillez consulter [[Help:Uploading business card images]]
   -->
   {{CustomerContact
   |Number=
   |BizcardImage=
   |Primary phone number=
   |Address=
   }}

Nommer et documenter le fichier de préchargement

Certaines extensions ont des attentes spécifiques quant à l'emplacement de stockage du texte préchargé. D'autres laissent cette décision entièrement à la charge de l'administrateur système.

Nommer et documenter le fichier de préchargement nécessite un certain soin, car les fichiers de préchargement n'apparaissent pas toujours sur "Quels liens ici" et risquent donc d'être supprimés accidentellement (pas d'informations / pas de liens - difficile à dire à partir d'un article qui a été créé et abandonné). Pour les fichiers de préchargement basés sur des modèles, les conventions de nommage suivantes peuvent aider à éviter une suppression accidentelle :

  • mettre le modèle dans Template:CategoryName
  • mettre le fichier de préchargement dans Template:CategoryName/Preload

Chargement du fichier de préchargement

Le préchargement peut être obtenu avec un paramètre preload dans l'URL telle que http://en.wikipedia.org/wiki/Talk:Main_Page?action=edit&section=new&preload=Template:Foo qui pointe vers la boîte d'édition d'une nouvelle page, préchargée avec Template:Foo. Certaines extensions vous permettent aussi de déclencher votre fichier de préchargement, voir ci-dessous.

Le wikicode de la page source est préchargé dans la boîte d'édition si la page ou la section n'existent pas encore. Si la page ou la section à éditer existe déjà, alors seul son wikicode est chargé et la commande de préchargement est ignorée.

  • les balises ‎<noinclude> et ‎</noinclude> sont supprimées; si le texte préchargé doit fournir les balises noinclude , vous pouvez utiliser
    <no<includeonly></includeonly>include>
    
    dans votre source : depuis que les deux balises du milieu sont supprimées (voir la suite), le texte préchargé se terminera avec le ‎<noinclude> souhaité.
  • Les balises ‎<includeonly> et ‎</includeonly> sont supprimées de la page source. Si le texte préchargé doit fournir les balises includeonly, vous pouvez utiliser
    <include<includeonly></includeonly>only>
    
    dans votre source : puisque les deux balises du milieu seront supprimées, le texte préchargé se terminera avec le ‎<includeonly> souhaité.

Ainsi il n'y a ni inclusion complète, ni transclusion régulière. Voir aussi T7210 (depuis le 2006-03-09).

Si une nouvelle section est créée, le contenu initial de la boîte Sujet/titre peut être obtenu avec le paramètre preloadtitle

http://meta.wikimedia.org/w/wiki.phtml?title=Meta:Sandbox&action=edit&section=new&preloadtitle=New_Header

S'il ne s'agit pas de créer une nouvelle section, le résumé peut être défini dans le paramètre summary. (T19002)

http://meta.wikimedia.org/w/wiki.phtml?title=Meta:Sandbox&action=edit&summary=Doing%20some%20changes

La case à cocher pour l'édition mineure peut être initialisée en ajoutant le paramètre minor

http://meta.wikimedia.org/w/wiki.phtml?title=Meta:Sandbox&action=edit&minor=1

Utiliser les paramètres

Version de MediaWiki :
1.23

Avec le paramètre d'URL preloadparams[] , vous pouvez passer des paramètres au texte préchargé. (pour créer un lien vers le wiki, vous pouvez échapper le [] pour obtenir %5b%5d). A chaque insertion de parameter[] dans l'URL (dans l'ordre) correspond une variable suivant l'ordre numérique : par exemple la première occurrence remplace la variable $1, la seconde $2, ainsi de suite.

les variables $1, $2, ... sont différentes des variables {{{1}}}, {{{2}}}, ...

Pour utiliser preloadparams[], le modèle doit utiliser obligatoirement les variables $1, $2, ... au lieu des paramètres {{{1}}}, {{{2}}}, ... qui ne sont pas liées à la fonctionnalité preloadparams[].

Cette documentation doit être améliorée en expliquant pourquoi ces deux modèles différents de notation des paramètres de modèle existent, et quand il est possible ou nécessaire d'utiliser chacune des deux notations.

Par exemple :

Extensions

Les extensions qui déclenchent un fichier de préchargement comprennent :

  • Extension:Inputbox (stable, livré avec MediaWiki) - Ceci couvre la plupart du contrôle sur le processus de chargement. Cela vous permet de placer un bouton quelque part dans un article, typiquement sur une page d'aide ou la page de la catégorie correspondant à l'article. Ajouter le nom du fichier de préchargement dans la définition du bouton.
  • Extension:NamespacePreload (stable)
  • Extension:MultiBoilerplate (stable)
  • Extension:Page Forms (stable) - Ceci peut simplement précharger une page d'article, en plus des fonctionnalités de ses formulaires.
  • Extension:Preloader (non maintenu)

Quelques extensions gèrent également pour vous les trois étapes :

Toutes les extensions relatives à la création des pages sont dans Category:Extensions de création de pages .

Voir aussi