« STIC:STIC I - exercice 1 (Yoshi) » : différence entre les versions

De EduTech Wiki
Aller à la navigation Aller à la recherche
Ligne 151 : Ligne 151 :
* Introduction ultra-rapide à [[XML]]
* Introduction ultra-rapide à [[XML]]
* Les [[Tutoriel DTD|DTD]] (chapitres 1-6, à relire SVP)
* Les [[Tutoriel DTD|DTD]] (chapitres 1-6, à relire SVP)
* '''Installation du logiciel Exchanger XML Editor'''
** Peut donner des soucis pour Mac !


'''Préparation page travail''' (c.f. aussi tâches ci-dessous)
'''Préparation page travail''' (c.f. aussi tâches ci-dessous)

Version du 24 septembre 2018 à 15:03

Cet article est en construction: un auteur est en train de le modifier.

En principe, le ou les auteurs en question devraient bientôt présenter une meilleure version.

Cette page fait partie des cours STIC I et STIC II

STIC

Introduction

Ce premier exercice du cours STIC I représente une "entrée en matière souple" qui permet notamment de vous familiariser avec :

  • Les objectifs et le reglèment du cours
  • Le format du cours : tous les exercices suivent le même format
  • Les différents environnements pédagogiques et de travail
    • Ce wiki pour la partie transmissive, l'énoncé de l'exercice et l'aide
    • Le serveur tecfaetu.unige.ch pour publier vos exercices et mettre à jour votre page travaux
    • Le cours sur Moodle pour la publication des notes et des feedback --> Inscription http://tecfalms.unige.ch/moodle/course/view.php?id=308 Attention : à modifier avant le cours de vendredi 28 sept. 2018 !!!

Sur le plan pédagogique, ce premier exercice permet de :

  • Consolider les connaissances en HTML5, CSS et SVG
  • Réfléchir sur comment organiser un petit site et comment le "styler"
  • Utiliser un schéma XML et créer un contenu XML
  • Utiliser des bibliothèques JavaScript

Cet exercice vise aussi à consolider les sujets abordés dans l'atelier d'initiation, voir :

Connaissances/compétences envisagées

À l'issue de cet exercice vous devez avoir acquis les connaissances/compétences suivantes :

  • Créer du contenu web et le publier à un endroit précis sur le serveur
  • Incorporer des éléments SVG dans HTML et dans EduTechWiki
  • Utilisation de base du langage XML et savoir décrire les similarités/différences avec HTML5
  • Comprendre les bases d'une grammaire DTD et savoir l'associer à un document XML
  • Comprendre les bases du langage XSLT et savoir l'associer à un document XML pour créer du HTML5/CSS
  • Inclure un fichier JavaScript externe dans une page HTML5 et créer du contenu qui respecte une structure précise
  • Comprendre les principes d'une page dynamique avec l'utilisation de Impress.js

Prérequis

Les outils et compétences nécessaires pour suivre le cours ont été illustrés lors de l'atelier MINIT. Pour ceux qui n'étaient pas présents, il faudra disposer pour ce cours des éléments suivants :

Activités en salle de classe

Ces activités ont été faites dans l'atelier d'initiation. On rappellera juste les principes...

Rappel HTML

Design, style et couleurs

Clic-droit sur un élément, puis sélectionner Inspect (Firefox/Chrome)

Rappel initiation à CSS

Code exemple HTML et CSS

Si vous n'avez pas encore de home page, voici le code d'une page HTML5 

<!DOCTYPE html>
<html lang="fr">
  <head>
    <meta charset="UTF-8">
    <title>Votre titre</title> 
    <link href="css-template.css" rel="stylesheet"> 
  </head>

  <body>

    <h1>Titre principal</h1>
    <p>Votre texte. Votre texte. Votre texte.</p>
    <blockquote>Une citation</blockquote>
    <hr>

    <a href="http://validator.w3.org/check/referer">Valid HTML</a>
    <a href="http://jigsaw.w3.org/css-validator/check/referer">CSS valide</a>

  </body>
</html>

Code du fichier CSS utilisé avec la page ci-dessus 

