Situation Professionnelle : Mise en place de l'environnement documentaire

Compétences du référentiel visées

• 3.3 : Participer à l'évolution d'un site Web

  • Justification : Déploiement un site web statique. Manipulation du fichier de configuration mkdocs.yml pour modifier l'arborescence et le contenu du site.

• 4.1 : Analyser les objectifs et modalités d'organisation d'un projet

  • Justification : Analyse des contraintes (légèreté, versioning, collaboration) dans la partie "Besoins identifiés". Choix d'une solution technique (Markdown/MkDocs) en fonction de ces objectifs.

• 6.1 : Mettre en place son environnement d'apprentissage

  • Justification : Création d'un portfolio en ligne pour présenter les travaux réalisés au cours de mon BTS

• 6.3 : Gérer son identité professionnelle

  • Justification : Mise en ligne de mon portfolio professionnel pour valoriser mes compétences et mes réalisations

• 6.4 : Développer son projet professionnel

  • Justification : Structuration de mon parcours et de mes objectifs professionnels à travers la création de cet environnement en ligne

Compétences techniques mobilisées

• Codage en Markdown
• Utilisation de GitLab

Contexte

Dans le cadre du cours de support en BTS SIO SLAM (1ère année), cette situation professionnelle avait pour objectif de créer un portfolio en ligne en respectant les indications fournies par l’enseignant. (Squelette, ...)

Le portfolio devait être rédigé en Markdown puis mis en ligne via GitLab afin de présenter les différents travaux réalisés au cours des deux années.

Objectifs de la situation professionnelle

• Comprendre la structure d’un portfolio professionnel
• Utiliser le langage Markdown
• Organiser et présenter des informations techniques de manière claire
• Mettre en ligne un contenu destiné à être consulté

Le markdown a été choisi pour sa compatibilité avec les plateformes de gestion de contenu et sa simplicité d’utilisation pour la rédaction de documents structurés.
De plus, l'utilisation du CI/CD (automatisation du déploiement) de GitLab permet de simplifier la mise en ligne du portfolio et d'assurer une mise à jour rapide et efficace des contenus en minimisant les risques d'erreurs lors du déploiement.

Solution technique retenue :

J'ai mis en place une chaîne "DevOps" composée des outils suivants :

• VSCode : Éditeur de texte principal.
• Obsidian : Editeur secondaire pour la modification du tableau de synthèse
• Markdown : Langage de balisage pour la rédaction du portfolio.
• GitLab : Plateforme pour héberger et gérer le portfolio en ligne.

J'ai choisi d'utiliser le Markdown car ce language assure une perrenité de mon contenu. En effet, si dans 10 ans je souhaite réutilisermon portfolio ou le relire, ce sera toujours possible grâce à sa compatibilité avec de nombreux outils. De plus, étant du texte brut, il est facilement comprhéensible et modifiable, même avec n'importe quel éditeur de texte.

L'utilisation de GitLab (Forge) assure la continuité et la disponibilité de mon travail même en cas de sinistre materiel (vol, perte, ...) car étant hébergé en ligne, je peux y accéder et récupérer mes données depuis n'importe quel ordinateur, qui a une connxion internet, en clonant mon projet. En faisant cela, je récupèrerait toutes mes données contenues dans mon dépôt.
Ensuite je peux créer de nouveaux fichiers, modifiers les existants, ... et les push sur GitLab pour les sauvegarder.

Le déploiement continu (CI/CD) est intéréssant car il permet l'automatisation de la mise à jour de mon site (mon portfolio ici) quand je fait un commit sur GitLab. Cela offre un gain de temps considérable, en m'évitant toutes les différentes commandes à faire manuellement, ainsi qu'une diminution du risque d'erreur et d'oublis lors du déploiement.
Donc, grâce à cette automatisation, je peux me concentrer sur la création de contenu et l'amélioration de ma page web sans me soucier de cette partie de mise en ligne.

Travail réalisé

• Installation et configuration de l'IDE VSCode et des extensions nécessaires
• Prise en main d'Obsidian
• Apprentissage du langage Markdown
• Création d'un dépôt GitLab pour héberger le portfolio
• Création et adaptation des différentes sections du portfolio
• Rédaction des contenus en Markdown
• Mise en ligne du portfolio
• Audit du portfolio d'un camarade
• Audit de mon portfolio par un camarade
• Configuration du fichier mkdocs.yml pour la génération du site

Voici une capture de mon code pour le fichier mkdocs.yml :

Résultat

Le portfolio est fonctionnel et accessible en ligne.
Il permet de présenter de manière structurée les exercices et compétences travaillées dans le cadre du BTS SIO.
Il est modifiable et évolutif, permettant d’ajouter de nouveaux contenus au fur et à mesure de l’avancement dans la formation.

Preuves de réalisation

Voici une capture d'écran de mon site ainsi qu'une capture de mes commits sur GitLab :

Preuve de la mise en oeuvre du workflow Git en mode nomade :