Gestion de projets STAF-18 - Technique

Pour XML, consultez ma page XML. Les transparents "Introduction à XML" sont disponibles en format HTML ou PDF.

Visualisation d'un fichier XML + XSLT en HTML

Pour visualiser le contenu de votre fichier XML, vous utilisez le servlet XSLatorServlet. Regardez l'exemple ci-dessous et substituez votre fichier xml dans l'URL, mais gardez le fichier xsl !). Ce servlet prend un fichier xml sur le réseau ainsi qu'un fichier xsl et produit du HTML avec.

• http://tecfa2.unige.ch:8080/servlet/XSLatorServlet?xml=http://tecfa.unige.ch/staf/staf-e/staf18/demo-project.xml&xsl=http://tecfa.unige.ch/staf/staf-e/staf18/project.xsl
• Exemple pour un project:
  http://tecfa2.unige.ch:8080/servlet/XSLatorServlet?xml=http://tecfa.unige.ch/staf/staf-e/staf18/proj/proj12.xml&xsl=http://tecfa.unige.ch/staf/staf-e/staf18/project.xsl

• http://tecfa2.unige.ch:8080/servlet/DefaultApplyXSL?URL=/staf/staf-e/staf18/proj/proj11.xml&xslURL=/staf/staf-e/staf18/project.xsl

Attention:

• N'ecrasez PAS les projets de vos collègues et faites une copie de sauvegarde !!
• Le servlet va se planter si votre fichier XML n'est pas "well-formed" (tags qui ferment) ou si vous indiquez un DTD local
• Vérifiez la spécification du DTD dans le fichier XML (le servlet ne peut PAS lire un fichier local !)
• Soit vous mettez tout en commentaires:

<!--
<!DOCTYPE project SYSTEM "http://tecfa2.unige.ch:8080/staf/staf-e/staf18/project.dtd">
<!DOCTYPE project SYSTEM "project.dtd">
-->

• Soit vous indiquez l'URL où se trouve le DTD

<!DOCTYPE project SYSTEM "http://tecfa2.unige.ch:8080/staf/staf-e/staf18/project.dtd">
<!--
<!DOCTYPE project SYSTEM "project.dtd">
-->

Explication du fichier XSLT

Explication du DTD, outils

L'explication du DTD project.dtd est sous construction:

• Le DTD en arbre HTML, regardez surtout project, specification, etc.
• Consultez d'abord le fichier: dtd-explications.text. Il s'agit d'un fichier XML plus ou moins rempli de commentaires (OUTDATED 7/6/99)
• La version HTMLisé: http://tecfa2.unige.ch:8080/servlet/XSLatorServlet?xml=http://tecfa.unige.ch/staf/staf-e/staf18/dtd-explications.xml&xsl=http://tecfa.unige.ch/staf/staf-e/staf18/project.xsl n'apporte pas beaucoup pour le moment (OUTDATED 7/6/99)

Validation

• Si vous utilisez un outil non-validant, vous pouvez utiliser notre service de validation on-line

Outils

Vous choisissiez l'outil qui vous convient. Comme pour HTML, il existe 4 types d'outils:

1. Un simple éditeur de texte
2. Un éditeur avec support simple (comme emacs/sgml ou Spy ou Xed). Ces outils vous permettent de créer des fichier XML well-formed (Tags qui ferment etc. mais qui ne respectent pas un DTD).
3. Un éditeur avec support "sémantique" (comme emacs/psgml ou Excosoft/Documentor ou Emile pour Mac). Il faut si possible choisir un tel outil, car il vous permet de créer des documents valides. Il "comprend" un DTD et vous offre le choix des bons tags pour chaque contexte ! Un outil non-validant vous laisse créer des tags au hasard.
   Voir : comment installer le support XML pour Emacs (mais ignorez tous ce qui JAVA /DKS!).
4. Un ou outil XML professionnel comme XMetal
5. Un outil totalement WysWyg genre FrameMaker/SGML ou les futurs MS/Word. Très cher pour le moment

Il existe quelques bon sites qui font l'inventaire, notamment http://www.xmlsoftware.com/ et Free XML software

Attention:

• Si vous utilisez un outil avec support DTD/validation il faut mieux commencer avec un template vierge.
• Il faut également configurer l'outil en ISO-Latin (pas en UTFxx) !