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
- Cliquer sur New project.
- Sélectionner Create from template.
- Choisir le modèle Pages / Plain HTML.
- Renseigner les informations du projet :
| Paramètre | Valeur |
|---|---|
| Project name | Nom du projet (ex. : webpro) |
| Project URL | Namespace correspondant à votre compte PLM |
| Visibility Level | Public |
Important : le nom du projet sera utilisé dans l'adresse de votre site web. Choisissez un nom simple, sans espace ni caractère accentué.
- 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
- Ouvrir son projet sur PLMlab.
- Cliquer sur Code.
- 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
- Ouvrir le dossier du projet récupéré.
- Repérer le dossier
public. - Copier les fichiers de votre site web dans ce dossier.
- 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
- Retourner sur le projet PLMlab.
- Dans le menu de gauche, aller dans Deploy → Pages.
- Ouvrir Domains & Settings.
- 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 :
- Aller dans Settings → General.
- Rechercher la rubrique Pages.
- 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 :
- Ouvrir votre projet sur PLMlab.
- Aller dans Deploy → Pages.
- 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 :
- Ouvrir le projet sur PLMlab en local.
- Modifier ou ajouter les fichiers nécessaires dans le dossier
public. - Enregistrer les modifications.
- 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 pas | Vérifier que le pipeline de publication est terminé avec succès. |
| Une erreur 404 apparaît | Vérifier la présence du fichier index.html dans le dossier public. |
| Les images ne s'affichent pas | Vérifier les chemins et les noms des images dans le fichier HTML. |
| Les modifications ne sont pas visibles | Vérifier que les modifications ont bien été enregistrées et envoyées (Commit & Push). |
| Le site demande une authentification | Vérifier les paramètres d'accès public dans la rubrique Pages. |
