Extension:Semantic Drilldown/fr

**Manuel des extensions MediaWiki**
Semantic Drilldown; État de la version : bêta
Implémentation	Page spéciale
Description	Extension construite autour de Semantic MediaWiki qui fournit une page pour scruter les données sémantiques (drill down) basées sur les catégories d'un site, en utilisant des filtres faciles à créer.
Auteur(s)	Yaron Koren
Maintenance	gesinn.it
Dernière version	5.0.2 (juin 2026)
MediaWiki	1.43+
PHP	8.1+
Modifie la base; de données	Non
	Paramètres $wgShowCategoriesAsTabs; $wgNumRangesForNumberFilters; $wgDisableFilterCollapsible; $wgFiltersLargestFontSize; $wgMinValuesForComboBox; $wgFiltersSmallestFontSize; $wgHideFiltersWithoutValues; $wgHideCategoriesByDefault; $wgNumResultsPerPage; $wgResultFormatTypes;
	Accroches utilisées AdminLinks; MagicWordwgVariableIDs; MakeGlobalVariablesScript; ParserAfterTidy; PageSchemasRegisterHandlers; ParserFirstCallInit; UnitTestsList;
Licence	Licence publique générale GNU v2.0 ou ultérieur
Téléchargement	GitHub: page du projet; URL du dépôt git; historique des validations; ;
Exemple	Verwaltungskooperation

This page is a translated version of the page Extension:Semantic Drilldown and the translation is 87% complete.

Avertissement :

La version 6.0.0 supprimera le support de PageSchemas.

L'extension Semantic Drilldown fournit une page pour scruter les données d'un site en utilisant les catégories et les filtres sur les propriétés sémantiques. Elle est fortement liée à l'extension Semantic MediaWiki qui ajoute des annotations sémantiques qui permettent à un wiki de fonctionner comme une base de données collaborative.

Installation

Semantic MediaWiki doit être installé pour que cette extension fonctionne.
Téléchargez et placez le(s) fichier(s) dans un répertoire appelé SemanticDrilldown dans votre dossier extensions/.
Ajoutez le code suivant à la fin de votre fichier LocalSettings.php :
```
wfLoadExtension( 'SemanticDrilldown' );
```
Exécutez le script de mise à jour qui va créer automatiquement les tables de base de données dont cette extension a besoin.
Fait – Accédez à Special:Version sur votre wiki pour vérifier que l'extension a bien été installée.

Auteurs

Semantic Drilldown a été écrit en grande partie par Yaron Koren. Le code pour afficher les résultats de l'exploration a été écrit par David Loomer. The 'combo box' jQuery input was created by Sanyam Goyal as part of the 2010 Google Summer of Code. Le code d'interface avec l'extension Page Schemas a été créé par Ankit Garg lors du Google Summer of Code de 2011. Une grande partie du code actuel pour gérer les filtres de date a été écrite par Edward Chernenko. Des contributions utiles ont également été apportées par MWJames, Joel Natividad et autres personnes.

Historique des versions

Pour commencer

Avant de configurer Semantic Drilldown, vous devez avoir initialisé toutes les structures de données sur votre site - les propriétés, catégories, modèles et les formulaires si vous en utilisez. Voir la section Pour commencer des formulaires de page pour en savoir plus sur ce qu'il y a à réaliser.

Assurez-vous que quelques pages existent, qu'elles contiennent des annotations et appartiennent à une catégorie.

Après tout cela, aller d'abord à la page Special:BrowseData pour voir à quoi ressemble la structure des catégories de votre site.

À ce stade, vous avez deux possibilités selon que l'extension Page Schemas installée ou pas. (on présente brièvement une interface unique pour générer des modèles, des formulaires et des filtres). Si vous utilisez Page Schemas, vous pouvez revenir aux schémas des pages que vous avez déjà créés (ou en créer de nouveaux s'ils n'existent pas) et ajouter des filtres à chaque propriété correspondante via l'interface.

