| Les deux révisions précédentesRévision précédenteProchaine révision | Révision précédente |
| serveurscrutari:config:attributes [2015/03/27 19:04] – [Fichier attributes.xml : définir les attributs utilisés] vincent | serveurscrutari:config:attributes [2017/11/02 11:54] (Version actuelle) – vincent |
|---|
| * //technical// : attributs techniques qui sont pas traités comme du texte, les recherches ne portent pas dessus mais ils peuvent servir pour des filtres | * //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 : | Le moteur Scrutari propose des attributs prédéfinis avec l'espace de nom //ns//, avec leurs libellés dans plusieurs langues : |
| * //sct:authors// : auteurs d'un document (cet attribut est typiquement placé dans le premier groupe) | * //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é | * //sct:tags// : mots-clés libres |
| | * //sct:thumbnail// : URL d'une image servant de vignette pour la fiche (cet attribut est typiquement placé dans le groupe des attributs techniques) |
| | * //sct:website// : site web vers lequel renvoie la fiche (par exemple, la fiche d'un organisme) |
| |
| 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, l'utilistation d'attributs communs permettant la réutilisation d'un fichier au format ScrutariData d'un moteur Scrutari à un autre. | Ils ne sont cependant pas inclus par défaut. Il faut les indiquer spécifiquement (le moteur propose des libellés par défaut qui peuvent être modifiés). Il faut considérer ces attributs prédéfinis comme des suggestions, l'utilisation d'attributs communs permettant la réutilisation d'un fichier au format ScrutariData d'un moteur Scrutari à un autre. |
| |
| Outre son nom, il est possible d'indiquer le libellé de l'attribut dans différentes langues et son format. Le format sert surtout pour indiquer le mode d'affichage à utiliser de préférence pour les valeurs pour les attributs. L'impact d'un format est surtout visible pour les attributs multi-valués (avec plusieurs valeurs) | Outre son nom, il est possible d'indiquer le libellé de l'attribut dans différentes langues et son format. Le format sert surtout pour indiquer le mode d'affichage à utiliser de préférence pour les valeurs pour les attributs. L'impact d'un format est surtout visible pour les attributs multi-valués (avec plusieurs valeurs) |
| |
| Les trois formats possibles sont les suivants : | Les formats possibles sont les suivants : |
| |
| * //inline// : les valeurs sont disposés sur une même ligne, séparé par une virgule (exemple des auteurs), c'est le mode par défaut | * //inline// : les valeurs sont disposés sur une même ligne, séparé par une virgule (exemple des auteurs), c'est le mode par défaut |
| 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. | 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. Il peut contenir un élément //<format>// pour indiquer le format de l'attribut, cet élément ayant par ailleurs un seul attribut //@type// qui doit avoir comme valeur //inline//, //list// ou //block//. | 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 !!<label>!! qui sont les libellés de l'attribut dans différentes langues. Il peut contenir un élément !!<format>!! pour indiquer le format de l'attribut, cet élément ayant par ailleurs un seul attribut !!@type!! qui doit avoir comme valeur //inline//, //list// ou //block//. |
| |
| ==== Exemple ==== | ==== Exemple ==== |
| <attributes> | <attributes> |
| <group name="primary"> | <group name="primary"> |
| <attr-def ns="sct" key="authors"> | <attr-def ns="sct" key="authors"> |
| <lib xml:lang="fr">Réalisateurs</lib> | <label xml:lang="fr">Réalisateurs</label> |
| </attr-def> | </attr-def> |
| <attr-def ns="cine" key="producteurs"> | <attr-def ns="cine" key="producteurs"> |
| <lib xml:lang="fr">Producteurs</lib> | <label xml:lang="fr">Producteurs</label> |
| </attr-def> | </attr-def> |
| </group> | </group> |
| <group name="secondary"> | <group name="secondary"> |
| <attr-def ns="cine" key="resume"> | <attr-def ns="cine" key="resume"> |
| <format type="block"/> | <format type="block"/> |
| <lib xml:lang="fr">Résumé</lib> | <label xml:lang="fr">Résumé</label> |
| </attr-def> | </attr-def> |
| </group> | </group> |
| <!ATTLIST group name NMTOKEN #REQUIRED> | <!ATTLIST group name NMTOKEN #REQUIRED> |
| | |
| <!ELEMENT attr-def (format?|lib*)> | <!ELEMENT attr-def (format?|label*)> |
| <!ATTLIST attr-def ns NMTOKEN #REQUIRED> | <!ATTLIST attr-def ns NMTOKEN #REQUIRED> |
| <!ATTLIST attr-def key NMTOKEN #REQUIRED> | <!ATTLIST attr-def key NMTOKEN #REQUIRED> |
| <!ATTLIST format type NMTOKEN #REQUIRED> | <!ATTLIST format type NMTOKEN #REQUIRED> |
| |
| <!ELEMENT lib (#PCDATA)> | <!ELEMENT label (#PCDATA)> |
| <!ATTLIST lib xml:lang NMTOKEN #REQUIRED> | <!ATTLIST label xml:lang NMTOKEN #REQUIRED> |
| |
| </code> | </code> |
| |
