Voir la source de MINIT

==Info pratiques==

Cette page fait référence à la partie facultative de l'atelier MINIT prévue dans le cadre du Master MALTT. 

{{bloc important | Programme et contenus valables pour la volée '''Aegir''' (année académique 2020/2021) }}

;Dates :

* '''Mercredi 16 septembre''', matin et après-midi
* '''Jeudi 17 septembre''', matin

Voir plus bas pour le programme en détail.

;Contacts:

* [[Utilisateur:Mattia A. Fritz|Mattia A. Fritz]]
* [http://tecfa.unige.ch/perso/morands/ Stéphane Morand]

==Introduction==
L’atelier d’initiation pour les novices se déroule sur 3 demi-journées, chacune avec un thème spécifique, mais qui dans l’ensemble ont l’objectif d’introduire le fonctionnement des pages web. Le choix de ce sujet présente plusieurs objectifs pédagogiques et techniques :
* Il s’agit d’une technologie qui peut aller du très simple au très complexe
* Publier une page web nécessite des connaissances à plusieurs niveaux
** Codage HTML5 + CSS
** Gestion de différents fichiers et dossiers
** Utilisation d’un éditeur de texte
** Fonctionnement « avancé » d’un navigateur web
** Fonctionnement d’un serveur web
** Fonctionnement d’un serveur (S)FTP
* Le contenu de l’atelier sert comme base pour les cours techniques STIC I et II
* La connaissance « approfondie » d’une technologie peut être généralisée à d’autres technologies

=== Objectifs ===

À la fin de l'atelier, vous devez être capables de :

* Utiliser un éditeur de texte pour :
** Créer des pages HTML5 et structurer le contenu avec des balises appropriées
** Savoir appliquer des déclarations de style CSS qui déterminent l'affichage graphique des contenus
* Utiliser un logiciel de transfert de fichiers pour :
** Publier tous les fichiers nécessaires à l'affichage d'une page ou petit site web (e.g. fichiers HTML5, CSS, images, SVG, ...) à des endroits précis sur le serveur tecfaetu.unige.ch

Des objectifs plus spécifiques sont illustrés dans la suite de la page.

===Prérequis===
Aucune connaissance spécifique n’est demandée pour participer à l’Atelier technique. Par contre, on s’attend à ce que vous maîtrisiez les fonctions « de base » de votre ordinateur telles que :
* Créer, renommer, déplacer et effacer des fichiers/dossiers
* Savoir utiliser un navigateur web (pour l’atelier on utilisera de préférence Google Chrome)
* Download et extraction de fichiers
* Download et installation de logiciels

===Est-ce que je dois participer ?===

L'atelier est facultatif. Dans cette page vous trouvez plusieurs sections avec les '''objectifs''' de chaque demi-journée. Si vous pensez déjà les maîtriser, il est inutile que vous veniez. 

Pensez néanmoins à configurer un logiciel de transfert de fichier avec les données du serveur tecfaetu.unige.ch (voir section SFTP plus bas pour les détails) avant le début des cours (en particulier le cours STIC I).

===Je voudrais participer mais je ne peux pas===

Si vous ne pouvez pas participer à une ou plusieurs demi-journées, cette page propose toutes les activités qui sont prévues pendant l'atelier, y compris les ressources utilisées. Certaines activités (e.g. les "workshop") sont conçues afin que vous puissez les faire (ou refaire) également chez vous. En cas de problèmes, n'hésitez pas à nous contacter. 

===Matériel et logiciels===
Vous devez avoir votre ordinateur portable avec vous avec un chargeur. Au niveau des logiciels, nous installerons le nécessaire pendant l'atelier.

===Profitez de l’atelier===

{{bloc important | L’atelier est le moment pour poser des questions ou demander de l’aide au niveau technique. }}

Il ne faut pas hésiter ou se dire que vous aurez le temps pour apprendre. Après l’atelier technique, les cours vont commencer directement et les connaissances techniques dévoilées pendant l’atelier d’initiation seront considérées acquises.

==Programme==

Organisation des demi-journées :
* Mercredi... 09:00 – 12:30 -> Introduction à HTML5
* Mercredi... 14:00 – 17:30 -> Introduction à CSS
* Jeudi......... 09:00 – 12:30 -> Introduction au transfert des fichiers (SFTP)

Ici de suite le programme plus détaillé pour chaque session.

===Mercredi matin===

* 09:00 – 09:30 Visioconférence (détails dans l'espace MINIT 2020) avec présentation sur le déroulement de la journée et introduction à HTML5
* 09:30 – 10:30 Activité en autonomie à distance : 
** Installation et configuration des éditeurs de texte [[Brackets]] et/ou [[Visual studio code]]
** Lecture de la page [[Introduction à HTML5]]
* 10:30 – 11:00 Pause
* 11:00 – 12:00 Workshop HTML5 (exercices en autonomie) avec permanence via visioconférence en cas de questions.
* 12:00 - 12:30 Synthèse de la demi-journée en visioconférence

===Mercredi après-midi===

* 14:00 – 15:00 Activité en autonomie à distance :
** Lecture de la page [[Introduction à CSS]]
* 15:00 – 15:30 Visioconférence (détails dans l'espace MINIT 2020) avec présentation de CSS
* 15:30 – 16:00 Pause
* 16:00 – 17:00 Workshop CSS (exercices en autonomie) avec permanence via visioconférence en cas de questions.
* 17:00 - 17:30 Synthèse de la demi-journée en visioconférence

===Jeudi matin===

* 09:00 – 10 :30 Installation du logiciel SFTP Cyberduck et transfert de fichiers sur le serveur tecfaetu.unige.ch
* 10:30 – 11:00 Pause
* 11:00 – 12:30 Création d’une page HTML5 + CSS et publication en ligne

==Introduction à HTML5==

Une version plus approfondie de cette partie est disponible dans la page EduTechWiki suivante que vous pouvez consulter pour rappel ou si vous étiez absent-e-s :

{{ Goblock | [[Introduction à HTML5]] }}

Référez-vous à la section Workshop HTML5 pour les exercices de consolidation du contenu.

===Objectifs===

Après la séance consacrée à l’introduction à HTML5 vous devrez être familier avec :
* Les grandes lignes du fonctionnement requête/réponse d’une ressource/page web
* Qu’est-ce qu’un langage de marquage
* L’existence de différentes versions de HTML
* La structure d’un document HTML5
* Les balises et attributs HTML les plus fréquents
* Les liens hypertextuels : protocoles, domaines, chemins, noms de fichiers, extensions
* Différents type de fichiers (pages web, images, …)
* L’utilisation des outils de développement d’un navigateur web
* L’utilisation et la configuration d’un éditeur de texte

===Outils===

====Outils de développement du navigateur web====
Nous allons utiliser les outils de développement d'un navigateur pour montrer dans la pratique comment une page HTML est affichée par un navigateur web.

{{ bloc important | Nous allons utiliser les '''outils de développement''' qui sont disponibles dans la plupart des navigateurs web. Dans le contexte de l'Atelier, nous allons utiliser Google Chrome, car pour longtemps c'était le navigateur avec les meilleures outils de développement disponibles. Depuis 2020 les outils de développement de différents navigateurs se ressemblent beaucoup, donc vous pouvez utiliser votre navigateur de choix si vous le préférez, en sachant que dans ces cas, il y aura quelques différences à prévoir. De plus, dans certains navigateurs il faut d'abord activer ces outils pour pouvoir les utiliser. }}

Si vous décidez d'utiliser Chrome et vous ne l'avez pas encore, installez-le sur votre ordinateur : 
* [https://www.google.fr/intl/fr/chrome/browser/desktop/ Lien pour installer Google Chrome]
Une fois installé le logiciel, ouvrez-le et pointer vers la page de TECFA :
* http://tecfa.unige.ch/
Pour ouvrir les outils procédez de cette manière (voir également l’image) :
# Cliquez sur l’icône du menu sur la droite de l’écran
# Sélectionnez l’item « Plus d’outils »
# Cliquez sur « Outils de développement »

[[Fichier:MINIT developer tools menu.png|700px|vignette|néant|Ouvrir les outils développeur sur Google Chrome]]

Vous devrez obtenir un résultat similaire à celui-ci :

[[Fichier:MINIT developer tools screen.png|700px|vignette|néant|Capture d'écran de la page TECFA avec outils développeur sur Google Chrome]]

====Éditeurs de texte====

Un éditeur de texte est un logiciel qui permet d'écrire du code dans plusieurs langages (e.g. HTML, CSS, JavaScript), avec des fonctionnalités d'aide comme par exemple la mise en évidence de la syntaxe, l'aide pour compléter des mots, la signalisation d'erreurs, etc. 

Pour montrer que la source de l'information est toujours dans les fichiers, nous allons installer deux éditeurs de texte différents :

# [[Brackets]]
# [[Visual studio code]]

; Brackets

[[Brackets]] est un logiciel open-source développé et maintenu par Adobe. Le logiciel est disponible pour Windows, Mac et Linux.
La plupart des actions nécessaires pour installer et configurer le logiciel sont également disponible dans la page de ce Wiki consacrée à l’éditeur :
* {{Goblock | [[Brackets|Voir la page '''Brackets''' sur ce Wiki]] }}
À la fin de la partie sur l’installation de Brackets vous devez avoir :
# Brackets installé sur votre ordinateur (obligatoire)
# Changé le thème de Light à Dark et augmenté la taille de la police du code (optionnel)
# Modifié la langue an anglais (conseillé)
# Installé au moins les extensions suivantes (obligatoire) :
## '''HTML Templates''' by Travis Almand. Pour y accèder utiliser le menu principale <code>Edit > HTML Templates</code>, puis choisir le modèle souhaité (dans la plupart des cas HTML5)
## '''Beautify''' by Drew Hamlett. Pour l’activer : menu principale <code>Edit > Beautify on save</code> doit être coché.

; Visual studio code

[[Visual studio code]] est un logiciel open-source développé est maintenu par Microsoft. Le logiciel est également disponible pour Windows, Mac et Linux. Il s'agit d'un éditeur un peu plus avancé par rapport à Brackets, pour plus de détails voir la page de ce Wiki :

* {{Goblock | [[Visual studio code|Voir la page '''Visual studio code''' sur ce Wiki]]}}

À la fin de la partie sur l'installation de Visual studio code vous devez avoir :
# Visual studio code installé sur votre ordinateur
# Modifié les ''settings'' pour que l'option ''Editor: Word wrap'' soit sur '''on'''
# Installé l'extension '''Live Server''' by Ritwick Dey
# Installé l'extension '''Prettier - Code formatter''' by Prettier

===Code et balises fréquentes===
====Squelette HTML5====

<source lang="HTML5">
<!DOCTYPE html>
<html lang="fr">
<head>
    <meta charset="UTF-8">
    <meta name="viewport" content="width=device-width, initial-scale=1.0">
    <meta http-equiv="X-UA-Compatible" content="ie=edge">
    <title>Titre du document</title>
</head>
<body>
    
</body>
</html>
</source>

==== Titres ====

<source lang="HTML5">
<h1>Titre de premier niveaux (Grand)</h1>
<h2>Titre de deuxième niveaux</h2>
<h3>Titre de troisième niveaux</h3>
</source>

==== Paragraphes ====
<source lang="HTML5">
<p>Texte du premier paragraphe.</p>
<p>Texte du deuxième paragraphe.</p>
</source>

==== Liens hypertextuels ====

<source lang="HTML5">
<a href="http://tecfa.unige.ch">TECFA</a>
<a href="../lien-relatif/page.html">Lien relatif</a>
</source>

==== Listes à puces ====

; Non-ordonnée

<source lang="HTML5">
<ul>
    <li>Premier item non ordonné</li>
    <li>Deuxième item non ordonné</li>
    <li>Troisième item non ordonné</li>
</ul>
</source>

; Ordonnée

<source lang="HTML5">
<ol>
    <li>Premier item ordonné</li>
    <li>Deuxième item ordonné</li>
    <li>Troisième item ordonné</li>
</ol>
</source>

==== Images ====

Le fichier avec l'image doit posséder un URL. '''Évitez de pointer à des images qui :'''

* Ne spécifient pas clairement qu'elles peuvent être réutilisées/modifiées, voir par exemple :
** [[Médias libres d'utilisation]]
** [[Licences Creative Commons et Copyleft]]
* Sont hébergées sur d'autres sites/domaines (e.g. ne pointez pas à http://free-images.com/image_whfezgfreer.jpg)
* Ne sont pas en format <code>.jpg</code>, <code>.png</code> ou <code>.svg</code>
* Sont très lourdes au niveau du poids du fichiers (essayez de limiter à quelques centaines de kb au maximum !)
** Vous pouvez utiliser par exemple [[GIMP]] pour modifier une [[image matricielle]], voir [https://www.gimp.org/tutorials/GIMP_Quickies/ GIMP Quickies] pour un bref tutoriel à ce propos

<source lang="HTML5">
<img src="chemin/au/fichier/image.jpg" alt="Texte alternatif pour screenreaders" title="Description de l'image" />
</source>

La balise <code>img</code> est une balise ''vide'' qui n'accepte pas de contenu. Pour cette raison, il est de bonne pratique de placer le <code>/</code> de clôture à la fin de la balise.

===Workshop HTML5===
====Fichiers pour le workshop====
Lors de l’activité workshop, vous allez travailler sur des fichiers que nous avons préparés pour cette partie de l’atelier. 
Les fichiers comprimés dans un archive .zip se trouvent sous ce lien :

* {{Goblock | [https://github.com/MALTT-STIC/minit-html5-essentials/archive/master.zip MINIT-HTML5-essentials]}}
Si vous n’arrivez pas à télécharger directement le fichier .zip, vous pouvez :
#Aller à l’adresse https://github.com/MALTT-STIC/minit-html5-essentials
#Cliquer sur le bouton vert en haut à droite « Code »
#Cliquer sur « Download ZIP »

[[Fichier:MINIT html5 workshop screen.png|700px|vignette|néant|Capture d'écran du répositoire avec les fichiers pour le Workshop]]

Il faudra ensuite extraire le contenu du fichier et le mettre sur votre ordinateur. Puis l’ouvrir avec Brackets. Cliquez d'abord sur : 
 
 File > Open folder…

Chercher le dossier que vous avez extrait dans votre gestionnaire des fichiers et sélectionnez-le. Vous devrez obtenir un résultat similaire à l'image suivante :

[[Fichier:MINIT brackets html5 files.png|700px|vignette|néant|Fichiers du workshop HTML5 ouverts en Brackets]]

====Fonctionnement du Workshop====
Lorsque vous ouvrez le fichier du workshop avec Brackets, vous avez trois dossiers :

* <code>examples</code>
* <code>hands-on</code>
* <code>tasks</code>

Les dossiers Examples et Tasks contiennent des sous-dossiers qui sont en relation. Pour chaque dossier exemple, qui contient des fichiers HTML5 avec du code, il existe un dossier dans les tâches où vous trouverez une « challenge » et la solution au problème. Le dossier « Hands-on », par contre, est vide.

Les trois dossiers sont conçus pour créer un flux de travail de la manière suivante :
# Vous '''regardez le code''' et le rendu de la page d’exemple
# Lorsque vous avez compris l’exemple, vous créez un sous-dossier dans le dossier <code>hands-on</code> et vous essayez vous-même de coder quelque chose de '''très simple''' similaire à l’exemple. 
#* Il faudra créer les dossiers et les fichiers à partir de zéro pour émuler une situation de départ. 
#* Adoptez déjà la bonne pratique de nommer vos dossiers/fichiers en n'utilisant que des lettres minuscules (sans accents) et les symboles <code>-</code> ou <code>_</code> 
#* Essayez de coder sans avoir les exemples sous les yeux et '''évitez de faire du copier/coller !'''
# Quand vous pensez maîtriser le sujet, vous pouvez essayer de résoudre la tâche associée.
## Ouvrez le fichier qui termine avec <code>xxxx-challenge.html</code> et lisez les instructions dans le commentaire en haut de la page
## Essayez de résoudre la tâche
## Regardez la solution dans le fichier <code>xxxx-solution.html</code>
# Passez à l’exemple suivant 

'''N’hésitez pas à demander de l’aide si vous en avez besoin'''. De temps en temps, on regardera ensemble quelques exemples ou solutions aux tâches.

==Introduction aux CSS==

Une version plus approfondie de cette partie est disponible dans la page EduTechWiki suivante que vous pouvez consulter pour rappel ou si vous étiez absent-e-s :

{{ Goblock | [[Introduction à CSS]] }}

Référez-vous à la section Workshop CSS pour les exercices de consolidation du contenu.

===Objectifs===
Après la séance consacrée à l’introduction aux CSS vous devrez être familier avec :
* Le fonctionnement « avancé » d’un navigateur web (parsing et rendering)
* Le Document Object Model (DOM)
* La séparation entre contenu (HTML5) et forme (CSS)
* Les éléments HTML en tant que « boites » avec des coordonnées
* La différence entre le document et le viewport
* Les manières d’ajouter des styles à vos pages web (attribut, inline et fichier externe)
* Les propriétés et valeurs de style les plus fréquentes
* Les différentes manières de positionner les éléments HTML (propriété CSS position)

===Outils===
Nous allons continuer à utiliser/explorer l’éditeur de texte [[Brackets]] qui propose des fonctionnalités qui facilitent le codage CSS.
De plus, nous allons utiliser l’environnement web codepen.io qui permet de montrer des exemples HTML + CSS de manière simple et intuitive. Cet environnement sera utilisé également dans le cours STIC I lors de l’introduction à [[JavaScript]]

===Ajouter du CSS à vos pages HTML ===

==== Avec l'attribut style====

<source lang="HTML5">
<body style="background-color: black; color: white">
</source>

==== Avec la balise style ====

Dans le <code><head>...</head></code> de votre page :

<source lang="HTML5">
<head>
    <meta charset="UTF-8">
    <title>Style inline</title>
    <style>
        body {
            background-color: black;
            color: white;
        }
    </style>
</head>
</source>

==== Avec un fichiers CSS externe (conseillé) ====

Lien dans le <code><head>...</head></code> de votre page :

<source lang="HTML5">
<head>
    <meta charset="UTF-8">
    <title>Style with external file</title>
    <link rel="stylesheet" href="style.css" type="text/css" />
</head>
</source>

Le fichier doit exister et respecter le bon chemin. Dans ce cas, le fichier s'appelle <code>style.css</code> et doit se trouver au même niveau de la page HTML :

<source lang="CSS">
/* This is an external CSS file */


/* There is no need for any header, and it must contain only CSS syntax */

body {
    background-color: black;
    color: white;
}
</source>

===Balises pour le style===

Les propriétés CSS peuvent s'appliquer à toutes les balises HTML5, cependant, par convention, il existe deux balises qui sont souvent utilisées lorsque les éléments ont exclusivement une fonction de style (i.e. pas de relation sémantique avec le contenu). Les deux balises sont :

* <code><nowiki><div>...</div></nowiki></code> à utiliser pour des bloques de contenu, par exemple :
*: <source lang="HTML5">
<div>
  <p>Paragraphe à l'intérieur du div</p>
  <p>Autre paragraphe à l'intérieur du div</p>
</div>
</source>
* <code><nowiki><span>...</span></nowiki></code> à utiliser surtout pour des bouts de texte, par exemple :
*: <source lang="HTML5">
<p>Mon texte avec un <span>mot</span> qui possède un style particulier</p>
</source>

===Sélecteurs et propriétés fréquentes===

==== Trois modalités de sélection ====

# Nom de la balise
#: <source lang="CSS">
body {
  ...
}

p {
  ...
}
</source>
# Nom de la classe, par exemple pour <code><nowiki><p class="important">Text</p></nowiki></code>
#: <source lang="CSS">
.important {
  ...
}
</source>
# ID de l'élément (une seule ID par page), par exemple <code><nowiki><h1 id="unique">Titre</h1></nowiki></code>
#: <source lang="CSS">
#unique {
  ...
}
</source>

==== Aligner du contenu (simple) ====

Pour aligner du contenu simple (e.g. texte ou image à l'intérieur d'un paragraphe ou d'un div), utiliser :

<source lang="CSS">
.aligner-au-centre {
  text-align: center;
}
</source>

Dans ce cas, la classe doit s'appliquer à l'élément conteneur des éléments qui doivent être alignées au centre. Par exemple :

<source lang="HTML5">
<div class="aligner-au-centre">
  <p>Mon texte va être aligné au centre</p>
  <p>Mon texte va être aligné au centre</p>
  <img src="logo.png" title="Image va être alignée au centre">
</div>
</source>

==== Colorer (simple) ====

On peut colorer presque tous les éléments, ici on va voir le background et la couleur du foreground (normalement du texte) :

<source lang="CSS">
body {
  background-color: black;
  color: white;
}
</source>

On peut utiliser également les valeurs hexadécimaux pour les couleurs (plus avancé) :

<source lang="CSS">
body {
  background-color: #000;
  color: #FFF;
}
</source>

Ou encore les valeurs RGB :
<source lang="CSS">
body {
  background-color: rgb(0, 0, 0);
  color: rgb(255, 255, 255);
}
</source>

'''Ce trois bouts de code produisent exactement le même résultat'''

===Workshop CSS===
Le workshop CSS aura la même structure du Workshop HTML5 du matin. 
Les fichiers comprimés dans un archive .zip se trouvent sous ce lien :

* {{Goblock | [https://github.com/MALTT-STIC/minit-css-essentials/archive/master.zip MINIT-CSS-essentials] }}

Si vous n’arrivez pas à télécharger directement le fichier .zip, vous pouvez :
#Aller à l’adresse https://github.com/MALTT-STIC/minit-css-essentials
#Cliquer sur le bouton vert en haut à droite « Clone or download »
#Cliquer sur « Download ZIP »

Suivez les mêmes indications que pour le Workshop HTML5 (voir plus haut dans la page)

===Exemples CodePen.io===
Quelques exemples pour consolider/découvrir d'autres possibilités :
# [https://codepen.io/mafritz/pen/dpGPOd Exemple de base] : comment appliquer des propriétés de style à un ou plusieurs éléments du DOM
# [https://codepen.io/mafritz/pen/rrxaoj Sélecteurs CSS - bases] : les trois manières les plus fréquentes pour sélectionner un élément à style (tag, class et id)
# [https://codepen.io/mafritz/pen/qakQqz Sélecteurs et héritage] : comment les propriétés de style se propage dans l'arborescence du DOM
# [https://codepen.io/mafritz/pen/ZpWmWj Sélecteurs et priorité] : que se passe-t-il si un élément a plusieurs sélecteurs/styles en même temps ?
# [https://codepen.io/mafritz/pen/dprQRP Composition de sélecteurs] : les sélecteurs peuvent se combiner pour former des sélecteurs très précis
# [https://codepen.io/mafritz/pen/XjKNwE Tailles de police] : pixels, pourcentage, ...
# [https://codepen.io/mafritz/pen/GjqAgg Largeur et hauteur] : différence entre dimensions absolues et pourcentages
# [https://codepen.io/mafritz/pen/ZpQYRZ Block vs. Inline element] : la différence entre éléments block et inline, et les dangers de faire confusion...
# [https://codepen.io/mafritz/pen/yaZywg Margin and padding] : combien d'espace prend une boîte?
# [https://codepen.io/mafritz/pen/wzrZZy Positioning] : déterminer le positionnement d'un élément avec des coordonnées
# [https://codepen.io/mafritz/pen/bwEAwk Floating] : différentes manières pour placer un élément à côté d'un autre,  '''mais voir plutôt une méthode plus récente''' avec [[Flexbox]]
# [https://codepen.io/mafritz/pen/ammyxN Animation CSS] : possibilité d'animer des "boîtes" (technique avancée)

Vous pouvez accèder à l’ensemble des exemples ici :
* https://codepen.io/collection/DrLerZ/

===Éventuellement au programme===
S’il reste du temps à la fin de la journée, nous verrons également quelques techniques plus avancées pour faciliter la création de pages web ou les rendre plus « professionnelles ».
Nous allons voir :
* Les framework CSS, eg :
** [http://www.w3schools.com/w3css/default.asp W3CSS]
** [[Bootstrap]]
* [https://fonts.google.com/ Google fonts]

==Introduction au transfert des fichiers==
===Objectifs===
Après la séance consacrée à l’introduction au transfert des fichiers vous devrez être familier avec :
* Qu’est qu’un serveur web
* La différence entre fichiers locaux (sur votre ordi) et fichiers distants (sur le serveur)
* Le logiciel de transfert de fichiers Cyberduck (ou alternative, par exemple [[FileZilla]] ou WinSCP)
* La différence entre HTTP et (S)FTP
* L’arborescence et les chemins de vos dossiers personnels sur le serveur tecfaetu.unige.ch
** Votre dossier home (privé)
** Votre dossier perso/homepage (public)
** Votre espace travaux (public)
* Publier des fichiers sur internet et connaître leurs URL (domain + path + nom de fichier + extension)

===Outils===
Vous allez installer sur votre ordinateur le logiciel de transfert de fichier Cyberduck qui est disponible pour Windows et Mac :
* Liens vers le site [https://cyberduck.io/ officiel Cyberduck]
Nous allons configurer ce logiciel pour que vous puissiez transférer des fichiers sur le serveur qui est mis à disposition des étudiants MALTT.

Nous vous encourageons aussi à installer [[FileZilla]], une alternative appréciée par certaines personnes. Aux utilisateurs Windows, on conseille [https://winscp.net/eng/download.php WinSCP], logiciel plus complexe mais plus efficace car il utilise une interface de type "Norton Commander".

====Installation de Cyberduck====

Pour installer Cyberduck, téléchargez-le depuis le site officiel https://cyberduck.io/. 

{{ bloc important | '''Attention''' : il existe une versione payante du logiciel (à travers les stores Apple et Windows), mais la version gratuite suffit dans le contexte du Master ! }}

# Choisir le download selon votre système d'exploitation
# Suivre les instructions du programme d'installation (normalement il n'y a pas d'options à choisir à ce moment)

À la fin du processus d'installation vous devrez obtenir une résultat similaire au suivant lorsque vous ouvrez le logiciel pour la première fois (caputre d'écran pour la version 5.1 sous Windows) :

[[Fichier:MINIT cyberduck initial screen.png|700px|vignette|néant|Capture d'écran du logiciel Cyberduck (version 5.1 sous Windows)]]

====Création d'un signet====

Créer un signet vous permet d'ouvrir facilement une connexion SFTP avec un serveur pour transférer des fichiers. Le signet se "souvient" de :

#L'adresse du serveur
#Votre login utilisateur
#Un chemin spécifique sur le serveur (optionnel)

TECFA met à disposition des étudiants trois espaces sur le serveur <code>tecfaetu.unige.ch</code> (voir plus bas pour les détails). Vous devrez donc créer trois signets différents. De suite les étapes pour en créer un, il faudra répéter l'opération avec les chemins spécifiques de chaque espace (voir plus bas).

=====Ajouter un nouveau signet=====

Suivre d'abord ces étapes (voir également image plus bas) :

#Assurez-vous d'être dans l'écran des signets
#Cliquez sur le '''+''' en bas de l'écran pour ajouter un nouveau signet
#Choisissez depuis le menu déroulant des protocols l'option '''SFTP (SSH File Transfer Protocol)'''

{{bloc important | '''Attention''': les serveurs TECFA marchent exclusivement en '''SFTP''', pour des raisons de sécurité le protocole FTP n'est pas activé. L'une des erreurs les plus fréquentes est un mauvais choix du protocole ! }}

[[Fichier:MINIT cyberduck new bookmark.png|700px|vignette|néant|Assurez-vous bien de choisir le protocol SFTP (et non pas FTP), si non la connexion ne marche pas !]]

=====Configurer le signet avec les données du serveur tecfaetu.unige.ch=====

Suivre ces étapes (voir également l'image plus bas) :

#Choisir un surnom pour le signet, par exemple '''Espace HOME (tecfaetu)'''. Vous pouvez choisir un autre nom, cela n'affecte pas le fonctionnement.
#Insérez le serveur : <code>tecfaetu.unige.ch</code>
#Saisissez votre nom d'utilisateur court
#Cliquez sur la flèche '''Plus d'options''' si une partie de la fenêtre ne s'affiche pas, et ajouter le chemin d'accès de l'espace, par exemple <code>/home/etu27/votre-login-court</code> --> '''Attention''': chemin valable seulement pour la volée '''aegir''', référez vous à la section suivante pour les chemins précis !
#Fermez la fenêtre, les informations sont sauvegardées automatiquement

[[Fichier:MINIT cyberduck fill form.png|700px|vignette|néant|Insérez les informations du serveur tecfaetu.unige.ch pour créer le signet ]]

===Vos dossiers personnels sur le serveur===
Sur le serveur tecfaetu.unige.ch vous disposez de trois dossiers que vous pouvez/devez utiliser pour vos fichiers :
# Un espace home ('''privé''')
# Un espace personnel/homepage ('''public''')
# Un espace travaux ('''public''')
====Espace home====
Il s’agit d’un espace privé dont le contenu '''n’est pas accessible par les navigateurs web'''. Vous pouvez utiliser cet espace pour vos fichiers personnels.  Vous trouverez votre espace home dans ce chemin:

 /home/etu27/''votre-login-court''

Sur un serveur, tous les utilisateurs à leur nom qui se trouvent à l'intérieur du dossier '''home'''. Dans le spécifique du MALTT, faites bien attention à ne pas confondre cet espace avec l'espace personnel où vous allez placer votre homepage (voir point suivant).

====Espace personnel/homepage====
Cet espace est à votre disposition pour vos fichiers qui peuvent être accédés par le web à travers un URL du style :

* http://tecfaetu.unige.ch/perso/maltt/votre-login-court/dossier/fichier.html

{{bloc important | C’est dans ce dossier, d’ailleurs, qui doit se trouver votre homepage personnel. }}

Vous trouverez votre espace personnel dans ce chemin :

 /web/perso/maltt/''votre-login-court''

====Espace travaux====

{{bloc important | Cet espace est dédié à vos rendus « officiels » pour certains de cours du MALTT, notamment les cours STIC I et STIC II. }}

Le fichiers contenus dans cet espace seront accessible depuis le web à l'adresse :

* http://tecfaetu.unige.ch/etu-maltt/aegir/votre-login-court/

Vous trouverez votre espace travaux dans ce chemin :

 /web/etu-maltt/aegir/''votre-login-court''

=== Anatomie d'un lien hypertextuel ===

Les ressources que vous publiez sur les espaces personnel/homepage et espace-travaux seront disponibles directement sur le web à travers ce qu'on appelle une '''URL''', c'est-à-dire l'adresse de la ressource. C'est important de bien comprendre l'anatomie des adresses pour deux raisons :

# Savoir dans quel dossier précis téléverser les fichiers
# Savoir récupérer l'URL correspondant

Voici un exemple concret :

* http://tecfaetu.unige.ch/minit/test-url/page-test.html

Cette adresse pointe vers une simple page HTML5 qui se trouve à un endroit spécifique du serveur tecfaetu.unige.ch. Nous pouvons décomposer l'URL de la manière suivante :

# '''http''' représente le '''protocole''' pour communiquer avec le server. Dans le cas du web, on utilise normalement http ou https pour la communication sécurisée
# '''tecfaetu.unige.ch''' représente le '''domaine''' ou, plus précisement dans ce cas, le '''sous-domaine''' de l'URL. tecfaetu est en effet un sous-domaine du domaine principale unige.ch
# '''/minit/test-url/''' représente le '''chemin''' (ou '''path''' en anglais). Il s'agit, dans ce cas, de l'arborescence du serveur web qui permet de trouver le fichier à un endroit précis. Par rapport à la '''racine''' du serveur web, nous nous trouvons donc dans un dossier <code>minit</code> qui a à son intérieur un sous-dossier <code>test-url</code>
# '''page-test.html''' représente le '''nom du fichier''' qui se compose également de l'extension <code>.html</code> 

La page présente à son intérieur une image [[SVG]] du logo [[HTML5]]. Cette image possède elle-même son propre URL. Vous pouvez le voir de la manière suivante :

# Click droit sur l'image
# Ouvrir l'image dans un nouveau onglet

Un nouveau tab du navigateur s'ouvre et affiche l'image du logo en plus grande échelle. Notez bien l'URL dans la barre des adresses du navigateur :

* http://tecfaetu.unige.ch/minit/test-url/assets/images/html5-logo.svg

Vous pouvez noter que, par rapport à l'URL de la page, le chemin de cette URL est plus long. En effet, l'image se trouve dans un sous-dossier <code>assets</code> qui possède un sous-dossier <code>images</code>. Le nom du fichier a également une extension différente, car il s'agit dans ce cas d'un fichier [[SVG]].

Ces fichiers existent "physiquement" dans le serveur tecfaetu.unige.ch dans un dossier qui s'appelle <code>/web/minit</code>. Vous pouvez noter, cependant, que dans le chemin de l'URL il n'y a pas de '''/web/''', car le chemin commence directement avec '''/minit/'''. En effet, la configuration du serveur tecfaetu a été faite ainsi que le dossier racine du serveur pour les fichiers publiques soit justement le dossier '''/web/'''. Donc tout ce qui se trouve à son intérieur est disponible sur le web avec un URL définit par l'arborescence des dossiers contenus dans le dossier '''/web/'''.

Vous pouvez "naviguer" directement du web l'arborescence des fichiers à travers l'URL http://tecfaetu.unige.ch/minit/test-url/ car ce dossier ne possède pas de fichier index.html ou welcome.html. En revanche, à l'intérieur du dossier vous trouver également un dossier nommé <code>with-default</code>, si vous cliquez sur ce dossier - ou vous y accédez avec l'url http://tecfaetu.unige.ch/minit/test-url/with-default/ - vous allez voir une page et non pas la liste des fichiers contenus. Ceci s'explique par le fait que le dossier <code>with-default</code> possède un fichier qui s'appelle '''index.html'''.

En fonction de la configuration du serveur web tecfaetu.unige.ch, si un dossier possède un fichier qui s'appelle :

* <code>index.html</code> ou
* <code>welcome.html</code>

celui-ci est affiché même si l'URL se limite au chemin, sans préciser le nom du fichier. En d'autres termes, les deux URL suivants donnent exactement la même réponse :

* http://tecfaetu.unige.ch/minit/test-url/with-default/
* http://tecfaetu.unige.ch/minit/test-url/with-default/index.html

===Création d’une home page personnelle===
Nous terminerons l’atelier avec une activité qui sera ensuite complétée lors du premier exercice du cours STIC I : la création d’une home page personnelle que vous devrez publier sur votre espace personnel (voir plus haut).
Cette activité vous permettra d’utiliser tous les éléments abordés pendant l’atelier. L’activité sera également l’occasion pour chercher de l’aide auprès de vos collègues et/ou les responsables de l’atelier.

==Ressources complémentaires==
Ici de suite une liste de ressources qui peuvent être utiles pour compléter et/ou consolider les acquis.
===Fonctionnement web===
* [https://www.youtube.com/watch?v=Dxcc6ycZ73M What is the internet ?] – vidéo tirée de code.org
* [https://www.youtube.com/watch?v=kBXQZMmiA4s HTTP et HTML] – vidéo tirée de code.org (essayez de trouver à quel moment la vidéo dit quelque chose de différent par rapport à ce que vous avez vu pendant l’atelier)
La série complète « How the internet works » est disponible sous ce lien https://code.org/educate/resources/videos

===HTML5===
* [http://www.w3schools.com/html/default.asp Tutoriel HTML5 sur W3schools]
* [http://www.w3schools.com/html/html_quiz.asp Quiz sur HTML sur W3schools]
* [http://www.w3schools.com/tags/default.asp Références HTML5 (tag) sur W3schools]
* [http://www.w3schools.com/tags/ref_standardattributes.asp Références HTML5 (attributs globaux) sur W3schools]
* [http://www.w3schools.com/tags/ref_attributes.asp RéférencesHTML5 (attributs) sur W3schools]
* [http://html5doctor.com/element-index/ Référence des éléments HTML5 sur html5 doctor]
* [http://html5doctor.com/downloads/h5d-sectioning-flowchart.pdf Flowchart des éléments sémantiques (PDF tiré de html5 doctor)]

===CSS===
* [http://www.w3schools.com/css/default.asp Tutoriel CSS sur W3schools]
* [http://www.w3schools.com/css/css_quiz.asp Quiz sur CSS sur W3schools]
* [http://www.w3schools.com/cssreF/ Références CSS sur W3schools]
* [https://css-tricks.com/snippets/css/ Liste de CSS « snippets » sur CSS-Tricks]

===Validation des pages===
* [https://w3c.github.io/developers/tools/ Liste de validateurs du W3C], voir surtout :
** [https://validator.w3.org/unicorn/ Unicorn] - validateur intégrant HTML, CSS et Link Checker

===Guides de style de codage===

* [https://google.github.io/styleguide/htmlcssguide.xml Google HTML/CSS style guide]
* [http://www.w3schools.com/html/html5_syntax.asp W3schools HTML5 style guide]

===Ressources internes à ce Wiki===

Dans ce wiki vous pouvez également trouver des pages qui portent sur les sujets traités dans l'atelier. Veuillez néanmoins noter que ces pages sont souvent écrites par des étudiants comme vous, ce qui peut être à la fois un avantage (même niveau de connaissance) et un désavantage (informations incomplètes ou pas claires). Voici quelques références :

* [[Introduction à HTML5]] et [[HTML5]]
* [[Introduction à CSS]] et [[Tutoriel CSS]]
* [[Document Object Model]]
* [[Le fonctionnement du protocole HTTP]]

===Ressources EduTechWiki en anglais===

La version anglaise de ce wiki contient plus d'informations sur les mêmes sujets. Voici une liste :

* [[:en:HTML]]
* [[:en:HTML5]]
* [[:en:CSS]] (page avec plusieurs liens à des sujets plus spécifiques)

[[Category: Ressources STIC]]

== Activités Aegir ==

Tâche à effectuer :

* Créer une page HTML5 avec un message "Vive HTML5", le [https://www.w3.org/html/logo/ logo de HTML5], et un paragraphe de votre choix
* Styliser votre page avec quelques déclarations CSS
* Publier dans votre espace travaux, dans un sous dossier spécifique

Contraintes :
* Votre fichier doit s'appeler <code>index.html</code>
* Le logo doit se trouver dans un sous dossier assets/images/
* Vous devez avoir au moins une déclaration de style dans un fichier .css externe
* Modifiez les dimensions de l'image dans le code (style css dans l'attribut ou dans le fichier externe, à choix) pour une hauteur de 450px
* Votre page doit se trouver dans un dossier minit/vive-html5
* Ajouter à la fin de la page la date et votre nom