|
Travaux Personnels Encadrés |
|||||||||||||||||||||||||||
Définition du standard TPEMLIntroductionPour la création du site regroupant tous les TPE des classes de 1ère S au LFB, nous avons du trouver une façon de classifier et de catégoriser les TPE indépendamment du design. La solution à ceci fut la création d'un fichier utilisant le format XML, et une définition de balises spécifiques regroupant l'information requise pour donner toutes les informations sur les TPE différents. Nous appellerons ici ce format TPEML (pour TPE Markup Language), en manque d'un meilleur nom. Le rôle de ce fichier est simple: une liste de TPE, avec une entrée pour chacun, avec l'information pour celui-ci: thème, sujet, auteurs, URL du dossier, etc. Ce document décrira précisément les précautions et règles à suivre afin d'éditer ce document (d'ailleurs appelé tpe.xml ici), et fera aussi la liste de toutes les balises et attributs de ce format. Édition du fichier XMLUn certain nombre de précautions sont nécessaires lors de l'édition du fichier XML (tpe.xml). Encodage des fichiers / ISO-8859-1XML nécessite une certaine attention à la façon de laquelle vous encodez vos fichiers. Parmi les points importants du standard XML, une partie est celle de l'internationalisation, qui est faite par l'utilisation de Unicode et de UTF-8. Ceci ne pose pas de problème aux américains, mais pour les français, habitués à utiliser ISO-8859-1 comme encodage standard (Latin-1), ceci induit bon nombre de changements, surtout parce que le support UTF-8 n'existe pas partout, et surtout: peu au niveau des navigateurs (quoique les dernières versions, qui supportent le XML, s'en occupent). Pour éviter des complications, il a donc été décidé que nous utiliserions le "vieil" encodage ISO-8856-1. Ceci n'importera pas beaucoup pour vos travaux: faites juste attention à ne pas sauvegarder en UTF-8, UTF-16, Unicode ou autre avec votre éditeur (XML). Si vous êtes en doute, sauvegardez juste "normalement". L'en-tête XML sera donc: <?xml version="1.0" encoding="iso-8859-1" ?> Mise à jour du fichier tpe.xmlCe fichier doit impérativement être synchronisé entre tous les auteurs, sion il y a un risque de corruption du fichier. Avec CVS, le travail est facilité: Commencez, avant de changer quoi que ce
soit, par faire un Il risque d'y avoir changement par quelqu'un d'autre entre-temps. Dans le
meilleur des cas, CVS s'en occupera et mettra tous les changements en commun.
Sinon, vous risquez de voir un message apparaître comme quoi il y a eu un
conflit, par exemple avec un Format XML: TPEMLVoici la liste de toutes les balises, figurant dans un ordre logique, avec des exemples de leur utilisation. Le DTD de TPEML est disponible ici: http://www.bioinformatics.org/tpe-lfb/tpeml/tpeml.dtd. Utilisez-le de la manière suivante: <!DOCTYPE listetpe PUBLIC "-//LFB//DTD TPEML 1.0//FR" "http://www.bioinformatics.org/tpe-lfb/tpeml/tpeml.dtd"> EntitésLe DTD de TPEML définit toutes les entités de XHTML 1.0. Vous pouvez donc utiliser des entités assez pratiques comme ç, é, etc. listetpeLa balise <listetpe> est la base du document TPEML. Tous les autres éléments sont contenus dans celui-ci.
Attributs: aucun Exemple: <listetpe> <tpe id="..."> . . . </tpe> </listetpe> tpeLa balise <tpe> identifie un seul TPE. Ses sous-éléments donneront chaque pièce d'information nécessaire pour l'identification du TPE. Attributs:
Contenu: éléments sujet, theme, auteurs, resume, site, dossier, problematique, carnets, fiche_synthese. Exemple: <tpe id="oeil-couleur"> <theme theme_id="images" /> <auteurs> <auteur> <nom>Ellefsen</nom> <prenom>Per Einar</prenom> <classe> <annee>1</annee> <filiere>S</filiere> <numero>3</numero> </classe> <email>per.einar@skynet.be</email> </auteur> <auteur> <nom>Lekhal</nom> <prenom>Haïba</prenom> <classe> <annee>1</annee> <filiere>S</filiere> <numero>3</numero> </classe> <email>snynigga@hotmail.com</email> </auteur> </auteurs> <sujet>La perception des couleurs par l'oeil</sujet> <site>http://www.bioinformatics.org/oeil-couleur/</site> <dossier> <format type="HTML">http://www.bioinformatics.org/oeil-couleur/dossier/</format> <format type="RTF">http://www.bioinformatics.org/oeil-couleur/dossier/book.rtf</format> <format type="PDF">http://www.bioinformatics.org/oeil-couleur/dossier/book.pdf</format> </dossier> <problematique> Comment est constitué l'oeil? Quels sont les mécanismes qui nous permettent de percevoir le monde extérieur en couleur? Pourquoi certaines personnes ne perçoivent-elles pas les couleurs comme nous? </problematique> <resume> En passant premièrement par une description de l'anatomie de l'oeil ... </resume> <carnets> <carnet url="http://www.bioinformatics.org/oeil-couleur/carnets/haiba/">Haïba Lekhal</carnet> <carnet url="http://www.bioinformatics.org/oeil-couleur/carnets/per/">Per Einar Ellefsen</carnet> </carnets> </tpe> themeObligatoire - Cette balise donne une information sur le thème auquel le TPE se rapporte. Attributs:
Contenu: Aucun. Élément vide. Exemple: <theme theme_id="risques_nat_tech" /> sujetObligatoire - Le sujet choisi par les auteurs pour ce TPE.
Attributs: aucun Exemple: <sujet>La perception des couleurs par l'oeil</sujet> auteursObligatoire - Liste des auteurs du TPE. Contien une balise <auteur> pour chacun d'entre eux.
Attributs: aucun Exemple: <auteurs> <auteur> <nom>Ellefsen</nom> <prenom>Per Einar</prenom> <classe> <annee>1</annee> <filiere>S</filiere> <numero>3</numero> </classe> <email>per.einar@skynet.be</email> </auteur> <auteur> <nom>Lekhal</nom> <prenom>Haïba</prenom> <classe> <annee>1</annee> <filiere>S</filiere> <numero>3</numero> </classe> <email>snynigga@hotmail.com</email> </auteur> </auteurs> auteurInformation sur un auteur.
Attributs: aucun Exemple: voir auteurs nomObligatoire - Le nom de famille d'un auteur
Attributs: aucun Exemple: voir auteurs prenomObligatoire - Le prénom d'un auteur
Attributs: aucun Exemple: voir auteurs classeObligatoire - Informations sur la classe de l'auteur
Attributs: aucun Exemple: voir auteurs anneeObligatoire - L'année de la classe dans laquelle se trouve l'auteur (T, 1, 2, 3, etc.)
Attributs: aucun Exemple: voir auteurs filiereSi elle existe, la filière dans laquelle se trouve l'élève (S, ES, L)
Attributs: aucun Exemple: voir auteurs numeroObligatoire - Le numéro de la classe (par exemple, pour 1ère S 3: 3).
Attributs: aucun Exemple: voir auteurs L'adresse e-mail de l'auteur, si elle est connue
Attributs: aucun Exemple: voir auteurs resumeObligatoire - Un résumé du TPE, de 2 à 3 phrases.
Attributs: aucun Exemple: <resume> Ce TPE traite de ... </resume> problematiqueLa problématique du TPE, sous forme de questions.
Attributs: aucun Exemple: <problematique> Comment est constitué l'oeil? Quels sont les mécanismes ...? </problematique> siteSi le TPE est hébergé sur Internet, l'adresse (URL) de ce site.
Attributs: aucun Exemple: <site>http://likium.multimania.com/tpe/</site> dossierUne liste des formats disponibles du TPE, et leur adresses Internet. Même si cet élément n'est pas obligatoire, il devrait être présent pour un bon fonctionnement.
Attributs: aucun Exemple: <dossier> <format type="HTML">http://www.bioinformatics.org/oeil-couleur/dossier/</format> <format type="RTF">http://www.bioinformatics.org/oeil-couleur/dossier/book.rtf</format> <format type="PDF">http://www.bioinformatics.org/oeil-couleur/dossier/book.pdf</format> </dossier> formatInformation relative à l'existence d'un format spécifique du dossier. Attributs:
Contenu: L'URL (de préférence absolu: de la forme http://..., mais peut aussi être relatif si vous êtes sûr du résultat) de ce format précis Exemple: <format type="PDF">http://www.bioinformatics.org/oeil-couleur/dossier/book.pdf</format> carnetsS'ils sont connus, une liste des carnets de bord du TPE.
Attributs: aucun Exemple: <carnets> <carnet url="http://www.bioinformatics.org/oeil-couleur/carnets/haiba/">Haïba Lekhal</carnet> <carnet url="http://www.bioinformatics.org/oeil-couleur/carnets/per/">Per Einar Ellefsen</carnet> </carnets> carnetInformation sur un carnet de bord. Attributs:
Contenu: Le nom de l'élève à qui appartient le carnet de bord. Exemple: <carnet url="http://www.bioinformatics.org/oeil-couleur/carnets/haiba/">Haïba Lekhal</carnet> fiche_syntheseS'ils sont connus, une liste des fiches de synthèse des élèves pour ce TPE.
Attributs: aucun Exemple: <fiche_synthese> <fiche url="http://likium.multimania.com/tpe/nicolas.pdf">Nicolas Naville</fiche> <fiche url="http://likium.multimania.com/tpe/mehdi.pdf">Mehdi Benhmade</fiche> </fiche_synthese> ficheInformation sur une fiche de synthèse. Attributs:
Contenu: Le nom de l'élève à qui appartient la fiche de synthèse. Exemple: <fiche url="http://likium.multimania.com/tpe/mehdi.pdf">Mehdi Benhmade</fiche> |