Héberger un site Hugo gratuitement sur Frama.io

Vous avez installé Hugo en local et vous êtes prêt·e à 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:

Framagit, intro

Autorisez les Gitlab Pages à accéder au compte :

Framagit, authorize Gitlab

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:

Framagit référence du 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

Cette section a été mise à jour !

Consultez la page suivante pour utiliser la dernière version de Hugo

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).

L'association Framasoft ne fonctionne que grâce à nos dons.

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)