1. Présentation

Ce guide explique comment migrer un site web personnel vers la plateforme PLMlab (GitLab) de Mathrice, en utilisant le service GitLab Pages.

Cette solution permet d'héberger gratuitement des sites web statiques (HTML, CSS, JavaScript, images, PDF, etc.).

La migration ne nécessite pas de connaissances particulières en développement web.

Une méthode est proposée :

** transfert des fichiers depuis son ordinateur avec Git.

2. Préparer son site web

Avant de commencer, il faut disposer d'une copie locale du site web à migrer sur son ordinateur.

En général, un site web simple contient :

  • Un fichier index.html : page principale du site.
  • Un ou plusieurs fichiers CSS : mise en forme du site.
  • Un ou plusieurs dossiers contenant les images et les documents (PDF, etc.).
  • Éventuellement des fichiers JavaScript.

Exemple d'organisation des fichiers :

mon-site/
│
├── index.html
├── style.css
├── photo/
│   ├── photo1.jpg
│   └── photo2.jpg
│
└── documents/
    └── document.pdf

Conservez cette organisation autant que possible afin de ne pas avoir à modifier les chemins des images et des documents dans vos pages HTML.

3. Créer son projet sur PLMlab

Étape 1 – Se connecter à PLMlab

Accéder à la plateforme :

https://plmlab.math.cnrs.fr

Se connecter avec son compte utilisateur PLM (compte Mathrice).

Étape 2 – Créer un nouveau projet

  1. Cliquer sur New project.
  2. Sélectionner Create from template.
  3. Choisir le modèle Pages / Plain HTML.
  4. Renseigner les informations du projet :
ParamètreValeur
Project nameNom du projet (ex. : webpro)
Project URLNamespace correspondant à votre compte PLM
Visibility LevelPublic

Important : le nom du projet sera utilisé dans l'adresse de votre site web. Choisissez un nom simple, sans espace ni caractère accentué.

  1. Cliquer sur Create project.

Le projet est maintenant créé. Il contient les fichiers nécessaires à la publication du site.

4. Transférer les fichiers du site

Transfert depuis son ordinateur avec Git

Cette méthode permet de transférer directement l'ensemble des fichiers de son site depuis son ordinateur.

Elle nécessite :

  • Git installé sur son ordinateur.
  • Une clé SSH configurée pour accéder à PLMlab.(voir documentation dans le SDRIVE du CNRS)

https://sdrive.cnrs.fr/f/619827613

Étape 1 – Récupérer l'adresse du dépôt

  1. Ouvrir son projet sur PLMlab.
  2. Cliquer sur Code.
  3. Copier l'adresse SSH du dépôt.

Elle ressemble à cet exemple :

git@plmlab.math.cnrs.fr:compteplm/nomduprojet.git

Étape 2 – Récupérer le projet sur son ordinateur en local

Ouvrir un terminal et exécuter :

git clone git@plmlab.math.cnrs.fr:compteplm/nomduprojet.git

Remplacer compteplm et nomduprojet par les informations correspondant à votre compte et à votre projet.

Cette commande crée un dossier contenant les fichiers du projet.

Étape 3 – Copier les fichiers du site

  1. Ouvrir le dossier du projet récupéré.
  2. Repérer le dossier public.
  3. Copier les fichiers de votre site web dans ce dossier.
  4. Remplacer les fichiers d'exemple du modèle si nécessaire.

Vérifier que le fichier index.html se trouve bien directement dans public.

Étape 4 – Envoyer les fichiers sur PLMlab

Dans le terminal, se placer dans le dossier du projet :

cd nomduprojet

Ajouter les nouveaux fichiers et enregistrer les modifications :

git add .
git commit -m "Migration du site Web"
git push

Les fichiers sont maintenant transférés sur PLMlab.

5. Configurer la publication du site web

Une fois les fichiers transférés, il faut vérifier les paramètres de publication.

Étape 1 – Désactiver le domaine unique

  1. Retourner sur le projet PLMlab.
  2. Dans le menu de gauche, aller dans Deploy → Pages.
  3. Ouvrir Domains & Settings.
  4. Dans les paramètres du domaine, décocher Use unique domain si cette option est activée.

Étape 2 – Autoriser l'accès public au site

Pour permettre à tous les internautes de consulter votre site :

  1. Aller dans Settings → General.
  2. Rechercher la rubrique Pages.
  3. Dans le paramètre de contrôle d'accès, sélectionner Everyone with access si cette option correspond à la configuration proposée sur votre projet.

Vérifier que le site est effectivement consultable sans connexion à PLMlab.

Attention : un dépôt public permet également de consulter son contenu et son historique. Ne déposez jamais de mots de passe, de clés privées, de données personnelles ou de documents confidentiels dans un dépôt public.

6. Récupérer l'adresse de son site web

Pour connaître l'adresse de votre site :

  1. Ouvrir votre projet sur PLMlab.
  2. Aller dans Deploy → Pages.
  3. Repérer l'adresse publiée dans la rubrique Pages.

L'adresse dépend du nom du projet, de votre compte et de la configuration de PLMlab.

Vous pouvez ensuite communiquer cette adresse à vos correspondants ou l'ajouter à votre page professionnelle.

7. Mettre à jour son site web

Une fois le site publié, il est possible de le modifier à tout moment.

Pour effectuer une modification :

  1. Ouvrir le projet sur PLMlab en local.
  2. Modifier ou ajouter les fichiers nécessaires dans le dossier public.
  3. Enregistrer les modifications.
  4. Effectuer un Commit & Push.

La publication est automatiquement relancée.

Après quelques instants, les modifications sont visibles à l'adresse habituelle du site.

8. En cas de problème

Problème rencontréVérification à effectuer
Le site ne s'affiche pasVérifier que le pipeline de publication est terminé avec succès.
Une erreur 404 apparaîtVérifier la présence du fichier index.html dans le dossier public.
Les images ne s'affichent pasVérifier les chemins et les noms des images dans le fichier HTML.
Les modifications ne sont pas visiblesVérifier que les modifications ont bien été enregistrées et envoyées (Commit & Push).
Le site demande une authentificationVérifier les paramètres d'accès public dans la rubrique Pages.