Si vous ne l'avez pas, vous devez utiliser la fonction parser #drilldowninfo.

Utilisation

Special:BrowseData

La page "Browse data" est le cœur de l'extension. Elle énumère toutes les catégories de haut niveau du wiki; c'est-à-dire les catégories qui ne sont pas des sous-catégories d'une autre catégorie, et le nombre de pages qu'elle contiennent chacunes. Chaque nom de catégorie est un lien vers un drilldown pour les pages de cette catégorie. Il permet à l'utilisateur de sélectionner des contraintes supplémentaires pour limiter le nombre de résultats. Ces contraintes sont de deux types :

Sous-catégories - si la catégorie possèdes des sous-catégories elles apparaîtront sur une ligne "Subcategory". Chacune d'elle représente un lien permettant à l'utilisateur de ne voir que les pages qui appartiennent à cette sous-catégorie. La page drilldown résultat comprendra des liens pour tous les filtres de la catégorie de niveau supérieur et toutes les sous-catégories de la sous-categorie sélectionnée. Vous pouvez donc utiliser la page Browse data pour naviguer dans l'ensemble de l'arbre des catégories.

Les filtres - les filtres basés sur les propriétés sémantiques peuvent être définis pour n'importe quelle catégorie de premier niveau. Chacun de ces filtres obtient sa propre ligne dans la zone des contraintes, pour ne permettre à l'utilisateur de limiter les résultats qu'aux pages qui ont certaines valeurs pour une propriété sémantique. There is special handling for filters that correspond to properties of type Date or Number - for Date filters, the time range by which values are grouped (years, months or days) depends on the distribution of the current set of values, and for Number filters, the number values are grouped into a set of ranges of approximately equal size, again depending on the current set of values.

Dans l'affichage du filtre du drilldown, les valeurs qui n'ont pas de résultat les concernant, ne sont pas affichées. Le filtre affichera également deux valeurs supplémentaires : "Other" et "None". Les pages qui apparaissent dans "Other" sont celles qui ont une valeur pour cette propriété de filtrage différente de celles spécifiées. Les pages qui apparaissent dans "None" sont celles qui n'ont pas de valeur pour cette propriété. "Other" et "None", tout comme les autres valeurs de filtrage, n'apparaissent pas quand il n'y a pas de résultats pour elles.

After any amount of clicking on different subcategories and filters, the user will be able to see, in the page header near the top of the page, the set of subcategories and filters they have clicked on, that currently set constraints on the result. L'utilisateur peut débloquer toute contrainte en cliquant sur le "x" à côté de son nom dans l'entête.

The drilldown 'results', i.e. the set of pages displayed at any given time during the drilling-down, are by default displayed in the same manner as in MediaWiki's category page; this display, however, can be customized, to show additional values for each page, or to show results in other formats such as tables, maps and timelines.

#drilldowninfo

The #drilldowninfo parser function should only be added to either top-level categories, or categories whose page contains __SHOWINDRILLDOWN__ - see Excluding and including categories from the list .

#drilldowninfo prend en compte les paramètres suivants :

filters - prend en compte l'ensemble des filtres pour cette catégorie. Dans la plupart des cas, ce sera le seul paramètre défini. Les filtres doivent être séparés par des virgules, et après le nom de chaque filtre, entre parenthèses, se trouve une clause indiquant l'un des éléments suivants :
- property - propriété Semantic MediaWiki utilisée par ce filtre (obligatoire)
- category - catégorie MediaWiki de laquelle obtenir des valeurs
- requires - numéro du filtre précédemment énuméré, pour lesquel l'utilisateur doit sélectionner une valeur avant de pouvoir voir ce filtre.

Example

