Modèle XML de fiches descriptives d’espèces de poissons d’aquariophilie, inspiré d’un schéma créé en 2006 par Arnaud D’Alayer et Marilou Bourque.
Ce modèle XML définit la structure d’une fiche descriptive d'une espèce de poisson d’aquiariophilie. Il est utilisé extensivement comme exemple tout au long du cours « INU3011 Documents structurés » donné à l’EBSI, Université de Montréal.
Les fiches conformes à ce modèle sont destinées à servir de source d’informations pour toute personne s’intéressant à la tenue d’un aquarium.
| Nom | Type (générale / paramètre) | Texte de remplacement | Description | Commentaires de modélisation |
|---|---|---|---|---|
| moyMinMaxComm | paramètre | "(( (moy, min?, max?) | (min, max?) | max ), commentaires?)" | Modèle de contenu correspondant à la mesure d’une certaine caractéristique physique d’un poisson. | |
| texte | paramètre | "(section+ | para+)" | Modèle de contenu de texte structuré en sections ou en paragraphes. | |
| inline | paramètre | "(#PCDATA | lien | tempé-C | long-cm | vol-litres | em)*" | Modèle de contenu de texte rendu en un seul paragraphe. |
| élément: | Nom (idGen) | Modèle de contenu | Infobulle: courte description et, si applicable, règles d’écriture et au moins 2 exemples de contenus attendus | Commentaires de modélisation |
|---|---|---|---|---|
| attribut: | Nom de l’attribut | Type et mention de valeur par défaut | ||
| élément: | fiche-poisson | (métadonnées, poisson) | Une fiche descriptive d’une espèce de poisson d’aquariophilie. | |
| attribut: | id | NMTOKEN #REQUIRED | L’identifiant de la fiche, soit son nom de fichier, sans l’extension ".xml". Exemples: cyprinus_carpio poissonus_panus | |
| attribut: | image | (oui | non) #REQUIRED | Indique si une photo du poisson est disponible ou non dans le dossier des photos. | |
| élément: | métadonnées | (date-dern-modif, créateur+) | Les métadonnées de gestion de la fiche. | |
| élément: | poisson | (noms, famille, origines-géo, première-description?, taille-cm?, longévité-ans?, qualité-eau?, zone-de-vie?, alimentation?, aspect-physique?, dimorphisme?, comportement?, reproduction?) | L’information descriptive proprement dite de l’espèce de poisson. | |
| élément: | date-dern-modif | (#PCDATA) | Date de création ou de dernière modification de la fiche; forme AAA-MM-JJ. Exemples: 2018-09-30 2021-12-01 | |
| élément: | créateur | (#PCDATA) | Nom d’une personne ayant contribué au contenu de la fiche; forme Prénom Nom-de-famille. Un élément "créateur" par contributeur. Exemples: Jacques A. Le Maître Lam Locong | |
| élément: | noms | (nom-scientifique, nom-commun*) | Les différents noms sous lesquels l’espèce de poisson est connue. | |
| élément: | nom-scientifique | (#PCDATA) | Nom scientifique de l’espèce (habituellement un nom latin en deux mots). Inscrit avec majuscule initiale. Exemples: Cyprinus carpio Acanthicus adonis | |
| élément: | nom-commun | (#PCDATA) | Un nom populaire, en français ou en anglais, sous lequel l’espèce est connue. Inscrit avec majuscule initiale au premier mot seulement. Exemples: Carpe commune Adonis pleco | |
| attribut: | langue | (fr | en) #REQUIRED | Indique si le nom est en français (fr) ou en anglais (en). | |
| élément: | famille | (#PCDATA) | Nom de la famille à laquelle l’espèce appartient. Habituellement un nom français au pluriel. Inscrit avec majuscule initiale. Exemples: Cyprinidés Ascanidés | |
| élément: | origines-géo | (origine+, commentaires?) | Régions où l’on trouve l’espèce à l’état naturel. | |
| élément: | origine | (#PCDATA) | Une des origines géographiques de l’espèce. Si possible, utiliser une forme provenant d’un thésaurus géographique. Exemples: Amérique du Sud - Uruguay - Río Negro Australie - Queensland | |
| élément: | première-description | (nom-du-descripteur, année) | Première description scientifique de l’espèce. | |
| élément: | nom-du-descripteur | (#PCDATA) | Nom de famille de la ou des personnes ayant décrit l’espèce pour la première fois. Si plus d’un nom, les séparer par "&". Exemples: Isbrücker & Nijssen Linnaeus | |
| élément: | année | (#PCDATA) | Année où l’espèce a été décrite pour la première fois. Exemples: 1926 2000 | |
| élément: | taille-cm | ((mâle, femelle)|(%moyMinMaxComm;)) | Longueur, en centimètres, des individus de cette espèce. Exemples: <mâle><moy>20</moy></mâle><femelle><moy>15</moy></femelle> <min>43,5</min><max>55,6</max><commentaires>n=7</commentaires> | |
| élément: | longévité-ans | (%moyMinMaxComm;) | L’espérance de vie des individus de cette espèce. | |
| élément: | section | (titre, para+) | Bloc de texte consistant en un titre suivi d'un paragraphe ou plus. | |
| élément: | titre | (#PCDATA) | Titre d’une section. Exemples: Approche générale Conseils pour les débutants | |
| élément: | para | %inline; | Un paragraphe de texte. Peut contenir du texte et les sous-éléments suivants:
- em passage en emphase;
- lien lien vers autre fiche;
- tempé-C température (en °C);
- long-cm longueur (en cm);
- vol-litres volume (en litres). Exemples: Tous les spécimens ont survécu. La température atteint rarement <tempé-C>42</tempé-C>. C’est <em>inouï</em>. | |
| élément: | em | %inline; | Un passage en emphase dans un paragraphe. Peut contenir du texte et les sous-éléments suivants:
- em passage (encore plus) en emphase;
- lien lien vers autre fiche;
- tempé-C température (en °C);
- long-cm longueur (en cm);
- vol-litres volume (en litres). Exemples: plus grand que <lien id="cyprinus_carpio">Cyprinus carpio</lien>! <long-cm>10</long-cm> de moins… beaucoup <em>beaucoup</em> plus grand! | |
| élément: | lien | (#PCDATA) | Un lien vers une autre fiche. L’attribut "id" donne l’identifiant de la fiche cible, soit le nom de fichier de la fiche, sans l’extension ".xml". On doit inscrire comme contenu de l'élément le nom scientifique contenu dans la fiche cible. Exemples: Cyprinus carpio Acanthicus adonis | |
| attribut: | id | NMTOKEN #REQUIRED | Identifiant de la fiche cible, soit le nom de fichier de la fiche, sans l’extension ".xml". Exemples: cyprinus_carpio paracheirodon_axelrodi | |
| élément: | tempé-C | (#PCDATA) | Une température, en degrés Celsius. Inscrire une valeur numérique seule, sans le mot "degrés". Exemples: 34,7 -2,45 0 | |
| élément: | long-cm | (#PCDATA) | Une longueur, en centimètres. Inscrire une valeur numérique seule, sans le mot "centimètres". Exemples: 23 40,6 | |
| élément: | vol-litres | (#PCDATA) | Un volume, en litres. Inscrire une valeur numérique seule, sans le mot "litres". Exemples: 248 0,983 | |
| élément: | qualité-eau | (température-C, acidité-pH?, dureté-dGH?) | Caractéristiques de l’eau convenant à cette espèce. | |
| élément: | température-C | (%moyMinMaxComm;) | Température acceptable de l’eau (degrés Celsius). | |
| élément: | acidité-pH | (%moyMinMaxComm;) | Acidité acceptable de l’eau (pH). | |
| élément: | dureté-dGH | (%moyMinMaxComm;) | Dureté acceptable de l’eau (dGH). | |
| élément: | zone-de-vie | (#PCDATA) | Indication de la profondeur où l’on trouve habituellement l’espèce. Exemples: Fond Milieu et inférieure Surface et milieu Inférieure | |
| élément: | alimentation | (%texte;) | Informations, en format libre, concernant l’alimentation de cette espèce. | |
| élément: | aspect-physique | (%texte;) | Informations, en format libre, concernant l’aspect physique de cette espèce. | |
| élément: | dimorphisme | (%texte;) | Informations, en format libre, concernant le dimorphisme (différences entre mâles et femelles) de cette espèce. | |
| élément: | comportement | (%texte;) | Informations, en format libre, concernant le comportement de cette espèce. | |
| élément: | reproduction | (%texte;) | Informations, en format libre, concernant la reproduction de cette espèce. | |
| élément: | mâle | (%moyMinMaxComm;) | Longueur, en centimètres, des individus mâles de cette espèce. | |
| élément: | femelle | (%moyMinMaxComm;) | Longueur, en centimètres, des individus femelles de cette espèce. | |
| élément: | commentaires | (para+) | Un paragraphe ou plus de commentaires en format libre se rapportant à l’élément où ces commentaires se trouvent. | |
| élément: | moy | (#PCDATA) | Valeur numérique correspondant à la valeur moyenne d’une mesure. Ne pas inscrire le nom de l’unité. Exemples: 45,987 17 0,52 | |
| élément: | max | (#PCDATA) | Valeur numérique correspondant à la valeur maximum d’une mesure. Ne pas inscrire le nom de l’unité. Exemples: 45,987 17 0,52 | |
| élément: | min | (#PCDATA) | Valeur numérique correspondant à la valeur minimum d’une mesure. Ne pas inscrire le nom de l’unité. Exemples: 45,987 17 0,52 |