Merge pull request #15 from trufi-association/installing-josm

Installing josm

docs/index.md

@@ -1,34 +1,45 @@
 # Cartographie des lignes de bus
 
-Documentation pour les communautés le long du parcours de Trufi Association. Tous les documents doivent être faciles à comprendre, comporter quelques graphiques et être aussi courts que possible, et les images ne doivent pas être trop petites.
+Cette série de tutoriels mise au point par l'association Trufi e.V. vise à faciliter la cartographie des lignes de bus en utilisant J0SM pour OpenStreetMap afin de permettre aux communautés de numériser leurs systèmes de transport public.
 
-#### Préparation
+## Configurer votre espace de travail
 
-[Installation de JOSM sur linux](installing-josm-on-linux/index.md) - Documentation sur l'installation de Java et JOSM sur linux.
+JOSM est une application de bureau que nous utilisons pour ajouter des itinéraires de transport public à OpenStreetMap. Mais JOSM (Java OpenStreetMap (éditeur)) est beaucoup plus puissant et parfois aussi compliqué.
 
-[Relier votre compte OSM à JOSM](oauth-josm/index.md) - Nous lions votre propre compte OSM à JOSM afin que vous puissiez télécharger les modifications apportées à la carte depuis JOSM. _Certaines communautés ne vous obligent pas à suivre cette documentation car elles l'ont déjà configurée pour vous._
+[**Installation de JOSM sous Linux**](./install-josm/linux.md)
 
-#### Préparez-vous à ajouter une relation à OSM
+[**Installation de JOSM sous Windows**](./install-josm/windows.md)
 
-[Comprendre les relations](understanding-relations/index.md) - Afin de cartographier l'infrastructure des systèmes de transport public, nous devons d'abord comprendre les relations. Les graphiques dominent ici!
+[**Installation de JOSM sur Mac**](./install-josm/mac.md)
 
-[Ajout d'arrêts de bus ou de positions d'attente pour les passagers](adding-bus-stops/index.md) - Explique comment cartographier les arrêts de bus et les positions d'attente et explique la différence entre eux. _Certaines communautés ne vous demandent pas de cartographier les arrêts de bus ou les positions d'attente. Dans certains cas, ils ne nécessitent pas les deux pratiques de cartographie, par exemple dans les villes sans arrêts de bus_
+[**Relier votre compte OSM à JOSM**](oauth-josm/index.md)<br/>
+Nous lions votre propre compte OSM à JOSM afin que vous puissiez télécharger les modifications apportées à la carte depuis JOSM.
 
-[Diviser les voies en une ou deux](split-ways/index.md) - Documente la manière de diviser un chemin dans les cas où une relation ne suit pas le chemin jusqu'à la fin.
+## Basics
 
-#### Ajouter un itinéraire à OSM
+[**Comprendre les relations**](understanding-relations/index.md)<br/>
+Afin de cartographier l'infrastructure des systèmes de transport public, nous devons d'abord comprendre les relations. Les graphiques dominent ici!
 
-[Cartographie des lignes de bus](mapping-routes/index.md) - Ici, tout se réunit. C'est la partie pour laquelle vous êtes probablement ici. Il s'agit de savoir comment cartographier des itinéraires dans JOSM pour les ajouter à OpenStreetMap.
+[**Diviser les voies en une ou deux**](split-ways/index.md)<br/>
+Documente la manière de diviser un chemin dans les cas où une relation ne suit pas le chemin jusqu'à la fin.
 
-#### Explication des éléments de l'interface utilisateur JOSM
+## Routes on JOSM
 
-[Séparer les voies en une ou deux](split-ways/index.md) - Documente comment diviser un chemin dans les cas où une ligne de bus ne suit pas le chemin jusqu'à la fin.
+[**Ajout d'arrêts de bus ou de positions d'attente pour les passagers**](adding-bus-stops/index.md)<br/>
+Explique comment cartographier les arrêts de bus et les positions d'attente et explique la différence entre eux. _Certaines communautés ne vous demandent pas de cartographier les arrêts de bus ou les positions d'attente. Dans certains cas, ils ne nécessitent pas les deux pratiques de cartographie, par exemple dans les villes sans arrêts de bus_
 
