Utilisateur:Ludo Thécaire/Articles récents
Un article de Wikipédia, l'encyclopédie libre.
Ludo Thécaire peut générer une liste thématique d'articles récents. Grâce à un critère, le robot trouve des articles récents et complète une page par le haut indéfiniment. Il peut découper au besoin par des sections mensuelles ou quotidiennes. A charge aux membres du projet de maintenir la page, en suppriment les doublons, les liens rouges, ou encore en archivant les vieilles sections.
Le robot doit laisser autant que possible la main aux contributeurs, il n'y a pas de problème pour compléter sois même la liste par des articles ou des commentaires, ou même retirer des articles. Pour ce dernier point, certaines configurations peuvent induire le robot à replacer des articles ; mais il n'est pas impossible de changer de configuration.
Sommaire |
[modifier] Traitement
[modifier] Avant propos
Par souci de clarté, la description du traitement a été retouché. Voici un récapitulatif des appellations synonymes utilisées précédemment et actuellement.
- Liste, liste principale ; précédemment : liste longue, liste de la page projet, archive, liste générée en premier ;
- Résumé ; précédemment : liste courte, liste du portail, liste générée en deuxième.
[modifier] Fonctionnement
Une page spéciale de MediaWiki liste les pages qui possèdent un lien avec une page considérée (par exemple Special:Whatlinkshere/Robot). Cette liste a la particularité d'être triée par date de création des articles indiqués, les premiers étant les plus anciens. Par ailleurs certains modèles sont thématiques, c'est le cas des bandeaux de portails. Il est donc possible en utilisant les seules informations fournies par Wikipédia, et dans la mesure ou les contributeurs placent régulièrement les bandeaux de portail, d'extraire les articles les plus récents en fonction d'un thème (technique reprise à Probot de Dake). A cela s'adjoint d'autres méthodes comme l'utilisation d'un cache local pour permettre d'utiliser d'autres sources comme les catégories, ou d'utiliser la base de donnée de toolserver si les critères sont complexes.
Suite à cette phase de récupération de donnée, le robot récupère la précédente liste des articles récents générée afin d'éviter d'ajouter des doublons puis complète la page à partir de la première section.
Éventuellement, un résumé des dernier article peut alors être généré sur une page séparée. Pour cette page, le robot remplace le contenu se trouvant entre les deux balises <-- BEGIN BOT SECTION --> et <-- END BOT SECTION -->, laissant aux membres du projet le soins de personnaliser le haut et le bas de la page.
[modifier] Paramétrages
Le même script est utilisé pour une dizaine de projets. Ce traitement a certain aspect paramétrables pour s'adapter à différentes exigences.
| Paramètre | Type | Description |
|---|---|---|
icon |
Text | Nom d'une image sur Commons (en retirant le Image:) pour symboliser le projet pour lequel le script fonctionne. C'est une décoration utilisée dans des pages propre à Ludo Thécaire. N'a aucune influence sur les pages générées. |
| Source | ||
byTemplate |
Liste de wikipage | Définit des modèles servant à trouver de nouvelles pages. Lorsqu'une page récente inclut une de ces pages, le robot est en mesure de la repérer. |
useDatabase |
Booléen | Indique au robot d'utiliser la base de donnée locale de Toolserver. Le traitement est bien plus rapide, mais le temps de mise à jour de la base s'ajoute, la détection des article est un peu déphasée dans le temps. Force l'usage de cacheResult. |
cacheResult |
Booléen | indique au robot de sauver le résultat en cache. Permet de détecter non seulement les nouveaux articles, mais aussi le bien plus vieux, sur lesquels le critère de détection est maintenant valide. |
numberOfLastEntry |
Nombre | Les listes de Wikipédia sont triée par date, cet élément indique au robot la taille terminal de ces listes qu'il doit tenter d'ajouter en temps que nouveaux articles. Trop petit, on peut louper des articles, trop long, on peut compter plusieurs fois le même article (s'il a été retiré de la liste des articles récents entre temps). N'a pas d'influence si cacheResult est activé. |
minimumPeriode |
Nombre | Nombre de minutes minimum avant de relancer le script. |
| Destination | ||
longPageName |
Wikipage | Définit l'emplacement de la liste à compléter. |
shortPageName |
Wikipage | Définit l'emplacement pour y placer un résumé, la liste de quelques dernière entrées. |
| Mise en forme | ||
projectStyle |
Couple | Permet de changer l'apparence de la liste générée. Soit [s1], [s2] les deux éléments du couple. La liste des nouveaux articles est générée en les séparant par l'élément [s1] ; [s2] termine la liste. |
titleLevel |
Text | Force l'usage d'un niveau de titre particulier pour la liste. === pour un titre de niveau trois. |
label |
Dictionnaire | Permet de rajouter de la décoration en fonction de la provenance d'un article (quel modèle). Voir Projet:Droit/RC pour un exemple. |
longPageMode |
Text | Force l'usage d'une structure de titres particulière. Pas encore bien générique, il existe tout de même quatre différentes configurations :
|
portalStyle |
4-uplet | Permet de changer l'apparence de la liste générée sur la page de résumé. Soit [s1], [s2], [s3], [s4] les quatre éléments du tuple et une liste d'article article1, article2, article3. Le résultat est généré tel que [s1]article1[s2]article2[s2]article2[s3][s4] |
shortListSize |
Nombre | Nombre d'articles à placée dans la liste résumée. |
[modifier] Foire aux questions
[modifier] Le robot a listé une catégorie !
Le robot liste effectivement les catégories. Il serait dommage de ne pas être informé de l'évolution de l'arborescence. Le robot liste également les images (qu'il place dans une galerie). Si nécessaire je peux mettre une option pour pouvoir retirer des deux points.
[modifier] Le robot a listé un lien rouge !
L'explication la plus probable est qu'un article a été créé, que quelqu'un a ajouté le portail. Que le robot a donc ajouté l'article dans la liste des articles récents. Puis enfin que l'article a été supprimé.
[modifier] Un article apparait deux fois !
C'est généralement lorsqu'un article est renommé. Le robot ne peut pas corriger de lui même la liste des articles qu'il a déjà générée. La liste peut être corrigée à la main sans problème. Pour la page de résumé, il est possible de s'en charger, en deuxièmes lieux, le cas échéant le robot le fera lors de son prochain passage.
[modifier] Le robot écrase mes corrections !
Le robot écrase systématiquement la page du résumé avec les dernières entrées de la liste. Il faut donc corriger à la main la liste principale. On peut également ensuite corriger le résumé, mais le robot la corrigera de toute manière à la prochaine mise à jour.
[modifier] Le robot a listé un ancien article !
Deux cas selon que le traitement est configuré avec ou sans cache (cacheResult) :
- Sans : lorsque un article est supprimé puis restauré, la date de restauration est interprétée par Wikipédia comme la date de création de l'article. C'est le cas lorsque par exemple les administrateurs fusionnent des articles, ou retirent du texte en violation de copyright. Le robot ne fait pas de traitement lourd, comme analyser l'historique d'un article, et liste donc ce vieil article comme un article récent.
- Avec : la date n'est pas considérée, un article est considéré comme récent si il utilise un bandeau de portail, mais ne l'utilisait pas au précédant passage du robot. Si l'article n'a pas le portail du projet, fort probablement les membres du projet ne l'ont pas consulté. Il n'est pas inutile de le lister.
[modifier] Qui s'occupe de l'archivage ?
Le robot n'archive rien. Il ne fait que compléter la page, sans modifier son ensemble, il est donc possible de faire ce que l'on veut à la main et notamment de nettoyer les vieilles sections. Une bonne pratique serait de nettoyer la page de temps en temps, certains projets archivent cela de manière annuelle dans des sous-pages, d'autres préfèrent simplement supprimer. C'est aux membre du projet de s'en occuper.
[modifier] Je n'ai pas la réponse
N'hésitez pas à passer sur ma page de discussion.
