Extension:WikidataPageBanner/fr

L’extension WikidataPageBanner ajoute les images de bannière en haut des pages wiki. Elles peuvent figurer sur toutes les pages des espaces de noms spécifiés, ou simplement sur des pages individuelles. Les noms de fichier des images peuvent être mis dans Wikidata (avec P948) plutôt que de figurer sur le wiki local.

Les bannières sont largement utilisées avec les projets Wikivoyage. Cette extension a été principalement inspirée du modèle pagebanner de Wikivoyage.

Utilisation
Il existe quelques manières différentes pour positionner l'image d'une bannière sur une page :


 * 1) Pour utiliser   comme une image de bannière personnalisée, définissez-la sur la page :
 * 2) L’extension peut automatiquement ajouter la même image de bannière à toutes les pages des espaces de noms spécifiés, définis via la variable de configuration.
 * 3) Si le wiki est connecté à Wikidata, il peut aussi y récupérer la bannière de chaque page. Dans ce cas le modèle Template:PAGEBANNER doit exister (et peut être vide). Le Wikivoyage anglophone possède un exemple de Template:Pagebanner complexe avec une logique de rendu et des dépendances supplémentaires de modèles.



Paramètres de la fonction
Les paramètres suivants sont pris en charge par la fonction d’analyse  :


 * pgname — ajoute un titre personnalisé à la bannière.
 * icon-* — pour ajouter des icônes personnalisées, utilisez le paramètre  (où   est le nom de l'icône à utiliser). Puis définissez une image de fond   dans MediaWiki:Common.css pouvant être utilisée en tant qu'icône. Faites cela pour toutes les icônes à ajouter sur la page.
 * tooltip — utiliser image-caption pour afficher la description de l'image quand on la survole
 * toc — utiliser yes pour afficher la table des matières à l'intérieur de la bannière
 * bottomtoc — utiliser yes pour placer la table des matières sous la bannière. Ceci n'impactera que la page sur laquelle elle est utilisée. Pour afficher la table des matières en bas et sur tout le site, voir le paragraphe ci-dessous.
 * extraClass — utilisez  (avec le séparateur Espace) pour ajouter des classes supplémentaires à la bannière pouvant être utilisées pour la personnaliser avec les styles dans MediaWiki:Common.css
 * origin — voir la section ci-dessous.
 * link — définit la cible du lien de la bannière et fonctionne de la même manière que le paramètre link pour les images (par exemple Nom_de_l'événement pointera vers la page Nom_de_l'événement plutôt que vers la page de l'image de la bannière). Omettez la valeur pour supprimer le lien, comme link.



Paramètre 'origin'
Utiliser ce paramètre pour définir une zone focale suggérée de l’image. Ceci est utilisé pour tronquer la bannière de manière appropriée sur les petits écrans. La valeur du paramètre est formée des coordonnées X et de Y séparées par une virgule. Chaque coordonnée représente la distance du centre de l'image en tant que valeur allant de -1 à 1. Par exemple, 1,1 est le coin supérieur droit et -1,1 est le coin inférieur droit. Voir l'image de droite pour la représentation graphique des coordonnées.

Notez que origin sert pour les images qui débordent de la zone cible allouée à la bannière (par exemple en largeur avec des grands panoramas, ou des photos de portraits pour la hauteur). La bannière ne sera pas repositionnée si l'espace n'est pas complètement occupé, laissant des zones vides. Par exemple si une bannière doit occuper une largeur de 320 pixels et une hauteur de 180 pixels, une image de cette taille exactement ne sera pas du tout repositionnée; une image de 600 pixels en largeur sur 180 pixels en hauteur peut être repositionnée horizontalement et une image de 320 pixels en largeur sur 1000 pixels en hauteur peut être repositionnée verticalement.



Variables de configuration
$wgWPBImage indique qu'il faut utiliser l'image de la bannière par défaut. Ajouter le nom de l'image sans le préfixe de l'espace de noms 'File:'. Si le wiki n'a pas de bannière par défaut, ne modifiez pas ce champ.

$wgWPBBannerProperty Banner property on Wikidata which holds a commons media file. C'est essentiel si Wikidata est activé.

$wgWPBEnableDefaultBanner active l'image de la bannière par défaut sur les pages sans utiliser.

tableau $wgWPBNamespaces d'espaces de noms pour lesquels la bannière doit être affichée. L'espace de noms par défaut est Main. Vous pouvez également le mettre à pour afficher la bannière sur tous les espaces de noms, sauf ceux qui sont exclus par $wgWPBDisabledNamespaces.

$wgWPBDisabledNamespaces permet d'exclure l'affichage de la bannière dans certains espaces de noms. Notez que ce paramètre n'a d'effet que si vaut. Sinon ce paramètre est ignoré et seuls les espaces de noms de $wgWPBNamespaces sont pris en compte.

$wgWPBStandardSizes is an array of standard predefined screen widths in increasing order of size.

$wgWPBEnablePageImagesBanners when set to true and is installed will use a page image when no Wikidata image or locally defined image is set.

$wgWPBDisplaySubtitleAfterBannerSkins is an array of names of skins that should have the banner displayed in the site-notice area, instead of in the page subtitle (which is the default).

$wgWPBEnableHeadingOverride determines whether the page title is displayed overlayed on the banner image. Valeur par défaut :.

$wgWPBEnableMainPage determines whether a banner is allowed to be shown on the. Valeur par défaut :.

Exemples
A few use examples with explanation:

Will add a banner using image Grand_canyon.jpg as source locally or from wikimedia commons.

Will add a banner using image Grand_canyon.jpg as source locally or from wikimedia commons. Additionally will add icons with class names oo-ui-icon-star, oo-ui-icon-unesco. Set background-image property on theses classes in MediaWiki:Common.css to your desired icon.

Will add a banner using image Grand_canyon.jpg as source locally or from Wikimedia Commons. Additionally adds a Table of Contents inside banner. Sets the name displayed on banner as Some page.

This will add a banner using the Grand_canyon.jpg image as source either locally or from Wikimedia Commons. It additionally adds CSS classes class1 and class2 to the .wpb-topbanner div.



Exemple d'utilisation de la bannière de Wikidata
Make sure  is set to correct Wikidata banner property. Then leave the image name empty, and set any other required parameters:

This will use the banner image as set on the page's Wikidata item. If there is no banner image set for that item, or the page doesn't have a Wikidata item, a default image may be used (if  is set).

Mise en forme
The extension has ample scope for styling the banner via Common.css. Voici quelques exemples de modifications CSS habituelles.

Ceci positionne la table des matières juste sous la bannière dans le cas où elle est longue. Note that doing this would cause every banner page on a wiki to have the ToC at the bottom of the banner. However, using  as a paramter would only show the ToC at the bottom on the page it's used.

Would set the font size of the banner name to 1 em (smaller than the default 2.2 em).

Would reduce the vertical spacing between lines of the ToC.

Would set some blank space between the banner and ToC.