Extension:Subpage Fun

Manuel des extensions MediaWiki

Subpage Fun État de la version : stable
Implémentation	Fonction d'analyseur , Variable
Description	Définit quelques nouvelles fonctions d'analyse pour obtenir des informations avancées concernant les sous-pages.
Auteur(s)	Daniel Werner (Danwediscussion)
Dernière version	0.7.0 (2020-02-16)
MediaWiki	1.25+
Modifie la base de données	Non
Licence	Licence ISC
Téléchargement	Télécharger l'extension Git [?]: parcourir le dépôt (Phabricator · GitHub) relecture Gerrit du code historique Git des validations (commits) Télécharger le tarball source README RELEASE-NOTES
Accroches utilisées GetThisVariableValueSwitch MagicWordwgVariableIDs ParserFirstCallInit ParserGetVariableValueSwitch
Traduire l’extension Subpage Fun sur translatewiki.net si elle y est disponible

L'extension Subpage Fun fournit à votre wiki sept nouvelles fonctions d'analyse et variables pour obtenir les informations sur les sous-pages que vous ne pouvez pas obtenir avec les mots magiques existants de MediaWiki. En outre, cette extension a un concept légèrement différent de ce qui est considéré comme sous-page par les fonctions existantes de MediaWiki.

Vous pouvez lire ici presque tout ce dont vous avez besoin de connaître à propos des sous-pages MediaWiki. Cette extension va un pas plus loin et indique qu'une sous-page n'est pas simplement la partie derrière la barre oblique (/). Une page seule est une sous-page dans le cas ou une page parent existe. Cela signifie que Subpage Fun ne vas pas considérer la page AC/DC comme sous-page tant que la page AC n'est pas définie. En supposant que la page AC/DC/Discography existe, la page AC/DC/Discography/1975/1976 aurait 1975/1976 pour le {{SUBPAGETITLE}} . La variable MediaWiki {{SUBPAGENAME}} ne contiendra que 1976 dans ce cas, ce qui n'a pas de sens car cette page n'existe même pas.

Pour les développeurs, cette extension fournit la classe PHP SubpageInfo qui peut servir à recueillir les informations sur les sous-pages dans d'autres extensions.

Utilisation

Subpage Fun définit {{SUBPAGETITLE}}, {{SUBPAGES}}, {{PARENTPAGES}}, {{SIBLINGPAGES}}, {{NUMBEROFSUBPAGES}}, {{TOPLEVELPAGE}}. Vous pouvez les utiliser ainsi comme des variables pour la page actuelle, ou vous pouvez les utiliser avec un paramètre comme {{NUMBEROFSUBPAGES: Pagename}} pour les utiliser avec la page que vous souhaitez.

SUBPAGETITLE

Vrai nom d'une sous-page, pas seulement la partie derrière la dernière barre oblique (/) comme fourni par SUBPAGENAME de MediaWiki.

SUBPAGELEVEL

Niveau de la sous-page d'une page. Une page normale qui n'est pas une sous-page va renvoyer 0.

NUMBEROFSUBPAGES

Nombre de sous-pages d'une page. Fonctionne également avec des sous-pages pour voir combien de sous-pages elles possèdent. Compte toutes les pages descendantes, pas seulement les pages enfant directes.

TOPLEVELPAGE

Page de niveau supérieur, qui est la page avec avec le niveau de sous-page 0 dans la même arborescence de sous-page.

SUBPAGES

Génère toutes les sous-pages en tant que liste séparée par des virgules. Ceci représente toutes les pages enfant, et pas uniquement celles des enfants directs. Les sorties n'ont pas d'ordre spécifique.

PARENTPAGES

Fournit toutes les pages ancêtres sous forme de liste séparée par des virgules. La sortie commence par la page de niveau supérieur et se termine par la page parent directe.

SIBLINGPAGES

Fournit la fratrie entière du même niveau que la sous-page et de l'arborescence, en tant que liste séparée par des virgules. Les sorties n'ont pas d'ordre spécifique.

{{SUBPAGES}}, {{PARENTPAGES}}, {{SIBLINGPAGES}} a une sortie de liste. Vous pouvez utiliser cette sortie pour une utilisation ultérieure avec Extension:Arrays par exemple.

Si une fonction est utilisée avec le paramètre 1 sur une page avec des caractères non valides, la valeur de la sortie est une chaîne vide.

Mise en forme avancée

Il existe plusieurs autres paramètres pour certaines fonctions en plus de 1 qui est disponible pour toutes les fonctions et qui permet de définir la page dont on recherche les informations.

linked

Si ce paramètre a une valeur quelconque, toutes les pages de la liste des fonctions génératrices de liste deviennent des liens

sep

Permet de définir un séparateur de liste différent du séparateur par défaut ,

depth

Fonctionne avec {{SUBPAGES}}, {{NUMBEROFSUBPAGES}}, {{PARENTPAGES}}. Permet de définir la profondeur relative de la page la plus éloignée. Si la profondeur est définie à une valeur inférieure à 0 ou n'est pas définie, les fonctions exécutent tout, pour {{PARENTPAGES}} une valeur négative renverra ces nombreux éléments en commençant par la page de niveau supérieur.

filter

Fonctionne avec {{SUBPAGES}}, {{PARENTPAGES}}, {{SIBLINGPAGES}}, {{NUMBEROFSUBPAGES}}. Ce paramètre permet de définir une expression régulière (délimiteurs autorisés /%|, modificateurs autorisés imsSuUx) qui filtrera tous les éléments de la liste qui ne correspondent pas à l'expression. Alternativement, il est possible de définir un mot simple qui doit faire partie d'une entrée de liste sinon l'entrée ne sera pas sortie. Il est possible de définir plusieurs mots séparés par un | échappé par exemple avec l'aide d'un modèle comme Template:! en utilisant {{!}}.

Exemples :

• {{PARENTPAGES: linked=true |depth=1}} va fournir en tant que lien, la page parent directe de la page actuelle.
• {{PARENTPAGES: <page> |depth=-1}} donne le même résultat que {{TOPLEVELPAGE}} avec la seule différence que si ‎<page> est déjà la page de premier niveau, une chaîne vide est renvoyée.
• {{SUBPAGES: somepage |depth=1 |sep=<nowiki> </nowiki>}} renverra toutes les sous-pages directes sous somepage séparées par une simple espace.

Support pour les développeurs

Les développeurs peuvent utiliser certaines fonctions PHP statiques de la classe SubpageInfo qui fournit des informations sur les sous-pages que la classe MediaWiki Title ne fournit pas.

Installation

• Téléchargez et placez le(s) fichier(s) dans un répertoire appelé SubpageFun dans votre dossier extensions/.
  Les développeurs et les contributeurs au code doivent à la place installer l'extension à partir de Git en utilisant:

  cd extensions/
  git clone https://gerrit.wikimedia.org/r/mediawiki/extensions/SubpageFun
  

• Ajoutez le code suivant à la fin de votre fichier LocalSettings.php  :

  wfLoadExtension( 'SubpageFun' );
  

• Fait – Accédez à Special:Version sur votre wiki pour vérifier que l'extension a bien été installée.

Voir aussi

• SubPageList - Permet de lister et de compter les sous-pages.
• SubpageNavigation - Affiche les enfants directs de la page actuelle dans l'entête de l'article et fournit des sous-pages de navigation de la page spéciale pour parcourir tous les articles du wiki de différentes manières.