body {
    font-family: Verdana, Geneva, Arial, Helvetica, sans-serif;
    font-size: 12px;
    background-color:#CCCCCC;
    margin-left: 1em;
    margin-top: 3px;
    margin-bottom: 3px;
       }

h1, h2, h3 {color: green}

p  {
     margin-left: 2em;
     text-align:justify;
     font-family: Arial, serif ; 
     font-size: 12pt
     }

blockquote  {
     margin-left: 4em;
     text-align:justify;
     font-style:italic;
     font-family: Arial, serif ; 
     font-size: 11pt
     }

Présentation/modification de fichiers impress.js

Introduction à SVG

Outils et ressources:

Introduction à XML

  • Introduction ultra-rapide à XML
  • Les DTD (chapitres 1-6, à relire SVP)
  • Installation du logiciel Exchanger XML Editor
    • Peut donner des soucis pour Mac !

Préparation page travail (c.f. aussi tâches ci-dessous)

Utilisation d'un éditeur (à installer)

Projet 1 / Tâches

L'exercice 1 comprend une série de tâches. N'en oubliez aucune SVP !

Faites votre "home page" à TECFA

Cette home page faite en HTML5 doit représenter l'image que vous voulez donner au "monde extérieur". A vous de décider...

Emplacement et nom du fichier d'entrée

La "home page" sera accessible par l’URL 

http://tecfaetu.unige.ch/perso/maltt/votre-login-court/

Par exemple: 

http://tecfaetu.unige.ch/perso/maltt/ardiri6/

Exemple de nom correct du fichier d'entrée: welcome.html, welcome.htm, index.html, ou index.htm. Il est important de respecter ces conventions, car le serveur est configuré pour qu'il affiche un de ces fichiers lorsqu'on lui demande d'afficher juste le répertoire.

Pour savoir où mettre votre home page, consultez notre serveur LDAP (votre home page y est indiquée):

Par SFTP: 

tecfaetu.unige.ch
/web/perso/maltt/votre-login-court/

Contraintes

  • Aucune, à part faire attention à ce que le résultat corresponde aux objectifs
  • Vous pouvez créer autant de sous-pages que vous voulez... ou aucune.
  • Vous pouvez relier d'autres pages (présentation impress.js, home page wiki, home page externe, etc.). Il est obligatoire de faire tous les liens dans le rapport, mais pas dans votre home page.
  • La technologie utilisée peut rester simple, mais vous pouvez également inclure des éléments sophistiqués, comme une animation GSAP.

Contribution wiki

Contrairement aux autres projets STIC, on demande une contribution wiki minimaliste.

1) Perfectionnez votre home page sur edutechwiki français. Réfléchissez au contenu que vous voulez y mettre et parlez-en dans votre rapport.

2) Insérez une image SVG dans la home page. Elle doit être positionnée, avoir une "bonne" taille, et une légende.

3) Corrigez quelques erreurs (syntaxe, liens, mauvaises explications) dans d'autres page wikis.

  • Faites attention à utiliser du code wiki. Copier/coller depuis Word donne de très mauvais résultats. Utilisez l'aide du wiki si nécessaire.

Créez, éditez et adaptez légèrement la présentation de votre page travail

La page travail sert d'instrument portefeuille pour tous les travaux "STIC". Les étudiant(e)s se souciant de la gestion des savoirs incluent également leurs autres travaux.

Création / Edition

Copiez les 6 fichiers "travaux.dtd", "travaux.xsl", "ENLEVERwelcome.xml", "travauxdoc.txt", "travaux.css" et "example.xml" depuis http://tecfa.unige.ch/tecfa/teaching/staf14/files/workpage/

  1. Faites attention de sauver la cible sous/save as sans ouvrir le fichier dans le navigateur ! Vous pourriez perdre de l'information ou encore vous retrouver avec du simple HTML !
  2. Renommez le fichier ENLEVERwelcome.xml en welcome.xml
  3. Lancez un éditeur XML et ouvrez ce fichier "welcome.xml"
  4. Remplissez les balises xml d'une façon logique qui puissent décrire votre page Travaux MALTT / STAF et n'oubliez pas de sauver de temps en temps! Vous allez trouver quelques explications dans le fichier travauxdoc.txt.
  5. Si vous travaillez en local (par exemple, chez vous), une fois terminé, il faut transférer tous les fichiers avec SFTP (grâce à Cyberduck par exemple) dans votre espace Travaux.
  6. Vérifiez les changements que vous avez faits de temps en temps avec votre browser préféré soit en local soit à l'URL suivant: http://tecfaetu.unige.ch/etu-maltt/wall-e/votre_login/
  7. Félicitations!!! Vous avez votre première page en XML! Et si vous ne la trouvez pas très jolie, c'est à vous de changer sa mise en forme en apprenant XSLT (fichier travaux.xsl)

