Habillage:Vector/2022

Manuel des habillages MediaWiki - catégorie

Vector 2022 État de la version : stable
Politique de compatibilité	Versions ponctuelles alignées avec MediaWiki. Le master n'est pas compatible arrière.
Composer	mediawiki/vector-skin
Licence	Licence publique générale GNU v2.0 ou supérieur
Téléchargement	Télécharger l'habillage Git [?]: télécharger la branche master de Git parcourir le dépôt (Phabricator · GitHub) historique des validations contributeurs au dépôt (GitHub) revue de code
Exemple	https://en.wikipedia.org/ https://vi.wikipedia.org/ https://test.wikipedia.org/
Paramètres $wgVectorNightMode $wgVectorResponsive $wgVectorStickyHeader $wgVectorMaxWidthOptions $wgVectorFontSizeConfigurableOptions $wgVectorLanguageInHeader $wgVectorLanguageInMainPageHeader $wgVectorWvuiSearchOptions $wgVectorTableOfContentsCollapseAtCount $wgVectorPromoteAddTopic $wgVectorWrapTablesTemporary $wgVectorWebABTestEnrollment $wgVectorDefaultSkinVersionForNewAccounts $wgVectorDefaultSkinVersionForExistingAccounts
Téléchargements trimestriels	0
Utilisé par les wikis publics	14,010 (Ranked 2nd)
Habillage par défaut des wikis publics	5,943
Traduisez l'habillage Vector/2022 sur translatewiki.net
Rôle Vagrant	vector
Problèmes :	Tâches ouvertes · Signaler un bogue

Vector 2022 est un habillage MediaWiki et représente la seconde évolution de l'habillage Vector. Il a été développé en tant que partie du projet Améliorations du bureau. Il est intégré à MediaWiki depuis MediaWiki 1.38 . C'est l'habillage par défaut de plusieurs projets Wikimedia.

Vector 2022 diffère de la plupart des habillages en ce qu'il n'a pas sa propre base de code; ou plutôt, son code fait partie de l'habillage Vector, et les deux sont téléchargés ensemble.

La version MediaWiki 1.38 de cet habillage a ouvert le support officiel aux tiers. Notez que les sites qui exécutent MediaWiki 1.36 ou 1.37 qui utilisent Vector 2022 rencontreront des difficultés lors du passage à la version 1.38 . Voir T299104 et Extension:WikimediaMaintenance pour plus de détails.

Installation

Cet habillage est fourni avec MediaWiki 1.38 et supérieur. Les instructions de configuration restantes doivent encore être suivies.

• Téléchargez et placez le(s) fichier(s) dans un répertoire appelé Vector dans votre dossier skins/.
• Ajoutez le code suivant à la fin de votre fichier LocalSettings.php  :

  wfLoadSkin( 'Vector' );
  

• Configurez selon les besoins.
• Fait - Naviguer vers Special:Version sur votre wiki pour vérifier l'installation correcte de l'habillage.

Dépendances facultatives

Vector 2022 peut utiliser les extensions suivantes si elles sont installées, bien qu'aucune ne soit nécessaire :

