Aide:SemanticMediaWiki

De Scoutopedia
Révision datée du 30 juin 2015 à 11:51 par Ahupond (discussion | contributions) (→‎Annotations)
(diff) ← Version précédente | Voir la version actuelle (diff) | Version suivante → (diff)
Pour commencer
Manuel du parfait
petit Scoutopedien

Bac à sable

Aide technique
Règles générales
Règles techniques


SemanticMediaWiki est une extension du logiciel de wiki qui permet de dynamiser le fonctionnement du site Scoutopédia.

Présentation générale[modifier le wikicode]

Le fonctionnement du wiki standard permet seulement d'utiliser des données statiques dans les articles, ce qui implique souvent un travail fastidieux lorsqu'une information est mise à jour, car il faut identifier l'ensemble des pages du wiki qui la contient et la modifier. Confrontés à ce problème, beaucoup de wikis commencent par dresser des bots.

SemanticMediaWiki permet d'automatiser ces tâches en associant pour chaque article des valeurs à des propriétés puis à les référencer dans d'autres articles. Lorsque l'information est modifiée dans l'article d'origine, toutes les pages qui font référence à cette valeur seront automatiquement modifiées sans avoir besoin de l'intervention d'un utilisateur.

Sur Scoutopédia, nous utilisons cette extension principalement pour afficher les groupes sur des cartes dynamiques, sans avoir à modifier les articles des échelons à chaque fois qu'un nouveau groupe est créé, qu'un groupe est fermé ou déplacé. Il suffit de modifier la page du groupe et celle des échelons supérieurs est automatiquement modifiée grâce à cette extension.

L'intérêt de SemanticMediaWiki est multiple. Il permet de :

  • Générer des listes automatiques. Celles-ci sont construites automatiquement par l'extension, il n'y a plus de copie des données à faire, ni de report des modifications d'une page à l'autre.
  • Représenter les données de manière visuelle. Il est possible de représenter des données géographiques sur une carte, de construire des tables de données, de représenter des articles dans un ordre chronologique pour visualiser en enchainement d'évènements, ...
  • Structurer les données. Il est possible de facilement construire des pages qui indiquent des données comme Quels sont les groupes scouts qui ont ouvert dans les années 1920 ? Des concepts comme l'inclusion d'une année dans une décennie, ou l'inclusion d'un point géographique dans une surface géographique sont compris par l'extension, il est donc facile de résoudre ce type de problème.
  • Rechercher des informations. Un utilisateur qui souhaiterait connaitre la liste des groupes scouts accueillant des garçons dans le département du Rhin peut très facilement le faire.
  • Réutilisation extérieure. Il est possible de récupérer les données sémantiques depuis d'autres sites, ce qui permet d'enrichir d'autres logiciels informatique avec les données gérées par Scoutopédia. Si un autre site s'appuie sur nos données sur les groupes, à chaque fois qu'un utilisateur met à jour les effectifs d'un groupe scout, la modification sera prise en compte dans son logiciel également !
  • Intégration de données. De même, il serait techniquement possible d'interconnecter Scoutopédia avec d'autres systèmes informatiques. nous pourrions récupérer les effectifs d'un groupe SGDF directement depuis l'intranet de l'association par exemple. Attention ! Ce scénario est hypothétique et n'a pour seule vocation que de montrer les possibilités de l'extension !

Propriétés[modifier le wikicode]

La première étape pour utiliser SemanticMediaWiki est de créer une propriété. On utilise également le terme attribut pour désigner une propriété, les deux mots sont équivalents.

Une propriété va désigner une valeur ayant un sens précis pour chaque article. Par exemple, on peut créer une propriété qui va permettre d'indiquer, pour chaque article, sa position géographique. Une propriété n'a pas a être universelle, cela signifie qu'on peut parfaitement créer une propriété de positionnement géographique, même si des articles traitent de sujets pour lesquels une position géographique n'a pas d'intérêt. Pour ces articles là, il suffit de ne pas valoriser la propriété et l'article ne sera pas pris en compte dans les requêtes sémantiques qui l'utilisent.

Pour créer un propriété, il va d'abord falloir lui choisir un type de donnée.

Admettons que je souhaite créer une propriété nommée « Coordonnées GPS » de type « Coordonnées géographiques ».

Pour cela je vais créer la page Attribut:Coordonnées GPS et lui mettre en contenu :

[[A le type::Coordonnées géographiques]]

Admettons que je souhaite créer une propriété nommées « Test » de type « Texte » et que je veux limiter les valeurs possible à « test1 » ou « test 2 ».

Pour cela je vais créer la page Attribut:Test et lui mettre en contenu :

[[A le type::Texte]] [[Valeur possible::test1]] [[Valeur possible::test2]]

Il est recommandé d'enrichir cette page pour documenter son utilisation. La liste de toutes les pages utilisant l'attribut et les valeurs qui sont associées à chaque page s'affiche en bas de la page de chaque attribut. Un formulaire est disponible pour vous aider à créer la page ; au lieu de cliquer sur Créer, il suffit de créer sur Créer avec un formulaire.

Annotations[modifier le wikicode]

Une fois la propriété créée, je vais vouloir associer des valeurs à mes articles pour cette propriété. Cette opération s'effectue en utilisant une annotation. Par exemple, je souhaite indiquer que la position GPS de l'article « Test » est « 1.23456 2.34567 ». Je viens de créer la page « Attribut:Position » avec [[A le type::Coordonnées géographiques]]

Pour cela, il me suffit de modifier l'article « Test » en ajoutant l'une des notations suivantes :

  • [[Position::1.23456 2.34567]] (cela va afficher la valeur)
  • [[Position::1.23456 2.34567|Autre]] (cela va afficher « Autre »)
  • {{#set:Position=1.23456 2.34567}} (cela n'affiche rien)

Une fois l'article modifié, la page Attribut:Position sera automatiquement modifiée. On pourra y voir que la page « Test » est associée à la valeur « 1.23456 2.34567 » pour cet attribut. Ensuite, on pourra afficher un lien vers l'article dans une carte à sa position géographique, par exemple.

Bien évidemment, il est possible d'annoter des pages via des modèles. C'est d'ailleurs ce qui est fait pour les pages de groupe.


Avertissement Attention !
Les requêtes sémantiques sont mises en cache pour éviter que le serveur ne meure dans d’atroces souffrances à chaque requête.

Cela signifie que les modifications des valeurs mettront un certain temps avant d'être prises en compte.

Ces informations sont données à titre documentaire. Scoutopedia ne saurait être tenu responsable d'incidents survenus au cours de l'utilisation de ces techniques.

Recherche[modifier le wikicode]