Format des Documents-Dossiers

Introduction

Le format est générique comparé à la définition des DD : les différentes formes (génératrice ou publiée) ne sont pas précisément identifiées. Les ressources particulières du document-dossier (fichier texte pour la recherche, description longue) sont vues comme des formes.

Un document-dossier consiste en un fichier zip contenant un manifeste au format XML et des ressources. Ces ressources peuvent être zippées (ex : site web) ou non (ex : document PDF). Lorsque une ressource est zippée, le manifeste décrit ses entrées déterminantes (ex : index.html pour un site web).

L'identification d'une ressource par les utilisateurs se fait essentiellement par son titre (ex : "Support Web", "Support papier", "Sources du module").

Un système interagit avec le DD en fonction des ressources qu'il supporte. Deux informations sont disponibles pour cela : un type MIME et un type applicatif.

Exemples

  • Un dépôt (une bibliothèque) proposera en téléchargement toutes les ressources, permettra la navigation dans les ressources typées web (ou possédant une entrée de ce type) et indexera les ressources de type search et text/plain.

  • Scenari sera capable d'identifier la forme génératrice par son type MIME et de l'importer.

Remarques

  • L'ordre des ressources dans le manifeste est significatif lors de leur présentation.

Éléments du manifeste

  • manifest

    Élément racine du manifeste

  • metadata

    Représente les méta-données du document dossier : titre, description, date, etc... sous la forme d'éléments Dublin Core. Ces propriétés sont éditables.

  • resources

    Élément conteneur des différentes ressources

  • resource

    Représente une ressource (forme) du document-dossier.

    Attributs :

    • path

      Chemin de la ressource dans le zip du document-dossier

    • mimeType

      Type MIME de la ressource

    • titre (optionnel)

      Titre de la ressource

      Si l'attribut n'est pas présent, la ressource ne doit pas être visible par les utilisateurs

    • type (optionnel)

      Type applicatif de la ressource

      Deux types sont proposés pour le moment :

      • web : la ressource est consultable par un navigateur

      • search : la ressource est destiné à être indexée par un moteur de recherche

  • entry

    Représente une entrée déterminante d'une ressource dans le cas d'une archive, possède les mêmes attributs que l'élément resource.

Exemple de fichier manifest.xml

<manifest xmlns="scenari.eu:polydocument:1.0">

<metadata xmlns:dc="http://purl.org/dc/elements/1.1/">

<dc:title>Les chaînes éditoriales numériques</dc:title>

<dc:subject>chaînes éditoriales, document, mise en forme</dc:subject>

<dc:description>Une chaîne éditoriale est un procédé technologique et méthodologique, issu de la recherche en ingénierie documentaire. L'approche consiste à réaliser un modèle de document, à assister les tâches de création du contenu et à automatiser leur mise en forme. L'intérêt est de réduire les coûts de production et de maintenance des contenus, et de mieux contrôler leur qualité.</dc:description>

<dc:language>fr</dc:language>

<dc:date>2011-04-05</dc:date>

<dc:publisher>scenari-platform.org</dc:publisher>

</metadata>

<resources>

<!-- Fichier texte pour la recherche -->

<resource path="Module_Exemple_text.txt" mimeType="text/plain" type="search" />

<!-- Description longue -->

<resource path="Module_Exemple_web_description.zip" title="Description du module" mimeType="application/zip">

<entryPoint path="co/Module_Exemple_description.html" mimeType="application/xhtml+xml" type="web" />

</resource>

<!-- Exemple d'une description mono-fichier -->

<!--<resource path="Module_Exemple_description.html" title="Description du module" mimeType="application/xhtml+xml" type="web" />-->

<!-- Autres formes publiées -->

<resource path="Module_Exemple_web_web.zip" title="Support Web" mimeType="application/zip">

<entryPoint path="index.html" mimeType="text/html" type="web" />

</resource>

<resource path="Module_Exemple_papier.odt" title="Support papier" mimeType="application/vnd.oasis.opendocument.text" />

<resource mimeType="application/zip" title="Support Diaporama" path="Module_Exemple_diaporama_pres.zip">

<entryPoint path="index.html" mimeType="text/html" type="web" />

<!-- Exemple dans le cas d'un diaporama Flash -->

<!-- <entryPoint path="diaporama.swf" mimeType="application/x-shockwave-flash" type="web" /> -->

</resource>

<resource path="Module_Exemple_scormMono_scorm12.zip" title="Support Web - SCORM 1.2" mimeType="application/zip">

<entryPoint path="imsmanifest.xml" mimeType="application/imsccml+xml" />

<entryPoint path="index.html" mimeType="text/html" type="web" />

</resource>

<resource path="Module_Exemple_scormMulti_scorm2004.zip" title="Support Web - SCORM 2004" mimeType="application/zip">

<entryPoint path="imsmanifest.xml" mimeType="application/imsccml+xml" />

<entryPoint path="index.html" mimeType="text/html" type="web" />

</resource>

<!-- Forme génératrice -->

<resource path="Module_Exemple_sources.zip" title="Sources du module" mimeType="application/zip">

<entryPoint path=".wspmeta" mimeType="application/x-scenari-wspmeta+xml" />

<entryPoint path="Module_Exemple/Mon_Module.xml" mimeType="application/x-scenari-item+xml" />

</resource>

</resources>

</manifest>