Skip to content
forked from a10s-ca/ladsr-ds

Gabarits de données structurées de La danse sur les routes du Québec

Notifications You must be signed in to change notification settings

saumier/ladsr-ds

 
 

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

75 Commits
 
 
 
 
 
 
 
 
 
 

Repository files navigation

Gabarits de données structurées de La danse sur les routes du Québec

Ce dépôt contient les gabarits de données structurées utilisés par le site web de La danse sur les routes du Québec.

Il s'agit de gabarits de données structurées au format JSON-LD s'appuyant sur le vocabulaire Schema.org.

Contenu

Les gabarits contiennent :

Ces gabarits ont été construits dans le contexte du site de La danse sur les routes du Québec. Bien qu'ils comportent des références à des données qui ne sont pas disponibles sur ce site, ils sont dans l'ensemble adapté à sa structure et ses contraintes. Il faut donc faire preuve de discernement pour les utiliser dans un autre contexte.

Par ailleurs, dans cet esprit, les différentes notes du présent document, et les notes accompagnant les gabarits, font parfois référence à des spécificités de l'architecture et de la technologie du site de La danse sur les routes. Encore une fois, le lecteur est invité à adapter la documentation et les gabarits à son propre contexte.

Conventions

Identification des valeurs à modifier dans le gabarit

Les gabarits sont rendus disponibles sous forme de fichier contenant des données au format JSON-LD.

Pour faciliter leur compréhension, des notes ou des explications ont été incluses comme valeur pour certaines clés. Lorsque c'est le cas, elles ont été placées entre crochets doubles ({{}}). Par exemple:

"url": "{{url complète vers la page web concernée}}"

Une fois le gabarit utilisé et rempli avec des données, il ne devrait plus contenir de crochets doubles. Par exemple:

"url": "https://ladansesurlesroutes.com/"

Utilisation des tableaux

La syntaxe JSON-LD/Schema.org permet d'indiquer un objet, plutôt qu'un tableau d'objets, pour les clés où le tableau contient un seul item. Pour faciliter la lecture, les gabarits présentent toujours des tableaux lorsqu'il est possible d'inclure plusieurs valeurs pour une clé.

Donc, même si le passage suivant est valide:

"sameAs": "https://www.facebook.com/ladansesurlesroutes"

Le gabarit sera plutôt présenté comme ceci, pour clarifier le fait qu'il est possible d'inclure plusieurs valeurs à la clé sameAs:

"sameAs": ["https://www.facebook.com/ladansesurlesroutes"]

Identifiants

Les identifiants utilisés pour les clés @id de différents gabarits peuvent être de n'importe quel format.

Toutefois, pour rendre les choses simple et respecter une convention souvent utilisée dans les données structurées et liées, nous suggérons d'utiliser dans la mesure du possible une URI identique à l'URL comme identifiant, en ajoutant un anchor au besoin.

Ainsi, comme les oeuvres, les compagnies et les chorégraphes disposent chacun d'une URL unique, le @id pourrait être l'URL en question.

Pour les représentations, qui ne disposent pas d'une URL unique, le @id pourrait être l'URL de l'oeuvre, suivi d'un anchor correspondant à la représentation, par exemple par son numéro d'enregistrement Airtable.

D'un modèle à l'autre, les @id doivent être cohérents, c'est à dire que si une URI est utilisée comme @id sur la page d'un chorégraphe, c'est cette même URI qui doit être utilisée lorsque le chorégraphe est mentionné comme creator dans creativeWork ou comme director dans Event.

ISNI, VIAF et autres identifiants

L'ajout d'identifiants externes est facultatif mais recommandé.

Accès aux gabarits

  • Organization, pour les organisations (diffuseurs, agences, compagnies de danse)
  • Person, pour les chorégraphes indépendants
  • CreativeWork, pour les oeuvres chorégraphiques
  • Event, pour les représentations

About

Gabarits de données structurées de La danse sur les routes du Québec

Resources

Stars

Watchers

Forks

Releases

No releases published

Packages

No packages published