Vous avez installé Hugo en local et vous êtes prête à révéler votre site à la face du monde?
Voici les étapes à suivre pour mettre en ligne sur vous.frama.io
grâce au service Framagit de l'association Framasoft.
Création du compte sur Framagit
Pour commencer, créez un compte sur framagit.org
Cliquez ensuite sur le lien reçu par mail et personnalisez l’interface de Framagit en répondant à la question suivante:
Autorisez les Gitlab Pages à accéder au compte :
Initialisation du projet
Créez un nouveau projet:
- le project slug doit être
<votre-nom>.frama.io
- le Visibility Level doit être ‘Public’ (sinon seules les personnes membres du projet pourront voir votre site)
- ne cochez pas ‘Initialize repository with a README’ afin d’éviter un conflit dans Git
Pour pousser sur votre dépôt sans mot de passe, prenez le temps de créer une clé SSH comme ça vous est conseillé
Ensuite, depuis la page ‘Project overview’, copiez la référence de votre dépôt:
Utilisez cette référence dans Git pour ajouter votre dépôt Framagit comme ‘remote’ :
git remote add origin git@framagit.org:<votre-nom>/<votre-nom>.frama.io.git
Mise en place du déploiement automatique
Dernière étape, créez un fichier nommé .gitlab-ci.yml
à la racine de votre projet contenant ces lignes:
image: monachus/hugo
variables:
GIT_SUBMODULE_STRATEGY: recursive
pages:
script:
- hugo --enableGitInfo
artifacts:
paths:
- public
only:
- master
Vous y êtes !
Une fois que vous avez pushé vos fichiers, patientez quelques secondes et votre site devrait apparaître sur https://<votre-nom>.frama.io
.
Résolution de problèmes
En cas de problème vous pouvez
- obtenir des infos sur le processus de build dans Framagit → CI/CD → Pipelines
- trouver de l’aide sur les forums de Framasoft
- si tout fonctionne en local mais échoue lors de la mise en ligne, regardez du côté des notes de version de Hugo si des changements importants ont eu lieu entre votre version locale et celle que vous avez défini pour Framagit (dans le fichier
.gitlab-ci.yml
).
Si vous en avez les moyens, pensez à leur faire un don
Références
- https://docs.framasoft.org/fr/gitlab/gitlab-pages.html
- https://framablog.org/2017/03/20/les-gitlab-pages-debarquent-dans-framagit/
- Comprendre les Pages Gitlab https://about.gitlab.com/direction/release/pages (en anglais)