22 lines
1.4 KiB
Markdown
22 lines
1.4 KiB
Markdown
|
# 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
|