Page's Life Extension

Aller à : navigation, rechercher
Page's Life est une extension qui permet de créer deux types de visualisations. Ces visualisations permettent de visualiser la vie d'une page mediawiki et les contributeurs qui la font vivre. Sur cette page se trouve l'explication de toutes les façons possibles de paramétrer les visualisations produites par l'extension. Si vous désirez tester ces paramètres vous pouvez le faire sur cette page: Page's Life Extension Tool

Visualisation de type Area

Ce type de visualisation va nous permettre de visualiser la vie d'une page du wiki. Pour afficher ce graphique sur une de vos page il vous suffit d'écrire le code suivant:

{{#PLArea: }}

Il est possible de paramétrer cette visualisation grâce à quelques paramètres supplémentaires que vous pouvez ajouter au code de base. Chaque paramètre a un nom qui est affecté à une valeur grâce au symbole "=". Si plusieurs paramètres sont utilisés alors il faut les séparer grâce au symbole "|". La structure est la suivante:

{{#PLArea: paramètre1=valeur1 | paramètre2=valeur2}}

Paramètre title

Le paramètre title permet de spécifier la page de votre wiki que vous voulez visualiser en spécifiant le titre de la page. Si ce paramètre n'est pas utilisé alors la visualisation concernera la page sur laquelle le code a été ajouté. Sur l'exemple ci-dessous on affiche la visualisation mais pour la page "Accueil":

{{#PLArea: title=Accueil}}

Sur cette visualisation vous avez une vue d'ensemble de la vie de la page "Accueil" de ce wiki. En cliquant sur le titre vous pouvez accéder à la page "Accueil" qui est visualisée. À droite se trouve la date de création de la page et la date de sa dernière modification. Vous pouvez zoomer sur ce graphique en changeant les valeurs pour le "De" et le "À". À droite se trouve également un bouton hamburger qui vous permet d'exporter la visualisation en plusieurs formats (PNG et SVG). Vous pouvez également zoomer sur la visualisation par semaine ou par jour en cliquant sur les liens à gauche. En bas se trouve ce qu'on appelle un navigator. Ce navigator vous permet de zoomer manuellement sur la visualisation et de vous y déplacer.

Paramètre plotband

Le paramètre "plotband" permet de faire apparaître des boutons en dessous de votre visualisation. Ces boutons correspondront aux utilisateurs qui ont contribué sur la page. En cliquant sur les boutons cela permettra de faire apparaitre des plotband sur votre visualisation et ainsi montrer quand est-ce qu'ils ont contribué et donc fait "vivre" la page du wiki en question.

{{#PLArea: plotband=yes | title=Accueil}}

Valeur par défaut: no
Valeurs possibles: no, yes

Paramètre proportional

Par défaut les échelles ne sont pas proportionnelles et linéaires. L'axe des Y s'adapte en fonction des données qu'on visualise. L'axe des X sépare tous les points à égale distance pour mieux les voir mais la distance entre les points n'est pas représentative du temps qui les sépare. Le paramètre "proportional" permet d'éviter ce mécanisme et afficher la vraie tendance de la vie de la page.

{{#PLArea: plotband=yes | proportional=yes | title=Accueil}}

Valeur par défaut: no
Valeurs possibles: no, yes

Paramètre currentDate

Le paramètre currentDate permet de faire apparaitre la date actuelle sur la visualisation. Ce paramètre peut être un indicateur pour montrer si une page est encore mise à jour régulièrement ou si cela fait un long moment que la page n'a pas été mis à jour. Dans ce cas de figure cela pourrait mettre en garde qu'il y a des chances que le contenu de la page soit obsolète et n'ait pas été mis à jour. Ce paramètre s'associe bien avec le paramètre proportional car il est ainsi possible de voir directement dans le graphique si l'espace entre la dernière modification et la date actuelle est grand ou pas. Il est possible de mettre encore plus en évidence cet espace si on active le paramètre plotband et qu'on appuie sur le "montrer tous" car il n'y aura pas de plotband entre la dernière date de modification de la page et la date actuelle.

{{#PLArea: plotband=yes | proportional=yes | title=Accueil | currentDate=yes}}

Valeur par défaut: no
Valeurs possibles: no, yes

Paramètre step

Le paramètre step permet de transformer l'area en un step area. Un step area représente plus fidèlement la vraie tendance de la vie d'une page car la progression de la taille d'une page ne se produit pas progressivement mais par bonds. En d'autres termes la taille d'une page augmente/diminue uniquement après une modification.

{{#PLArea: plotband=yes | proportional=yes | step=yes | title=Accueil}}

Valeur par défaut: no
Valeurs possibles: no, yes

Visualisation de type Basic Bar

Ce type de visualisation permet de visualiser les contributeurs d'une page classés, par défaut, par ordre décroissant. Pour afficher ce graphique sur une de vos page il vous suffit de mettre le code suivant:

{{#PLBasicBar: }}

Il est possible de paramétrer cette visualisation grâce à quelques paramètres supplémentaires que vous pouvez ajouter au code de base. Chaque paramètre a un nom qui est affecté à une valeur grâce au symbole "=". Si plusieurs paramètres sont utilisés alors il faut les séparer grâce au symbole "|". La structure est la suivante:

{{#PLBasicBar: paramètre1=valeur1 | paramètre2=valeur2}}

Paramètre title

Le paramètre title permet de spécifier la page de votre wiki que vous voulez visualiser en spécifiant le titre de la page. Si ce paramètre n'est pas utilisé alors la visualisation concernera la page sur laquelle le code a été ajouté. Sur l'exemple ci-dessous on affiche la visualisation mais pour la page "Accueil":

{{#PLBasicBar: title=Accueil}}

Paramètre number

Le paramètre number permet d'afficher seulement un certain nombre de contributeurs en lui spécifiant un nombre entier supérieur ou égal à 1. Cela permet d'afficher les X meilleurs ou moins bon contributeurs selon l'ordre de tri (cf paramètre sort).Si ce paramètre prend la valeur "all" alors tous les contributeurs seront affichés. Dans cet exemple on va afficher les deux meilleurs contributeurs:

{{#PLBasicBar: title=Accueil | number=2}}

Valeur par défaut: all
Valeurs possibles: all, N*

Paramètre sort

Le paramètre sort permet de spécifier le tri des contributeurs en fonction de leur contribution totale à la page. Par défaut les contributeurs de la page sont classés par ordre décroissant en d'autres termes par ordre descendant. Les valeurs comprises par ce paramètre sont "ASC" pour ascendant et "DESC" pour descendant. Dans cet exemple on affiche les contributeurs par ordre croissant:

{{#PLBasicBar: title=Accueil | sort=ASC}}

Valeur par défaut: DESC
Valeurs possibles: ASC, DESC

Paramètre sortByContributor

Le paramètre sortByContributor permet de trier nos contributeurs par ordre alphanumérique. Si on affecte à ce paramètre la valeur "ASC" alors les contributeurs seront classés par ordre alphanumérique. Si on affecte à ce paramètre la valeur "DESC" alors les contributeurs seront classés par ordre alphanumérique inverse. Dans cet exemple on affiche les contributeurs par ordre alphanumérique:

{{#PLBasicBar: title=Accueil | sortByContributor=ASC}}

Valeur par défaut: no
Valeurs possibles: no, ASC, DESC