French translation for docs (#3030)

original PR go-gitea/docs#147 and author @0xbaadf00d

10 files changed, 489 insertions, 0 deletions

diff --git a/docs/content/doc/advanced.fr-fr.md b/docs/content/doc/advanced.fr-fr.md
new file mode 100755
index 0000000000..04734a8f81
--- /dev/null
+++ b/docs/content/doc/advanced.fr-fr.md
@@ -0,0 +1,13 @@
+---
+date: "2017-08-23T09:00:00+02:00"
+title: "Avancé"
+slug: "advanced"
+weight: 30
+toc: false
+draft: false
+menu:
+  sidebar:
+    name: "Avancé"
+    weight: 40
+    identifier: "advanced"
+---
diff --git a/docs/content/doc/advanced/make.fr-fr.md b/docs/content/doc/advanced/make.fr-fr.md
new file mode 100755
index 0000000000..427a8fc68f
--- /dev/null
+++ b/docs/content/doc/advanced/make.fr-fr.md
@@ -0,0 +1,44 @@
+---
+date: "2017-08-23T09:00:00+02:00"
+title: "Make"
+slug: "make"
+weight: 10
+toc: true
+draft: false
+menu:
+  sidebar:
+    parent: "advanced"
+    name: "Make"
+    weight: 30
+    identifier: "make"
+---
+
+# Make
+
+Gitea fait largement usage de Make pour automatiser les tâches et avoir un développement plus rapide. Ce guide explique comment installer Make.
+
+### Linux
+
+Vous pouvez installer Make avec votre gestionnaire de paquetages 
+
+Depuis Ubuntu/Debian:
+
+```bash
+sudo apt-get install build-essential
+```
+
+Depuis Fedora/RHEL/CentOS:
+
+```bash
+sudo yum install make
+```
+
+### Windows
+
+Si vous utilisez Windows, vous pouvez télécharger une des versions suivantes de Make:
+
+- [Simple binaire](http://www.equation.com/servlet/equation.cmd?fa=make). Copiez le quelque part et mettez à jour `PATH`.
+  - [32-bits version](ftp://ftp.equation.com/make/32/make.exe)
+  - [64-bits version](ftp://ftp.equation.com/make/64/make.exe)
+- [MinGW](http://www.mingw.org/) includes a build. The binary is called `mingw32-make.exe` instead of `make.exe`. Add the `bin` folder to your `PATH`.
+- [Chocolatey package](https://chocolatey.org/packages/make). Run `choco install make`
diff --git a/docs/content/doc/installation.fr-fr.md b/docs/content/doc/installation.fr-fr.md
new file mode 100755
index 0000000000..55b48bda3e
--- /dev/null
+++ b/docs/content/doc/installation.fr-fr.md
@@ -0,0 +1,13 @@
+---
+date: "2017-08-23T09:00:00+02:00"
+title: "Installation"
+slug: "installation"
+weight: 10
+toc: false
+draft: false
+menu:
+  sidebar:
+    name: "Installation"
+    weight: 10
+    identifier: "installation"
+---
diff --git a/docs/content/doc/installation/from-binary.fr-fr.md b/docs/content/doc/installation/from-binary.fr-fr.md
new file mode 100755
index 0000000000..5aeea0ea4d
--- /dev/null
+++ b/docs/content/doc/installation/from-binary.fr-fr.md
@@ -0,0 +1,45 @@
+---
+date: "2017-08-23T09:00:00+02:00"
+title: "Installation avec le binaire pré-compilé"
+slug: "install-from-binary"
+weight: 10
+toc: true
+draft: false
+menu:
+  sidebar:
+    parent: "installation"
+    name: "Binaire pré-compilé"
+    weight: 20
+    identifier: "install-from-binary"
+---
+
+# Installation avec le binaire pré-compilé
+
+Tous les binaires sont livrés avec le support de SQLite, MySQL et PostgreSQL, et sont construits avec les ressources incorporées. Gardez à l'esprit que cela peut être différent pour les versions antérieures. L'installation basée sur nos binaires est assez simple, il suffit de choisir le fichier correspondant à votre plateforme à partir de la [page de téléchargement](https://dl.gitea.io/gitea). Copiez l'URL et remplacer l'URL dans les commandes suivantes par la nouvelle:
+
+```
+wget -O gitea https://dl.gitea.io/gitea/1.0.1/gitea-1.0.1-linux-amd64
+chmod +x gitea
+```
+
+## Test
+
+Après avoir suivi les étapes ci-dessus, vous aurez un binaire `gitea` dans votre répertoire de travail. En premier lieu, vous pouvez tester si le binaire fonctionne comme prévu et ensuite vous pouvez le copier vers la destination où vous souhaitez le stocker. Lorsque vous lancez Gitea manuellement à partir de votre CLI, vous pouvez toujours le tuer en appuyant sur `Ctrl + C`.
+
+```
+./gitea web
+```
+
+## Dépannage
+
+### Anciennes version de glibc
+
+Les anciennes distributions Linux (comme Debian 7 ou CentOS 6) peuvent ne pas être capable d'exécuter le binaire Gitea, résultant généralement une erreur du type ```./gitea: /lib/x86_64-linux-gnu/libc.so.6: version `GLIBC_2.14' not found (required by ./gitea)```. Cette erreur est due au driver SQLite que nous intégrons dans le binaire Gitea. Dans le futur, nous fournirons des binaires sans la dépendance pour la bibliothèque glibc. En attendant, vous pouvez mettre à jour votre distribution ou installer Gitea depuis le [code source]({{< relref "from-source.fr-fr.md" >}}).
+
+### Exécuter Gitea avec un autre port
+
+Si vous obtenez l'erreur `702 runWeb()] [E] Failed to start server: listen tcp 0.0.0.0:3000: bind: address already in use`, Gitea à besoin d'utiliser un autre port. Vous pouvez changer le port par défaut en utilisant `./gitea web -p $PORT`.
+
+## Il manque quelque chose ?
+
+Est-ce que nous avons oublié quelque chose sur cette page ? N'hésitez pas à nous contacter sur notre [serveur Discord](https://discord.gg/NsatcWJ), vous obtiendrez des réponses à toute vos questions assez rapidement.
diff --git a/docs/content/doc/installation/from-package.fr-fr.md b/docs/content/doc/installation/from-package.fr-fr.md
new file mode 100755
index 0000000000..4e8149236e
--- /dev/null
+++ b/docs/content/doc/installation/from-package.fr-fr.md
@@ -0,0 +1,57 @@
+---
+date: "2016-12-01T16:00:00+02:00"
+title: "Installation depuis le gestionnaire de paquets"
+slug: "install-from-package"
+weight: 10
+toc: true
+draft: false
+menu:
+  sidebar:
+    parent: "installation"
+    name: "Gestionnaire de paquets"
+    weight: 20
+    identifier: "install-from-package"
+---
+
+# Installation depuis le gestionnaire de paquets
+
+## Linux
+
+Nous n'avons pas encore publié de paquet pour Linux, nous allons mettre à jour cette page directement lorsque nous commencerons à publier des paquets pour toutes distributions Linux. En attendant, vous devriez suivre les [instructions d'installation]({{< relref "from-binary.fr-fr.md" >}}) avec le binaire pré-compilé.
+
+## Windows
+
+Nous n'avons pas encore publié de paquet pour Windows, nous allons mettre à jour cette page directement lorsque nous commencerons à publier des paquets sous la forme de fichiers `MSI` ou via [Chocolatey](https://chocolatey.org/). En attendant, vous devriez suivre les [instructions d'installation]({{< relref "from-binary.fr-fr.md" >}}) avec le binaire pré-compilé.
+
+## macOS
+
+Actuellement, nous ne supportons que l'installation via `brew` pour macOS. Si vous n'utilisez pas [Homebrew](http://brew.sh/), vous pouvez suivre les [instructions d'installation]({{< relref "from-binary.fr-fr.md" >}}) avec le binaire pré-compilé. Pour installer Gitea depuis `brew`, utilisez les commandes suivantes :
+
+```
+brew tap go-gitea/gitea
+brew install gitea
+```
+
+## FreeBSD
+
+Le portage FreeBSD `www/gitea` est disponible.  Vous pouvez également installer le paquet pré-compilé avec la commande suivante:
+
+```
+pkg install gitea
+```
+
+Pour une version plus récente, ou pour les instructions de compilations, veuillez consulter la documentation officielle de FreeBSD : [install it from the port](https://www.freebsd.org/doc/handbook/ports-using.html)
+
+```
+su -
+cd /usr/ports/www/gitea
+make install clean
+```
+
+Le port utilise la schéma standard du système de fichiers FreeBSD : Les fichiers de configuration sont localisés dans le répertoire `/usr/local/etc/gitea`, les modèles, options, plugins et thèmes sont localisés dans le répertoire `/usr/local/share/gitea`, et le script de démarrage se situe dans `/usr/local/etc/rc.d/gitea`.
+
+Pour exécuter Gitea en tant que service, utilisez la commande `sysrc gitea_enable=YES` et la commande `service gitea start` pour démarrer le service.
+
+## Il manque quelque chose ?
+
+Est-ce que nous avons oublié quelque chose sur cette page ? N'hésitez pas à nous contacter sur notre [serveur Discord](https://discord.gg/NsatcWJ), vous obtiendrez des réponses à toute vos questions assez rapidement.
diff --git a/docs/content/doc/installation/from-source.fr-fr.md b/docs/content/doc/installation/from-source.fr-fr.md
new file mode 100755
index 0000000000..7e4078484d
--- /dev/null
+++ b/docs/content/doc/installation/from-source.fr-fr.md
@@ -0,0 +1,80 @@
+---
+date: "2017-08-23T09:00:00+02:00"
+title: "Installation depuis le code source"
+slug: "install-from-source"
+weight: 10
+toc: true
+draft: false
+menu:
+  sidebar:
+    parent: "installation"
+    name: "Code source"
+    weight: 30
+    identifier: "install-from-source"
+---
+
+# Installation depuis le code source
+
+Nous ne couvrirons pas les bases de la configuration de Golang dans ce guide. Si vous ne savez pas comment démarrer un environnement fonctionnel, vous devrez suivre les [instructions d'installation](https://golang.org/doc/install) officielles.
+
+**Attention**: La version 1.7 ou suppérieur de Go est nécessaire
+
+## Téléchargement
+
+Tout d'abord, vous devez récupérer le code source, la manière la plus simple est d'utiliser directement Go. Il suffit d'appeler les commandes suivantes pour récupérer le code source et passer au répertoire de travail.
+
+```
+go get -d -u code.gitea.io/gitea
+cd $GOPATH/src/code.gitea.io/gitea
+```
+
+Maintenant, il est temps de décider quelle version de Gitea vous souhaitez compiler et installer. Actuellement, ils existent plusieurs options possibles. Si vous voulez compiler notre branche `master`, vous pouvez directement passer à la [section compilation](#compilation), cette branche représente la dernière version en cours de développement et n'a pas vocation à être utiliser en production.
+
+
+Si vous souhaitez compiler la dernière version stable, utilisez les étiquettes ou les différentes branches disponibles. Vous pouvez voir les branches disponibles et comment utiliser cette branche avec ces commandes:
+
+```
+git branch -a
+git checkout v1.0
+```
+
+Si vous souhaitez valider une demande d'ajout (_Pull request_), vous devez activer cette branche en premier : 
+
+```
+git fetch origin pull/xyz/head:pr-xyz  # xyz is PR value
+```
+
+Enfin, vous pouvez directement utiliser les versions étiquettées (ex : `v1.0.0`). Pour utiliser les étiquettes, vous devez lister les étiquettes disponibles et choisir une étiquette spécifique avec les commandes suivantes :
+
+```
+git tag -l
+git checkout v1.0.0
+git checkout pr-xyz
+```
+
+## Compilation
+
+Comme nous regroupons déjà toutes les bibliothèques requises pour compiler Gitea, vous pouvez continuer avec le processus de compilation lui-même. Nous fournissons diverses [tâches Make](https://github.com/go-gitea/gitea/blob/master/Makefile) pour rendre le processus de construction aussi simple que possible. <a href='{{< relref "doc/advanced/make.fr-fr.md" >}}'>Voyez ici comment obtenir Make</a>. Selon vos besoins, vous pourrez éventuellement ajouter diverses options de compilation, vous pouvez choisir entre ces options :
+
+* `bindata`: Intègre toutes les ressources nécessaires à l'exécution d'une instance de Gitea, ce qui rend un déploiement facile car il n'est pas nécessaire de se préoccuper des fichiers supplémentaires.
+* `sqlite`: Active la prise en charge d'une base de données [SQLite3](https://sqlite.org/), ceci n'est recommandé que pour les petites installations de Gitea.
+* `tidb`: Active la prise en charge d'une base de données [TiDB](https://github.com/pingcap/tidb), c'est une base de données simplet et basée sur des fichiers. Elle est comparable à SQLite.
+* `pam`: Active la prise en charge de PAM (mLinux Pluggable Authentication Modules), très utile si vos utilisateurs doivent être authentifiés avec les comptes du système.
+
+Il est temps de compiler le binaire, nous suggérons d'intégrer les ressources avec l'option de compilation `bindata`. Pour inclure les ressources, vous devrez également exécuter la tâche Make `generate`. Dans le cas échéant, les ressources ne pourront pas être intégrées:
+
+```
+TAGS="bindata" make generate build
+```
+
+## Test
+
+Après avoir suivi toutes les étapes, vous devriez avoir le binaire `gitea` dans votre répertoire courant. Dans un premier temps, vous pouvez tester qu'il fonctionne puis, dans un second temps, vous pouvez le copier dans la destination de votre choix. Lorsque vous lancez Gitea manuellement à partir de votre CLI, vous pouvez toujours le tuer en appuyant sur `Ctrl + C`. 
+
+```
+./gitea web
+```
+
+## Il manque quelque chose ?
+
+Est-ce que nous avons oublié quelque chose sur cette page ? N'hésitez pas à nous contacter sur notre [serveur Discord](https://discord.gg/NsatcWJ), vous obtiendrez des réponses à toute vos questions assez rapidement.
diff --git a/docs/content/doc/installation/windows-service.fr-fr.md b/docs/content/doc/installation/windows-service.fr-fr.md
new file mode 100755
index 0000000000..66cc5fc6dd
--- /dev/null
+++ b/docs/content/doc/installation/windows-service.fr-fr.md
@@ -0,0 +1,34 @@
+---
+date: "2017-08-23T09:00:00+02:00"
+title: "Démarrer en tant que service Windows"
+slug: "windows-service"
+weight: 10
+toc: true
+draft: false
+menu:
+  sidebar:
+    parent: "installation"
+    name: "Service Windows"
+    weight: 30
+    identifier: "windows-service"
+---
+
+# Activer un service Windows
+
+Pour activer le service Windows Gitea, ouvrez une `cmd` en tant qu'Administrateur puis utilisez la commande suivante :
+
+```
+sc create gitea start= auto binPath= ""C:\gitea\gitea.exe" web --config "C:\gitea\custom\conf\app.ini""
+```
+
+N'oubliez pas de remplacer `C:\gitea` par le chemin que vous avez utilisez pour votre installation.
+
+Ensuite, ouvrez "Services Windows", puis recherchez le service `gitea`, faites un clique droit et selectionnez "Run". Si tout fonctionne, vous devriez être capable d'accèder à Gitea à l'URL `http://localhost:3000` (ou sur le port configuré si différent de 3000).
+
+## Désactiver un service Windows
+
+Pour désactiver le service Windows Gitea, ouvrez une `cmd` en tant qu'Administrateur puis utilisez la commande suivante :
+
+```
+sc delete gitea
+```
diff --git a/docs/content/doc/installation/with-docker.fr-fr.md b/docs/content/doc/installation/with-docker.fr-fr.md
new file mode 100755
index 0000000000..2f3567ee62
--- /dev/null
+++ b/docs/content/doc/installation/with-docker.fr-fr.md
@@ -0,0 +1,110 @@
+---
+date: "2017-08-23T09:00:00+02:00"
+title: "Installation avec Docker"
+slug: "install-with-docker"
+weight: 10
+toc: true
+draft: false
+menu:
+  sidebar:
+    parent: "installation"
+    name: "Docker"
+    weight: 10
+    identifier: "install-with-docker"
+---
+
+# Installation avec Docker
+
+Nous fournissons des images Docker mises à jour automatiquement via le Docker Hub de notre organisation. C'est à vous, lors devotre déploiement, de vous assurez d'utiliser toujours la dernière version stable ou d'utiliser un autre service qui met à jour l'image Docker pour vous.
+
+## Données stockées sur l'hôte
+
+Tout d'abord, vous devez simplement récupérer l'image Docker avec la commande suivante :
+
+```
+docker pull gitea/gitea:latest
+```
+
+Pour garder vos dépôts et certaines autres données persistantes, vous devez créer un répertoire qui contiendra ces données à l'avenir.
+
+```
+sudo mkdir -p /var/lib/gitea
+```
+
+Il est temps de démarrer votre instance Docker, c'est un processus assez simple. Vous avez à définir le mappage des ports et le volume à utiliser pour la persistance de vos données :
+
+```
+docker run -d --name=gitea -p 10022:22 -p 10080:3000 -v /var/lib/gitea:/data gitea/gitea:latest
+```
+
+Vous devriez avoir une instance fonctionnelle de Gitea. Pour accèder à l'interface web, visitez l'adresse http://hostname:10080 avec votre navigateur web préféré. Si vous voulez clôner un dépôt, vous pouvez le faire avec la commande  `git clone ssh://git@hostname:10022/username/repo.git`.
+
+## Named Volumes 
+
+Ce guide aboutira à une installation avec les données Gita et PostgreSQL stockées dans des volumes nommés. Cela permet une sauvegarde, une restauration et des mises à niveau en toute simplicité.
+
+### The Database
+
+Création du volume nommé pour la base de données :
+
+```
+$ docker volume create --name gitea-db-data
+```
+
+Une fois votre volume pret, vous pouvez récupérer l'image Docker de PostgreSQL et créer une instance. Tout comme Gitea, c'est également une image Docker basée sur Alpine Linux, Le montage des données se fera sans aucun problème.
+
+```
+$ docker pull postgres:alpine
+$ docker run -d --name gitea-db \
+    -e POSTGRES_PASSWORD=<PASSWORD> \
+    -v gitea-db-data:/var/lib/postgresql/data \
+    -p 5432:5432 \
+    postgres:alpine
+```
+
+Maintenant que la base de données est démarrée, il faut la configurer. N'oubliez pas le mot de passe que vous avez choisi, vous en aurez besoin lors de l'installation de Gitea.
+
+```
+$ docker exec -it gitea-db psql -U postgres
+psql (9.6.1)
+Type "help" for help.
+
+postgres=# CREATE USER gitea WITH PASSWORD '<PASSWORD>';
+CREATE ROLE
+postgres=# CREATE DATABASE gitea OWNER gitea;
+CREATE DATABASE
+postgres=# \q
+$
+```
+
+### Gitea
+
+Premièrement, le volume nommé :
+
+```
+$ docker volume create --name gitea-data
+```
+
+Puis l'instance de Gitea :
+
+```
+$ docker run -d --name gitea \
+	--link gitea-db:gitea-db \
+	--dns 10.12.10.160 \
+	-p 11180:3000 \
+	-p 8322:22 \
+	-v gitea-data:/data \
+	gitea/gitea:latest
+```
+
+Vous devriez maintenant avoir deux conteneurs Docker pour Gitea et PostgreSQL plus deux volumes nommés Docker.
+
+# Personnalisation
+
+Les fichier personnalisés ([voir les instructions](https://docs.gitea.io/en-us/customizing-gitea/)) peuvent être placés dans le répertoire `/data/gitea`.
+
+Le fichier de configuration sera sauvegardé à l'emplacement suivant : `/data/gitea/conf/app.ini`
+
+## Il manque quelque chose ?
+
+Est-ce que nous avons oublié quelque chose sur cette page ? N'hésitez pas à nous contacter sur notre [serveur Discord](https://discord.gg/NsatcWJ), vous obtiendrez des réponses à toute vos questions assez rapidement.
diff --git a/docs/content/doc/upgrade.fr-fr.md b/docs/content/doc/upgrade.fr-fr.md
new file mode 100755
index 0000000000..ca08daf9c0
--- /dev/null
+++ b/docs/content/doc/upgrade.fr-fr.md
@@ -0,0 +1,13 @@
+---
+date: "2017-08-23T09:00:00+02:00"
+title: "Mise à jour"
+slug: "upgrade"
+weight: 10
+toc: false
+draft: false
+menu:
+  sidebar:
+    name: "Mise à jour"
+    weight: 20
+    identifier: "upgrade"
+---
diff --git a/docs/content/doc/upgrade/from-gogs.fr-fr.md b/docs/content/doc/upgrade/from-gogs.fr-fr.md
new file mode 100755
index 0000000000..aa7c7ae1d6
--- /dev/null
+++ b/docs/content/doc/upgrade/from-gogs.fr-fr.md
@@ -0,0 +1,80 @@
+---
+date: "2017-08-23T09:00:00+02:00"
+title: "Mise à jour depuis Gogs"
+slug: "upgrade-from-gogs"
+weight: 10
+toc: true
+draft: false
+menu:
+  sidebar:
+    parent: "upgrade"
+    name: "Depuis Gogs"
+    weight: 10
+    identifier: "upgrade-from-gogs"
+---
+
+# Mise à jour depuis Gogs
+
+À partir de la version 0.9.146 (schéma de la base de données : version 15) de Gogs, Il est possible de migrer vers Gitea simplement et sans encombre.
+
+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. 
+* 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`.
+* Si vous avez personnalisé les répertoires `templates, public` dans `gogs/custom/`, copiez-les vers `gitea/custom/`.
+* Si vous avez d'autres répertoires personnalisés comme `gitignore, label, license, locale, readme` dans `gogs/custom/conf` copiez-les vers `gitea/custom/options`.
+* Copiez le répertoire `gogs/data/` vers `gitea/data/`.
+* 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
+
+* 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
+```
+
+* Vérifiez votre installation en exécutant Gitea avec la commande `gitea web`.
+
+### 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)
+
+Distributions utilisant systemd:
+
+* Copiez le script mis à jour vers `/etc/systemd/system/gitea.service`
+* Ajoutez le service avec la commande `sudo systemctl enable gitea`
+* Désactivez Gogs avec la commande `sudo systemctl disable gogs`
+
+Distributions utilisant SysVinit:
+
+* Copiez le script mis à jour vers `/etc/init.d/gitea`
+* Ajoutez le service avec la commande `sudo rc-update add gitea`
+* Désactivez Gogs avec la commande `sudo rc-update del gogs`