Notez bien:

  • La page XML doit être valide. Le fait qu'un contenu s'affiche ne veut rien dire...
  • Il faut respecter la sémantique des balises. Ne pas mettre n'importe quel contenu dans n'importe quel élément. Relisez le petit schéma.
  • En aucun cas il faut changer la DTD

Modification du style

  • Personnalisez votre page (selon vos capacités techniques): ajoutez éventuellement un menu, changez les marges, les fontes, etc.
  • Pour changer superficiellement la présentation, il faut transformer le CSS qui va styler le HTML généré par XSLT.

Pour ajouter des liens, il suffit d'intervenir dans le template "student".

  • Pour comprendre comment le HTML est produit, regardez soit le code source de la page dans IE explorer, soit en utilisant un outil de transformation XSLT dans votre éditeur, etc. Un outil rudimentaire est ici: http://tecfa.unige.ch/guides/tools/
  • Vous pouvez aussi essayer de comprendre la logique de XSLT, mais ce sera le sujet d'un travail STIC II.

Créez une présentation avec impress.js

  • Exceptionnellement, le choix du sujet est libre (donc pas forcément relié à un "sujet MALTT", mais soyez raisonnable au niveau du volume ....
  • Utilisez à la fois le placement et le zoom comme élément stylistique.
  • Créez au moins un dessin SVG (par exemple un schéma). Pour cela utilisez un éditeur en ligne simple, un logiciels de dessin comme Inkscape ou Illustrator, ou encore Libre Office Draw.
  • Adaptez le CSS à vos besoins (bonus). Résumez vos modifications dans le rapport.

Rappel

Faites un rapport en HTML

Lire STIC:Rapport STIC I et II pour les contraintes générales du rapport. Dans le cas particulier de cet exercice:

  • Mettez les liens à toutes les productions
    • Homepage TECFA
    • Homepage Wiki
    • Page travaux
    • Présentation Impress.js
  • Discutez dans le rapport les deux homepage et la présentation Impress.js
  • Votre contribution Wiki peut se limiter à votre homepage

NB: vu qu'il s'agit de votre premier rapport, nous évaluerons principalement des aspects "formels" tels que :

  • Le bon chemin et nom du fichier
  • La présence des éléments requis (prénom, nom, n° de l'exercice, date, balise title, etc.)
  • La structure du document (utilisation des titres de bon niveau h1, h2, ... pour les sections demandées)
  • La lisibilité (taille de la police, mise en page, ...)

Il ne faut donc pas vous concentrer trop sur le contenu pour cet exercice (mais il faudra déjà le faire pour l'ex 2!)

Délai

Une semaine avant le début de la période suivante (lundi 8:59). A ce moment il est possible de demander un feedback rapide (utilisez la page discussion).

Évaluation et conseils

Contraintes

Evaluation

Facteurs les plus importants
  1. HTML/CSS: Résultat selon vos objectifs explicités dans le rapport (!). Toutefois, on souhaite que vous utilisiez des éléments de structuration de HTML5
  2. HTML/CSS: Ergonomie générale des sites, y compris la navigation entre pages si vous en utilisez plusieurs
  3. XML: Validité de la page et contenu (vos coordonnés plus les 2 exercices STIC I au moins)
  4. Présentation avec impress.js: utilisation d'un SVG, originalité, utilité et ergonomie
  5. Qualité du rapport (surtout structure, emplacement, lisibilité, etc.)
Malus
  1. Emplacement incorrect des fichiers (donc le bon répertoire est "ex1", et un bon nom de fichier est un fichier "index" comme "welcome.html" ....)
  2. Présence d’erreurs HTML et CSS (validité de HTML/CSS)
  3. XML pas valide et/ou mal formé
  4. Absence du SVG dans la présentation
Bonus
  1. Utilisation créative de CSS
  2. Richesse et/ou utilité de contenus
  3. Bonne utilisation de HTML5 (i.e. tags sémantiques)
  4. Élément SVG intéressant

Il sera impossible d'avoir un 6 sans avoir accompli toutes les tâches décrites ci-dessus

Autres exercices de la même période

Projets alternatifs pour experts

Pour ceux qui maîtrisent déjà les sujets traités dans cet exercice, il y a la possibilité de négocier un travail alternatif, par exemple :

  • Créer une page/tutoriel EduTechWiki sur un sujet technique que vous maîtrisez et qui pourrait être intéressant pour le domaine STIC (en général, pas forcément STIC I)
  • Réorganiser de manière importante des contenus proposés pour cet exercices mais qui ne sont plus à jour ou mal structurées
  • Créer et documenter un outil qui peut être utilisé par vos collègues (e.g. boilerplate HTML et CSS, script qui test la structure attendue d'un rapport STIC, etc.)

Si vous décidez pour le projet alternatif il faudra en tout cas :

  1. Modifier votre homepage EduTechWiki
  2. Créer votre homepage et la publier sur le server tecfaetu.unige.ch
  3. Remplir votre page travaux
  4. Créer un bref rapport sur ce que vous avez fait

Choix du sujet à négocier au plus vite avec nous, déjà pendant la journée en présence ou par email dans les jours suivants.

Ressources

Transparents

Transparents (plus mis à jour !!)
  1. Design d'un petit dispositif: http://tecfa.unige.ch/guides/tie/html/www-design-intro/www-design-intro.html
  2. HTML de base: http://tecfa.unige.ch/guides/tie/html/xhtml-intro/xhtml-intro.html
  3. CSS de base: http://tecfa.unige.ch/guides/tie/html/css-intro/css-intro.html

Tutoriels et pages ressources

HTML
CSS
SVG
Impress.js
Couleurs
Design
XML

Outils

Editeurs HTML - votre choix:

  • On vous conseille d'utiliser un éditeur qui fournit un support pour HTML5 et CSS, par exemple Brackets

Ensuite, installer / utiliser un éditeur XML si c'est pas déjà fait. Voici quelques choix:

Éditeurs XML - Choix 1
  • Java 6 SDK. Il faut installer cet environnement, car plusieurs programmes que nous allons utiliser en ont besoin.

Installer sous Win7 (en principe facile). Il suffit de télécharger la version Windows *.exe.

Installation de Exchanger sous Mac(plus difficile !)

(1) Télécharger le fichier zip

(2) Dézipper dans un répertoire (par exemple c:\exchanger)

(3) cliquer sur le fichier xngr-editor.jar.

Si le programme ne démarre pas (Win/Mac). Votre installation Java est défaillante. (3) Créer un fichier de commande exchanger.cmd (sous Windows) avec le contenu suivant: 

cd c:\exchanger 
start javaw -jar xngr-editor.jar

... équivalent sur Mac.

Éditeur XML - Choix 2
  • epcEdit
  • Le plus convivial à utiliser (mais pas à installer)
XML Copy editor - Choix 3
  • XML Copy editor
  • Le plus facile à installer ! Assez facile à utiliser.
  • Peut valider toutes sortes de schémas.
Éditeur XML - autres choix
SVG

Exemples et autres infos

Exemples CSS:

Outils en ligne:

Autres articles edutechwiki anglais sur Internet et HTML:

Aide

Discussion de cette page

Utilisez la page discussion de cette page pour poser des questions. Pour insérer un nouveau titre, utilisez simplement le "+".

Important: Si vous cliquez sur l'étoile ("Ajouter cette page à votre liste de suivi"), le wiki vous enverra un mail après chaque modification de la page.

Séminaire de codage

Le lundi après la semaine des cours en présence (i.e. le lundi suivant le cours STIC du vendredi), un séminaire de codage est organisé par TECFA.

Récupérée de « https://edutechwiki.unige.ch/fmediawiki/index.php?title=STIC:STIC_I_-_exercice_1_(Yoshi)&oldid=100707 »