Différences
Ci-dessous, les différences entre deux révisions de la page.
| Prochaine révision | Révision précédente | ||
| documentation:poste:web [2026/03/24 10:58] – créée diaoune | documentation:poste:web [2026/03/24 11:01] (Version actuelle) – supprimée diaoune | ||
|---|---|---|---|
| Ligne 1: | Ligne 1: | ||
| - | # Création d'un site avec Publii et PLMlab | ||
| - | --- | ||
| - | |||
| - | ## Qu' | ||
| - | |||
| - | Publii est un logiciel (CMS) open-source qui permet de créer des **sites web statiques**. | ||
| - | |||
| - | Contrairement aux CMS classiques (comme WordPress), il ne nécessite pas de serveur dynamique ni de base de données : le site est généré en fichiers HTML, CSS et JavaScript, puis déployé facilement (GitHub Pages, Netlify, etc.). | ||
| - | |||
| - | 👉 Avantages : | ||
| - | |||
| - | * rapide | ||
| - | * sécurisé | ||
| - | * simple à héberger | ||
| - | |||
| - | Lien de télechargement -> https:// | ||
| - | |||
| - | --- | ||
| - | |||
| - | ## Qu' | ||
| - | |||
| - | PLMlab est une plateforme de type **GitLab** mise à disposition par le CNRS pour la communauté des mathématiques. | ||
| - | |||
| - | C’est une **forge logicielle** qui permet de : | ||
| - | |||
| - | * héberger du code (Git) | ||
| - | * collaborer sur des projets | ||
| - | * faire de l’intégration continue (CI/CD) | ||
| - | * héberger des sites web (GitLab Pages) | ||
| - | |||
| - | --- | ||
| - | |||
| - | ## 📖 Glossaire | ||
| - | |||
| - | * **Site public** : accessible à tout le monde sur Internet, sans authentification (ex : une page professionnelle visible par tous). | ||
| - | |||
| - | * **Site privé** : accessible uniquement à des utilisateurs autorisés (connexion requise, accès restreint). | ||
| - | |||
| - | * **Repository (repo)** : espace de stockage d’un projet (code, fichiers, historique). | ||
| - | 👉 En pratique, **le repo correspond au nom du projet**. | ||
| - | |||
| - | --- | ||
| - | |||
| - | ## Étape 1 — Préparer le dépôt PLMlab | ||
| - | |||
| - | 1. Créer un **nouveau repository** sur PLMlab (public ou privé) | ||
| - | 2. Générer un **Access Token** : | ||
| - | |||
| - | * Aller dans **Settings → Access Tokens** | ||
| - | * Créer un token avec les droits **Owner** et **api** | ||
| - | * ⚠️ **Attention : le token est limité à 4 semaines par défaut** | ||
| - | * **Copier le token** (il ne sera plus visible après) | ||
| - | |||
| - | --- | ||
| - | |||
| - | ## Étape 2 — Configurer Publii | ||
| - | |||
| - | 1. Lancer **Publii** | ||
| - | 2. Aller dans : | ||
| - | | ||
| - | 3. Configurer comme suit : | ||
| - | |||
| - | ``` | ||
| - | Website URL : https:// | ||
| - | Server | ||
| - | Repository | ||
| - | Branch | ||
| - | Token : ****************** | ||
| - | ``` | ||
| - | |||
| - | 4. **Sauvegarder** les paramètres | ||
| - | |||
| - | 5. Lancer une **première synchronisation** | ||
| - | |||
| - | * Cela envoie les fichiers vers PLMlab | ||
| - | * Le dossier `public/` apparaît dans le repo | ||
| - | |||
| - | --- | ||
| - | |||
| - | ## Étape 3 — Générer le fichier `.gitlab-ci.yml` | ||
| - | |||
| - | 1. Dans PLMlab, aller dans **Deploy → Pages** | ||
| - | 2. Suivre l' | ||
| - | |||
| - | * **Step 1** : image Docker → `alpine: | ||
| - | * **Step 2** : Installation → laisser vide | ||
| - | * **Step 3** : Build command → `echo " | ||
| - | 3. Valider → le fichier `.gitlab-ci.yml` est automatiquement créé | ||
| - | |||
| - | Exemple : | ||
| - | |||
| - | ```yaml | ||
| - | image: alpine: | ||
| - | |||
| - | create-pages: | ||
| - | script: | ||
| - | - echo " | ||
| - | pages: | ||
| - | publish: public | ||
| - | rules: | ||
| - | - if: $CI_COMMIT_REF_NAME == $CI_DEFAULT_BRANCH | ||
| - | ``` | ||
| - | |||
| - | --- | ||
| - | |||
| - | ## Étape 4 — Attendre la fin du pipeline | ||
| - | |||
| - | 1. Aller dans **Build → Pipelines** | ||
| - | 2. Attendre que le pipeline soit **✅ Passed** | ||
| - | |||
| - | --- | ||
| - | |||
| - | ## Étape 5 — Désactiver le domaine unique | ||
| - | |||
| - | 1. Aller dans **Deploy → Pages → Domains & Settings** | ||
| - | 2. **Décocher** la case **"Use unique domain" | ||
| - | 3. Cliquer sur **Save changes** | ||
| - | 4. Copier l'URL du site (ex : | ||
| - | | ||
| - | |||
| - | ### ❓ Pourquoi ? | ||
| - | |||
| - | Si l’option est activée, l’URL change à chaque déploiement : | ||
| - | |||
| - | ``` | ||
| - | fdiaoune-monsiteweb-abc123.pages.math.cnrs.fr | ||
| - | ``` | ||
| - | |||
| - | 👉 Problème : Publii a besoin d’une **URL fixe** pour générer correctement : | ||
| - | |||
| - | * les liens | ||
| - | * les images | ||
| - | * le CSS | ||
| - | |||
| - | ➡️ Il faut donc **une URL stable** | ||
| - | |||
| - | --- | ||
| - | |||
| - | ## Étape 6 — Mettre à jour Publii | ||
| - | |||
| - | 1. Retourner dans **Publii → Server settings** | ||
| - | 2. Remplacer **Website URL** par l’URL finale | ||
| - | 3. Relancer une synchronisation | ||
| - | |||
| - | 🎉 Le site est maintenant en ligne ! | ||
| - | |||
| - | --- | ||
| - | |||
| - | ## ⚠️ Important — Délai de mise à jour | ||
| - | |||
| - | Les changements ne sont **pas instantanés**. | ||
| - | |||
| - | À chaque synchronisation : | ||
| - | |||
| - | * un pipeline CI/CD est lancé | ||
| - | * délai : quelques secondes à quelques minutes | ||
| - | |||
| - | 👉 Suivi : **Build → Pipelines** | ||
| - | |||
| - | --- | ||
| - | |||
| - | ## 💡 Astuce | ||
| - | |||
| - | Pour voir vos modifications **immédiatement** : | ||
| - | |||
| - | 👉 Bouton **" | ||
| - | |||
| - | Cela ouvre le site en local (`file:/// | ||
| - | |||
| - | * styles OK | ||
| - | * images OK | ||
| - | * navigation OK | ||