Modèle personnalisé¶

Il est possible d'inclure votre propre contenu header or footer dans Gogs sans toucher au code source original. Ceci est utile pour ajouter du code "analytics" ou pour inclure du contenu statique personnalisé.

Pour en savoir plus consultez : inject custom head and footer.

Inclure un fichier CSS personnalisé¶

Voici un example pour inclure un fichier CSS personnalisé dans votre instance Gogs. Les noms et répertoires sont arbitraires, ils peuvent être modifiés à votre guise, l'unique restriction étant qu'ils soient accesible par une requête.

Créez un fichier nommé custom.css dans le répertoire public/css.
Placez des règles CSS dans ce fichier.
Editez le fichier custom/templates/inject/head.tmpl et ajoutez une ligne <link rel="stylesheet" href="/css/custom.css">
Redémarrer Gogs
Ajoutez plus de contenu CSS dans le fichier ne nécessite pas de redémarrer Gogs

Webhook¶

Gogs supporte les webhook pour les évènements de dépôt, vous pouvez le trouver dans la page des paramètres(/:username/:reponame/settings/hooks). Tous les évènements 'pushes' sont des requêtes POST, et nous soutenons actuellement trois formats: Gogs, Slack et Discord.

Paramètres¶

Payload URL est l'adresse qui reçoit les informations en cas de 'push'.
Secret aide à identifier votre serveur.
Active indique si le hook est activé ou non.

Information sur les événements¶

Ci-dessous un exemple d'informations sur l'évènement qui sera envoyé par Gogs à l'URL de destination :

X-Gogs-Delivery: f6266f16-1bf3-46a5-9ea4-602e06ead473
X-Gogs-Event: push
X-Gogs-Signature: 1921679ed6274399b6514721056337f6913b6ff1cb35a24d340e983745d637f1

{
  "ref": "refs/heads/develop",
  "before": "28e1879d029cb852e4844d9c718537df08844e03",
  "after": "bffeb74224043ba2feb48d137756c8a9331c449a",
  "compare_url": "http://localhost:3000/unknwon/webhooks/compare/28e1879d029cb852e4844d9c718537df08844e03...bffeb74224043ba2feb48d137756c8a9331c449a",
  "commits": [
    {
      "id": "bffeb74224043ba2feb48d137756c8a9331c449a",
      "message": "!@#0^%\u003e\u003e\u003e\u003e\u003c\u003c\u003c\u003c\u003e\u003e\u003e\u003e\n",
      "url": "http://localhost:3000/unknwon/webhooks/commit/bffeb74224043ba2feb48d137756c8a9331c449a",
      "author": {
        "name": "Unknwon",
        "email": "[email protected]",
        "username": "unknwon"
      },
      "committer": {
        "name": "Unknwon",
        "email": "[email protected]",
        "username": "unknwon"
      },
      "timestamp": "2017-03-13T13:52:11-04:00"
    }
  ],
  "repository": {
    "id": 140,
    "owner": {
      "id": 1,
      "login": "unknwon",
      "full_name": "Unknwon",
      "email": "[email protected]",
      "avatar_url": "https://secure.gravatar.com/avatar/d8b2871cdac01b57bbda23716cc03b96",
      "username": "unknwon"
    },
    "name": "webhooks",
    "full_name": "unknwon/webhooks",
    "description": "",
    "private": false,
    "fork": false,
    "html_url": "http://localhost:3000/unknwon/webhooks",
    "ssh_url": "ssh://unknwon@localhost:2222/unknwon/webhooks.git",
    "clone_url": "http://localhost:3000/unknwon/webhooks.git",
    "website": "",
    "stars_count": 0,
    "forks_count": 1,
    "watchers_count": 1,
    "open_issues_count": 7,
    "default_branch": "master",
    "created_at": "2017-02-26T04:29:06-05:00",
    "updated_at": "2017-03-13T13:51:58-04:00"
  },
  "pusher": {
    "id": 1,
    "login": "unknwon",
    "full_name": "Unknwon",
    "email": "[email protected]",
    "avatar_url": "https://secure.gravatar.com/avatar/d8b2871cdac01b57bbda23716cc03b96",
    "username": "unknwon"
  },
  "sender": {
    "id": 1,
    "login": "unknwon",
    "full_name": "Unknwon",
    "email": "[email protected]",
    "avatar_url": "https://secure.gravatar.com/avatar/d8b2871cdac01b57bbda23716cc03b96",
    "username": "unknwon"
  }
}

Traduisez Gogs¶

Depuis la version v0.5.0, Gogs prend en charge plusieurs langues et un clic suffit pour changer la langue de l'interface instantanément.

Pour les activer, allez dans le fichier custom/conf/app/ini:

[i18n]
LANGS = en-US,zh-CN,zh-HK,de-DE,fr-FR,nl-NL,lv-LV,ru-RU,ja-JP,es-ES,pt-BR,pl-PL,bg-BG,it-IT
NAMES = English,简体中文,繁體中文,Deutsch,Français,Nederlands,Latviešu,Русский,日本語,Español,Português do Brasil,Polski,български,Italiano

Contribuez à la traduction¶

Inscrivez-vous sur Crowdin et remplissez les chaînes non traduites.

Parfois, vous trouverez qu'il est assez difficile de traduire une phrase de l'anglais à votre langue, ne paniquez pas! Il n'est pas nécessaire de faire de la traduction mot-à-mot, il suffit de faire passer l'idée.

Pour pouvoir tester votre traduction sans modifier le dépôt Git, il faut placer votre fichier dans custom/conf/locale/<file> et redémarrer Gogs.

Faites une correction¶

Si vous avez trouvé des chaînes mal traduites, faites une recherche rapide de la clé sur Crowdin.

Par exemple, supposons qu'Accueil vous semble être une mauvaise traduction, ne recherchez pas Accueil mais la clef correspondante : home. De même, cherchez quelque chose comme home:uname_holder pour les clés prévues dans l'article.

Fichiers de traduction additionnels locaux¶

Si vous n'êtes pas satisfait de la traduction officielle, il est possible de la surcharger avec un autre fichier placé dans custom/conf/locale/locale_<lang>.ini. Il est nécessaire de redémarrer Gogs après.