• UniversalLanguageSelector - pour le sélecteur de langue
• PageImages - pour inclure une image (si disponible) pour chaque page, dans la barre de recherche
• ShortDescription - pour inclure une description pour chaque page dans la barre de recherche (les projets Wikimedia ont des fonctionnalités similaires mais n'utilisent pas cette extension)

Configuration

Faire de Vector 2022 l'habillage par défaut

Pour MediaWiki 1.38+ , ajouter ceci dans LocalSettings.php pour en faire l'habillage par défaut :

$wgDefaultSkin = 'vector-2022';

Features

Mode sombre

Version de MediaWiki :

1.43

Vector 2022 possède un mode nuit (mode sombre), qui a trois états possibles :

• day - connu également comme mode clair
• night - connu également comme mode sombre
• os - connu également comme mode automatique Ce mode s'adaptera automatiquement à l'état du système d'exploitation ou du navigateur

Le mode sombre est géré par un drapeau de fonctionnalité. Pour l'activer, déclarer $wgVectorNightMode ainsi :

$wgVectorNightMode['beta'] = true;
$wgVectorNightMode['logged_out'] = true;
$wgVectorNightMode['logged_in'] = true;

Lorsqu'il sera activé, le mode du thème par défaut sera à jour. Pour changer le thème par défaut pour tous les utilisateurs en mode automatique ou en mode sombre, initialisez la valeur par défaut de l'option utilisateur avec :

$wgDefaultUserOptions['vector-theme'] = 'os';
// ou 
$wgDefaultUserOptions['vector-theme'] = 'night';

Veuillez noter que votre contenu doit être compatible avec le mode sombre. Voir les recommendations pour les wikis Wikimedia .

Configurability

Notez que Vector 2022 a plusieurs drapeaux (instables) de fonctionnalités pouvant être supprimés à l'avenir. La plupart de ces drapeaux de fonctionnalités sont liés à des caractéristiques incomplètes. Il n'est pas recommandé de changer la valeur par défaut de ces drapeaux de fonctionnalité sauf si c'est expliqué sur cette page.

• $wgVectorMaxWidthOptions - Peut être utilisé pour configurer si max-width doit s'appliquer. Relativement stable jusqu'à présent.
• $wgVectorLanguageInMainPageHeader - Contrôle si le sélecteur de langue est affiché sur la page principale dans l'entête.
• $wgVectorTypeahead - Tableau associatif avec les clés showDescription et showThumbnail (booléens).

Option pour épingler le menu

Vector 2022 permet de contrôler divers menus apparaissant épinglés dans la barre latérale ou repliés dans l'entête. Ces options peuvent être configurées à la fois par les utilisateurs dans leurs préférences et par les administrateurs en tant que paramètres par défaut.

Les options d'épinglage suivantes sont disponibles :

• vector-main-menu-pinned - contrôle la position du menu principal de navigation
  • 1 (valeur par défaut) - Le menu est épinglé dans la barre latérale gauche
  • 0 - Le menu est replié dans l'icône hamburger
• vector-page-tools-pinned - Contrôle la position du menu des outils de page
  • 1 (valeur par défaut) - Le menu est épinglé dans la barre latérale droite
  • 0 - les outils sont repliés dans l'icône d'entête
• vector-toc-pinned - contrôle la position du sommaire
  • 1 (valeur par défaut) - Le sommaire est épinglé dans la barre latérale
  • 0 - Le sommaire est réduit à un bouton flottant
• vector-appearance-pinned - Contrôle la position du menu d'apparence
  • 1 (valeur par défaut) - Les options d'apparence sont épinglées dans la barre latérale
  • 0 - Les options d'apparence sont repliés dans l'icône d'entête

Pour modifier ces valeurs par défaut, ajouter ceci à LocalSettings.php :

Note this will not work for anonymous users due until T366999 is worked on.

// Exemple: replier tous les menus
$wgDefaultUserOptions['vector-main-menu-pinned'] = 0;
$wgDefaultUserOptions['vector-page-tools-pinned'] = 0;
$wgDefaultUserOptions['vector-toc-pinned'] = 0;
$wgDefaultUserOptions['vector-appearance-pinned'] = 0;

Workarounds

Avertissement :

This code should never be run on Wikimedia production sites as it causes the page to be re-rendered which can impact SEO as well as user experience.

To pin the sidebar for anonymous users by default, this code can be added at the beginning of MediaWiki:Common.js (see live example):

if (!mw.config.get('wgUserName')) {
	const observer = new MutationObserver((mutationsList, observer) => {
		for (const mutation of mutationsList) {
			if (mutation.target.classList.contains('vector-animations-ready')) {
				document.querySelector( '[data-event-name="pinnable-header.vector-main-menu.pin"]' ).click()
				observer.disconnect();
				break;
			}
		}
	});
	
	observer.observe(document.documentElement, { attributes: true, attributeFilter: ['class'] });
}

If you also want to pin the tools for anonymous users by default, you can add the following line of code (after line 5):

document.querySelector( '[data-event-name="pinnable-header.vector-page-tools.pin"]' ).click()

Voir aussi

• Documents d'architecture