# Utilisation

Pour commencer à publier, vous devez créer un dépot `pages` dans lequel vous y déposerez vos fichiers. Le contenu sera accessible via `https://votre-login.gitnet.page/{fichier}`.

Dans le cas où vous souhaitez intégrer des pages à un dépot existant, ajoutez une branche `pages` puis accédez à votre contenu via `https://votre-login.gitnet.page/le-depot/{fichier}` :

```bash
git switch --orphan pages
# Si vous avez des fichiers ignorés par git qui existent :
git rm --cached -r .
```

Et si vous désirez accéder à du contenu qui se trouve sur une autre branche, il faudra la spécifier de cette façon : `https://votre-login.gitnet.page/le-depot/@la-branche/{fichier}`.

Vous pouvez utiliser un générateur de site static mais il faudra ajouter un CI/CD. J'ai réalisé des tests avec [Hugo](https://gohugo.io/) + [Woordpecker](https://woodpecker-ci.org/) et ça marche bien ! On build la branche ou se trouve les sources, on copie le résultat dans la branche `pages` et on pousse le code sur [Gitnet]. Voici la [configuration utilisée](https://gitnet.fr/deblan/pages-ci/src/branch/master/.woodpecker.yml).  

Si toutefois le service venait à être pas mal utilisé, alors j'intégrerai des fonctionnalités plus avancées comme le nom de domaine personnalité. Tel qu'il est déployé actuellement, ce n'est pas possible. 

[Gitnet]: https://gitnet.fr
[Gitea]: https://gitea.io/
[Codeberg/pages-server]: https://codeberg.org/Codeberg/pages-server