From b63e2e0ded42b78429a80e2f39b325700c93cd24 Mon Sep 17 00:00:00 2001 From: Deoren Moor Date: Sat, 25 Aug 2018 01:47:47 -0500 Subject: [PATCH] Update en-us and fr-fr versions of the "Upgrade from Gogs" doc (#4618) * Update "Upgrade from Gogs" en-us doc - Move "Change gogs specific information" FROM/TO steps up to just beneath matching section header, adjust indention and explicitly specify syntax of code sample to provide highlighting - Adjust header levels to match what appears to be the intended level, remove trailing decoration (see below) - Move "Upgrading to most recent ..." section down, remove decoration (section header formatting likely covers this well enough already) refs go-gitea/gitea#4286, go-gitea/gitea#3558 * Update "Upgrade from Gogs" fr-fr doc - Adjust indention and explicitly specify syntax of code sample to provide highlighting - Adjust header levels to match what appears to be the intended level, remove trailing decoration since section header formatting likely covers this well enough already refs go-gitea/gitea#4286, go-gitea/gitea#3558 --- docs/content/doc/upgrade/from-gogs.en-us.md | 63 +++++++++++---------- docs/content/doc/upgrade/from-gogs.fr-fr.md | 56 +++++++++--------- 2 files changed, 62 insertions(+), 57 deletions(-) diff --git a/docs/content/doc/upgrade/from-gogs.en-us.md b/docs/content/doc/upgrade/from-gogs.en-us.md index 4e16b3b78..41131777a 100644 --- a/docs/content/doc/upgrade/from-gogs.en-us.md +++ b/docs/content/doc/upgrade/from-gogs.en-us.md @@ -33,50 +33,53 @@ There are some basic steps to follow. On a Linux system run as the Gogs user: * Enter Gitea admin panel on the UI, run `Rewrite '.ssh/authorized_keys' file`. * If custom or config path was changed, run `Rewrite all update hook of repositories`. -### Change gogs specific information: +## Change gogs specific information * Rename `gogs-repositories/` to `gitea-repositories/` * Rename `gogs-data/` to `gitea-data/` * In `gitea/custom/conf/app.ini` change: -### Upgrading to most recent `gitea` version: + FROM: + + ```ini + [database] + PATH = /home/:USER/gogs/data/:DATABASE.db + [attachment] + PATH = /home/:USER/gogs-data/attachments + [picture] + AVATAR_UPLOAD_PATH = /home/:USER/gogs-data/avatars + [log] + ROOT_PATH = /home/:USER/gogs/log + ``` + + TO: + + ```ini + [database] + PATH = /home/:USER/gitea/data/:DATABASE.db + [attachment] + PATH = /home/:USER/gitea-data/attachments + [picture] + AVATAR_UPLOAD_PATH = /home/:USER/gitea-data/avatars + [log] + ROOT_PATH = /home/:USER/gitea/log + ``` + +* Verify by starting Gitea with `gitea web` + +## Upgrading to most recent `gitea` version + After successful migration from `gogs` to `gitea 1.0.x` it is possible to upgrade to the recent `gitea` version. Simply download the file matching the destination platform from the [downloads page](https://dl.gitea.io/gitea) and replace the binary. -FROM: -``` -[database] -PATH = /home/:USER/gogs/data/:DATABASE.db -[attachment] -PATH = /home/:USER/gogs-data/attachments -[picture] -AVATAR_UPLOAD_PATH = /home/:USER/gogs-data/avatars -[log] -ROOT_PATH = /home/:USER/gogs/log -``` - -TO: -``` -[database] -PATH = /home/:USER/gitea/data/:DATABASE.db -[attachment] -PATH = /home/:USER/gitea-data/attachments -[picture] -AVATAR_UPLOAD_PATH = /home/:USER/gitea-data/avatars -[log] -ROOT_PATH = /home/:USER/gitea/log -``` - -* Verify by starting Gitea with `gitea web` - -### Troubleshooting +## Troubleshooting * If errors are encountered relating to custom templates in the `gitea/custom/templates` folder, try moving the templates causing the errors away one by one. They may not be compatible with Gitea or an update. -### Add Gitea to startup on Unix +## Add Gitea to startup on Unix Update the appropriate file from [gitea/contrib](https://github.com/go-gitea/gitea/tree/master/contrib) with the right environment variables. diff --git a/docs/content/doc/upgrade/from-gogs.fr-fr.md b/docs/content/doc/upgrade/from-gogs.fr-fr.md index aa7c7ae1d..65a2375f4 100644 --- a/docs/content/doc/upgrade/from-gogs.fr-fr.md +++ b/docs/content/doc/upgrade/from-gogs.fr-fr.md @@ -19,7 +19,7 @@ menu: Veuillez suivre les étapes ci-dessous. Sur Unix, toute les commandes s'exécutent en tant que l'utilisateur utilisé pour votre installation de Gogs : -* Crééer une sauvegarde de Gogs avec la commande `gogs dump`. Le fichier nouvellement créé `gogs-dump-[timestamp].zip` contient toutes les données de votre instance de Gogs. +* Crééer une sauvegarde de Gogs avec la commande `gogs dump`. Le fichier nouvellement créé `gogs-dump-[timestamp].zip` contient toutes les données de votre instance de Gogs. * Téléchargez le fichier correspondant à votre plateforme à partir de la [page de téléchargements](https://dl.gitea.io/gitea). * Mettez la binaire dans le répertoire d'installation souhaité. * Copiez le fichier `gogs/custom/conf/app.ini` vers `gitea/custom/conf/app.ini`. @@ -29,43 +29,45 @@ Veuillez suivre les étapes ci-dessous. Sur Unix, toute les commandes s'exécute * Vérifiez votre installation en exécutant Gitea avec la commande `gitea web`. * Connectez vous au panel d'administration de Gitea et exécutez l'action `Rewrite '.ssh/authorized_keys' file`, puis l'action `Rewrite all update hook of repositories` (obligatoire si le chemin menant à votre configuration personnalisée à changé). -### Modifier les informations spécifiques de gogs +## Modifier les informations spécifiques de gogs * Renommez `gogs-repositories/` vers `gitea-repositories/` * Renommez `gogs-data/` to `gitea-data/` * Dans votre fichier `gitea/custom/conf/app.ini`, modifiez les éléments suivants: -DE : -``` -[database] -PATH = /home/:USER/gogs/data/:DATABASE.db -[attachment] -PATH = /home/:USER/gogs-data/attachments -[picture] -AVATAR_UPLOAD_PATH = /home/:USER/gogs-data/avatars -[log] -ROOT_PATH = /home/:USER/gogs/log -``` - -VERS : -``` -[database] -PATH = /home/:USER/gitea/data/:DATABASE.db -[attachment] -PATH = /home/:USER/gitea-data/attachments -[picture] -AVATAR_UPLOAD_PATH = /home/:USER/gitea-data/avatars -[log] -ROOT_PATH = /home/:USER/gitea/log -``` + DE : + + ```ini + [database] + PATH = /home/:USER/gogs/data/:DATABASE.db + [attachment] + PATH = /home/:USER/gogs-data/attachments + [picture] + AVATAR_UPLOAD_PATH = /home/:USER/gogs-data/avatars + [log] + ROOT_PATH = /home/:USER/gogs/log + ``` + + VERS : + + ```ini + [database] + PATH = /home/:USER/gitea/data/:DATABASE.db + [attachment] + PATH = /home/:USER/gitea-data/attachments + [picture] + AVATAR_UPLOAD_PATH = /home/:USER/gitea-data/avatars + [log] + ROOT_PATH = /home/:USER/gitea/log + ``` * Vérifiez votre installation en exécutant Gitea avec la commande `gitea web`. -### Dépannage +## Dépannage * Si vous rencontrez des erreurs relatives à des modèles personnalisés dans le dossier `gitea/custom/templates`, essayez de déplacer un par un les modèles provoquant les erreurs. Il est possible qu'ils ne soient pas compatibles avec Gitea. -### Démarrer automatiquement Gitea (Unix) +## Démarrer automatiquement Gitea (Unix) Distributions utilisant systemd: