Text only | Skip links
Skip links||IT Services, University of Oxford

1. First steps with Oxygen

In this first exercise you will learn how to use Oxygen to
  • create a new XML document
  • add a document header
  • keep your document well-formed and valid
  • display and edit your document without seeing tags

2. Documents de travail

Tous les fichiers dont vous aurez besoin sont réunis dans le dossier Travaux sur votre clé; on vous invite à les mettre à jour en téléchargeant ce même dossier en format zip du site http://tei.oucs.ox.ac.uk/Oxford/2010-06-mutec/Travaux.zip.

Bien que les deux équipes travaillent sur des documents différents, la démarche sera identique pour les deux. D'abord on va créer un entête TEI pour le document. Ensuite, dans la session TP2, on va ajouter une transcription basique du document. Demain, dans la session TP3, on va enrichir cette transcription avec du balisage ‘sémantique’. Enfin dans la session TP4, on va explorer les possibilités de traitement et de visualisation de ce document apportées par XSLT.

L'équipe A travaille sur deux pages extraites d'une lettre du 19ème siecle au sujet des frères Abbadie. Des renseignments sur le contexte et le contenu de ce manuscrit sont présentés dans le fichier Abbadie/notes.txt, et des images des pages sont disponibles dans les fichiers Abbadie/F-12-5080-p-1.jpg et Abbadie/F-12-5080-p-2.jpg. Il y a une transcription en texte pur des deux états de ce document dans les fichiers original.txt et revised.txt. Ne les regardez pas tout de suite!

L'équipe B travaille sur une feuille de manuscrit concernant les préparations pour un déplacement royal au château de Marly en 1763. Des renseignements sur le contexte et le contenu de ce manuscrit sont présentés dans le fichier acteRoyal/notes.txt, et un image est disponible dans le fichier acteRoyale/page1.jpg. Il y a une transcription en texte pur dans le fichier page1.txt. Ne le regardez pas tout de suite!

3. Création d'un nouveau fichier

  • Ouvrez Oxygen. Cliquez sur l'icône Nouveau en haut à gauche, (ou selectionnez Nouveau du menu Fichier, ou tapez CTRL-N.) pour ouvrir la boîte de dialogue Nouveau

    Sélectionnez l'option par défaut : XML. Tapez OK.

  • Dans boîte de dialogue qui suit il faut d'abord spécifier le langage de schéma voulu: vous pouvez choisir DTD ou RelaxNG (compact ou XML) ou XML Schema selon vos intérêts... Ensuite, il faut spécifier où se trouve le fichier du schéma, en cliquant sur l'icône du dossier à droite de la fenêtre URL. Cherchez le fichier Schemas/tei_mut du type approprié et ouvrez-le. Tapez OK.
  • Oxygen fait de son mieux pour profiter des informations contenues par le schéma. Donc, il sait ajouter tous les éléments obligatoires dans votre nouveau document. Néanmoins, il ne peut pas tout faire: s'il y a un choix d'éléments obligatoires, Oxygen n'osera pas le faire pour vous. Si vous voyez d'abord un écran comme ceci:

    Ne vous désespérez pas, Oxygen essaye de vous mettre à l'aise en cachant toutes les balises. Nous, on n'a pas peur des balises: donc sélectionnez l'onglet "Texte" en bas à gauche pour recevoir un affichage plus classique comme ceci:

    Selon votre choix de langue de schéma, le logiciel de validation appliqué sera différent, mais en tout cas vous devez voir des messages d'erreur et une partie du nouveau document sera soulignée en rouge. (sinon, cliquez sur le coche rouge pour valider le document) Pourquoi?

4. Correction de l'entête

  • Oxygen indique des erreurs parce que le document n'est pas encore valide.
  • Les messages au-dessous de l'écran pourraient éventuellement expliquer le problème...
  • Est-ce que vous sauriez corriger les erreurs? (suggestion: il manque des détails dans la description de la source)
  • Quand vous aurez enlevé toutes les erreurs, les lignes rouges disparaîtront; et vous allez voir en haut à droit un joli petit carré vert!

5. Complétez l'entête

Comme vous le saviez (maintenant) un entête TEI peut être très détaillé ou très simple. A vous de décider! Mais voici quelques suggestions pour des ajouts à ce header minimal. N'hésitez pas à explorer les autres options.
  1. Donnez des renseignements sur l'éventuelle distribution/publication de ce fichier. Qui va le distribuer et à quelles conditions?
  2. Donnez des renseignements bibliographiques sur la source originelle -- au moins l'identifiant du manuscrit
  3. Résumez les principes éditoriaux que vous allez suivre en numérisant ce document
  4. Indiquez les langues naturelles présentes dans le texte
  5. Catégorisez le document, comme type de texte, type de sujet etc.
  6. Ajoutez les noms des responsables: qui a fait quoi pour la création de cette ressource numérique? Quand?
Vous aurez besoin d'ajouter pour ça les éléments suivants:
  1. <publicationStmt>, contenant <distributor>, <availability> etc.
  2. <sourceDesc> contenant <msDesc> avec un <msIdentifier> etc.
  3. <encodingDesc>, contenant un <editorialDecl> etc.
  4. <langUsage> dans <profileDesc>
  5. <textClass> dans <profileDesc>, contenant <keywords> and/or <catRef> .
  6. <respStmt>s dans <fileDesc>, et au moins un <change> à l'intérieur d'un <revisionDesc>.

Pour vous informer au sujet de n'importe quel élément TEI, allez sur http://www.tei-c.org/release/doc/tei-p5-doc/en/html/REF-ÉLÉMENTS.html. Pour savoir quels éléments seraient valides à un point spécifique de l'entête, tapez le caractère < à l'endroit concerné et Oxygen vous présentera une liste des éléments disponibles.

N'oubliez pas de valider votre document en cliquant sur le coche rouge. Il faut ajouter quelque chose (au moins un paragraphe vide <p/>) au sein de l'élément <text> pour créer un document valide. Dans le prochain exercice, vous allez compléter le document proprement dit.

Quand vous aurez fini n'oubliez pas de sauvegarder votre fichier!. Vous aurez la possibilité de le compléter dans l'exercice prochain.



TEI@Oxford. Date: July 2009
Copyright University of Oxford