Aller au contenu

TP00 - Utilisation de Gitlab et fiche de présentation personnelle en Typst

Objectifs du TP

À la fin de ce TP, les étudiants :

  • se seront inscrits dans un groupe et auront communiqué leur login du gitlab de l’école à l’enseignant
  • auront configuré leur machine pour travailler avec git
  • auront accepté une invitation du gitlab de l’école pour travailler dans un projet créé par l’enseignant
  • auront rédigé une fiche de présentation personnelle avec Typst et publié cette fiche dans une release sur Gitlab
  • auront compris l’utilisation de Gitlab CI/CD pour la génération automatique d’une release

Les livrables sont:

  • une fiche de présentation personnelle en PDF

Temps accordé: 45 minutes en classe + travail personnel à la maison si nécessaire

Installation des logiciels recommandés

Pour interagir avec les dépôts sur Gitlab, vous devez avoir un client git. Si vous utilisez macOS, git est déjà installé de base, mais sur Windows, vous devez l’installer séparément. Si ce n’est pas déjà fait, téléchargez et installez git sur votre machine.

Configurez le user name et le e-mail. Dans un terminal (ou Git Bash sur Windows), tapez les commandes suivantes:

git config --global user.name "Mona Lisa"
git config --global user.email mona.lisa@edu.hefr.ch

Note

Nous utilisons beaucoup git pour les travaux pratiques. Si vous n’êtes pas vraiment à l’aise avec cet outil, nous vous recommandons d’étudier les nombreuses documentations disponibles sur Internet:

Info

Avec votre adresse e-mail de l’école, vous pouvez obtenir le GitHub Student Developer Pack qui vous donne aussi droit à GitKraken Pro pendant toutes vos études.

En plus de git, vous aurez besoin d’un éditeur de code. Nous recommandons Visual Studio Code qui est gratuit et très populaire, mais vous pouvez utiliser l’éditeur de votre choix (CLion, Vim, Neovim, Emacs, …). Notez juste que les explications pour les TPs seront basées sur Visual Studio Code.

Configuration du dépôt sur gitlab.forge.hefr.ch

Consultez vos e-mails et trouvez l’invitation du gitlab de l’école pour rejoindre un projet «tp00-x». L’URL de ce projet ressemble à ça:

https://gitlab.forge.hefr.ch/ado/2025-2026/<ENSEIGNANT>/tp00-<GROUPE>/tp00-<x>

Acceptez cette invitation. Vous recevrez une telle invitation pour chaque TP de ce cours. Pour ce premier travail, vous êtes seul(e) à travailler sur le projet, mais pour les suivants, le système vous attribuera (aléatoirement) un partenaire.

À faire

Utilisez l’interface web du projet (settings → General) pour modifier la description du projet et pour ajouter un project avatar.

Rédaction de la fiche de présentation personnelle en Typst

Typst est un langage de mise en page moderne qui permet de créer des documents de manière simple et efficace. Il est particulièrement adapté pour la rédaction de documents techniques et scientifiques.

Pour ce premier TP, vous allez rédiger votre fiche de présentation personnelle en utilisant Typst et publier le PDF de votre document sur Gitlab.

Commencez par cloner le dépôt tp00-<x> dans votre répertoire de travail. Editez ensuite le fichier doc/report.typ pour y ajouter les informations suivantes:

  • Votre nom
  • Votre prénom
  • Le pronom par lequel vous souhaitez être désigné (il/lui, elle/elle,…)
  • Votre photo (ou vore avatar)
  • La classe dans laquelle vous êtes
  • Votre formation de base (par exemple EMF Informaticien, EMF…, EPAI, CFC de…, Collège…)
  • Vos connaissances préalables avec une auto-évaluation entre 0 et 10 sur les points suivants: (mettez 0 si vous n’en avez jamais entendu parler, 5 ou 6 si vous utilisez cette technique régulièrement, 10 si vous l’avez inventé ou écrit un livre sur le sujet)
    • Programmation en C
    • Programmation en C++
    • Programmation en assembleur (Intel ou ARM)
    • Programmation sur Arduino, ESP32 ou autre petit système embarqué
  • D’autres connaissances que vous avez et que vous pensez être utiles pour ce cours
  • Les attentes que vous avez pour ce cours
  • Vos hobbies et vos passions (si vous en avez envie)

Sauvegardez votre document et poussez vos modifications sur Gitlab.

À faire

Etudiez le fichier .gitlab-ci.yml pour comprendre le processus d’intégration continue mis en place pour ce projet. Lisez la documentation de Gitlab CI/CD pour en savoir plus sur la configuration des pipelines.

Si vous avez des questions, visualisez tout d’abord les tutoriels disponibles sur Internet:

Si vous avez encore des questions, n’hésitez pas à demander des explications à l’enseigant.

Quand vous êtres satisfait du résultat, validez la version en définissant le tag v1.0.0 et en poussant le tag sur Gitlab. Le PDF de votre document devrait être généré automatiquement et disponible dans la release associée à ce tag.

Délais

Le document doit être rendu au plus tard 2 jours après la séance en classe à 23h59 (soit le mercredi à 23h59 si vous avez le TP le lundi).