Manual:Skin configuration/fr

Cette page explique comment configurer les habillages sur un wiki pour les administrateurs.

Cette documentation concerne MediaWiki 1.31+.

Pour utiliser les habillages, voir pour les informations générales.

Pour les développeurs qui veulent créer de nouveaux habillages ou modifier ceux qui existent, référez-vous à Créer un habillage MediaWiki pour les informations techniques.



Télécharger les habillages
Le téléchargement de l'archive MediaWiki contient déjà plusieurs habillages. Voir Extensions et skins groupés pour une liste.

Néanmoins, si vous avez téléchargé MédiaWiki de Git ou si vous voulez installer des habillages supplémentaires, vous devrez télécharger leur code séparément.

Beaucoup d’habillages de MediaWiki se trouvent dans le dépôt Git Wikimedia (voir la liste complète). Vous pouvez télécharger les archives d'habillages à partir du distributeur d'habillages.

Pour télécharger un des habillages de ce groupe via Git, vous devez faire un appel de la manière suivante :

 git clone https://gerrit.wikimedia.org/r/mediawiki/skins/[nom de l'habillage]

Par exemple : pour obtenir l'habillage par défaut Vector, vous devez fournir ce qui suit à partir du sous-répertoire  de votre répertoire d'installation MediaWiki :

 git clone https://gerrit.wikimedia.org/r/mediawiki/skins/Vector

Sélectionnez une version appropriée de l'habillage. Modifiez à l'aide du nouveau répertoire et exécutez :

git checkout REL1_35

(remplace  avec une autre branche de version ou balise)



Activer les habillages
Vous devez activer dans votre fichier  tout habillage de votre répertoire   que vous souhaitez utiliser. Par exemple pour activer Vector, ajoutez ce qui suit. Si vous utilisez plusieurs habillages, chacun d'eux doit être activé séparément :



(ceci est équivalent à l'activation d'une extension, seulement dans un répertoire différent.)

Des étapes supplémentaires peuvent être nécessaires en fonction de l'habillage choisi. Les instructions d'installation détaillées sont disponibles pour chaque page d'habillage sur MediaWiki.org ; pour l'habillage Vector par exemple, voir Habillage:Vector#Installation. Pour les autres habillages, les instructions sont similaires.



Définir un habillage par défaut pour le wiki
Un habillage par défaut doit être défini pour les nouveaux utilisateurs du wiki en initialisant la variable  dans   avec le nom de l'habillage en minuscules tel qu'il est spécifié dans le fichier de l'habillage. Les utilisateurs peuvent toujours modifier sur leur page de préférences, l'habillage qu'ils veulent utiliser, sauf si vous avez désinstallé ou supprimé tous les autres habillages, ou que vous avez désactivé l'ensemble des préférences (voir ci-dessous). Par exemple :

En modifiant ces valeurs sur un wiki existant, vous modifierez automatiquement les paramètres de tous les utilisateurs qui utilisaient l'habillage par défaut précédent. Le script de maintenance modifie les préférences utilisateur mais pratiquement vous n'aurez pas à l'utiliser.

Si vous ne changez pas cette valeur, Vector sera l'habillage par défaut.



Désinstaller des habillages
Pour désinstaller un habillage, supprimez la ligne  (ou   pour MediaWiki 1.24 ou plus ancien) de votre fichier. Vous pouvez ensuite supprimer les fichiers d'habillage du répertoire.

Si certains utilisateurs étaient en train d'utiliser l'habillage que vous venez de désinstaller, MediaWiki va automatiqument les basculer sur l'habillage par défaut du wiki.



Masquer des habillages sans les désinstaller
L'administrateur peut limiter le choix des habillages proposés sur tout le site dans les préférences de l'utilisateur en listant les habillages à supprimer dans le tableau. Ceci peut être utile si vous voulez tester un nouvel habillage sans que les utilisateurs ne le voient. Pour faire cela, insérez dans  des lignes similaires aux suivantes :

Vous pourrez avoir un aperçu de l'habillage en utilisant le paramètre d'URL.



Modifier le CSS pour tout le site
MediaWiki permet aux administrateurs de spécifier des règles CSS ajoutées à chaque page générée et valables pour tout le site. Ces règles peuvent être ajoutées en modifiant la page Gadget-site.css (ancien Common.css)) sur votre wiki, si  est mis à  . En plus d'une feuille de style globale, vous pouvez également préciser des règles CSS à utiliser avec certains habillages (voir Manuel:Interface/Feuilles de style).



Modification du CSS utilisateur
Les utilisateurs peuvent aussi déclarer leurs propres règles CSS en créant une page. Le CSS sur cette page est ensuite appliqué à tout habillage adopté par l'utilisateur. Si un autre habillage par défaut est choisi pour le site, le CSS personnalisé de l'utilisateur continuera a fonctionner tout comme avant. Cette fonctionalité peut être activée en initialisant  à   dans. Un utilisateur peut aussi appliquer le CSS à un habillage spécifique en créant la page User:Username/skinname.css. Si un utilisateur choisit l'habillage MonoBook par exemple, il modifiera la page Special:MyPage/monobook.css.



Désactiver la capacité des utilisateurs du site à choisir des habillages dans leurs préférences
L'administrateur système peut supprimer complètement l'option habillage qui n'apparaît alors plus dans les préférences utilisateur. Ceci n'a de sens que si votre site utilise un habillage personnalisé et que l'affichage ne se fait pas convenablement avec les autres habillages.

Pour faire cela, ajoutez une nouvelle ligne contenant le code suivant dans LocalSettings.php. Ceci va supprimer l'option habillage des préférences et la possibilité d'utiliser le paramètre  dans l'URL.