Projet Phabricator : [[phab:tag/{{{phabricator}}}/|#{{{phabricator}}}]]

Modèle:Habillage

From MediaWiki.org
Jump to navigation Jump to search
This page is a translated version of the page Template:Skin and the translation is 100% complete.
Other languages:
Deutsch • ‎English • ‎Türkçe • ‎dansk • ‎español • ‎français • ‎magyar • ‎polski • ‎português • ‎português do Brasil • ‎فارسی • ‎中文 • ‎日本語
Documentation du modèle

Ce modèle doit être ajouté sur la page principale de chacun des habillages du wiki afin d'afficher une boîte d'informations et catégoriser l'habillage courant.

Utilisation

Copier-coller :

{{Skin|templatemode =
|name            = 
|status          = 
|hook1           = 
|hook2           = 
|newhook1        = 
|newhook2        = 
|username        = 
|author          = 
|description     = 
|image           = 
|imagesize       = 
|version         = 
|update          = 
|version preview = 
|update preview  = 
|mediawiki       = 
|php             = 
|composer        =
|license         = 
|download        = 
|readme          = 
|changelog       = 
|example         = 
|parameters      = 
|compatibility   = 
|bugzilla        = 
|phabricator =
}}

Pour obtenir de l'aide sur la valeur des paramètres, voir ci-dessous.

Manuel des habillages MediaWiki - catégorie
Crystal Clear device blockdevice.png
{{{name}}}
État de la version : inconnu
Placeholder.png
Description {{{description}}}
Auteur(s) SomeAuthor
Version actuelle : {{{version}}} ({{{update}}})
Version actuelle de développement {{{version preview}}} ({{{update preview}}})
MediaWiki {{{mediawiki}}}
PHP {{{php}}}
Composer {{{composer}}}
Licence {{{license}}}
Téléchargement {{{download}}}
{{{readme}}}
{{{changelog}}}
Exemple {{{example}}}
Paramètres
{{{parameters}}}
{{{compatibility}}}
Traduisez l'habillage Skin sur translatewiki.net
Problèmes : [[phab:tag/{{{phabricator}}}|Tâches ouvertes]] · Signaler un bogue


Paramètres de contenu

Cette section décrit les paramètres qui contrôlent le contenu de la boîte d'information. Pour l'aide concernant templatemode et les autres paramètres de contrôle, voir Paramètres de contrôle.

Content parameters
Parameter Description
namename of the skin
statuscurrent release status

One of:

  • unstable (broken - do not use this extension)
  • experimental (early stages of development, may change drastically)
  • beta (stable but not fully tested)
  • stable (stable version)
  • unmaintained (unmaintained - previously claimed to be stable, now unmaintained)
  • unavailable (code is unreleased/lost/etc.)
  • unknown (default)

If the status is anything other than the above, it will be ignored and the default value of 'Unknown' will be displayed in the template instead.

hook1
hook2
hook3
hook4
...
hook90
nom de chaque accroche utilisée par l'extension

En plaçant des valeurs dans ce champ, vous exposerez davantage votre extension et aiderez les autres développeurs. Chaque accroche documentée ajoutera automatiquement l'extension à une catégorie qui liste l'ensemble des extensions qui utilisent cette accroche. Cette catégorie et auto-liée à chaque page d'accroche de sorte que les programmeurs puissent facilement trouver des exemples d'extensions qui utilisent une accroche particulière.

Pour les accroches intégrées :

  • utilisez le nom de l'accroche seul. Voir Manual:Hooks pour les valeurs (mais omettez le '/' de début).

Pour les accroches personnalisées définies par les extensions :

  • utilisez extensionName/hookName. Pour une liste partielle d'accroches personnalisées, voir Extension hook registry.
Pour les accroches multiples, assignez la première accoche à hook1, la seconde à hook2 et ainsi de suite.
newhook1
newhook2
newhook3
newhook4
...
newhook90
nom de chaque accroche fournie par l'extension Vous pouvez également ajouter les accroches dans Extension hook registry.
usernameThe author's username on MediaWiki.org (if they have one). May be omitted, but if present it will be used to link to the author's user & user_talk page. It should be provided without namespace and without [[]]s.
authorThe skin author's name, if different from their MediaWiki.org username. Free text. If omitted then the 'username' field will be used (if present).
descriptionshort description
imagescreenshot or logo of skin. It should be provided without namespace and without [[]]s.
imagesizefacultative, size of the image (default size is 220px)
versionlast version
updatedate of the last update
mediawikirequired version of MediaWiki
phprequired version of PHP
licenselicense(s) governing use of this skin, e.g. GPL
downloadlink to the download : If you put the code into page in the MediaWiki wiki, link to it using a full page name and section name, e.g. [[Skin:Example/version_1.22a#Code]] (it must remain valid when bot-copied elsewhere)
readmeexternal link to the readme file
changelogexternal link to the changelog file
parametersavailable parameters for LocalSettings.php
exampleexample, website or screenshot of working skin
compatibilitycompatibility chart, e.g. Template:Extension Testing
bugzillaBugzilla MediaWiki skin component name

Paramètres de contrôle

Control parameters
Parameter Description
templatemodeControls auto-categorization of host page.

Normally left blank. Alternate values are:

  • nocats - suppresses categorization. Use this value if you are adding this template to subpages of a skin or to how-to documentation of skins. For example, the usage image above sets templatemode=nocats because this isn't an actual skin page and we don't want to add this page to any categories on account of it.

Si ce paramètre est laissé vide, ce modèle va ajouter la page hôte à Catégorie:Tous les habillages et à l'une ou à plusieurs catégories supplémentaires, en fonction des valeurs assignées aux paramètres de contenu.

subpage; it is not in the Skin: namespace; or if suppressed by 'templatemode=nocats'

Categories added

This template will automatically add the pages it is used on to the Category:All skins category.

In addition, it will categorize the page based on the value of the status parameter:

Utiliser la boîte d'information

Pages d'extensions existantes

Si vous désirez ajouter la boîte d'information sur une page existante, copiez et collez le code qui se trouve au début de cette page.

Créer un nouvel article d'habillage

Pour créer une nouvelle page d'habillage, saisissez son nom ci-dessous et cliquez sur le bouton. Une nouvelle page sera créée avec le modèle de la boîte d'information déjà en place.

Please replace "TheSkin" with your skin's name:


MediaWiki is an open-source project and users are encouraged to make any MediaWiki skins under an Open Source Initiative (OSI) approved GPLv2 compatible license (including MIT, BSD, PD). For skins that have a compatible license, you can request commit access to the MediaWiki source repository for skins.

A developer sharing their code in the code repository should expect:

Feedback / Criticism / Code reviews
Review and comments by other developers on things like framework use, security, efficiency and usability.
Developer tweaking
Other developers modifying your submission to improve or clean-up your code to meet new framework classes and methods, coding conventions and translations.
Future versions by other developers
New branches of your code being created by other developers as new versions of MediaWiki are released.
Credit
Credit for your work being preserved in future versions
Similarly, you should credit the developers of any skins whose code you borrow from.

Any developer who is uncomfortable with any of these actions occurring should not host their code in the code repository. You are still encouraged to create a summary page for your skin on the wiki to let people know about the skin, and where to download it.

Enhancing this template

If you would like to improve on this template, thanks! This is a complicated template so here is some help along the way:

In addition, Template:Skin/Sample stores the boiler plate that is preloaded into newly created pages and contains some basic documentation on how to fill in the template parameters. It needs to be kept in sync with Template:Skin/doc.

The Create skin button

To improve the create skin button behavior:

Infobox parameters

In general:

  • To make this template easy to use, each label in the infobox is linked to documentation on the template parameter(s) it displays. If you add a parameter, please be sure to also add it to the content parameter documentation and link its label to that documentation.

Test case

See if the following pages are still ok, after edited this template.