This page is dedicated to translate WikiLens/StructuredDataTutorial in LangueFran?aise.

Cette page est destin?e aux utilisateurs de pages de donn?es structur?es. Si vous ?tes un programmeur plein de bonne volont? pour ?crire des plugins qui interagissent avec des donn?es structur?es, vous devriez regarder en anglais la page WikiLens/StructuredDataTutorial/Developers.

Pour cr?er une Category WikiLens pour des objets disposant en eux de donn?es structur?es (comme le Titre et l'Auteur d'un livre dans Category Book, ou le Prix et le Lieu pour une Category Restaurant) :

1. Cr?ez la page nouvelle category. Vous pouvez ais?ment le faire ? partir de la page d'accueil du Wiki en cliquant sur Create Category^#1 et en suivant les instructions.

2. Ajoutez une ligne ? la page category qui pointe vers les champs de la page pour la nouvelle Category. Un nom int?ressant pour cette page est <NewCategory>/Fields. Exemple

   Fields: Restaurant/Fields

3. Ajouter les champs ? la page Fields en ?ditant directement cette page. Les choses qui peuvent aller sur les "Fields" sont :

   • le nom d'un champ (field). Ce champ est par d?faut une bo?te une bo?te de texte avec une taille par d?faut. Pour cr?er un champs, mettez simplement une ligne avec un * et le nom du champ. Exemple :

    * Nom
    * Adresse

• Une bo?te de texte ? taille fixe. Ce champ est un widget de type bo?te texte avec taille optionnelle et param?tres mot-cl? de longueur maximale. Exemple :

    * Zip
      * Widget: textbox(size=5,maxlength=10)

• Un jeu de boutons radio. Tr?s pratiques quand seul un choix parmi plusieurs choix doit ?tre fait. Comme avec n'importe quel champ, un nom optionnel peut ?tre r?gl? avec l'option * Name. Ce nom sera utilis? dans l'affichage pour les utilisateurs, mais pas en interne. Un bouton radio gadget est de type radio, avec des "keyword parameter cols" pour d?finir combien de colonnes les options devraient "lined up in". Les s?lections disponibles devraient ?tre list?es sous une option Options. Notez qu'il y a aussi une opiton par d?faut utilis?e ici. Ceci sp?cifie quelle valeur ce champ a pour les items qui n'ont pas encore eu une valeur sp?cifi?e par quelqu'un.

Exemple :

    * lunchCost
      * Name: Average lunch cost
      * Widget: radio(cols=6)
      * Options:
        * $3-5
        * $5-7
        * $7-10
        * $10-15
        * $15-20
        * $20+
      * Default: $5-7

• Un jeu de bo?te ? cocher. Une ou plus de ces bo?tes peuvent ?tre coch?es. Le widget est appel? bo?te ? cocher, et il prend les m?mes param?tre de colonnes que les boutons radio. Notez aussi que les options se lisent ici dans "key: value" form. Les utilisateurs verront la section valeur de l'option, mais au moment de stocker les donn?es, le syst?me utilisera la cl?. Ceci s'av?re pratique pour les cas o? vous attendez que le texte des choix pr?sent?s ? l'utilisateur puisse ?tre modifi?. Exemple:

    * otherFeatures
      * Name: Other features
      * Widget: checkbox
      * Options:
        * veggie: Has vegetarian entrees
        * lunch_buffet: Has lunch buffet

• D'autre formes de widget support?s sont :

  • select - une bo?te de liste qui accepte de multiple s?lections (le param?tre taille sp?cifie la taille de la bo?te liste)
  • dropdown - un menu d?roulant vers le bas ou une bo?te liste d?pendant du param?tre taille qui accepte une s?lection unique
  • textarea - une bo?te de saisie de texte multi-ligne (les param?tres de lignes et colonnes sp?cifient sa dimension)
  • hidden - un champ qui n'est pas affich? mais stock? et peut ?tre ?dit? manuellement dans le texte Wiki

Une belle fonctionnalit? du support des donn?es structur?es dans WikiLens est qu'il essaiera de s'ajuster tant que vous faites des modifications aux types de donn?es structur?es. En particulier, il fait un beau travail en s'arrangeant pour vos ajouts de champs d'une cat?gorie. Il fait encore un travail pire en modifiant les champs, parce que les vieilles valeurs pourraient ne plus avoir de sens. Pour des options qui modifient, la m?thode "key: value" de sp?cification d'options vous permet de modifier le texte d'une option sans modifier les donn?es.

¹ voir Cr?erCategory