deblan.io-gemini/blog/posts/624.gmi
2022-08-18 13:36:51 +02:00

46 lines
2.5 KiB
Plaintext

# Gitnet héberge vos pages statiques
* 2022-07-31 21:50:00
* Informatique
**
=> https://gitnet.fr Gitnet
est la forge logicielle que je gère depuis quelques années et qui héberge la totalité de mes projets**. Elle s'appuie sur l'excellentissime **
=> https://gitea.io/ Gitea
, un logiciel libre pour faire son propre Github/Gitlab** sans dépenser des fortunes en ressources matérielles.
=> https://gitea.io/ Gitea
est un logiciel très complet mais une des fonctionnalités qui peut manquer à certain⋅e⋅s est **la publication pages web statiques** via la forge.
=> https://codeberg.org/ Codeberg
a développé
=> https://codeberg.org/Codeberg/pages-server Codeberg/pages-server
, un projet écrit en GO qui permet de réaliser cette fonctionnalité. Il lance un serveur web et sert les fichiers qui sont récupérés via l'API. Après l'avoir forké pour le personnalisé, il est à présent déployé sur
=> https://gitnet.page Gitnet Pages
.
Pour commencer à publier, vous devez créer un dépot `pages` dans lequel vous déposerez y 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}` :
```{class="language-shell-session window"}
dev@project $ git switch --orphan pages
# Si vous avez des fichiers ignorés par git qui existent :
dev@project $ 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
=> https://gohugo.io/ Hugo
+
=> https://woodpecker-ci.org/ Woordpecker
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
=> https://gitnet.fr Gitnet
. Voici la
=> https://gitnet.fr/deblan/pages-ci/src/branch/master/.woodpecker.yml configuration utilisée
.
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.
=> /uploads/content/624/screenshot-20220803-161712.jpg Gitnet Pages [IMG]