Comment créer un site à partir d'un autre ?

I. Recopier le site

👉 Aller sur le dépôt du site qui sert de modèle.

Site à copier pour cours à usage général

👉 On va recopier le site : Cliquer sur le bouton «Créer une bifurcation» en haut à droite («fork» en anglais)

👉 Remplir le champ Nom du projet, puis sélectionner le domaine avec le menu déroulant.

👉 Absolument cocher Uniquement la branche par défaut main

👉 Cocher «Public» puis cliquer sur «Bifurquer un projet»
Au point 3. il faudra choisir un nom de groupe ou en créer un nouveau en cliquant juste en dessous sur "Créer un groupe".

À savoir pour choisir un nom de groupe sur la forge des communs numériques éducatifs

La forge est un espace de liberté pour ses membres. Mais le choix du nom d'un groupe doit être fait en connaissant les points suivants :

Si vous choisissez "Ministère" alors votre application en ligne ou site web personnel sera accessible à l'URL ministere.forge.apps.education.fr Cet exemple est caricatural mais vous comprenez aisément que cela puisse poser problème et créer de la confusion. De meme "Troisième", "Mathématiques" ou "Tutoriels" qui pourraient laisser à penser qu'on y retrouvera toutes les ressources de troisième et de mathématiques de la forge, ou des tutoriels concernant l'usage de la forge.

Il faut donc personnaliser et ne pas utiliser de noms génériques pour les groupes : être le plus précis possible. Par exemple, pour le lycée Van Gogh, ne pas mettre seulement vanGogh, mais par exemple lyceeVanGoghErmont (lycée Van Gogh d'Ermont)

👉 Respecter les règles suivantes :

• Utiliser un nom de groupe qui soit clair et précis, et qui ne soit pas trompeur quant à l'identité ou les objectifs du groupe.
• Ne pas choisir un nom de groupe qui pourrait créer une confusion avec un autre groupe existant ou qui pourrait nuire à la réputation d'autrui.
• Les noms de groupe ne doivent en aucun cas contenir des éléments offensants, discriminatoires, ou qui pourraient gêner d'autres utilisateurs.
• Les noms de groupe trop génériques, tels que "modèles" ou "cours", sont interdits /a priori/ afin de prévenir toute confusion et de maintenir une organisation claire au sein de la plateforme. Ils peuvent toutefois être utilisés, après accord par le comité de suivi (COSUI) s'ils représentent une communauté de contributeurs.

Le comité de suivi se réserve le droit de juger qu'un nom de groupe n'est pas approprié et de demander d'en changer. Merci de votre compréhension. Certains groupes aux noms génériques existent et sont liés à l'existence d'une communauté active sur le sujet.

😀 On obtient :

👉 Dans le menu de gauche sélectionner "Compilation" puis "Pipelines"

👉 Puis en haut à droite cliquer sur «New pipeline»

👉 Puis cliquer à nouveau sur «Exécuter le pipeline» sans rien changer à ce qui est proposé

⌛ Etre assez patient et attendre un peu. On attend pendant qu'il s'affiche build.

😀 Après quelques instants s'affiche :

👉 Vous pouvez enfin cliquer sur "Déploiement" puis sur "pages"

👉 Il faut décocher "Utiliser un domaine unique"

Vous obsrvez que l'url proposée est très compliquée. Elle sera simplifiée après avoir décoché "Utiliser un domaine unique" puis enregistré la modification

👉 Après avoir enregistré la modification, vous obtenez une url plus simple :

C'est l'adresse de rendu de votre site, vous pouvez la noter 😊.

II. Personnaliser le site

😀 C'est presque fini !

Il faut modifier le README.md

👉 Cliquer sur le nom de votre site en haut à gauche

👉 Cliquer sur "Modifier", puis sélectionner "EDI Web"

👉 Cliquer sur le fichier README.md

👉 Modifier le fichier README.md

👉 Enregistrer la modification du fichier en réalisant un "commit"

Voir ci-dessous

Réaliser un commit

Suivre cette méthode pour toutes les modifications de fichiers de votre site.

Cliquer sur l'icône :

Renseigner le commit :

Visualiser les modifications apportées par le commit demandé :

Faire le commit :

En bas à droite, Cliquer sur Go to project pour visualiser l'évolution de la construction du site.

Au début, la construction est en cours :

Une fois la construction terminée, on obtient :

Rafraichir la page du rendu de votre site. Il faut attendre un peu, et parfois recommencer, pour voir apparaître les modifications.

Personnaliser le projet : Modifier le fichier mkdocs.yml

👉 Revenir sur Web IDE

👉 Sélectionner le fichier mkdocs.yml

👉 Modifier le fichier mkdocs.yml

Il y a seulement deux lignes à modifier :

• Ligne :
  site_description: Un modèle avec mkdocs
  Remplacer Un modèle avec mkdocs par votre propre description de site (par exemple Cours de SVT de ... )

• Sous la ligne :
  copyright: |
  Remplacer Nom d'auteur par votre nom

👉 Faire le commit

Le nom du site

Le nom du site est le nom du projet que vous avez donné lorsque vous avez rélisé la bifurcation du site modèle.

Modifier le fichier index.md

👉 Revenir sur Web IDE

👉 Sélectionner le fichier index.md du dossier docs

• Éditer le fichier index.md
• Le personnaliser. Il s'agit de la page d'accueil de votre site.

Si besoin voir le tutoriel Avant de démarrer

👉 Faire le commit

URL du site

😀 On peut se rendre sur l'adresse du rendu (nous l'avons trouvée dans "Déploiement" puis "Pages") pour voir le résultat.

Changer de logo

Vous pouvez choisir un autre logo en suivant ce lien : Logos Material Design Icons

• Comme expliqué précédemment, ouvrir le fichier mkdocs.yml
• Vers la ligne 25 vous pouvez lire :
  logo: material/stairs-up

👉 Il suffit de remplacer stairs-up par la référence choisie.

Par exemple :

avec : logo: material/teddy-bear

on obtient le rendu suivant :

III. Votre propre contenu

Pour ajouter vos propres pages, voir le tutoriel Kit de survie Gitlab en ligne

⚙️ Modification avancée de votre site : supprimer le lien vers le dépôt du site

⚠️ Cette modification n'est à réaliser que si vous avez bien réfléchi aux conséquences.

Elle supprime le lien direct de votre site

• vers le dépôt du site :

• vers le dépôt de la page active :

👉 Vous pourrez toujours atteindre votre dépôt à partir de son adresse url.

👉 Ci-dessous votre haut de page avant et après la modification :

Avant :

Après :

Comment faire ?

• Suivre les explications du II. pour ouvrir le fichier mkdocs.yml

• Vers la ligne 58 mettre en commentaire (ajouter simplement # au début de la ligne) les deux lignes suivantes.

# repo_url: !ENV [CI_PROJECT_URL]
# edit_uri: !ENV [EDIT_VARIABLE]

👉 Faire le commit

Ne pas supprimer

Il est recommandé de ne pas supprimer ces deux lignes pour pouvoir les rétablir facilement en supprimant le # du début de la ligne.