Ceci est une ancienne révision du document !
−Table des matières
Fichier metadata.xml : définir les méta-données du moteur
Le fichier de configuration metadata.xml permet d'indiquer un certain nombre d'information comme son nom en plusieurs langues, une description courte, la langue à utiliser par défaut, etc.
Structure du format XML
L'élément racine est l'élément <metadata> qui peut contenir les éléments (en un seul exemplaire) :
- <title> qui indique le titre du moteur : il contient des éléments <label> possédant l'attribut @xml:lang indiquant le titre dans une langue donnée
- <description> qui est une description courte (une phrase) et qui comme <title> contient des éléments <label> avec l'attribut @xml:lang
- <icon> qui indique l'URL d'une image de 16 pixels sur 16 servant d'icone d'identification du moteur
- <website> : URL d'un site sur lequel l'internaute pourra avoir plus d'information sur le moteur et le contenu qu'il traite
- <default-lang-ui> : langue à utiliser par défaut pour l'interface du moteur et pour l'affichage des résultats si aucune langue n'est indiquée.
Cet élément peut également contenir des éléments <attr> désignant des attributs, c'est à dire des informations au contenu libre que Scrutari lui-même ne traite pas et qui peuvent être utile dans des configurations particulières. Un élément <attr> possède les attributs @ns qui est l'espace de nom, et @key la clé locale et il contient un ou plusieurs éléments <val> qui sont les valeurs de l'attribut.
Exemple
L'exemple suivant est le fichier metadata.xml de la Coredem
<?xml version="1.0" encoding="UTF-8"?> <metadata> <title> <label xml:lang="fr">Coredem</label> <label xml:lang="es">Coredem</label> <label xml:lang="en">Coredem</label> <label xml:lang="pt">Coredem</label> </title> <description> <label xml:lang="fr">Initiative collective de partage de savoirs et d’outils libres</label> <label xml:lang="es">Iniciativa colectiva de intercambio de conocimientos</label> <label xml:lang="en">Collective initiative of knowledge sharing</label> <label xml:lang="pt">Iniciativa coletiva de troca de conhecimentos</label> </description> <icon>http://scrutari.coredem.info/coredem.png</icon> <website>http://www.coredem.info/</website> </metadata>
DTD
<!ELEMENT sources (source*)> <!ELEMENT metadata (title?|description?|icon?|website?|default-lang-ui?|attr*)> <!ATTLIST source name NMTOKEN #REQUIRED> <!ELEMENT title (label*)> <!ELEMENT description (label*)> <!ELEMENT icon (#PCDATA)> <!ELEMENT website (#PCDATA)> <!ELEMENT default-lang-ui (#PCDATA)> <!ELEMENT attr (val+)> <!ATTLIST attr ns NMTOKEN #REQUIRED> <!ATTLIST attr key NMTOKEN #REQUIRED> <!ELEMENT val (#PCDATA)>