Différences

Ci-dessous, les différences entre deux révisions de la page.

--- doc:forgejo [2024/06/19 16:49] – ↷ Nom de la page changé de doc:gitlab à doc:forgejo Zatalyz
+++ doc:forgejo [2024/06/19 18:47] (Version actuelle) – [Upgrade] Niveaux de titres... Zatalyz
@@ Ligne 1: / Ligne 1: @@
 ====== Forgejo - Port ======
-<WRAP center round todo 60%>
-Migration de gitlab à Forgejo ; https://port.numenaute.org est actuellement sur gitlab, https://git.numenaute.org sur Forgejo.
-</WRAP>
 Le service https://port.numenaute.org est une forge logicielle((L'adresse https://git.numenaute.org redirige automatiquement sur ce service.)).
@@ Ligne 9: / Ligne 6: @@
 Le logiciel est basé sur Forgejo ; vous trouverez la documentation officielle (en anglais) sur [[https://forgejo.org/]].
+<WRAP center round info 60%>
+Nous avons précédement eu une forge basée sur Gitlab, dont les dépôts ont été transférés sur Forgejo (migration finie le 19/06/2024). Si certains liens sont cassés ou si vous ne retrouvez pas un dépôt, signalez-le nous.
+</WRAP>
 ===== Conditions d'utilisation du service =====
@@ Ligne 29: / Ligne 31: @@
 </WRAP>
-===== Transférer un dépôt depuis Gitlab =====
+===== Pour les utilisateurs avancés =====
+==== Transférer un dépôt depuis Gitlab ====
 Aller sur le menu "+" (en haut à droite à côté de votre avatar), sélectionner "Nouvelle migration", choisissez Gitlab.
@@ Ligne 35: / Ligne 40: @@
 Pour le reste, ça devrait aller tout seul, Forgejo pointe la doc de Gitlab sur comment se créer un jeton d'accès, y'a des options de dev qui devraient vous parler... Et voilà, ça devrait être migré !
+===== Pour les administrateurs de Numenaute =====
+==== Installation ====
+Notes un peu en vrac, ça suffira pour retrouver le fil conducteur.
-===== Pour les utilisateurs avancés =====
+Dépendances :
-<WRAP center round todo 60%>
+  sudo apt install git git-lfs gpg
-Les trucs un peu compliqués que permet le logiciel, ou qui sont accessibles avec des droits précis.
-</WRAP>
-===== Pour les administrateurs de Numenaute =====
+Ajout de l'user:
-<WRAP center round todo 60%>
+  sudo adduser --system --shell /bin/bash --gecos 'Git Version Control' \
-Infos pour gérer un service similaire.
+  --group --disabled-password --home /home/git  git
-</WRAP>
+Puis installer le binaire en suivant ce tutoriel : [[https://forgejo.org/download/]].
+  sudo adduser --system --shell /bin/bash --gecos 'Git Version Control' \
+  --group --disabled-password --home /home/git  git
+Créations des dossiers
+  sudo mkdir /var/lib/forgejo
+  sudo chown git:git /var/lib/forgejo && sudo chmod 750 /var/lib/forgejo
+Dossiers custom:
+  sudo -u git mkdir /var/lib/forgejo/custom
+  sudo -u git mkdir /var/lib/forgejo/custom/public
+  sudo -u git mkdir /var/lib/forgejo/custom/public/assets
+  sudo -u git mkdir /var/lib/forgejo/custom/public/assets/img
+==== Personnalisation ====
+Le fichier de configuration est ''/etc/forgejo/app.ini''. Une fois modifié, redémarrer le service : ''service forgejo restart''.
+=== Thème et pages personnalisées ===
+Documentation officielle :
+  * https://forgejo.org/docs/latest/developer/customization/ (partie dev)
+  * https://forgejo.org/docs/latest/admin/customization/ (partie sysadmin, donc a priori plutôt mon truc ?)
+Les fichiers sont à mettre dans ''/var/lib/forgejo/custom/'' dans notre installation. Pour être pris en compte, il faut redémarrer le service : ''sudo service forgejo restart''.
+À l'intérieur de ce dossier "custom" plusieurs possibilités :
+  * ''public'' : ce qui est directement accessible (genre les images, dans ''public/assets/img/'')
+  * ''template'' : ce qui sert à construire les pages
+Les fichiers de template sont dans https://codeberg.org/forgejo/forgejo/src/branch/forgejo/templates/ ; mais là pour "construire" une autre homepage... bon courage. Modifier home.tmpl et ensuite le mettre dans ''$FORGEJO_CUSTOM/templates''.
+== Ajout d'éléments dans le pied de page, les onglets, etc ==
+Source : https://forgejo.org/docs/latest/developer/customization/#adding-links-and-tabs
+Pour par exemple ajouter un lien vers les mentions légales, j'ai créé le fichier ''/var/lib/forgejo/custom/templates/custom/extra_links_footer.tmpl'' dans lequel j'ai ajouté une balise html :
+<code><a class="item" href="https://numenaute.org/asso:mentions_legales">Mentions Légales</a></code>
+Pour trouver les bonnes balises html, le plus simple est sans doute d'inspecter la page. On peut aussi regarder les pages initiales, [[https://codeberg.org/forgejo/forgejo/src/branch/forgejo/templates/repo/header.tmpl|par exemple ici]] pour la partie header.
+== CSS et thèmes ==
+Les thèmes officiels de Forgejo sont [[https://codeberg.org/forgejo/forgejo/src/branch/forgejo/web_src/css/themes|ici]]. En théorie si on crée un fichier ''numenaute.css'' dans ''/var/lib/forgejo/custom/web_src/css/themes'', il y a une chance que ça apparaisse (mais peut-être qu'il faudra le déclarer ailleurs). Mais attention, en vrai y'a des appels d'appels de fichiers et... pfiou. Une inspection dans les pages web, on note la couleur, un coup de grep dans la partie css et ça va le faire ;)
+Il faut par contre ensuite déclarer la liste des thèmes possibles dans ''/etc/forgejo/app.ini'' et dire quel thème on veut par défaut. Je n'ai pas fait dans la dentelle, j'ai permis de sélectionner les divers thèmes liés à l'accessibilité, et les trois modifs de numenaute (juste les couleurs, donc, dans ''/var/lib/forgejo/custom/web_src/css/themestheme-numenaute-light.css'' etc).
+<code ini /etc/forgejo/app.ini>[ui]
+DEFAULT_THEME: numenaute-auto
+THEMES = forgejo-auto,forgejo-auto-deuteranopia-protanopia,forgejo-auto-tritanopia,forgejo-dark,forgejo-dark-deuteranopia-protanopia,forgejo-dark-tritanopia,forgejo-light,forgejo-light-deuteranopia-protanopia,forgejo-light-tritanopia,gitea-auto,gitea-dark,gitea-light,numenaute-auto,numenaute-dark,numenaute-light
+</code>
+== Textes et traduction ==
+Faudra bidouiller https://codeberg.org/forgejo/forgejo/src/branch/forgejo/options/locale/locale_fr-FR.ini ; y'a une section [startpage]. Et en toute logique mettre les ajouts dans ''/var/lib/forgejo/custom/options/locale/locale_fr-FR.ini''.
+Souci : il n'est pas possible de seulement ajouter ses modifs. Il faut copier tout le fichier et ajouter des modifications dedans...
+Donc pour le moment j'ai changé la page "home" en mettant directement le français, et seulement ça. C'est pas extra mais ça évite de pourrir toutes les traductions.
+== Modification de la page d'accueil ==
+J'ai créé ''/var/lib/forgejo/custom/templates/home.tmpl'' qui reprends en gros [[https://codeberg.org/forgejo/forgejo/src/branch/forgejo/templates/home.tmpl|l'équivalent par défaut]].
+==== Upgrade ====
+Vérifier s'il y a les fichiers de configuration à changer avant tout.
+=== Upgrade simple ===
+  wget https://codeberg.org/forgejo/forgejo/releases/download/v1.*.*-*/forgejo-1*.*-*-linux-amd64
+  chmod +x forgejo-1.*.*-*-linux-amd64
+  sudo service forgejo stop
+  sudo cp forgejo-1.*.*-*-linux-amd64 /usr/local/bin/forgejo
+  sudo chmod 755 /usr/local/bin/forgejo
+  sudo service forgejo start
+=== Upgrade complexe ===
+page à check : https://forgejo.org/docs/latest/admin/upgrade/
 {{tag>Brouillon Documentation}}