====== Fichier categories.xml : définir des catégories de corpus======

Le moteur Scrutari permet de regrouper des corpus issus de bases différentes au sein de « catégories ». Dans la Coredem, par exemple, tous les corpus des différents sites qui correspondent à des dossiers sont réunis dans la catégorie « dossiers ».

Le nombre de catégories n'est pas limité. Il existe toujours une catégorie « par défaut » dans lequel sont placés tous les corpus dont la catégorie n'est pas explicitement définie dans le fichier de configuration (si ce dernier n'existe pas, tous les corpus sont dans la catégorie par défaut).

Les catégories sont ordonnées. Cette ordonnancement joue un grand rôle dans l'ordre des fiches puisque toutes les fiches d'une catégorie supérieure sont placées avant les fiches d'une catégorie inférieure. Dans la Coredem, l'ordre des catégories est la suivante : //Concepts// > //Sites// > //Dossiers// > //Ouvrages// > //Textes et documents// (cette dernière catégorie étant la catégorie par défaut).

===== Structure du format XML =====

L'élément racine est l'élément !!<categories>!!. Il contient un nombre illimité d'éléments !!<category>!! qui définissent les catégories. Un élément //<category>// possède l'attribut !!@name!! qui correspond au nom de la catégorie et il contient un nombre illimité d'éléments  !!<label>!! indiquant l'intitulé de la catégorie dans une langue donnée. Un élément //<category>// peut aussi contenir des éléments !!<phrase>!! et !!<attr>!! en vue de personnalisation comme indiquée à la page [[serveurscrutari:config:phrases_attributs|Phrases et attributs]].

Les intitulés de la catégorie par défaut peuvent être définis en insérant un élément //<category>// avec comme valeur !!_default!! pour l'attribut //@name//.

L'ordre des éléments //<category>// est important car il définit l'ordre des catégories (dans l'ordre décroissant : les premières catégories définies sont placées en premier). La catégorie par défaut n'est pas obligatoirement la dernière, elle peut être placée avant d'autres catégories (si on définit par exemple une catégorie « archives » qui contient des fiches de moindre importance).

Ensuite, l'élément //<corpus-classes>// contient un nombre illimité d'éléments !!<corpus-list>!! (normalement, un par catégorie). Un élément //<corpus-list>// possède l'attribut !!@classe-name!! qui a pour valeur le nom de la catégorie correspondant à la liste et il contient des éléments !!<uri>!! qui ont comme valeur l'URI des corpus en question. 

==== Exemple ====

L'exemple suivant est la définition des catégories de la Coredem (en septembre 2014). Cinq catégories sont définies : Lexicommon (avec un seul corpus), Sites (un seul corpus également), Dossiers (huit corpus), Ouvrages (quatre corpus), Revues (Un corpus).

La catégorie par défaut a comme intitulé en français « Textes et documents ».

<code xml>
<categories>
    <category name="concept">
        <label xml:lang="fr">Lexicommon</label>
        <label xml:lang="en">Lexicommon</label>
        <label xml:lang="es">Lexicommon</label>
        <label xml:lang="pt">Lexicommon</label>
    </category>
    <category name="site">
        <label xml:lang="fr">Sites ressources</label>
        <label xml:lang="en">Websites</label>
        <label xml:lang="es">Sitios de recursos</label>
        <label xml:lang="pt">Sites-fonte</label>
    </category>
    <category name="dossier">
        <label xml:lang="fr">Dossiers</label>
        <label xml:lang="en">Dossiers</label>
        <label xml:lang="es">Dosiers</label>
        <label xml:lang="pt">Dossiês</label>
    </category>
    <category name="ouvrage">
        <label xml:lang="fr">Ouvrages</label>
        <label xml:lang="en">Books</label>
        <label xml:lang="es">Libros</label>
        <label xml:lang="pt">Livros</label>
    </category>
    <category name="revue">
        <label xml:lang="fr">Revues et cahiers</label>
        <label xml:lang="en"></label>
        <label xml:lang="es"></label>
        <label xml:lang="pt"></label>
    </category>
    <category name="_default">
        <label xml:lang="fr">Textes et documents</label>
        <label xml:lang="en">Texts and documents</label>
        <label xml:lang="es">Textos y documentos</label>
        <label xml:lang="pt">Textos e documentos</label>
    </category>
  <corpus-list category-name="concept">
                <uri>corpus:/7121aba0-5232-11e1-b86c-0800200c9a66/coredem_lexicommmon/lexicommon</uri>
  </corpus-list>
  <corpus-list category-name="site">
    <uri>corpus:/e17a05b0-c45e-11d8-9669-0800200c9a66/sitecoredem/site</uri>
  </corpus-list>
  <corpus-list category-name="dossier">
    <uri>corpus:/e17a05b0-c45e-11d8-9669-0800200c9a66/dph/dossiers</uri>
    <uri>corpus:/e17a05b0-c45e-11d8-9669-0800200c9a66/irenees/dossier</uri>
    <uri>corpus:/e17a05b0-c45e-11d8-9669-0800200c9a66/rsp/dossier</uri>
                <uri>corpus:/e17a05b0-c45e-11d8-9669-0800200c9a66/ire/dossier</uri>
                <uri>corpus:/e17a05b0-c45e-11d8-9669-0800200c9a66/culturemedia/dossier</uri>
                <uri>corpus:/e17a05b0-c45e-11d8-9669-0800200c9a66/cetim/dossier</uri>
                <uri>corpus:/e17a05b0-c45e-11d8-9669-0800200c9a66/agter/dossier</uri>
                <uri>corpus:/e17a05b0-c45e-11d8-9669-0800200c9a66/premiermai/selection</uri>
  </corpus-list>
    <corpus-list category-name="revue">
        <uri>corpus:/7121aba0-5232-11e1-b86c-0800200c9a66/passerelles/passerelles</uri>
    </corpus-list>
  <corpus-list category-name="ouvrage">
    <uri>corpus:/e17a05b0-c45e-11d8-9669-0800200c9a66/eclm/eclm</uri>
    <uri>corpus:/e17a05b0-c45e-11d8-9669-0800200c9a66/ire/ouvrage</uri>
    <uri>corpus:/e17a05b0-c45e-11d8-9669-0800200c9a66/cetim/publication</uri>
    <uri>corpus:/7121aba0-5232-11e1-b86c-0800200c9a66/passerelles/passerelles</uri>
  </corpus-list>
</categories>
</code>

===== DTD =====

<code xml>
<!ELEMENT categories (category*,corpus-list*)>

<!ELEMENT category (label*|phrase*|attr*)>
   <!ATTLIST category name NMTOKEN #REQUIRED>


<!ELEMENT corpus-list (uri*)>

   <!ELEMENT uri (#PCDATA)>

<!ELEMENT phrase (label*)>
   <!ATTLIST phrase name NMTOKEN #REQUIRED>

<!ELEMENT label (#PCDATA)>
   <!ATTLIST label xml:lang NMTOKEN #REQUIRED>
   
<!ELEMENT attr (val+)>
   <!ATTLIST attr ns NMTOKEN #REQUIRED>
   <!ATTLIST attr key NMTOKEN #REQUIRED>
 
<!ELEMENT val (#PCDATA)>

</code>