Il suffit normalement d'éditer les fichiers sous `content/`, commit et push.
L'intégration continue de Gitlab intervient automatiquement pour convertir les pages rédigées en Markdown (fichiers `*.md`) et mettre à jour les fichiers visibles depuis le portail.
Il suffit d'éditer les fichiers sous `content/`, commit et push.
Il n'y a rien d'autre à faire : l'intégration continue de Gitlab intervient automatiquement après chaque push, convertit les pages rédigées en Markdown (fichiers `*.md`), et publie la nouvelle version.
### En local
## Comment ça marche
Invoquez `make build` ou simplement `make`
La procédure de conversion et publication est dans le `Makefile`; `make help` en documente les cibles principales.
La publication consiste à committer le contenu du répertoire `output/` dans la branche dédiée `public` qui est disjointe de `main` (pas de commit ancêtre commun, hiérarchie différente).
Il n'y a aucune raison de travailler directement sur `public`.
Le résultat est produit dans le répertoire `output/`.
La conversion nécessite `pandoc`.
### Conversion en local
Utile pour par exemple contrôler le balisage HTML généré. Nécessite l'installation de [`pandoc`](https://pandoc.org).
Invoquez `make build`, ou juste `make`; le résultat est produit dans le répertoire `output/`.
### Publication _à la main_
Invoquez `make publish`
**Attention :** toute version publiée manuellement, ou toute sera écrasée par l'intégration continue au commit+push suivant, donc au mieux c'est redondant.
**Attention :** vous allez probablement publier une version ne correspondant pas à un commit, et qui sera écrasée par l'intégration continue quand vous committerez.
Invoquez `make publish`; c'est ce que fait l'intégration continue (fichier `.gitlab-ci.yml`).
### Publier
## Maintenance du portail
-[fonctionnement du portail](https://www.fil.univ-lille.fr/portail/index.php?dipl=PRIVE&label=Documents) et [contacts](https://www.fil.univ-lille.fr/portail/index.php?dipl=PRIVE&label=Gestion)