{{#drilldowninfo:filters=Author (property=Was written by),
Second author (property=Was written by),
Date (property=Was published on),
Source (property=Was published by,category=Sources),
Topic (property=Addresses topic,category=Topics),
For (property=Is for, category=Positions,requires=Topic),
Against (property=Is against,category=Positions,requires=Topic),
Mixed (property=Is mixed on,category=Positions,requires=Topic)}}

Les filtres sont affichés dans Special:BrowseData dans l'ordre dans lequel ils sont répertoriés dans #drilldowninfo.

title - définit le titre de la page drilldown pour cette catégorie (facultatif).
header - définit le nom d'une page (par exemple, Template:SD Header) à afficher avant les filtres.
footer - définit le nom d'une page à afficher après la sortie du drilldown.
display parameters - Ce paramètre vous permet de définir l'affichage des résultats comme le fait l'affichage des requêtes en ligne Semantic MediaWiki : that includes both additional properties that you would want to see displayed, and the format (such as a map or calendar) in which results will be displayed. "display parameters=" takes in a set of parameters like that of an inline query, although separated by semicolons instead of pipes. Ainsi, par exemple, pour afficher les résultats d'un drilldown de catégorie sur une carte Google Maps, vous pourriez avoir ceci dans l'appel : "|display parameters=? Has coordinates;format=googlemaps3".

Vous pouvez voir un exemple simple d'utilisation de cette fonctionnalité; chaque événement a sa ville également affichée. L'appel correspondant de #drilldowninfo est ici.

Plusieurs problèmes existent avec l'utilisation de display parameters= :

Malheureusement, actuellement, un format est autorisé pour n'importe quelle catégorie.
Les paramètres sort= et order= pour les requêtes en ligne ne fonctionneront pas - les pages seront toujours triées par leur nom.
As of Semantic MediaWiki version 1.8 and later wiki markup and html in properties of type text is displayed as plain text in various table result formats (table, broadtable, datatables), a workaround would be using result format template to create tabular output

Options d'affichage

Affichage des valeurs de filtre dans le style des balises du cloud

You can set the drilldown page to show the values for each filter and each subcategory in "tag-cloud" style, where the size of each value's name is dependent on the number of results it has. To do this, you need to add two values to your LocalSettings.php file, $sdgFiltersSmallestFontSize and $sdgFiltersLargestFontSize; these represent the font size of the names of the least-popular and most-popular filter values, respectively, in pixels. Voici un exemple :

$sdgFiltersSmallestFontSize=9;
$sdgFiltersLargestFontSize=25;

Assurez-vous d'ajouter ceci après l'inclusion de Semantic Drilldown lui-même.

Définir le nombre de résultats par page

By default, the list of results, or pages that match the current set of filters, is displayed in the style of a category page, with a maximum of 100 results per page. You can change the number of results per page in your LocalSettings.php file, by setting the variable $sdgNumResultsPerPage. Pour que chaque page affiche 250 résultats, ajouter ceci :

$sdgNumResultsPerPage=250;

Définir l'affichage des valeurs de filtrage

For filters that have above a certain number of values, values are shown in a combo box, instead of individually. Par défaut, ce nombre vaut 40. Pour changer la valeur, ajoutez quelque chose comme ceci à LocalSettings.php :

$sdgMinValuesForComboBox=50;

...or you can set it to 0 or 1 if you want filter values to always show up within a combo box, in order to boost performance; values shown individually require an additional database query in order to get the number of instances of that value.

For filters that correspond to Number properties, the values are automatically grouped into ranges, with an attempt to create ranges of roughly equal size while still having "nice" numbers for the boundaries (e.g., 1200 instead of 1234). Par défaut, les valeurs sont regroupées en 6 catégories. Pour changer cette valeur, ajoutez quelque chose comme ceci à LocalSettings.php :

$sdgNumRangesForNumberFilters=4;

Masquer les filtres sans valeur

Par défaut les filtres sans valeur affichent "(There are no values for this filter)". Si vous voulez masquer des filtres sans valeur, définissez

$sdgHideFiltersWithoutValues=false;

