Recommandations concernant les préréglages par défaut

Cette page contient des directives générales pour les préréglages par défaut​ et les nouvelles icônes.

Nouveaux attributs et valeurs

Veuillez d'abord vérifier qu'il n'y a pas déjà un ticket pour cet attribut, par exemple en utilisant la fonction de recherche en haut à droite de cette page.

En fait, nous devons nous assurer que le menu des pré-réglages n'est pas trop encombré, car il serait difficile de trouver les éléments utiles au quotidien si nous avions trop d'entrées exotiques. Les nouveaux attributs et valeurs devraient avoir :

• une documentation appropriée dans le ​wiki OSM,
• des chiffres d'utilisation convenables ( en absolu et par nombre de mappeurs),
• une utilisation dans le monde entier,
• les cas controversés (comme contact:phone=* par rapport à phone=*) doivent être décidés au cas par cas,
• Si une caractéristique n'est cartographiée que par une poignée de spécialistes, elle convient mieux dans un préréglage externe. Il s'agit généralement de schémas limités à un pays, un loisir, un sport ou une profession spécifique. Au lieu de créer votre propre préréglage externe, vous pouvez également étendre Nouveaux attributs (en).

Notes :

• Le but du préréglage interne est d'accompagner les attributs et les schémas d'étiquetage largement acceptés et utilisés par la communauté. L'objectif n'est pas d'inventer de nouveaux attributs ou schémas d'étiquetage.
• Lorsque vous examinez ​taginfo, vérifiez également où des valeurs inhabituelles sont utilisées.
• Vous pouvez utiliser l'API overpass pour charger ces objets dans JOSM et vérifier dans l'historique qui les a créés.
• Voir aussi ​cet exemple pour rechercher le dernier éditeur d'un tag spécifique.
• Un outil utile pour vérifier les balises est également ​taghistory. Si un attribut est utilisé, par exemple, 50 fois par an dans le monde entier, il n'est généralement pas nécessaire de définir un préréglage pour cet attribut. Vous pouvez toujours ajouter des attributs manuellement via la boîte de dialogue : Ajouter un attribut.
• Lorsque l'on modifie les paramètres par défaut, il faut également changer, pour des raisons de cohérence, le modèle de coloriage de la carte principale​ et peut-être aussi les règles du validateur.

Nouvelles icônes

• Le format de fichier doit être svg pour une mise à l'échelle sans perte. (Techniquement, le format png est également pris en charge, mais toutes les icônes prédéfinies sont svg depuis août 2016.)
• L'icône doit être identifiable à une taille de 16 pixels. Il s'agit de la taille par défaut à laquelle les icônes sont affichées dans la Fenêtre d'Édition sur les écrans à ppp (dpi) standard (non hidpi).
• La licence doit être compatible avec la GPL3 (comme PD ou CC0). Une bonne source d'icônes est ​openclipart.org (toutes les icônes y sont PD), ​publicdomainvectors.org (toutes les icônes CC0), ​freesvg.org (toutes les icônes CC0) ou ​osm-icons.org (beaucoup sont CC0). Vous pouvez également vérifier si JOSM possède déjà une icône appropriée et inutilisée dans l'un de ses dossiers d'icônes : icônes utilisées et icônes inutilisées.
• Si l'attribut s'applique à des nœuds, l'icône dans l'affichage cartographique et l'icône du préréglage doivent être,si possible, les mêmes. (Ce n'est pas possible lorsque différentes fonctionnalités utilisent le même préréglage, par exemple, crossing=island et crossing=traffic_signals ont des icônes différentes, mais sont traitées dans un seul préréglage "Passage Piéton".)
• Les icônes à fond transparent ne doivent pas être uniquement noires ou uniquement blanches. Sinon, si l'on utilise un fond noir ou blanc (sans images aériennes comme fond) dans la fenêtre d'édition de la carte, les icônes noires ou blanches seront invisibles. Solution : si vous souhaitez utiliser une icône noire, ajoutez un fond blanc carré à l'icône au lieu d'un fond transparent ou, mieux encore, utilisez un halo blanc.
  Exemples : Les icônes de couleur sont toutefois préférables.
• L'icône doit être le moins visible possible dans la fenêtre d'édition. Les icônes colorées à fond transparent sont donc préférables aux icônes noires/blanches à fond carré.
• L'icône doit être compréhensible dans tous les pays.
• Chaque préréglage devrait avoir sa propre icône et ne pas emprunter l'icône existante d'un autre préréglage afin que vous puissiez connaître l'attribut en voyant simplement l'icône dans la fenêtre d'édition.
• Pour tester votre icône par rapport à ces exigences dans JOSM, le testeur d'icônes (en) du modèle de coloriage vous aide.

Problèmes éventuels avec les svg dans JOSM

Veuillez vérifier si le fichier svg fonctionne correctement dans JOSM.

• La taille de base du svg doit être de 16 px ou supérieure à 64 px. Les images dont la taille de base est comprise entre 16 et 64 px ne seront pas mises à l'échelle à 16 px.
• Certaines bibliothèques svg ne fonctionnent pas avec JOSM (les images sont déformées). Si vous avez un tel fichier, essayez la solution suivante : créez un nouveau document svg avec Inkscape, copiez les données svg dans ce nouveau fichier, redimensionnez la page en fonction des données et enregistrez.
• Redimensionnez votre icône à 16px ou à un multiple entier de cette taille (pas quelque chose comme 458,1534) pour éviter les imprécisions d'affichage dues aux erreurs d'arrondi dans java.
• Vérifiez le code du fichier dans un éditeur de texte. Cherchez la valeur viewBox au début du fichier. Si l'icône est, par exemple, en 16x16 pixels, et si vous l'avez fait dans Inkscape (au moins cela arrive dans la version 0.91) et avez défini dans les propriétés du document 16,00000 par 16,00000 pixels, pixels, probablement dans le code du fichier vous avez ces valeurs viewBox="0 0 16.000002 16.000001". Changez-les en viewBox="0 0 16 16" ou vous aurez des problèmes (voir #12201 et le correctif [o31865]).
• Les icônes svg sont automatiquement nettoyées pour réduire la taille du fichier dans la version JOSM. Il n'y a donc pas besoin de faire cette étape manuellement avant de télécharger les fichiers svg dans svn. Voir comment:35:ticket:10479, comment:10:ticket:10877 et ticket:12201#comment:21 Les svgs non nettoyés sont meilleurs pour une édition ultérieure.
• Cependant, à cause d'un bug dans svgcleaner, le code svg ne devrait pas contenir d'arguments commençant par des caractères spéciaux dans les codes de style, par exemple -inkscape-font-specification:Sans;. Cela peut conduire à des changements de couleur (voir #13158).
• Si l'icône comporte des dégradés, le décalage doit augmenter à chaque arrêt, c'est-à-dire que deux arrêts avec le même décalage ne sont pas autorisés, voir ​svg salamander.
• Les styles CSS (<style type="text/css">) ne sont pas encore supportés par svgSalamander.
• Si possible, n'utilisez pas du tout d'éléments de texte, car cela peut entraîner des résultats d'affichage différents en fonction par exemple du système d'exploitation ou des polices installées. Pour éviter cela, vous pouvez transformer le texte en chemins dans le svg.
• Certains des problèmes cités peuvent être détectés en exécutant ce script​.

Voir également

• Le point de départ de ces règles est le ticket:10246#comment:14.
• La version originale de cette page en anglais

---

Retour au Guide du Développeur (en)
Retour à l'Aide Principale