Une introduction à DynamicPageLists (DPL) sur Fandom

Attention! Il s'agit d'un blog avancé très axé sur le codage, qui utilise de nombreux termes techniques que l'on rencontre dans le codage. Si vous n'avez pas encore compris des choses telles que les fonctions ou le wikitexte en général, veuillez en apprendre plus sur ces fonctions avant de continuer.

DynamicPageLists est une extension qui peut être optionnellement activée sur Fandom par le personnel de Fandom. Typiquement, il s'agit d'un générateur similaire à la façon dont on interroge des ensembles de données dans SQL, par exemple. Sauf qu'ici, vous pouvez directement interroger les articles du wiki et leurs données associées, pour les agréger d'une manière différente, ou les combiner pour améliorer vos articles dynamiquement et automatiquement.

DPL ou pas DPL - Pourquoi et quand?[]

Comme nous l'avons déjà mentionné, DPL est une aide précieuse pour agréger des éléments ou pour inclure de nouveaux contenus créés après la publication de la requête DPL.

Pour avoir une idée de ce que DPL peut faire, vous pouvez jeter un coup d'œil au mécanisme utilisé par notre page de requête Community Central pour les liens interlangues - DPL nous permet de voir toutes les nouvelles requêtes (= articles mediawiki) qui sont créées par les utilisateurs avec une certaine catégorie qui leur est attachée dans un format de liste personnalisé. Cliquez ici pour voir le code source.

Unne bonne raison de l'utiliser est si vous voulez utiliser DPL pour automatiser la maintenance du contenu et créer des pages qui combinent des informations modulaires.

Disons que vous êtes sur un wiki de jeu, et que vous voulez combiner toutes les descriptions d'un certain ensemble d'armures sur une seule page, mais vous ne voulez pas copier-coller de chaque article pour éviter d'avoir à maintenir les deux à jour. Ou vous êtes sur un wiki anime/tv et vous avez des pages d'épisodes avec des résumés que vous voulez combiner en une page de résumé de saison.

DPL peut vous aider à automatiser cela, en prenant une section spécifique d'un autre article et en la chargeant comme si elle avait été écrite sur la page sur laquelle vous utilisez DPL.

Vous pouvez voir un exemple très personnalisé en action ici: https://myheroacademia.fandom.com/wiki/Episodes?action=edit

Si vous le faites, faites attention à la nature et à la quantité d'informations que vous demandez ou que vous avez l'intention de rendre. Au fur et à mesure que les séries se succèdent, les temps de chargement des pages risquent de ralentir, ce qui aura un effet négatif sur votre référencement; envisagez donc de créer une vue d'ensemble distincte pour chaque collection. Veillez également à ce qu'une nouvelle page contienne toujours un texte original, par exemple une introduction!

Considérations relatives aux tests et à la charge de travail du serveur[]

Lorsque vous essayez de nouvelles choses avec DPL, veuillez toujours mettre une limite de 2-5 en utilisant le paramètre count (car il va compter jusqu'à la limite). Cela vous permet de tester vos modifications beaucoup plus rapidement, car moins de données doivent être compilées pour le rendu, et vous évite d'interroger involontairement des milliers de pages à la fois.

C'est surtout vrai lorsque vous utilisez le paramètre include.

Ne pas générer de boîtes de navigation avec DPL[]

Il peut être tentant de créer une boîte de navigation contenant tous les articles d'une catégorie donnée. Cependant, c'est une mauvaise idée pour de multiples raisons.

Pour commencer, trop de liens sur une page sont mauvais pour le référencement de votre wiki, ce qui se traduira par moins de vues au fil du temps. Selon le nombre d'articles que vous avez dans la catégorie, qui peut être un peu aujourd'hui mais beaucoup demain, cela peut également créer des problèmes de convivialité et d'accessibilité. N'oubliez pas que vous devez toujours concevoir votre site en tenant compte de l'accessibilité.

Veillez plutôt à n'inclure que les liens les plus importants dans une boîte à outils et assurez-vous que les pages vers lesquelles vous pointez sont un bon endroit pour que les utilisateurs poursuivent leur exploration. Si vous souhaitez toujours les renvoyer à une liste agrégée, envisagez de créer un lien vers une catégorie directement dans votre boîte de navigation.

Prêt à essayer? Voici des requêtes simples pour comprendre et explorer DPL[]

Il y a deux façons d'utiliser DPL: <dpl></dpl> et {{#dpl: }}. En fonction de la complexité, vous pouvez choisir l'un ou l'autre, mais nous nous concentrerons sur la deuxième façon.

{{#dpl:
|category=Conseil pro
|namespace={{ns:500}}
}}

{{#dpl:
|category=Billets de blog <!-- this is the default category for blog posts -->
|namespace={{ns:500}} <!-- this is the blog namespace number -->
|count=2
}}

{{#dpl:
|category=Billets de blog <!-- this is the default category for blog posts -->
|category=Actualités de produit <!-- attention: you need to make sure the case is correct! it will not work with "product updates" -->
|namespace={{ns:500}} <!-- this is the blog namespace number -->
|count=2
}}

{{#dpl:
|category=Diversité, Équité, Inclusion¦Actualités de programmes Fandom <!-- either DEI OR Program updates -->
|namespace={{ns:500}} <!-- this is the blog namespace number -->
|count=4
}}

Mais attendez, c'était quoi ce symbole ¦ bizarre? C'est là que les différentes méthodes d'utilisation du balisage DPL et des fonctions wikitexte entrent en jeu. Pour dire OR/OU, vous devez utiliser une barre verticale | - mais parce que dans une fonction wikitexte, ce symbole est utilisé pour indiquer un nouveau paramètre, vous ne pouvez pas le faire. C'est pourquoi vous utilisez ce que l'on appelle un "tuyau brisé" - ¦ - qui a exactement la même fonction, mais qui n'indique pas un nouveau paramètre à la fonction wikitexte.

Ceci n'est qu'un aperçu très général de DPL - il y a tellement plus que vous pouvez explorer dans notre documentation d'aide autour de DPL: Aide:DynamicPageList

Nous espérons que ces conseils vous donneront une bonne idée de la façon dont vous pourriez utiliser DPL pour améliorer votre wiki, une idée générale de son fonctionnement, et vous indiqueront par où commencer!

Devenir un Pro : Aspects Techniques

Une introduction à DynamicPageLists (DPL) sur Fandom

Une introduction à Lua sur Fandom

Contribuer sur le Dev Wiki

Comment utiliser les robots sur Fandom

Apprendre les bases Franchir les étapes suivantes
Devenir un mentor de communauté

Vous pouvez consulter l'article original ici (en anglais).