réinit

docs/ajout_jeu_de_données.md

@@ -0,0 +1,43 @@
+# Ajout d'un jeu de données
+Pour ajouter un jeu de données et sa conversion vous devrez faire un mapper et mettre le jeu de données dans le convertisseur.
+
+Checklist:
+- [] avoir un jeu de données de Points en Geojson à convertir, dans `etalab_data`, dans un dossier thématique (arbres, parking vélo, IRVE...).
+- [] un convertisseur (Mapper) qui étend le type `MappingConfigType`
+- [] une page de documentation markdown liée à ce jeu de données mentionnant une commande ts-node à lancer dans `docs`.
+- [] noter l'url du jeu de données source dans `get_datasets.sh`
+- [] ajouter l'import de ce Mapper dans `convert_to_osm_tags.ts`
+- [] tester le rendu de la conversion en plaçant la sortie output dans JOSM.
+
+## Récupérer un jeu de données
+## Créer un Mapper
+Créer un fichier ts dans mappings/converters qui expose un objet étendant `MappingConfigType`. Ici on fait un Mappeur qui ne changera qu'une seule clé en gardant toutes ses valeur, nom_amenageur sera converti en name.
+
+```ts
+
+export const mappingName: MappingConfigType = {
+    config_name: 'testing config mappingName',
+    config_author: 'tykayn <contact+geojson2osm@cipherbliss.com>',
+    default_properties_of_point: {},
+    tags: {
+        nom_amenageur : 'name'
+    },
+    add_not_mapped_tags_too: true,
+    source: {
+        geojson_path: '',
+        url: ''
+    },
+    filters: {},
+}
+```
+Le détail complet des configurations de MappingConfigType est à voir dans la page [configuration_de_conversion.md]
+
+## Ajouter le Mapper dans le point d'entrée de conversion
+
+Choisir le jeu de données en changeant la configuration dans `convert_to_osm_tags.ts`.
+Importer son Mapper dans `convert_to_osm_tags.ts` et le faire charger dans l'[Engine](engine.md) dans la partie qui réalise le chargement d'un Mapper.
+Ajouter le nom du mapper dans le tableau `allowed_configs`, puis remplir une condition pour que l'Engine prenne le bon modèle de mapping.
+
+
+# Debug
+activer les logs dans le fichier des `utils.ts`.