-[À propos de l'entrée dans la barre supérieure _Outils_](josm-tools/index.md) - Un aperçu rapide des options disponibles lorsque vous sélectionnez quelque chose dans l'éditeur pour effectuer des actions.
+[**Cartographie des lignes de bus**](mapping-routes/index.md)<br/>
+Ici, tout se réunit. C'est la partie pour laquelle vous êtes probablement ici. Il s'agit de savoir comment cartographier des itinéraires dans JOSM pour les ajouter à OpenStreetMap.
 
-[Comprendre la section _couches_ présentée à droite de l'éditeur](josm-editor-layers/index.md) - Un aperçu rapide de la section _Couches_ de l'éditeur JOSM. C'est un outil très important.
+## Extended
+
+[**À propos de l'entrée dans la barre supérieure _Outils_**](josm-tools/index.md)<br/>
+Un aperçu rapide des options disponibles lorsque vous sélectionnez quelque chose dans l'éditeur pour effectuer des actions.
+
+[**Comprendre la section _couches_ présentée à droite de l'éditeur**](josm-editor-layers/index.md)<br/>
+Un aperçu rapide de la section _Couches_ de l'éditeur JOSM. C'est un outil très important.
 
 # Contributeurs
 
 - TCHAMIE Léleng Denis ([OSM Togo](https://openstreetmap.tg/))
-- Kokou Elolo AMEGAYIBO - AKEAmazan ([OSM Togo](https://openstreetmap.tg/))
+- Kokou Elolo AMEGAYIBO - AKEAmazan ([OSM Togo](https://openstreetmap.tg/)) 

docs/installing-josm-on-linux/index.md → docs/install-josm/linux-java-jar.md

@@ -1,13 +1,9 @@
-# Comment installer JOSM
+# Traitement des fichiers .jar sous linux
 
 !!! note ""
 	Kokou Elolo AMEGAYIBO - AKEAmazan ([OSM Togo](https://openstreetmap.tg/)) a traduit la page en français. Oeuvre originale de Sören Reinecke ([Trufi Association](https://trufi-association.org))
 
-## Installation de JOSM sur Linux
-
-JOSM est une application de bureau que nous utilisons pour ajouter des itinéraires de transport public à OpenStreetMap. Mais JOSM (Java OpenStreetMap (éditeur)) est beaucoup plus puissant et parfois aussi compliqué. Nous avons écrit un _[guide] (../installation-mapping-tool/index.md)_ pour vous qui le rend plus facile à utiliser pour cartographier les itinéraires de transports publics. Cette documentation ne couvre que les étapes d'installation de JOSM. Nous ne montrons pas ici comment l'utiliser pour cartographier des itinéraires. Elle couvre seulement la procédure d'installation sous Linux.
-
-### Installation de Java
+## Installation de Java
 
 1. Ouvrez un terminal en appuyant sur la touche _WINDOWS_ de votre clavier et en tapant "terminal" dans la barre de recherche. Cela dépend du système d'exploitation et du menu de démarrage que vous utilisez, la façon dont la barre de recherche fonctionne en détail. Vous devrez peut-être l'activer d'abord pour commencer à taper.
 
@@ -43,11 +39,11 @@ JOSM est une application de bureau que nous utilisons pour ajouter des itinérai
 
    - **ToDo:** _Ajouter plus de dérivés de Linux_.
 
-### Installation de JOSM
+## Installation de JOSM
 
 À ce stade, nous n'avons plus besoin du terminal.
 
-1. Télécharger JOSM [ici](https://josm.openstreetmap.de/). ![](website-josm-download/out.png)
+1. Télécharger JOSM [ici](https://josm.openstreetmap.de/). ![](website-jar-download/out.png)
 
 2. Enregistrez-le sur votre ordinateur ou sur un périphérique de stockage portable. Enregistrez-le où vous voulez.
 
@@ -56,3 +52,5 @@ JOSM est une application de bureau que nous utilisons pour ajouter des itinérai
 4. Allez à la section _Permissions_ et cochez-y la case _Autoriser l'exécution du fichier comme programme_: ![](properties-permissions/out.png)
 
 5. Nous pouvons fermer la fenêtre et un double clic sur l'icône du programme devrait ouvrir JOSM. Si JOSM ne s'ouvre pas mais qu'une fenêtre apparaît et que vous voyez des boutons dont l'un est intitulé _Run_, alors cliquez sur ce bouton et JOSM devrait s'ouvrir.
+
+

docs/install-josm/linux.md

@@ -0,0 +1,128 @@
+# Installation de JOSM sous Linux
+
+!!! note ""
+	Kokou Elolo AMEGAYIBO - AKEAmazan ([OSM Togo](https://openstreetmap.tg/)) a traduit la page en français. Oeuvre originale de Sören Reinecke ([Trufi Association](https://trufi-association.org))
+
+Aperçu des différentes méthodes d'installation de JOSM sur les systèmes d'exploitation linux graphiques, par exemple les distributions linux basées sur Debian comme Ubuntu, Kubuntu et Debian elle-même, ou sur tout système d'exploitation non Debian disposant de Flatpak.
+
+**Utilisez autant que possible les logithèques et autres interfaces graphiques pour vous rendre service et n'utilisez le terminal/console que s'il est plus facile pour vous de vous en servir plus rapidement.**
+
+## 1. Méthode : Installer en utilisant Flatpak (recommandé)
+
+[Installation à l'aide de Flatpak](https://flathub.org/apps/details/org.openstreetmap.josm) (lien externe) est notre méthode d'installation recommandée qui est la même pour la plupart des variantes de linux. Exécutez la commande
+
+```bash
+flatpak install app/org.openstreetmap.josm/x86_64/stable -y
+```
+
+ou utiliser la fonctionnalité de résolution automatique de Flatpak :
+
+```bash
+flatpak install josm
+```
+
+Vous pouvez également utiliser votre logitèque s'il est configuré pour Flatpak.
+
+**Flatpak doit être installé sur votre système pour que cela fonctionne. Nous recommandons à tous les utilisateurs de JOSM d'utiliser cette méthode d'installation car c'est la manière la plus intelligente, la plus sûre et la plus simple d'installer des applications sous Linux. Pensez donc à installer et à configurer Flatpak si vous ne l'avez pas encore fait.**
+
+## 2. Méthode : Utiliser notre script bash
+
+1. Installer en utilisant notre propre script que nous avons écrit avec le support de certains systèmes linux que vous pouvez télécharger. [ici](https://trufi-association.org/installJOSM.sh) (lien externe vers notre site web).
+2. Enregistrez-le quelque part sur votre disque, par exemple dans le dossier *Téléchargements*.
+3. Identifiez-le comme un fichier exécutable (clic droit sur le fichier --> *Propriétés* --> *Permissions* --> cocher *Autoriser l'exécution du fichier comme un programme* ou similaire)
+4. Exécutez-le en tant que super-utilisateur (utilisateur *root*) dans un terminal car votre attention est requise.
+4. Après une exécution réussie, vous pouvez supprimer ce script.
+
+## 3. Méthode : Utilisation du système de gestion des paquets (non recommandé)
+
+**Ouvrez un terminal / console et exécutez toutes les commandes suivantes en tant que root**. Notre script d'installation bash exécute ces commandes automatiquement après avoir détecté la méthode d'installation appropriée disponible sur le système.
+
+### Ubuntu, Debian et dérivés
+
+Inscrire le dépôt officiel de JOSM
+
+```bash
+echo "deb https://josm.openstreetmap.de/apt alldist universe" > /etc/apt/sources.list.d/josm.list
+```
+
+et ensuite sa clé publique<br/>
+en utilisant `wget`
+
+```bash
+wget -q https://josm.openstreetmap.de/josm-apt.key -O- > /etc/apt/trusted.gpg.d/josm.gpg
+```
+
+ou en utilisant `curl`
+
+```bash
+curl https://josm.openstreetmap.de/josm-apt.key > /etc/apt/trusted.gpg.d/josm.gpg
+```
+
+Avant de tenter l'installation, actualisez les sources
+
+```bash
+sudo apt update
+```
+
+pour pouvoir enfin installer JOSM
+
+```bash
+sudo apt install josm
+```
+
+### OpenSUSE
+
+Récupérez la version
+
+```bash
+version=`cat /etc/os-release | grep "VERSION_ID"`
+version=${version/VERSION_ID=/}
+version=${version//\"/}
+```
+
+et ajouter le dépôt 'Geo'.
+
+```bash
+zypper ar -f https://download.opensuse.org/repositories/Application:/Geo/openSUSE_Leap_${version} Application:Geo
+```
+
+afin de pouvoir installer JOSM en utilisant
+
+```bash
+zypper install josm josm-fonts
+```
+
+### Debian
+
+**Utilisez ceci uniquement lorsque les étapes de "Ubuntu, Debian et dérivés" ne fonctionnent pas pour vous.**
+
+Obtenez d'abord le nom de code de votre installation Debian.
+
+```bash
+codename=`cat /etc/os-release | grep "VERSION_CODENAME"`
+codename=${codename/VERSION_CODENAME=/}
+codename=${codename//\"/}
+```
+
+pour pouvoir ajouter le bon dépôt de backports
+
+```bash
+echo "deb http://deb.debian.org/debian ${codename}-backports main" > /etc/apt/sources.list.d/backports.list
+```
+
+Avant de tenter l'installation, actualisez les sources
+
+```bash
+apt update
+```
+
+et enfin installer JOSM à partir des backports
+
+```bash
+apt install josm/${codename}-backports
+```
+
+## 4. Méthode : Utiliser la version .jar de JOSM (non recommandé)
+
+Exécuter JOSM sur linux en utilisant son `.jar`. Mais vous devez avoir installé Java si vous ne l'avez pas déjà fait. Nous avons écrit un tutoriel que vous pouvez trouver [ici](./linux-java-jar.md) montrant comment installer Java et comment utiliser un fichier `.jar` en général.
+

docs/install-josm/mac.md

@@ -0,0 +1,36 @@
+# Installation de JOSM sur Mac
+
+!!! note ""
+	Kokou Elolo AMEGAYIBO - AKEAmazan ([OSM Togo](https://openstreetmap.tg/)) a traduit la page en français. Oeuvre originale de Sören Reinecke ([Trufi Association](https://trufi-association.org))
+
+Nous allons couvrir ici comment installer JOSM sur Mac en utilisant différentes méthodes.
+
+## 1. Méthode : Installer JOSM via Homebrew
+
+1. Ouvrir un terminal
+2. Executer
+```bash
+brew install --cask josm
+```
+
+pour installer
+
+## 2 Méthode : Installer JOSM à l'aide d'un paquet
+
+Utilisez cette méthode si vous **n'avez pas** Homebrew installé, si l'installation de Homebrew est trop compliquée ou si JOSM sera votre seule application que vous installerez par-dessus Hombrew.
+
+1. Aller sur https://josm.openstreetmap.de
+2. Télécharger [Paquet MacOS](https://josm.openstreetmap.de/download/macosx/josm-macosx.zip) (lien externe).
+   ![](website-macpackage-download/out.png)
+3. Enregistrez-le quelque part, par exemple dans votre dossier *Téléchargements*, puis exécutez-le.
+
+## 3. Méthode : Installez JOSM en tant que `.jar`.
+
+Utilisez cette méthode si vous **avez** Java installé, si l'installation de Java JRE sur Mac ne vous pose pas de problème ou si JOSM n'est pas votre seule application qui dépend de Java.
+
+1. Aller sur <https://josm.openstreetmap.de>
+2. Télécharger [josm-tested.jar](https://josm.openstreetmap.de/josm-tested.jar) (lien externe).
+   ![](./website-jar-download/out.png)
+3. Enregistrez-le quelque part sur votre disque, par exemple en créant un dossier *Applications portables* sur votre bureau et en y plaçant ce fichier. De cette façon, vous conservez une bonne structure pour l'utilisation des applications portables.
+4. Exécutez JOSM en double-cliquant sur son fichier.
+   **Si rien ne se passe pendant plus de 10 secondes (en fonction de votre matériel), cela signifie que vous n'avez probablement pas installé Java ou que le fichier d'association *.jar* ne lui est pas correctement associé.**

docs/install-josm/windows.md

@@ -0,0 +1,28 @@
+# Installation de JOSM sous Windows 
+
+!!! note ""
+	Kokou Elolo AMEGAYIBO - AKEAmazan ([OSM Togo](https://openstreetmap.tg/)) a traduit la page en français. Oeuvre originale de Sören Reinecke ([Trufi Association](https://trufi-association.org))
+
+Nous allons voir ici comment installer JOSM sur Windows en utilisant différentes méthodes.
+
+## 1. Méthode : Installer JOSM à l'aide d'un programme d'installation
+
+Utilisez cette méthode si vous **n'avez pas** Java installé, si l'installation de Java JRE sur Windows est trop compliquée ou si JOSM est votre seule application qui dépend de Java.
+
+1. Aller sur <https://josm.openstreetmap.de>
+2. Télécharger [Installateur Windows](https://josm.openstreetmap.de/download/windows/josm-setup.exe) (lien externe).
+   ![](website-exe-download/out.png)
+3. Enregistrez-le quelque part, par exemple dans votre dossier *Téléchargements*, puis exécutez-le.
+3. Après une installation réussie, vous pouvez supprimer cet installateur.
+
+## 2. Méthode : Installez JOSM en tant que `.jar`.
+
+Utilisez cette méthode si vous **avez** Java installé, si l'installation de Java JRE sur Windows ne vous pose pas de problème ou si JOSM n'est pas votre seule application qui dépend de Java.
+
+1. Aller sur <https://josm.openstreetmap.de>
+2. Télécharger [josm-tested.jar](https://josm.openstreetmap.de/josm-tested.jar) (lien externe).
+   ![](./website-jar-download/out.png)
+3. Enregistrez-le quelque part sur votre disque, par exemple en créant un dossier *Applications portables* sur votre bureau et en y plaçant ce fichier. De cette façon, vous conservez une bonne structure pour l'utilisation des applications portables.
+4. Exécutez JOSM en double-cliquant sur son fichier.
+   **Si rien ne se passe pendant plus de 10 secondes (en fonction de votre matériel), cela signifie que vous n'avez probablement pas installé Java ou que l'association de fichiers *.jar* ne lui est pas correctement associée.**
+