Aller au contenu

👣 Parcours pas à pas

Pourquoi ce parcours ?

Dans ce parcours "pas à pas", vous allez acquérir un peu de vocabulaire spécifique, apprendre à recopier le site modèle proposé, à l'adapter, en utilisant Web IDE.

Dans un deuxième temps, vous pourrez prendre un peu de temps pour parcourir et découvrir les différentes pages de ce site.

I. Le rendu⚓︎

Vous trouverez ici un exemple de ce que vous pouvez réaliser. Prenez un peu de temps pour parcourir les différentes pages :

Rendu du site modèle avec pyodide-mkdocs-theme

II. Explications et vocabulaire⚓︎

Le rendu de votre site sera construit automatiquement. Nous allons voir comment procéder.

  • Tout d'abord vous trouverez ici une présentation de la structure du site qui a permis le rendu que vous venez de consulter : La structure du site

  • Il faut connaître aussi un peu de vocabulaire

III. C'est parti pour créer votre propre site⚓︎

Création à partir du site modèle⚓︎

Votre propre site

Créer votre première page⚓︎

Pour cela, vous allez travailler sur Web IDE.

Le début de votre premier fichier ma_premiere_page.md ressemblera à ceci :

Code à copier au début d'un fichier .md
---
author: compléter avec les noms d'auteurs
title: Compléter le titre qui sera affiché dans le menu
---

Ma jolie page

⚠️ Si vous regardez le rendu de votre site, la nouvelle page n'apparaît sûrement pas. Il faut en effet modifier le fichier .pages

  • Faites apparaître votre page dans le menu : Structure du site et organisation du menu

  • Réaliser à nouveau un commit, puis observer le rendu de votre site, qui contient maintenant votre nouvelle page.
    Ce n'est pas instantanné, il faut parfois rafraîchir le site.

Cacher les pages du site modèle⚓︎

Vous pouvez vouloir garder ces pages, comme modèles, sans qu'elles ne soient accessibles par votre menu. Il suffit de les "sortir" du fichier .pages principal :

Fichier .pages du site modèle
nav:
    - index.md
    - 01_chapitre_1
    - 02_chapitre_2
    - exercice_deux_versions
    - saisies
    - python_imbrique
    - qcm_1
    - exercices_avec_dessins
    - bac_a_sable.md
    - tags.md
    - credits
Fichier .pages de votre site
nav:
    - index.md
    - ma_premiere_page.md
    - tags.md
    - credits.md

Il ne restera que l'accueil, votre page, les tags et les crédits.

III. S'initier un peu plus à Web IDE⚓︎

Votre site est parti 😊.
Pour poursuivre, vous aurez besoin d'en apprendre un peu plus sur GitLab en ligne : à partir du VI du kit de survie GitLab

IV. Un contenu plus élaboré⚓︎

Comment écrire vos pages

👀 Vous pouvez explorer toutes les autres rubriques de ce tutoriel ...

😊 Bonne lecture ...

Par exemple :