Affichage des catégories

By default, a list of all top-level categories on the wiki shows up on one side of the "Browse data" page, to let users navigate to the drilldown interface for each such category. However, this display can be modified in a number of ways.

Supprimer la liste des catégories

You may want to have the drilldown page show the data only for one category, and not display the list of other categories. To do that, just add the string ?_single to anywhere in the URL query string; this will remove the list of categories.

Afficher le nom des catégories sous forme d'onglets

Si vous ajoutez la ligne suivante à LocalSettings.php :

$sdgShowCategoriesAsTabs = true;

...it will display categories as tabs at the top of the page, instead of in a vertical list on the side of the page. Cette option est plus logique pour les sites ayant un nombre plus petit de catégories (moins de sept ou environ).

Exclure et inclure des catégories de la liste

Vous voudrez peut-être ne pas voir certaines catégories dans la liste des catégories de premier niveau. Vous pouvez facilement supprimer une catégorie en ajoutant les éléments suivants n'importe où sur la page de la catégorie :

__HIDEFROMDRILLDOWN__

À l'inverse, il y a certaines catégories que vous voudrez peut-être afficher dans la liste principale BrowseData, même si elles ne sont pas des catégories de haut niveau. Vous pouvez également y parvenir en ajoutant ceci à la page de la catégorie :

__SHOWINDRILLDOWN__

À l'inverse, vous pouvez également définir des catégories qui ne figurent dans la liste que si vous les incluez spécifiquement, c'est-à-dire qu'elles ont une approche opt-in au lieu de opt-out. Vous pouvez le faire en ajoutant ceci à LocalSettings.php :

$sdgHideCategoriesByDefault = true;

Si vous faites cela, seules les catégories marquées avec __SHOWINDRILLDOWN__ apparaîtront. (La marque __HIDEFROMDRILLDOWN__, en revanche, deviendra non significative.)

Lien vers une page drilldown

La meilleure façon d'aller sur Special:BrowseData est d'utiliser la fonction d'analyse #drilldownlink. La syntaxe est la suivante;

{{#drilldownlink:category=|subcategory=|single|link text=|tooltip=|filters=}}

Les paramètres sont les suivants :

category - nom de la catégorie
subcategory - sous-catégorie (s'il y en a)
single - si ce paramètre est ajouté, la liste des catégories n'est pas affichée
link text - texte du lien; par défaut, c'est le nom de la catégorie
tooltip - texte qui apparaît lorsque le curseur survole le lien, le cas échéant
filters - ensemble des filtres à appliquer, au format a=b&c=d&...

Sites qui utilisent Semantic Drilldown

Voici un petit échantillon de sites qui utilisent Semantic Drilldown :

Liste de diffusion

Vous devez utiliser la liste de diffusion de Semantic MediaWiki, semediawiki-user, pour toute question, suggestion ou rapport de bogue concernant Semantic Drilldown. Si possible, veuillez ajouter "[SD]" au début de la ligne de l'objet, pour préciser le sujet.

Contribuer au projet

Bogues et demandes de fonctionnalité

Vous pouvez soumettre des rapports de bogues et des demandes de nouvelles fonctionnalités dans le suivi des bogues GitHubs.

Voir la liste des bogues connus et des fonctionnalités demandées actuellement pour Semantic Drilldown.

Traductions

La traduction de Semantic Drilldown est faite via translatewiki.net. Traduire cette extension. To add language values or change existing ones, you should create an account on translatewiki.net, then request permission from the administrators to translate a certain language or languages on this page (this is a very simple process). Dès que vous avez les droits pour une langue donnée, vous pouvez vous connecter et ajouter ou modifier les messages que vous souhaitez dans cette langue.

Voir aussi

Cargo - fournit une interface drilldown similaire, par dessus un système de stockage différent

Cette extension est incluse dans les fermes de wikis ou les hôtes suivants et / ou les paquets :