Travail pratique

ID : A05-TP05.1

But du TP

• Prendre en main l'IDE IntelliJ IDEA
• Se familiariser avec l'utilisation du système de gestion de versions Git et la plateforme de gestion de projets GitLab
• Déployer un site web supplémentaire sur nginx (Windows) en développement

Travail à réaliser

Git

1. Réalisez les divers tutoriels disponibles sur Learn Git Branching afin de vous former à Git.
2. Jouez avec Git Mastery afin de vous familiariser avec Git.
3. Installez et configurez Git sur votre laptop.

4. Configurez votre nom complet (Prénom Nom) et adresse email (@edu.hefr.ch) dans les paramètres globaux de Git, en entrant les commandes suivantes dans votre invite de commandes Windows :

   git config --global user.name "Prénom Nom"
   

   git config --global user.email "Adresse email"
   

5. Configurez Git pour qu'il crée toujours un commit de fusion (« Merge Commit ») lors d'une fusion, même quand une avance rapide (fast-forward) serait possible (voir Merge et Rebase) :

   git config --global merge.ff false
   

6. Vérifiez que votre config est correcte.

Question : Où sont stockées ces informations et comment peut-on les consulter ?

IntelliJ IDEA

Configurez les préférences de base suivantes dans IntelliJ IDEA :

1. Depuis l'écran d'accueil, cliquez sur Customize puis All settings….
2. Cherchez et configurez les options suivantes :
   • Sous Editor → General, section On Save : Remove trailing spaces on: → ✅ All lines
   • Sous Editor → General, section On Save : Ensure every saved file ends with a line break → ✅
   • (optionnel) Sous Editor → General → Appearance, section Presentation : Show whitespaces → ✅
     • Leading → ✅
     • Inner → ✅
     • Trailing → ✅
     • Selection → ✅
3. Configurez les divers paramètres pour l'encodage des fichiers sous Editor → File encodings :
   • Global Encoding → UTF-8
   • Project Encoding → UTF-8
   • Default encoding for properties files: → ISO-8859-1
   • Create UTF-8 files: → with NO BOM
4. Configurez les paramètres de base pour les commits sous Version Control → Commit, section Commit message inspections :
   • Blank line between subject and body → ✅
     • Cliquez sur ce paramètre puis dans la liste Severity: sélectionnez l'option Error
   • Limit body line → ✅
     • Cliquez sur ce paramètre puis dans la liste Severity: sélectionnez l'option Error
     • Vérifiez que Right margin: soit à 72
     • Show right margin → ✅
     • Wrap when typing reaches right margin → ✅
   • Limit subject line → ✅
     • Cliquez sur ce paramètre puis dans la liste Severity: sélectionnez l'option Error
     • Vérifiez que Right margin: soit à 50
5. Configurez le paramètre de base pour Git sous Version Control → Git, section Update :
   • Update method: → 🔘 Rebase

MkDocs

1. Clonez le projet du travail pratique qui se trouve sur GitLab.
2. Installez Material for MkDocs sur votre laptop.
3. Faites un « build » du site web MkDocs, disponible sur la branche develop (Git).
4. Déployez le site web (le répertoire site qui a été généré par le « build ») sur votre serveur web local (nginx sur Windows).
   • Le site doit être accessible avec l'URL http://tp05.api-ti.lan.
   • Le précédent site http://api-ti.lan (du travail pratique A02-TP02) doit continuer à être accessible, donc utilisez les serveurs virtuels (voir le travail pratique A03-TP03).
   • Modifiez la configuration de ce serveur virtuel afin que les fichiers de log de nginx (error.log et access.log) soient écrits dans le répertoire log, à la racine de votre projet IntelliJ IDEA.

---

Rendu du TP

Aucun rapport, manuel ou documentation n'est demandé pour ce travail pratique.

• La rédaction d'un aide-mémoire personnel des étapes à réaliser, des commandes à entrer, des fichiers à modifier, etc., est fortement recommandée !

Cette première partie du travail pratique doit être terminée pour le jeudi 15 octobre à 23h59, au plus tard.

Le TP sera évalué.