Ceci est une ancienne révision du document !


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 metadata (title?|description?|icon?|website?|default-lang-ui?|attr*)>
 
<!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)>
serveurscrutari/config/metadata.1474904452.txt.gz · Dernière modification: 2016/09/26 17:40 par vincent
CC Attribution-Share Alike 4.0 International
Driven by DokuWiki Recent changes RSS feed Valid CSS Valid XHTML 1.0