Fichier attributes.xml : définir les attributs utilisés

Le format ScrutariData permet d'associer des attributs à une fiche avec la liberté d'indiquer la clé de l'attribut. Encore faut-il configurer le moteur Scrutari pour qu'il sache quoi faire avec ces attributs. C'est le rôle du fichier attributes.xml.

Dans ce fichier, les attributs sont regroupés par groupe désignés par un nom. Scrutari considère trois groupes avec les noms suivants :

• primary : attributs du premier groupe, considérés comme « supérieurs » aux champs complémentaires : ils seront placés avant eux
• secondary : attributs du second groupe, placés après les champs complémentaires
• technical : attributs techniques qui sont pas traités comme du texte, les recherches ne portent pas dessus mais ils peuvent servir pour des filtres

Le moteur Scrutari propose des attributs prédéfinis, avec leurs libellés dans plusieurs langues :

• sct:authors : auteurs d'un document (cet attribut est typiquement placé dans le premier groupe)
• sct:thumbnail : URL d'une image servant de vignette pour la fiche (cet attribut est typiquement placé

Ils ne sont cependant pas inclus par défaut. Il faut les indiquer spécifiquement. Il faut considérer ces attributs prédéfinis comme des suggestions.

Outre son nom, il est possible d'indiquer le libellé de l'attribut dans différentes langues et son format. Le format est utile pour les attributs qui ont plusieurs valeurs.

Les trois formats possibles sont les suivants :

* inline : valeurs

L'élément racine est l'élément <attributes>, il contient un ou plusieurs éléments <group>. Un élément <group> possède l'attribut @name qui est le nom du groupe et contient un ou plusieurs élements <attr-def> qui sont les définitions des attributs.

Un élément <attr-def> possède deux attributs : @ns l'espace de noms de l'attribut et @key la clé locale de l'attribut (la clé complète de l'attribut est consitué de l'espace de noms et de la clé locale). Il peut contenir un ou plusieurs élements <lib> qui sont les libellés de l'attribut dans différentes langues.

Dans cet exemple, le libellé de l'attribut par défaut sct:authors est renommé pour correspondre aux réalisateurs.

<attributes>
    <group name="primary">
	<attr-def ns="sct" key="authors">
	    <lib xml:lang="fr">Réalisateurs</lib>
	</attr-def>
    </group>
    <group name="secondary">
	<attr-def ns="cine" key="producteurs">
	   <lib xml:lang="fr">Producteurs</lib>
	</attr-def>
    </group>
</attributes>

<!ELEMENT attributes (group*)>
 
<!ELEMENT group (attr-def*)>
   <!ATTLIST group name NMTOKEN #REQUIRED>
 
<!ELEMENT attr-def (lib*)>
   <!ATTLIST attr-def ns NMTOKEN #REQUIRED>
   <!ATTLIST attr-def key NMTOKEN #REQUIRED>
 
<!ELEMENT lib (#PCDATA)>
   <!ATTLIST lib xml:lang NMTOKEN #REQUIRED>