Manuel:Création de pages avec du texte préchargé
Please note: Some techniques recommended in this article require the use of extensions. Exercise caution when using them, as the status of each extension is self-assigned by its maintainer, and does not reflect the opinion of the MediaWiki development team.
Rappelez vous : certaines techniques recommandées dans cet article nécessitent l'utilisation d'extensions. Faites preuve de prudence lors de leur utilisation car le statut de chaque extension est auto-attribué par son mainteneur et ne reflète pas le point de vue de l'équipe de développement de MediaWiki. |
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 :
- Concevoir le fichier de préchargement et ses modèles supportés
- Créer des pages pour les fichiers de préchargement et les modèles supportés
- 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§ion=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 balisesnoinclude, vous pouvez utiliserdans votre source : depuis que les deux balises du milieu sont supprimées (voir la suite), le texte préchargé se terminera avec le<no<includeonly></includeonly>include>
<noinclude>souhaité. - Les balises
<includeonly>et</includeonly>sont supprimées de la page source. Si le texte préchargé doit fournir les balisesincludeonly, vous pouvez utiliserdans votre source : puisque les deux balises du milieu seront supprimées, le texte préchargé se terminera avec le<include<includeonly></includeonly>only>
<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
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
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.
$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[].
Par exemple :
- https://mediawiki.org/wiki/Project:Sandbox?action=edit§ion=new&nosummary=true&preload=Manual:Creating_pages_with_preloaded_text/param_demo
- https://mediawiki.org/wiki/Project:Sandbox?action=edit§ion=new&nosummary=true&preload=Manual:Creating_pages_with_preloaded_text/param_demo&preloadparams%5b%5d=first%20value&preloadparams%5b%5d=second%20value
- https://mediawiki.org/wiki/Project:Sandbox?action=edit§ion=new&preload=MediaWiki:July (introduit dans 1.41)
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 :
- Extension:ArticleToCategory2 (non maintenu)
Toutes les extensions relatives à la création des pages sont dans Category:Extensions de création de pages.