Merge pull-request #1261

12 files changed, 363 insertions, 0 deletions

diff --git a/doc/fr/analytics-tasks.markdown b/doc/fr/analytics-tasks.markdown
new file mode 100644
index 00000000..bef7377b
--- /dev/null
+++ b/doc/fr/analytics-tasks.markdown
@@ -0,0 +1,24 @@
+Analytique des tâches
+===================
+
+Chaque tâche possède une section analytique accessible à partir du menu à gauche dans la page des tâches
+
+Lead et cycle time
+-------------------
+
+![Lead and cycle time](http://kanboard.net/screenshots/documentation/task-lead-cycle-time.png)
+
+- Le lead time est la durée entre la création de la tâche et son achèvement (tâche fermée).
+- Le cycle time est la durée entre la date de début et l'achèvement.
+- Si la tâche n’est pas fermée, l’heure courante est utilisée à la place de la date d'achèvement.
+- Si la date de départ n\'est pas spécifiée, le cycle time n'est pas calculé.
+
+Remarque : vous pouvez configurer une action pour définir automatiquement que la date de départ sera le moment ou vous déplacez une tâche vers une colonne de votre choix
+
+Temps passé dans chaque colonne
+---------------------------
+
+![Temps passé dans chaque colonne](http://kanboard.net/screenshots/documentation/time-into-each-column.png)
+
+- Ce graphique montre le temps total passé dans chaque colonne pour la tâche
+- Le temps passé est calculé jusqu’à ce que la tâche soit fermée
diff --git a/doc/fr/closing-tasks.markdown b/doc/fr/closing-tasks.markdown
new file mode 100644
index 00000000..f0dee122
--- /dev/null
+++ b/doc/fr/closing-tasks.markdown
@@ -0,0 +1,16 @@
+Fermer des tâches
+=============
+
+Quand une tâche est fermée, elle n'est plus visible sur le tableau.
+
+Toutefois, vous pouvez toujours accéder à la liste des tâches closes en utilisant la requête **status:closed** dans un formulaire de recherche, ou bien choisissez simplement **Tâches fermées** dans le menu déroulant des filtres.
+
+Il existe deux façons différentes de fermer une tâche, depuis le menu déroulant des tâches sur le tableau :
+
+![Fermer une tâche par le menu déroulant](http://kanboard.net/screenshots/documentation/menu-close-task.png)
+
+…ou bien depuis la barre latérale dans la vue détaillée des tâches
+
+![Fermer une tâche](http://kanboard.net/screenshots/documentation/closing-tasks.png)
+
+Remarque : quand vous fermez une tâche, toutes les sous-tâches qui ne sont pas achevées verront leur statut passer à "Terminé".
diff --git a/doc/fr/create-tasks-by-email.markdown b/doc/fr/create-tasks-by-email.markdown
new file mode 100644
index 00000000..893c6df4
--- /dev/null
+++ b/doc/fr/create-tasks-by-email.markdown
@@ -0,0 +1,45 @@
+Créer des tâches par email
+=====================
+
+Vous pouvez créer des tâches directement en envoyant un message.
+
+Pour le moment, Kanboard fonctionne avec 3 services externes :
+
+- [Mailgun](http://kanboard.net/documentation/mailgun)
+- [Sendgrid](http://kanboard.net/documentation/sendgrid)
+- [Postmark](http://kanboard.net/documentation/postmark)
+
+Ces services gèrent le courrier entrant sans qu'on ait à configurer un serveur SMTP.
+
+À la réception d'un email par l'un de ces services, le message qu'il contenait est transmis et traité automatiquement par Kanboard.
+Toutes les opérations complexes sont prises en charge par ces services.
+
+Processus de réception du courrier entrant
+------------------------
+
+1. Vous envoyez un mail à une adresse spécifique, par exemple **quelquechose+monprojet@inbound.mondomaine.tld**
+2. Votre mail est envoyé sur les serveurs tiers SMTP
+3. Le fournisseur de SMTP appelle Kanboard via un webhook avec le mail en JSON ou aux formats multipart/form-data
+4. Kanboard analyse le mail reçu et crée la tâche dans le bon projet
+
+Remarque : les nouvelles tâches sont automatiquement créées dans la première colonne.
+
+Format du mail
+------------
+
+- La partie locale de l'adresse mail doit utiliser le signe + comme séparateur, par exemple **kanboard+projet123**
+- La chaîne de caractères définie après le signe + doit correspondre à l'identifiant d'un projet, par exemple **projet123** est l'identifiant du projet **Projet 123**
+- le sujet de l'email devient le titre de la tâche
+- Le corps du message devient la description de la tâche (au format Markdown)
+
+Les courriers entrants peuvent être écrits aux formats .txt ou .HTML.
+**Kanboard peut convertir en Markdown les messages écrits en simple HTML**.
+
+Sécurité et prérequis
+-------------------------
+
+- Le webhook de Kanboard est protégé par un jeton aléatoire
+- L'adresse de l'expéditeur doit correspondre à celle d'un utilisateur de Kanboard
+- L'utilisateur de Kanboard doit être un membre du projet
+- Le projet Kanboard doit avoir un identifiant unique, par exemple **MONPROJET**
+
diff --git a/doc/fr/creating-tasks.markdown b/doc/fr/creating-tasks.markdown
new file mode 100644
index 00000000..064ba18f
--- /dev/null
+++ b/doc/fr/creating-tasks.markdown
@@ -0,0 +1,27 @@
+Créer des tâches
+==============
+
+Depuis le tableau, cliquez sur le signe plus + à côté du nom de la colonne :
+
+![Création de tâche à partir du tableau](http://kanboard.net/screenshots/documentation/task-creation-board.png)
+
+Le formulaire de création de tâche apparaît :
+
+![Formulaire de création de tâche](http://kanboard.net/screenshots/documentation/task-creation-form.png)
+
+Le seul champ obligatoire est le titre.
+
+Description des champs :
+
+- **Titre** : le titre de votre tâche, tel qu'il sera affiché sur le tableau.
+- **Description** : vous permet d'ajouter davantage d'informations sur la tâche. Le contenu peut être écrit en [Markdown](http://kanboard.net/documentation/syntax-guide).
+- **Créer une autre tâche** : cochez cette case si vous souhaitez créer une tâche similaire (les champs seront pré-remplis).
+- **Assigné** : la personne qui va travailler sur la tâche.
+- **Catégorie** : une seule catégorie peut être assignée à une tâche.
+- **Colonne** : la colonne dans laquelle la tâche sera créée. La tâche sera positionnée en bas de cette colonne.
+- **Couleur** : Choisissez la couleur de la carte.
+- **Complexité** : utilisée dans la gestion de projet agile (Scrum), la complexité des points d'étape est un nombre qui montre à l'équipe le degré de difficulté de l'avancement du projet. Les utilisateurs se servent souvent des suites de Fibonacci.
+- **Estimation originale** : estimation du nombre d'heures nécessaire pour terminer les tâches.
+- **Date d'échéance** : les tâches dont la date d'échéance est dépassée auront une date d'échéance en rouge et les dates suivantes seront en noir dans le tableau. Plusieurs formats de date sont acceptés, outre le sélecteur de date.
+
+Avec le lien d'aperçu (« Prévisualiser »), vous pouvez voir la description de la tâche convertie depuis la syntaxe Markdown.
diff --git a/doc/fr/duplicate-move-tasks.markdown b/doc/fr/duplicate-move-tasks.markdown
new file mode 100644
index 00000000..6d8e269e
--- /dev/null
+++ b/doc/fr/duplicate-move-tasks.markdown
@@ -0,0 +1,58 @@
+Dupliquer et déplacer des tâches
+========================
+
+Dupliquer une tâche dans le même projet
+--------------------------------------
+
+Allez à la vue des par tâche et choisissez **Dupliquer** sur la gauche.
+
+![Duplication de tâche](http://kanboard.net/screenshots/documentation/task-duplication.png)
+
+Une nouvelle tâche sera créée avec les mêmes propriétés que celles de la tâche originale.
+
+Dupliquer une tâche vers un autre projet
+-----------------------------------
+
+Allez à la vue par tâches et choisissez **Dupliquer dans un autre projet**.
+
+![Duplication d'une tâche dans un autre projet](http://kanboard.net/screenshots/documentation/task-duplication-another-project.png)
+
+Seuls les projets dont vous êtes membre apparaîtront dans le menu déroulant.
+
+Avant de copier les tâches, Kanboard vous demandera les propriétés de la destination qui ne sont pas communes entre les projets source et destination.
+
+Vous devez essentiellement définir :
+
+- La swimlane de destination
+- La colonne
+- La catégorie
+- L'assigné
+
+Déplacer une tâche vers un autre projet
+------------------------------
+
+Allez à la vue par tâches et choisissez **Déplacer vers un autre projet**.
+
+Déplacer vers un autre projet est semblable à l'opération de duplication, vous devez choisir les nouvelles propriétés de la tâche.
+
+Liste des champs dupliqués
+-------------------------
+Voici la liste des champs dupliqués :
+
+- title
+- description
+- date_due
+- color_id
+- project_id
+- column_id
+- owner_id
+- score
+- category_id
+- time_estimated
+- swimlane_id
+- recurrence_status
+- recurrence_trigger
+- recurrence_factor
+- recurrence_timeframe
+- recurrence_basedate
+
diff --git a/doc/fr/index.markdown b/doc/fr/index.markdown
index 40e4f2d7..d06ca53b 100644
--- a/doc/fr/index.markdown
+++ b/doc/fr/index.markdown
@@ -29,3 +29,17 @@ Utiliser Kanboard
 - [Analytique](analytics.markdown)
 - [Diagramme de Gantt pour les tâches](gantt-chart-tasks.markdown)
 - [Diagramme de Gantt pour tous les projets](gantt-chart-projects.markdown)
+
+### Travailler avec les tâches
+
+- [Créer des tâches](creating-tasks.markdown)
+- [Fermer des tâches](closing-tasks.markdown)
+- [Dupliquer et déplacer des tâches](duplicate-move-tasks.markdown)
+- [Ajouter des captures d'écran](screenshots.markdown)
+- [Liens entre les tâches](task-links.markdown)
+- [Transitions](transitions.markdown)
+- [Suivi du temps](time-tracking.markdown)
+- [Tâches récurrentes](recurring-tasks.markdown)
+- [Créer des tâches par email](create-tasks-by-email.markdown)
+- [Sous-tâches](subtasks.markdown)
+- [Analytique des tâches](analytics-tasks.markdown)
diff --git a/doc/fr/recurring-tasks.markdown b/doc/fr/recurring-tasks.markdown
new file mode 100644
index 00000000..98759a98
--- /dev/null
+++ b/doc/fr/recurring-tasks.markdown
@@ -0,0 +1,24 @@
+Tâches récurrentes
+===============
+
+Pour convenir à ma méthodologie de Kanban, les tâches récurrentes ne sont pas basées sur une date mais sur les évènements du tableau.
+
+- Les tâches récurrentes sont dupliquée dans la première colonne du tableau quand les évènements sélectionnés se produisent
+- La date d'échéance peut être automatiquement recalculée
+- Chaque tâche enregistre l'identifiant de tâche de la tâche parente qui l'a créée et la tâche enfant qui a été créée.
+
+Configuration
+-------------
+
+Allez à la page de vue par tâches ou utilisez le menu déroulant du tableau, puis choisissez **Modifier la récurrence**.
+
+![Tâche récurrente](http://kanboard.net/screenshots/documentation/recurring-tasks.png)
+
+il existe trois façons de déclencher la création d'une nouvelle tâche récurrente :
+
+- Déplacer une tâche depuis la première colonne
+- Déplacer une tâche vers la dernière colonne
+- Fermer la tâche
+
+Les dates d'échéance, si elles concernent la tâche courante, peuvent être recalculées en fonction d'un nombre donné de jours, mois ou années.
+La date de base pour le calcul de la nouvelle date d'échéance peut être soit la date d'échéance existante, soit la date de l'action.
diff --git a/doc/fr/screenshots.markdown b/doc/fr/screenshots.markdown
new file mode 100644
index 00000000..d591d2a4
--- /dev/null
+++ b/doc/fr/screenshots.markdown
@@ -0,0 +1,26 @@
+Ajouter des captures d'écran
+==================
+
+Vous pouvez copier-coller des images directement dans Kanboard pour gagner du temps.
+Ces images sont mises en ligne en tant que pièces jointes à une tâche.
+
+Ceci est particulièrement utile pour prendre des captures d'écran, quand il faut par exemple décrire un problème.
+
+Vous pouvez ajouter directement des captures depuis le tableau en cliquant sur le menu déroulant ou sur la page de visualisation des tâches.
+
+![La capture d'écran dans le menu déroulant](http://kanboard.net/screenshots/documentation/dropdown-screenshot.png)
+
+Pour ajouter une nouvelle image, prenez votre capture et collez-la avec CTRL+V ou Command+V:
+
+![Page de capture](http://kanboard.net/screenshots/documentation/task-screenshot.png)
+
+Avec Mac OS X, vous pouvez utiliser les raccourcis suivants pour prendre des captures d'écran :
+
+- Command-Control-Maj-3 : prend une capture de l'écran entier et l'enregistre dans le presse-papiers
+- Command-Control-Maj-4, puis choix d'une zone : prend une capture d'une zone définie et l'enregistre dans le presse-papiers
+- Command-Control-Maj-4, puis touche espace, puis clic sur une fenêtre : prend une capture d'une fenêtre et l'enregistre dans le presse-papiers
+
+Il existe plusieurs applications tierces qui peuvent être utilisées pour prendre des captures d'écran avec des annotations et un choix de formes.
+
+**Remarque : cette fonctionnalité n'est pas disponible sur tous les navigateurs.** Elle n'existe pas pour Safari en raison de ce bug : https://bugs.webkit.org/show_bug.cgi?id=49141
+
diff --git a/doc/fr/subtasks.markdown b/doc/fr/subtasks.markdown
new file mode 100644
index 00000000..8c9de47c
--- /dev/null
+++ b/doc/fr/subtasks.markdown
@@ -0,0 +1,43 @@
+Sous-tâches
+========
+
+Les sous-tâches sont utiles pour se partager le travail que représente une tâche.
+
+Chaque sous-tâche :
+
+- peut être assignée à un membre du projet
+- a trois différents statuts : **À faire**, **En cours**, **Terminé**
+- dispose d'informations sur le temps de travail : **temps passé** et **temps estimé**
+- est classée en fonction de sa position
+
+Créer des sous-tâches
+-----------------
+
+Depuis la vue par tâche, cliquez sur **Ajouter une sous-tâche** dans le panneau latéral.
+
+![Ajouter une sous-tâche](http://kanboard.net/screenshots/documentation/add-subtask.png)
+
+Vous pouvez aussi ajouter rapidement une sous-tâche en saisissant seulement son titre :
+
+![Add a subtask from the task view](http://kanboard.net/screenshots/documentation/add-subtask-shortcut.png)
+
+Modifier le statut d'une sous-tâche
+---------------------
+
+Quand vous cliquez sur le titre d'une sous-tâche son statut change :
+
+![Sous-tâche en cours](http://kanboard.net/screenshots/documentation/subtask-status-inprogress.png)
+
+L'icône devant le titre est mise à jour en fonction du statut.
+
+![Sous-tâche effectuée](http://kanboard.net/screenshots/documentation/subtask-status-done.png)
+
+Remarque : quand la tâche est fermée, toutes les sous-tâches voient leur statut passer à **Terminé**.
+
+Chrono des sous-tâches
+-------------
+
+- À chaque fois qu'une sous-tâche est en cours de réalisation, le chronomètre est également démarré. Il peut être lancé et interrompu à tout moment.
+- Le chronomètre enregistre automatiquement le temps passé sur la sous-tâche. Vous pouvez aussi modifier manuellement la valeur du temps passé dans le champ adéquat quand vous modifiez une sous-tâche.
+- Le temps passé est arrondi au quart d'heure le plus proche. Cette information est enregistrée dans un tableau distinct.
+- Le temps passé à la tâche ainsi que le temps estimé sont automatiquement mis à jour en fonction de la somme de toutes les sous-tâches.
diff --git a/doc/fr/task-links.markdown b/doc/fr/task-links.markdown
new file mode 100644
index 00000000..f05e5d67
--- /dev/null
+++ b/doc/fr/task-links.markdown
@@ -0,0 +1,22 @@
+Liens entre les tâches
+==========
+
+Les tâches peuvent être liées ensemble avec des relations prédéfinies.
+
+![Task Links](http://kanboard.net/screenshots/documentation/task-links.png)
+
+Les relations établies par défaut sont les suivantes :
+
+- **fait référence à**
+- **bloque** | est bloqué par
+- **est bloqué par** | bloque
+- **duplique** | est dupliqué par
+- **est dupliqué par** | duplique
+- **est un enfant de** | est un parent de
+- **est un parent de** | est un enfant de
+- **vise les étapes importantes** | est une étape importante de
+- **est une étape importante de** | vise les étapes importantes
+- **correctifs** | est réglé par
+- **est réglé par** | correctifs
+
+Ces étiquettes peuvent être modifiées dans les paramètres de l'application.
diff --git a/doc/fr/time-tracking.markdown b/doc/fr/time-tracking.markdown
new file mode 100644
index 00000000..0b722c63
--- /dev/null
+++ b/doc/fr/time-tracking.markdown
@@ -0,0 +1,44 @@
+Suivi du temps
+=============
+
+Les information de la feuille de suivi du temps peuvent être définies au niveau des tâches ou des sous-tâches 
+
+Suivi de temps des tâches 
+------------------
+
+![Suivi de temps des tâches ](http://kanboard.net/screenshots/documentation/task-time-tracking.png)
+
+Les tâches ont deux champs:
+    
+- Temps estimé
+- Temps passé
+
+Ces valeurs représentent des heures de travail et doivent être entrées manuellement.
+
+
+Suivi de temps des sous-tâches
+---------------------
+
+![Suivi de temps des sous-tâches](http://kanboard.net/screenshots/documentation/subtask-time-tracking.png)
+
+Les sous-tâches ont aussi les champs "temps passé" et "temps estimé"
+
+Lorsque vous changez la valeur de ces champs, **le suivi des tâches est mis à jour automatiquement et devient la somme des sous-tâches**.
+
+Kanboard enregistre le temps entre chaque changement de statut des sous-tâches dans une table séparée
+
+- Changer le statut de la sous-tâche de **à faire** à **en cours** marque le temps de début
+- Changer le statut de la sous-tâche de **en cours** à **à faire** marque le temps de fin mais aussi met à jour le temps passé sur la sous-tâche et la tâche
+
+La répartition de tous les enregistrements est visible sur la page de la tâche
+
+![Feuille de suivi du temps pour les tâches](http://kanboard.net/screenshots/documentation/task-timesheet.png)
+
+Pour chaque sous-tâche, le chrono peut être à tout moment arrêté/démarré
+
+![Chrono des sous-tâches](http://kanboard.net/screenshots/documentation/subtask-timer.png)
+
+- Le chrono ne dépend pas du statut de la sous-tâche
+- Chaque fois que vous démarrez le chrono, un nouvel enregistrement est créé dans la table de suivi des temps
+- Chaque fois que vous arrêtez l'horloge, la date de fin est enregistrée dans la table de suivi des temps
+- Le temps passé est arrondi au quart d’heure le plus proche
diff --git a/doc/fr/transitions.markdown b/doc/fr/transitions.markdown
new file mode 100644
index 00000000..72106a64
--- /dev/null
+++ b/doc/fr/transitions.markdown
@@ -0,0 +1,20 @@
+Transitions entre les tâches
+================
+
+Les transitions enregistrent tous les mouvements des tâches entre les colonnes
+
+![Transitions](http://kanboard.net/screenshots/documentation/transitions.png)
+
+Depuis la page des tâches, vous pouvez accéder à ces informations:
+    
+- Date de l'action
+- Colonne d'origine
+- Colonne de destination
+- Exécuter (Pour l'utilisateur qui a déplacé la tâche) 
+- Temps passé sur la colonne d’origine
+
+Les données de transition entre les tâches peuvent aussi être exportées depuis la page des paramètres du projet
+
+![Transitions Export](http://kanboard.net/screenshots/documentation/transitions-export.png)
+
+Pour la période spécifiée, vous allez générer un fichier CSV que vous pouvez utiliser avec n’importe quel tableur