diff --git a/docs/communication/websites/export.md b/docs/communication/websites/export.md index 5f0b61974f450f1637bce05eed426f9bb89897a1..cc7ae153d1e604a0f81dcefecbb9a923e0f2a73b 100644 --- a/docs/communication/websites/export.md +++ b/docs/communication/websites/export.md @@ -15,6 +15,25 @@ Les fichiers renommés doivent être déplacés sur git. Les fichiers supprimés ou dépubliés doivent être supprimés sur git. Il faut veiller à limiter le nombre de commits et à éviter les commits vides. +## Setup + +### GitHub + +- Créer un repository à partir du template suivant : https://github.com/noesya/osuny-hugo-template +- Une fois le repository créé, générer un personal access token ici : https://github.com/settings/tokens + - Permission à accorder : `repo` + - Durée : pour une bonne sécurité, il n'est pas recommandé de créer un token permanent, notez simplement qu'il faut le régénérer réguilièrement. +- Copier le personnal access token +- Dans le back-office d'Osuny, créer ou modifier un website et renseignez les 2 champs relatifs à Git : + - Repository : `username/repo` + - Access token : `ghp_xxxxxxxxxxxxxxxxxxxx` + +### Déploiement (Netlify) + +La récupération du thème se fait via SSH par défaut. Pour que le déploiement fonctionne correctement, vous pouvez changer le remote du submodule pour qu'il utilise HTTPS. + +Sinon il faut ajouter la deploy key du site Netlify (récupérable dans "Site settings", "Build & deploy" puis "Deploy key") dans la section "Deploy keys" du repository contenant le thème (ici : https://github.com/noesya/osuny-hugo-theme/settings/keys). + ## Architecture Les git::providers permettent de dialoguer avec les services comme Github et Gitlab.