====== Gitea - plateforme de gestion de code ======

Installation classique de l'application dans le domaine code.viregul.fr

Dans l'application, création d'une organisation "Viregul'

Les dossiers de contenu sont stockés dans /home/yunohost.app/gitea : data et repository

===== Configuration =====

La personnalisation se fait dans ''/opt/gitea/custom/conf/app.ini'' comme le service d'envoi de mail :
<code>
[mailer]
ENABLED        = true
MAILER_TYPE    = smtp
HOST           = smtp.ouvaton.coop:465
USER           = envoismtp@viregul.fr
PASSWD         = `xxxx`
FROM           = "Code VireGul <code@viregul.fr>"

</code>

===== Personnalisation =====

Création de dossiers custom ([[https://www.thedroneely.com/posts/lets-customize-gitea/|sources]])
<code>

mkdir -p /opt/gitea/custom/public/img /opt/gitea/custom/templates/base

</code>

Création du template de base depuis le [[https://github.com/go-gitea/gitea/tree/master/templates/base|dépot original des templates]] à copier dans templates/base comme le fichier head_navbar.tmpl

Le modifier : changer l'icone de base et cacher le lien de l'aide :
<code>

<img class="ui mini image" src="{{AssetUrlPrefix}}/img/code.png">

<!-- <a class="item" target="_blank" rel="noopener noreferrer" href="https://docs.gitea.io">{{.i18n.Tr "help"}}</a> -->

</code>

Ajout d'une image personnalisée ''code.png'' dans : ''/opt/gitea/custom public/img/''

Relancer le service gitea

<code>
systemctl restart gitea

</code>

===== Procédure de mise à jour =====

  * sauvegarder ''/opt/gitea/custom''
  * Mettre à jour
  * Vérifier les différences entre ''/opt/gitea/custom/conf/app.ini''  et le fichier sauvegardé
  * Redémarrer le service.

Lors d'une mise à jour, gitea n'a pas redémarré à cause d'un problème de largeur de colonne dans la base de données ([[https://framagit.org/YunoHost-Apps/gitea_ynh/-/issues/37|bug]])

Correctif lié au patch :
<code>

sudo su
su gitea
cd /opt/gitea/
./gitea convert

</code>