Premiers pas
Les bases des SVG, télécharger Inkscape et créer un premier SVG pour JetPunk.
Les SVG sur JetPunk
Créer des quiz avec SVG, les SVG standards JetPunk et créer des quiz Cartes.
Fonctionnalités avancées
Ajout de CSS basique à un quiz et utilisation de fonctions avancées d'Inkscape.
Foire aux questions
Questions fréquemment posées au sujet des SVG et de JetPunk en général.
Aide au dépannage
Si vous rencontrez un problème avec un SVG, vous trouverez ici de quoi le résoudre.
Autres outils
Aide concernant les autres outils JetPunk : le Dot Placer et l'option Show Missing Dots.
Dans cette première section, vous trouverez des informations générales concernant les SVG et comment les modifier, en passant par l'installation d'Inkscape et la configuration d'un modèle. Nous verrons également comment créer un SVG simple pour vous permettre de créer votre premier quiz avec SVG sur JetPunk.
Le SVG, ou Scalable Vector Graphics, est un format d'image vectorielle qui diffère profondément d'autres formats répandus comme le JPG ou GIF, qui sont des images matricielles ou raster graphics. Alors que ces formats stockent un nombre de pixels, les SVG stockent des objets.
Par exemple, un fichier SVG peut contenir un cercle et un rectangle. Ceux-ci sont alors stockés sous forme de points et d'instructions sur la façon dont ces points sont reliés. Cela diffère des images matricielles, dans lesquelles les pixels sont stockés de manière individuelle.
Le stockage d'objets et de formes (appelés chemins ou paths en anglais) permet une plus grande précision de l'image et signifie que la qualité de cette image n'est pas fonction du niveau de zoom : l'image vectorielle n'est jamais pixélisée. C'est ce que l'on remarque avec les cartes sur JetPunk : elles sont toujours claires et lisibles, peu importe le niveau de zoom.
Il existe plusieurs façons de créer et d'éditer des fichiers SVG. Voici trois méthodes répandues :
Il est important de noter que les SVG ne sont, au fond, que des fichiers texte. Ils peuvent être ouverts, lus et modifiés à l'aide de n'importe quel éditeur de texte (comme le Bloc-notes ou TextEdit). Il s'agit de la 3ème option proposée ci-dessus, utile aux utilisateurs les plus chevronnés qui maitrisent l'édition brute de fichiers texte. Cependant, pour la plupart des utilisateurs, cette option sera la moins retenue car elle peut être déroutante.
La deuxième option est brièvement décrite dans un blog anglais, ici sur JetPunk, How to Make SVG Maps. Cependant cette méthode nécessite quelques connaissances en programmation, et dans l'ensemble n'est vraiment utile que pour les cartes géographiques. Bien que ce ne soit pas la méthode la plus pratique, vous trouverez d'autres explications quant à l'utilisation de MapShaper dans ce second blog : How To Make a Simple SVG Map. Encore une fois, cette méthode ne s'applique vraiment que pour la création de cartes géographiques et laisse peu de place à l'expansion dans d'autres domaines.
Nous arrivons maintenant à la première option, qui est la plus utilisée et la plus prisée : utiliser Inkscape. Inkscape est un logiciel open source gratuit, spécialement conçu pour l'édition de fichiers SVG. C'est le logiciel qui sera utilisé tout au long de ce Guide. Il vous permet de créer des SVG facilement et intuitivement à partir de zéro, ainsi que la possibilité d'éditer et d'ajouter directement des classes et des identifiants, nécessaires pour que les SVG interagissent avec JetPunk (nous y reviendrons plus loin).
Passons maintenant à l'installation et à la configuration d'Inkscape. Tout d'abord, vous devrez télécharger ce logiciel. Vous pouvez le faire à partir de ce lien :
Sur cette page, vous trouverez ce bandeau :
Vous devez sélectionner la version de votre système d'exploitation (Windows, MacOS...). Cliquez ensuite sur le bouton de téléchargement de l'installeur. Une fois le téléchargement effectué, procédez à l'installation de manière classique. Si vous utilisez Windows, après avoir suivi les instructions de l'installeur, vous devriez voir une fenêtre de ce genre :
Une fois l'installation terminée, vous pouvez ouvrir le logiciel. La fenêtre qui s'ouvre devrait ressembler à ceci :
C'est la "mise en page" principale d'Inkscape. Voyons brièvement quelques-unes de ses caractéristiques :
Nous reviendrons en détail sur ces différents éléments plus tard. Pour l'instant, une fois que vous avez téléchargé Inkscape, l'étape suivante consiste à configurer un modèle (template).
Bien que cette étape soit optionnelle, elle est fortement recommandée pour réduire les éventuels problèmes rencontrés ultérieurement. Ce que nous allons faire, c'est configurer un modèle (template en anglais) afin qu'à chaque lancement d'Inkscape, vous commenciez avec les mêmes paramètres optimisés pour JetPunk.
Ces premiers paragraphes s'adressent aux utilisateurs désireux de travailler sur Inkscape en mode sombre, aussi appelé thème foncé. Pour cela, nous allons régler certains paramètres via la fenêtre Préférences. Sur Mac, on y accède en cliquant sur "Inkscape" dans le coin supérieur gauche de l'écran, puis en cliquant sur "Préférences". Sous Windows, allez dans "Édition" dans la barre de menus, puis "Préférences" tout en bas. La fenêtre suivante devrait apparaître :
Dans cette fenêtre, vous pourrez gérer les paramètres des différents outils, les préférences d'enregistrement, les raccourcis et les couleurs d'affichage. Pour ce dernier point en particulier, les couleurs sont réglables dans l'onglet "Interface" puis "Thème". Cochez "Utiliser le thème foncé" si vous le souhaitez. Vous pouvez également changer les couleurs des icônes et ajuster leurs tailles d'affichage à votre guise.
Nota : dans la suite de ce Guide SVG, les captures d'écran sont présentées avec un thème clair, par défaut sur Inkscape.
Passons maintenant au paramétrage du modèle en lui-même. Un paramétrage correct permettra d'éviter des erreurs fréquemment rencontrées par les créateurs de SVG sur JetPunk. Cela passe par :
Ces paramètres se règlent dans les Propriétés du document, accessibles en cliquant sur "Fichier" dans la barre de menus, puis "Propriétés du document". La fenêtre suivante s'ouvre :
Voici une explication des différents encadrés de couleurs :
Une fois les réglages effectués, vous pouvez fermer la fenêtre des Propriétés du document. Comme dit précédemment, le bon réglage des paramètres encadrés en vert, orange et rouge est obligatoire pour que les SVG soient parfaitement supportés sur JetPunk ; le réglage des options encadrées en bleu est recommandé pour une meilleure utilisation du logiciel.
Pour finir, nous allons sauvegarder ces réglages dans un "modèle". Actuellement, les changements effectués ne sont affectés qu'au document en cours, mais nous allons les affecter par défaut à chaque lancement d'Inkscape. Pour ce faire, cliquez sur "Fichier" dans la barre de menus, puis "Enregistrer un modèle...". Une fenêtre s'ouvre avec quelques champs à renseigner. Il vous suffit de saisir "défaut" dans le champ "Nom" et de cocher "Définir comme modèle par défaut" :
Maintenant, il vous reste à cliquer sur "Save". Une fenêtre peut apparaître pour vous demander si vous souhaitez écraser le modèle par défaut actuel, et vous pourrez cliquer sur "Remplacer" pour valider. Cela remplacera le modèle par défaut, de manière à ce que vos paramètres soient chargés à chaque lancement d'Inkscape.
Nous allons commencer par créer un dessin simple, de manière à nous familiariser avec Inkscape, puis nous ajouterons les attributs XML pour rendre ce dessin fonctionnel sur JetPunk.
Premièrement, nous allons passer en revue les principaux outils que nous utiliserons, situés dans la barre d'outils à gauche de la fenêtre principale. Nota : les symboles peuvent légèrement différer de ceux présentés ci-après, selon la version d'Inkscape que vous utilisez.
Pour la suite, nous allons utiliser l'outil 5, que l'on appellera "Stylo" pour plus de simplicité :
Pour commencer nous allons cliquer sur l'outil Stylo, puis cliquer avec le bouton gauche sur le document. Cela démarrera le chemin et vous verrez qu'un guide rouge indique où la ligne apparaîtra lors de votre prochain clic gauche. Assurez-vous que lorsque vous cliquez avec le bouton gauche, vous le faites sans faire glisser, sinon vous obtiendrez une courbe et non une ligne droite. Toutefois, si cela se produit il est possible de corriger facilement votre tracé comme nous allons le voir plus loin. Dessinez une forme en cliquant où vous le souhaitez, puis pour finir cliquez sur le carré au départ de votre chemin, de manière à le fermer. Vous obtiendrez quelque chose de ce genre :
La forme peut être colorée en blanc, ou noir ou sans fond suivant vos paramètres. Nous verrons comment éditer tout cela plus tard. Mais d'abord, nous allons modifier cette forme. Cliquez sur l'outil "Éditeur de nœuds" (le deuxième dans la barre d'outils ci-dessus) :
Avez-vous remarqué que notre forme comportait une courbe ? Nous allons nous en débarrasser en utilisant l'éditeur de nœuds. Lorsque nous sélectionnons cet outil, de petites formes apparaissent sur chaque coin de notre dessin :
Ces petites formes représentent justement les nœuds, qui définissent notre tracé. On remarque que les nœuds sont représentés par des losanges ou des carrés. Les losanges représentent les coins, signifiant que les lignes qui relient ces nœuds sont des segments droits, et les carrés représentent les nœuds courbes, ce qui veut dire que les lignes passant par ces nœuds seront courbes et non droites. Nous allons voir comment transformer une courbe en segment droit. Pour ce faire, cliquez sur le nœud carré. Des "guides" apparaissent, indiquant comment est définie la courbe passant par ce nœud :
Si vous déplacez les poignées circulaires au bout des guides, cela affectera le tracé de la courbe. Cependant, pour supprimer totalement la courbe, nous devons changer le type de nœud. Cela peut se faire grâce à la barre de contrôle d'outils, au-dessus de votre page. En particulier, lorsque le nœud de la courbe est sélectionné, ce sont les symboles suivants qui nous intéressent :
Ces 4 options définissent les différents types de nœuds. Dans notre cas, nous allons cliquer sur l'option la plus à gauche "Rendre durs les nœuds sélectionnés" (une autre façon d'appeler les coins). Après avoir cliqué, nous remarquons que notre petit nœud carré s'est changé en losange. Pourtant, nous constatons aussi que la courbe n'a pas disparu, et les guides qui la définissent sont toujours présents. Heureusement, il suffit de cliquer une seconde fois sur le même bouton que précédemment, et les guides seront supprimés. En appliquant la même méthode à tous les nœuds des courbes, vous obtiendrez un tracé pourvu uniquement de coins :
Nous allons maintenant modifier le visuel, ou style, de notre tracé. Pour se faire, prenez l'outil de sélection (celui en haut de la barre d'outils à gauche). Puis cliquez droit sur votre tracé et sélectionnez "Fond et contours...". Cela ouvrira un panneau sur le côté droit de votre fenêtre, qui ressemble à cela :
Depuis ce panneau, nous pouvons modifier le remplissage de Fond, le Contour et le Style de contour du chemin sélectionné (en changeant d'onglet situé en haut du panneau). Par défaut, nous choisissons un Fond et un Contour de type "Aplat", représenté par le carré plein juste à droite de la croix "X". Ce réglage permet d'avoir une couleur pleine et non un motif de remplissage. Quand l'option est correctement choisie, le texte "Aplat" apparaît au-dessus des sélecteurs de couleur "RVB" et "TSL".
Par défaut également, le codage des couleurs est de type RVBA. En d'autres termes, la couleur choisie se caractérise par une certaine quantité de Rouge, de Vert et de Bleu, ainsi qu'un canal Alpha pour la transparence. Vous pouvez choisir la couleur que vous souhaitez directement en cliquant sur le sélecteur, ou en entrant les quantités RVBA, ou en entrant un code couleur hexadécimal dans le champ "RVBA". Dans notre cas, le code couleur est ffffffff : 6 caractères f pour le blanc, suivis de "ff" pour régler l'opacité à son maximum. Vous pouvez également modifier l'opacité du chemin lui-même au bas de l'onglet "Fond et contours". Cela affectera à la fois le remplissage et le contour.
L'onglet "Contour" est identique à l'onglet "Fond", sauf qu'il affecte la bordure du tracé. Le troisième onglet est "Style du contour" :
Voici une explication des différentes lignes :
À ce stade, vous avez tracé un dessin et personnalisé son style de contour et son fond. Nous pouvons donc passer à l'édition des données XML du SVG pour ensuite connecter ce SVG à JetPunk !
Comme dit précédemment, il est nécessaire d'ajouter des "identifiants" et des "classes" pour rendre nos SVG réactifs sur JetPunk. Mais que signifient ces termes ? La partie qui suit peut sembler compliquée de prime abord, mais en prenant votre temps pour assimiler ces notions, vous verrez que ce n'est finalement pas si compliqué. Tout d'abord, un peu de XML de base. Regardons le XML du "chemin" ci-dessous :
Certains diront "Oh non ! Du codage ! Je ne sais même pas programmer !" Rassurez-vous, tout ça n'est pas si méchant. Décortiquons cette ligne ensemble :
C'était votre première leçon de XML/HTML ! Sur JetPunk, les ids et les classes sont utilisés pour colorer les SVG chaque fois que vous devinez une réponse dans un quiz. Cela signifie que nous devons ajouter des ids ou des classes au SVG pour donner à JetPunk quelque chose avec quoi communiquer, seul moyen de dire à un chemin spécifique de "se colorer" en vert lors d'un quiz.
Pour modifier les attributs XML d'un chemin, il faut ouvrir l'éditeur XML. Sur Inkscape, cliquez sur "Édition" puis sur "Éditeur XML...". Une fenêtre s'ouvrira comme ceci :
L'éditeur XML d'Inkscape affiche certaines informations dans la moitié supérieure, notamment l'ordre des objets et leurs identifiants. À moins que vous ne soyez un utilisateur avancé, vous pouvez ignorer les lignes contenant des éléments tels que "svg:defs", "svg:metadata" et "sodipodi". Si une balise possède un petit triangle à sa gauche (ou un "+"), cela signifie qu'elle contient d'autres objets. Dans l'exemple ci-dessus, nous avons une balise de groupe "svg:g", qui contient une balise "path".
Lorsque vous sélectionnez un objet, en l'occurrence la balise "path" surlignée en bleu, vous pouvez voir et modifier ses attributs dans le panneau du bas. En plus des attributs sodipodi, que vous pouvez ignorer, chaque chemin doit avoir au moins un attribut "id" et un attribut "d", dont nous avons déjà brièvement parlé. Notez que vous n'avez de toute façon pas besoin d'ajouter manuellement ces attributs - ils sont automatiquement créés par Inkscape lorsque vous dessinez. L'attribut qui va nous intéresser pour l'instant est l'identifiant "id".
Pour modifier l'attribut, il vous suffit de cliquer sur sa valeur actuelle (dans ce cas "path1420"), de le modifier en tapant la valeur souhaitée, puis d'appuyer sur la touche Entrée du clavier pour enregistrer les modifications. J'ai renommé l'identifiant en "mon-chemin", comme dans l'exemple XML au début de cette section.
Et voilà ! Vous avez ajouté un identifiant personnalité à votre chemin. La prochaine étape consiste à le connecter à JetPunk.
Nous souhaitons maintenant ajouter quelques classes à notre path. Pour ce faire, vous devez cliquer sur le "+" (dans l'image ci-dessous, vous pouvez le voir à gauche de "Nom"). Une fois cliqué, un nouvel attribut apparaîtra, vide pour le moment. Sous "Nom", vous devez ajouter le nom qui encode l'attribut (c'est-à-dire son type), en l'occurrence "class". Attention, comme il s'agit d'un type d'attribut standardisé, il faut écrire exactement "class". "Classe" ou "Class" ne fonctionneraient pas. Sous "Valeur", vous devez saisir le nom de la classe spécifique que vous souhaitez ajouter, par exemple "classe1" ; contrairement à l'attribut, c'est un nom de votre choix qui n'a pas à suivre de règles particulières. Comme nous l'avons dit précédemment, pour ajouter plus d'une classe, il suffit de les séparer par un espace. L'exemple que nous avions en début de section aurait les attributs suivants :
Désormais, notre chemin possède l'identifiant "mon-chemin" et les 3 classes "classe1", "classe2" et "classe3".
Maintenant que nous avons créé un SVG et renseigné les données XML nécessaires, nous allons le connecter à quiz sur JetPunk. Retrouvez l'explication détaillée dans la section suivante du Guide : "Les SVG sur JetPunk" accessible via le page de menu, ou cliquez sur ce lien : Les SVG sur JetPunk.
Dans cette section du Guide SVG, nous verrons comment paramétrer un quiz sur JetPunk, une fois le SVG créé. Nous présenterons également les SVG standards proposés par JetPunk, et enfin comment créer un Click Map Quiz, ou quiz Carte en version française.
Avant-propos : les sections suivantes traitent du créateur de quiz intégré à JetPunk qui n'existe qu'en version anglaise. Par conséquent, les termes employés ici seront conservés texto en anglais. Des explications quant à leur signification seront néanmoins fournies.
Il est très simple d'ajouter un SVG à un quiz. Dans le créateur de quiz, il suffit de cliquer sur le bouton jaune "SVG Options" à l'étape 4 (Step 4) pour les quiz textuels ou à l'étape 3 (Step 3) pour les quiz à cartes cliquables (appelés quiz Cartes sur JetPunk et dans la suite du Guide) :
Cela ouvrira la page "SVG Options", utile notamment pour ajouter un SVG au quiz. Il existe actuellement deux options pour ajouter un SVG :
Si vous voulez en savoir plus sur les SVG standards JetPunk, vous pouvez lire le paragraphe dédié, plus loin dans cette section. Pour l'instant, nous supposerons que vous souhaitez charger un SVG que vous avez créé vous-même.
Pour charger votre SVG, cliquez sur le bouton vert "Upload SVG", puis cliquez sur "Choose a file" (Choisir un fichier) dans la fenêtre pop-up. Choississez ensuite votre fichier SVG et confirmez votre choix avec le bouton bleu "Upload Selected File" (Charger le fichier sélectionné).
Si vous rencontrez un problème lors du chargement de votre fichier, consultez la section Aide au dépannage.
Une fois le fichier chargé, vous pourrez avoir un aperçu du SVG en bas de l'écran. Suivant vos besoins, vous pouvez supprimer le SVG en cliquant sur le bouton rouge "Remove SVG" (Supprimer le SVG), ou le télécharger depuis JetPunk avec le bouton gris "Download SVG" (Télécharger le SVG).
Vous pouvez maintenant cliquer sur "<< Back" en haut de la page pour enregistrer les modifications et revenir à l'écran précédent. Et voilà ! Vous avez ajouté un SVG à votre quiz.
Passons maintenant à la partie plus technique : l'ajout d'id et/ou de classes pour faire changer la couleur des paths souhaités, lors de la saisie des réponses sur un quiz textuel (text quiz).
Pour plus de simplicité, nous supposerons que les ids et les classes sont déjà configurés dans votre SVG comme vu dans la section Premiers pas. Attention : les ids et les classes doivent être affectés aux chemins eux-mêmes, et non aux groupes qui les contiennent, sinon le SVG ne fonctionnera pas avec le quiz.
Les ids des paths devant être associés aux réponses sur JetPunk s'ajoutent comme s'il s'agissait d'indices à ces réponses. Ils doivent être saisis dans la première colonne tout à gauche de l'étape 2. Veillez à saisir les identifiants exactement tels qu'ils apparaissent dans l'éditeur XML d'Inkscape, sinon JetPunk ne les reconnaîtra pas comme des ids faisant référence à votre SVG.
Si vous n'êtes pas sûr des ids ou des classes que possèdent vos paths, retournez à l'écran "SVG Options" (via le bouton jaune). Si le quiz possède un SVG, vous verrez un bouton "Get SVG IDs" (Obtenir les identifiants SVG) au-dessus de l'aperçu. Lorsque vous cliquez dessus, JetPunk recherche dans le fichier les ids et les classes de chaque chemin et les renvoie sous forme de liste. Voici le résultat :
Comme vous pouvez le voir, tous les paths trouvés dans le SVG auront leurs ids affichés dans la colonne de gauche, puis leurs classes affichées dans la colonne de droite. Les classes ici sont séparées par des virgules pour plus de clarté, mais doivent être séparées par des espaces dans le SVG lui-même.
Les ids renvoyés doivent être uniques, vous pouvez donc en saisir un à l'étape 2 pour que le path change de couleur lors du quiz. De même, des classes peuvent également être ajoutées à l'étape 2 (toujours dans la colonne la plus à gauche) pour faire interagir plusieurs chemins avec une même réponse.
Par exemple, si deux paths ont la classe "water" (capture ci-dessus), et que nous saisissons "water" dans la cellule la plus à gauche d'une réponse à l'étape 2, alors la saisie de cette réponse colorerait en vert tous les chemins ayant la classe "water" ou même l'id "water".
En effet, à l'étape 2, l'éditeur ne fait pas de distinction entre classes et ids. Par conséquence, si vous avez un path avec un id "water", et un autre avec une classe "water", ils seront tous deux colorés en vert lorsqu'une bonne réponse est donnée, si celle-ci est associée à "water" dans sa colonne de gauche.
Si vous ne souhaitez pas télécharger un SVG personnalisé, vous pouvez simplement utiliser un SVG standard proposé par JetPunk à l'aide du sélecteur SVG (SVG Selector).
Il vous suffit de cliquer sur le bouton jaune "Options SVG" comme dans les étapes précédentes, puis de cliquer sur le bouton bleu "Select JetPunk SVG". Cela vous mènera au sélecteur SVG.
Ce sélecteur affiche une liste de SVG standards que vous pouvez utiliser librement pour vos quiz (la section suivante détaille la manière dont sont conçus ces SVG standards). Certains SVG ne sont disponibles que pour certains types de quiz ; par exemple, étant donné que la carte des Pays du monde standard est trop grande pour un Click Map Quiz (quiz Carte), une version réduite de cette carte est proposée.
Pour sélectionner un SVG sur cette page, cliquez simplement sur le nom de la carte que vous voulez puis cliquez sur le bouton vert pour la sélectionner. Cela vous ramènera à la page "SVG Options", où vous pouvez cliquer sur "<< Back" pour appliquer les modifications à votre quiz et revenir à l'éditeur.
Le SVG est maintenant ajouté à votre quiz ! Pour ajouter des ids depuis un SVG standard de JetPunk, voir la section ci-dessous.
Sur JetPunk, il existe donc des cartes "standards" libres d'utilisation que les utilisateurs peuvent charger dans leurs quiz via le sélecteur présenté ci-avant. Il est aussi possible de télécharger ces cartes, les modifier et les recharger pour un quiz.
Ces SVG ont tous un format standardisé, c'est-à-dire que dans chaque SVG les ids de tous les paths sont définis de manière uniforme et codifiée pour les rendre plus faciles à utiliser sur JetPunk. Voici les ids que vous pourriez trouver dans un SVG standard :
Pour récupérer un code pays ISO, vous pouvez vous rendre sur la page Wikipedia : Codes ISO 3166-1. Les codes qui nous intéressent ici sont ceux de la colonne "alpha-2". Cette source propose également les codes d'autres nations non reconnues par l'ONU ou par JetPunk.
Ajouter les ids à un quiz qui utilise un SVG standard est très simple. Saisissez simplement le nom des pays dans la colonne "Answer" (Réponse) à l'étape 2, puis cliquez sur "Add Path IDs" dans les options avancées ("Advanced"). Une fenêtre contextuelle s'ouvrira vous demandant quel type d'id vous souhaitez ajouter (voir capture d'écran suivante). Trois choix sont proposés : les capitales (Capitals), les pays (Countries) ou États des États-Unis (U.S. States). Une fois votre choix fait, JetPunk cherchera les correspondances entre les noms de la colonne de réponses et les ids dérivés des codes ISO. Par exemple, en écrivant "France" dans les réponses, après avoir cliqué sur "Add Path IDs", JetPunk vous proposera d'attribuer à la réponse l'identifiant "fr", c'est-à-dire le code ISO de la France. JetPunk vous montrera les modifications qu'il prévoit d'apporter, afin que vous puissiez les contrôler et corriger les éventuelles erreurs en décochant la case à côté de l'id suggéré que vous ne souhaitez pas voir attribué.
Cet outil a été conçu pour l'anglais, mais il fonctionne aussi plus ou moins correctement pour toutes les langues proposées sur JetPunk. Le système sait reconnaître certaines variations dans les noms de pays, notamment en anglais. Cependant, JetPunk est plus strict pour les autres langues, notamment le français. Par exemple, "République Tchèque" sera reconnue par JetPunk, mais pas "Tchéquie". N'oubliez pas que dans tous les cas, vous pouvez toujours attribuer manuellement une classe ou un id à une réponse.
Notez que cette fonctionnalité JetPunk n'est pas uniquement compatible avec les SVG standards : si vous créez votre propre SVG en veillant à utiliser les mêmes conventions que JetPunk, vous pouvez toujours connecter le SVG via le bouton "Add Path IDs".
Abordons maintenant le cas particulier des quiz avec cartes cliquables, "Click Map Quiz en anglais, ou tout simplement quiz Carte pour la suite du Guide. Si vous êtes nouveau sur JetPunk, vous ne savez peut-être pas de quoi il s'agit, ni comment fonctionne ce type de quiz. Eh bien c'est très simple !
Il s'agit d'un type de quiz dans lequel on vous donne une liste de réponses, et vous devez choisir la bonne à associer à l'élément en surbrillance (généralement en bleu) sur la carte. Par exemple, vous pourriez voir une carte de l'Europe où la Belgique est en surbrillance : vous devez alors faire défiler la liste des réponses possibles et cliquer sur "Belgique". Une fois cliqué, l'élément en surbrillance sera coloré en fonction de la réponse (vert si correct, rouge si incorrect) et vous passerez au suivant. Voici un exemple de quiz Carte.
Vous pouvez décider de procéder selon l'ordre de mise en surbrillance prédéfini par l'auteur du quiz (Ordre fixé) ou de procéder dans un ordre aléatoire à l'aide du menu déroulant au-dessus de la carte.
La particularité qui donne le nom aux quiz "Click Map" en anglais est qu'en plus de procéder dans l'un des deux ordres, on peut aussi cliquer librement sur un élément de la carte pour le mettre en surbrillance. Vous pouvez aussi utiliser les flèches à l'écran pour faire défiler les paths en surbrillance, et ainsi sauter les réponses qui vous posent problème et prendre le quiz dans l'ordre que vous souhaitez.
Notez que les réponses peuvent être triées, dans l'éditeur de quiz, soit par ordre alphabétique, soit par ordre numérique selon votre type de réponse.
Enfin, sachez qu'il existe des raccourcis clavier pour prendre les quiz Cartes sans utiliser la souris :
La première chose que vous aurez peut-être remarqué à propos de ce type de quiz est que leurs noms suivent majoritairement un certain schéma. En anglais, il est très courant d'ajouter "Map Quiz" au nom du quiz, par exemple "Europe Map Quiz". En français, la règle est d'ajouter "- Carte quiz" à la fin du titre du quiz, par exemple "Villes de France - Carte Quiz". Il est fortement conseillé de suivre ces règles afin de signaler aux utilisateurs qu'il s'agit d'un quiz Carte.
Passons à la création proprement dite du quiz. L'étape 1 (Step 1) du créateur de quiz est semblable à celle des autres types de quiz. On retrouve la possibilité de créer un quiz aléatoire comme pour les quiz textuels, dans le volet "More Options". Dans ce mode, les réponses sont tirées aléatoirement parmi une sélection de réponses de l'étape 2. Vous noterez que les quiz Carte offrent moins d'options que les quiz textuels dans ce domaine et que l'option "Yellow Box" est bien évidemment absente pour les quiz Cartes.
À l'étape 2, vous remarquerez qu'il n'est pas possible d'ajouter des colonnes : elles sont prédéfinies car ce type de quiz nécessite uniquement des réponses associées à des paths, sans indices supplémentaires. La première colonne est réservée à l'id et aux classes tandis que la seconde est réservée aux réponses. Voici comment vous devez procéder pour créer un quiz :
Toujours à l'étape 2, des options avancées vous sont proposées sous "Advanced". Par exemple, vous pouvez effectuer un tri automatique (option "Order Answers") soit par ordre alphabétique/numérique avec le choix "Sort" ou effectuer tri aléatoire pour vous assurer que vos réponses ne soient pas dans l'ordre alphabétique ("Shuffle"). Vous pouvez également traduire automatiquement des réponses depuis l'anglais vers une autre langue proposée par JetPunk ou encore importer ou exporter des réponses comme dans les quiz textuels. Comme il s'agit de fonctionnalités avancées, elles ne sont recommandées qu'aux utilisateurs expérimentés.
Passons maintenant à l'étape 3.
Dans cette troisième étape, vous pouvez ajouter votre SVG en cliquant sur le bouton jaune habituel. Si vous ne savez pas comment ajouter un SVG à un quiz, consultez la première partie de cette section, "Ajouter un SVG à un quiz".
Vous trouverez également plusieurs options qui concernent le design du quiz :
Une fois ces réglages effectués, vous pouvez prévisualiser votre quiz avant de le publier. Si vous êtes satisfait de l'ordre des réponses et de l'apparence du quiz, vous pouvez soumettre votre quiz. Félicitations : vous avez maintenant créé votre premier quiz Carte !
Vous avez sans doute déjà remarqué la présence de flèches, ou de cercles, désignant des réponses dans certains quiz Cartes. Vous pouvez, vous aussi, ajouter cette petite touche visuelle très simplement à vos quiz !
Le cercle est une fonction automatique pour tous les quiz, appelée "city-selector" (sélecteur de ville). Si vos paths sont des cercles ou des ellipses, un cercle city-selector sera généré automatiquement autour d'eux. Vous n'avez donc pas besoin de les ajouter manuellement. Cette fonctionnalité est particulièrement utile pour les villes (d'où son nom), très souvent représentées par des cercles sur les cartes, voire pour la localisation de micro-états. Voici un exemple de quiz Carte dans lequel les villes, représentées par des ronds, possèdent les cercles "city-selector" :
L'ajout des flèches est légèrement plus complexe, mais reste accessible à tous. Voici un exemple de flèche :
Pour ajouter une flèche comme celle-ci, l'option la plus simple est de télécharger le SVG standard de l'Afrique, qui contient déjà ces flèches. Ainsi, vous n'aurez pas à les redessiner. Voici les conditions pour que l'affichage des flèches fonctionne correctement :
Et c'est tout ! Tant que la flèche partage la classe avec le path à pointer et qu'elle possède la classe "map-hidden", tout fonctionnera comme prévu. Vous pouvez également créer vos propres flèches ou laisser libre court à votre imagination en créant d'autres formes tant que vous suivez les étapes 1 et 2 ci-dessus. Toutefois, n'oubliez pas que le plus souvent, la sobriété est préférable.
Dans cette section, nous aborderons les connaissances de base en CSS pour faire interagir JetPunk avec vos cartes. Nous explorerons également certaines fonctionnalités avancées d'Inkscape, pour vous permettre d'améliorer le rendu de vos SVG.
Avertissement avant d'aller plus loin : l'abus de CSS sur JetPunk, qui affecterait le contenu en dehors de vos SVG n'est pas toléré. En d'autres termes : ne faites rien de stupide, où dont vous n'êtes pas sûr à 100% !
Passons au CSS. CSS est l'acronyme de Cascading Style Sheets, ou "Feuilles de style en cascade". En un mot, retenez que le CSS est un outil qui permet de gérer les styles de pages Web. Pour nos besoins, l'utilisation de CSS permet la personnalisation des styles des SVG. Sur les pages Web, le code CSS est placé entre balises de style, qui ressemblent à ceci : <style>. Ces balises permettent au CSS de fonctionner sans afficher le texte contenu entre elles, de sorte que vous ne voyez pas le code mais uniquement ses effets.
Appuyons-nous sur un exemple : supposons que vous vouliez que les bonnes réponses d'un quiz textuel avec SVG deviennent bleues au lieu du vert habituel. Pour ce faire, nous devons utiliser le code suivant :
À présent, décortiquons cette ligne :
Donc, dans l'ensemble, vous avez peut-être déjà compris qu'il y a deux choses principales à considérer dans le CSS : les sélecteurs et les styles. Chaque style possède un nom et une valeur, et ils peuvent être chaînés de la manière suivante :
Les sélecteurs sont une source de confusion courante pour les développeurs. Si vous souhaitez en savoir plus sur ce sujet, vous trouverez de nombreux didacticiels et explications (en anglais) sur le W3Schools CSS Selectors Reference, ou encore sur la page de Référence CSS, proposée par MDM Web Docs (en français).
Voici les sélecteurs importants pour JetPunk :
Concernant les styles, voici les "noms" de ceux les plus couramment rencontrés sur JetPunk :
Voici donc les styles les plus courants que vous pouvez retenir pour vos SVG. Rappelez-vous que les couleurs peuvent être exprimées par un mot-clé ou par un code hexadécimal précédé d'un dièse #. N'oubliez pas non plus que, pour la plupart des styles de couleur, vous aurez besoin de l'attribut "! Important" après la valeur pour vous assurer de remplacer le style existant.
Enfin, n'oubliez pas que tous les styles CSS doivent être compris entre une balise ouvrante <style> et une balise fermante </style>. Sans ces balises, vos changements ne s'appliqueront pas.
La liste suivante vous est donnée dans la section Foire aux questions, mais elle pourrait vous être utile ici aussi. Voici donc les couleurs et classes standards, utilisées par JetPunk :
Il existe également des classes qui contrôlent des fonctionnalités particulières sur JetPunk, ce qui peut vous être utile pour modifier l'apparence ou les caractéristiques de vos quiz.
Si vous avez lu les premiers paragraphes de cette section, vous devriez pouvoir commencer à tirer parti du CSS. Mais, voyons quelques exemples pour mettre en application ces notions.
Tout d'abord, quelques informations générales. Les lignes de CSS que vous souhaitez ajouter peuvent être écrites n'importe où dans le quiz. Néanmoins, il est d'usage et recommandé de les écrire dans les instructions. L'important est, comme dit précédemment, d'écrire ces lignes dans une balise <style>.
Lorsque vous sélectionnez une classe dans un quiz texte SVG, vous devez toujours inclure ".svg-holder" au début, séparé des autres classes par un espace, pour vous assurer que vous remplacez correctement les styles. Sans ce sélecteur, votre ajout de styles ne fonctionnera pas. De même, dans les quiz Cartes, vous devez utiliser la classe ".map-holder".
Passons maintenant aux exemples. Notez que nous utiliserons le code #HEX pour indiquer une valeur de couleur générique. Pour essayer ces exemples, copiez-les et collez-les simplement dans votre quiz, en remplaçant #HEX par le code couleur de votre choix.
Ce sont les exemples les plus courants, que l'on retrouve dans de nombreux quiz. En voici quelques autres, plus atypiques, qui pourraient néanmoins vous servir :
Vous remarquerez que ce dernier exemple tire parti d'une propriété particulière : la visibilité des paths (visibility). Cela vient de la façon dont JetPunk gère la classe .svg-hidden. La valeur contraire de "visible" est "hidden".
Dans cette section, nous allons aborder la conversion d'objets sur Inkscape. Pour commencer, voici deux exemples de situations concrètes que vous pourriez rencontrer :
Pour faire face à ces situations, nous allons utiliser l'outil "Objet en chemin" qui, comme son nom l'indique, va permettre de convertir un objet qui n'est pas un chemin en chemin.
À ce stade, il est bon de revenir sur la différence entre chemins et objets. En fait, les formes créées à l'aide d'outils, tels que les rectangles, les cercles ou les textes, sont des objets possédant des propriétés spécifiques, et sont enregistrés dans le fichier SVG en tant que tels. Un chemin, en revanche, est un terme plus générique. En convertissant un cercle en chemin, il continuera à avoir la forme d'un cercle, mais en perdra ses propriétés intrinsèques (rayon, coordonnées...). Le SVG lui-même (et par conséquent JetPunk) n'aura plus moyen de savoir que le chemin a l'apparence d'un cercle. En convertissant un objet, vous perdrez donc ses propriétés mais vous pourrez éditer librement le chemin généré.
Revenons à l'outil de conversion. Celui-ci est très facile d'utilisation, puisqu'il suffit de sélectionner l'objet que vous souhaitez convertir, puis d'aller dans "Chemin" dans la barre de menus et de cliquer sur "Objet en chemin". Notez que les chemins ainsi générés peuvent être regroupés, en particulier si vous avez converti du texte. Pour les dissocier, faites simplement un clic droit sur le groupe et cliquez sur "Dégrouper".
Un autre outil pratique est celui de conversion de "Contour en chemin". Il peut vous être utile si vous voulez modifier librement les bords d'une forme, sans vous soucier de son épaisseur de trait, ou si vous souhaitez que des tracés libres (et sans fond) effectués sur Inkscape se colorent lorsqu'une réponse est devinée dans un quiz. Cette méthode est utilisée par exemple dans les quiz sur les fleuves ou encore les cartes de lignes de métro.
Pour convertir un contour en chemin, sélectionnez simplement un chemin possédant un contour mais pas de fond, puis allez dans "Chemin" dans la barre de menus et cliquez sur "Contour en chemin".
Les deux outils présentés ici sont "Combiner" et "Union" qui permettent, chacun à sa façon, de fusionner des chemins. Ces outils ont des effets différents, à choisir en fonction ce que vous voulez créer. Commençons par "Combiner".
L'outil "Combiner" se trouve sous "Chemin" dans la barre de menus (raccourci clavier Ctrl+K sur Windows ou Cmd+K sur Mac). Cet outil ne fait que combiner tous les chemins sélectionnés en un seul chemin.
Cela signifie que si deux chemins se chevauchent, ils continueront à se chevaucher même après avoir été combinés. Par ailleurs, le chemin combiné héritera des couleurs d'un seul des chemins, car un chemin ne peut contenir qu'une couleur pour le remplissage et une pour le contour.
En revanche, l'outil "Union", toujours sous "Chemin" dans la barre de menus, fait bien plus que combiner des chemins (raccourci clavier Ctrl++ sur Windows ou Cmd++ sur Mac). Cet outil fusionnera complètement les chemins sélectionnés, en supprimant également les nœuds qui se chevauchent. Autre conséquence : en joignant deux chemins qui ne possèdent que des contours, Inkscape essaiera de les connecter s'ils ne sont pas fermés. Au final, cet outil permet de générer un seul chemin global à partir de plusieurs tracés, sans parties superposées.
Voici un exemple pour illustrer la différence entre ces deux outils. Supposons que nous ayons tracé deux cercles qui se chevauchent :
En utilisant l'outil "Combiner", on obtient :
En utilisant l'outil "Union", on obtient :
Comme vous pouvez le voir, les deux outils produisent des résultats différents. "Combiner" donne deux tracés circulaires, contenu dans une même balise "path"; Inkscape les traite donc comme un seul chemin. "Union", en revanche, génère un chemin unique qui ressemble vaguement à une cacahuète.
Remarque : lors d'une "Union" de deux pays voisins sur une carte, il se peut que leurs frontières ne soient pas parfaitement alignées, ce qui génèrerait des nœuds résiduels au milieu du chemin résultant. Ces nœuds étant superflus, vous pouvez les supprimer manuellement à l'aide de l'éditeur de nœuds, représenté par cette icône :
Sélectionnez les nœuds inutiles et supprimez-les un à un pour avoir un tracé le plus propre (et le plus léger) possible.
Dans cette partie, nous traiterons de différentes façons de couper des chemins. Si vous cherchez à diviser un chemin en plusieurs parties, plutôt que d'en découper un morceau, la sous-section suivante vous sera plus utile.
Les outils dont nous parlerons ici sont "Différence" et "Intersection", tous deux sous "Chemin" dans la barre de menus. Ces deux outils ont, en un sens, des fonctions opposées : voyons pourquoi.
Commençons par la "Différence" : cet outil va prendre deux chemins, et "couper" toute partie du chemin du dessous en intersection avec le chemin du dessus. Cette fonction peut être utilisée pour créer des anneaux, à partir de cercles concentriques par exemple.
L'outil "Intersection", lui, fait l'inverse de ce que nous venons de voir : il prend deux chemins et ne conserve que les parties communes aux deux (leur intersection).
Remarque : les outils "Différence" et "Intersection" fonctionnent avec au moins deux chemins. Mais pour plus de simplicité, nous vous recommandons de vous limiter à deux chemins, en particulier pour la "Différence" dont le fonctionnement devient vite hasardeux. Par ailleurs, faites attention à l'ordre dans lequel sont positionnés les chemins (lequel est au-dessus).
Voyons un exemple d'utilisation de l'outil "Différence" : la création d'un anneau à partir de cercles, comme mentionné précédemment. Pour ce faire, commençons par dessiner un cercle avec l'outil d'ellipse tout en maintenant la touche ctrl enfoncée. Puis, pour créer un cercle concentrique, nous allons copier notre premier cercle et le "coller sur place" avec les commandes Ctrl+C, puis Ctrl+Alt+V (où leurs équivalents avec Cmd sur MacOS). Vous pouvez aussi trouver l'option de collage sur place sous "Édition" dans la barre de menus.
Vous obtenez ainsi deux cercles identiques. Pour réduire la taille du second cercle, vous pouvez le redimensionner "en place" en maintenant la touche Ctrl enfoncée (pour conserver l'aspect circulaire) tout en maintenant également la touche shift enfoncée pour le redimensionner depuis le centre de l'objet. Après avoir changé la couleur de ce second cercle, vous devriez obtenir quelque chose de ce genre :
Sélectionnez ensuite les deux cercles, en veillant à ce le plus petit (bleu ici) soit au-dessus du plus grand (rose dans notre exemple). Allez ensuite dans "Chemin", et sélectionnez "Différence". Le résultat obtenu sera égal au cercle rose auquel on a soustrait l'emprise du cercle bleu, ne laissant qu'un anneau rose :
C'est probablement l'utilisation la plus utile de l'outil "Différence", en particulier pour JetPunk.
Passons maintenant à "Intersection". Cet outil est utile lorsque vous souhaitez modifier une carte préexistante qui possèdent de nombreux chemins dont vous n'avez pas besoin. Voyons un exemple. Supposons que vous ayez téléchargé le SVG standard de l'Europe et que vous l'ayez redimensionné dans le but de créer une carte de la France métropolitaine et ses pays environnants. Dans ce cas, vous auriez beaucoup de chemins inutiles. Dans l'exemple d'image ci-dessous, la bordure de la page est colorée en rouge et s'affiche au-dessus du dessin (vous pouvez modifier ces options à partir des "Propriétés du document").
La première étape consiste à supprimer manuellement tous les paths qui sont totalement hors de la bordure de page, en les sélectionnant puis en appuyant sur la touche Suppr. Vous pouvez aussi redimensionner le rectangle bleu matérialisant l'océan pour qu'il corresponde à la taille de la page. Cliquez sur l'océan, et changer les valeurs de ses dimensions et de ses coordonnées dans l'éditeur d'objet :
Idéalement, vous devriez régler les coordonnées X et Y à 0,000, de manière à placer le coin supérieur gauche du chemin de l'océan dans le coin supérieur gauche de la page. "L" et "H" représentent respectivement la largeur et la hauteur du chemin de l'océan. Dans ce cas, vous devez définir "L" et "H" égales aux dimensions de la page, que vous trouvez dans les propriétés du document (120 x 120px dans le cas présenté ici). Une fois les paths supprimés et ces réglages effectués, vous devriez obtenir quelque chose comme ceci :
Nous allons maintenant utiliser l'outil "Intersection". Premièrement, nous allons copier/coller sur place le chemin de l'océan, qui se retrouvera ainsi au-dessus des autres chemins. Nous allons ensuite appliquer l'intersection individuellement à chaque pays dont la forme déborde de la page. C'est pour cette raison qu'il est particulièrement important que le chemin de l'océan soit parfaitement aligné avec la page.
À chaque fois que vous allez appliquer l'intersection entre un chemin et une copie de l'océan, cette copie disparaît. C'est pourquoi il est recommandé de copier/coller le chemin de l'océan plusieurs fois dès le début. Rappelez-vous également que pour qu'Intersection fonctionne comme souhaité, les copies de l'océan doivent être au-dessus des autres chemins. En sélectionnant par exemple le Royaume-Uni et l'un des exemplaires de l'océan (sélection multiple en maintenant Maj enfoncé), vous obtiendrez :
En appliquant l'Intersection, on obtient le résultat suivant :
Il faut savoir que l'outil "Intersection" supprime toutes les classes des chemins coupés. Puisque JetPunk utilise des classes pour colorer les chemins, il est probable que les chemins coupés aient perdu leurs valeurs de fond/contour. Nous y reviendrons plus tard, pour le moment nous répétons les étapes précédentes à chaque pays qui déborde partiellement des limites de la page. Le résultat des intersections successives devrait ressembler à ceci :
Enfin, dans le cas où les chemins seraient devenus noirs après intersection, vous pouvez modifier leurs couleurs directement depuis l'écran "Fond et contour", ou alors en ajoutant les classes "country" et "border" à chaque chemin si vous éditez un SVG Standard. Il est également possible d'ajouter la classe "surronding" au lieu de "country" pour donner aux pays avoisinant une couleur grise. Finalement, vous devriez obtenir le résultat suivant :
Cet exemple vous aura montré une utilisation concrète de l'outil "Intersection", très utile pour la création de cartes personnalisées pour JetPunk.
La dernière fonction dont nous parlerons dans cette section est la "Division", toujours sous "Chemin" dans la barre de menus. Cet outil permet de diviser un chemin en plusieurs parties, à partir d'une ligne symbolisant le trait de coupe.
Cet outil fonctionne exclusivement avec deux tracés dont l'un doit être un trait, c'est-à-dire un tracé unidimensionnel droit ou courbe. Tout ce que vous avez à faire est de tracer une ligne avec le stylo ou le crayon à l'endroit où vous souhaitez que le chemin soit coupé. Voici un exemple :
Ici, nous avons un chemin que nous voulons diviser (en bleu), au-dessus duquel une ligne ouverte est tracée avec le stylo (tracé rouge). Sélectionnez les deux, cliquez sur "Chemin" dans la barre de menus, puis "Division". Le résultat obtenu est le suivant :
Le chemin a bien été coupé en deux en suivant la ligne tracée. Pour mieux visualiser ce qui s'est passé, sélectionnez un seul des deux chemins résultants et essayez de le déplacer :
La chose dont vous devez vous souvenir lorsque vous utilisez cet outil est que les extrémités du trait indiquant où couper (en rouge dans l'exemple précédent) doivent être en dehors du chemin que vous souhaitez diviser. Si l'une des extrémités se trouve à l'intérieur du chemin, la division ne fonctionnera pas.
Trouvez les réponses aux questions fréquentes concernant les SVG sur JetPunk. Si vous cherchez de l'aide sur Inkscape en général, rendez-vous sur la page Fonctionnalités avancées. Si vous ne trouvez pas de réponse à votre problème ici, tentez votre chance dans la rubrique Aide au dépannage.
De nombreux quiz avec SVG se sont révélés difficilement lisibles voire incompatibles avec le Mode sombre, introduit en septembre 2021 sur JetPunk. Si vous utilisez un SVG standard de JetPunk pour votre quiz, vous n'avez rien à modifier car celui-ci sera mis à jour automatiquement. Cependant, si vous utilisez une carte personnalisée, vous devrez ajuster les paramètres de votre SVG manuellement.
Si vous utilisez une carte similaire à un SVG standard, comprenant les classes "country", "light-water", etc, vous pouvez simplement ajouter "jetpunk-svg" comme classe à l'objet SVG. Pour cela, il suffit d'ouvrir le SVG dans un éditeur de texte (Notepad, par exemple) et d'ajouter, à la fin du tag "<svg":
Exemple de la première ligne de la carte du monde JetPunk :
Cette classe permet la mise à jour des couleurs standards suivantes, lors du passage en Mode sombre (tout le reste n'est pas affecté) :
Malheureusement, non. Inkscape n'est actuellement disponible que pour une installation sur ordinateur. Toutefois, certains éditeurs en ligne fonctionnent sur mobile mais ils offrent généralement beaucoup moins de fonctionnalités qu'Inkscape.
Cependant, vous pouvez utiliser sur mobile comme sur ordinateur les SVG standards proposés par JetPunk en les sélectionnant depuis le sélecteur SVG. Vous ne pourrez simplement pas les modifier.
Il existe de nombreuses façons de trouver des SVG sur internet, mais veillez à ne pas voler les créations de quelqu'un d'autre, qui peuvent être protégées par le droit d'auteur. Voici quelques sources pour trouver des SVG :
Il est important de souligner que le dessin de cartes par retraçade des contours peut demander beaucoup d'efforts pour un résultat lourd et parfois de qualité moyenne. Avant de vous lancer dans ce genre de travail, il est donc grandement conseillé de chercher sur Wikimedia si une carte libre de droit existe pour l'utiliser directement.
Un SVG doit peser moins de 600 kb pour être chargé sur JetPunk.
Il ne doit pas non plus dépasser 830 pixels de large sur 600 pixels de haut. Si vous rencontrez des difficultés pour charger votre fichier sur JetPunk, vous pouvez lire la rubrique Aide au dépannage.
Ce point a déjà été traité dans la section Les SVG sur JetPunk ainsi que dans les Fonctionnalités avancées. Mais puisqu'il s'agit d'une question fréquemment posée, reprenons cela ici.
Voici les deux principales façons de faire se colorer deux chemins distincts avec une seule réponse :
La première méthode est utile si vous n'avez pas de scénarii qui nécéssitent d'avoir deux chemins séparés. Par exemple, si dans votre quiz il n'y a jamais une occasion où un seul des deux chemins doit se colorer, alors ceux-ci peuvent être combinés. Pour plus d'informations sur la manière de combiner des chemins, consultez la section Fonctionnalités avancées.
La seconde méthode est sans aucun doute l'option la plus "puissante", puisqu'elle permet de colorer l'un, ou l'autre, ou même les deux chemins simultanément. Pour ce faire, il faut utiliser les classes. Voici une brève explication sur ce point :
Connaissant ces informations, on voit qu'il suffit de donner la même classe à deux chemins et de saisir cette classe dans la première colonne de gauche à l'étape 2 pour les faire se colorer à partir d'une même réponse.
Voyons maintenant un exemple concret. Prenons les capitales de l'Afrique du Sud. Dans le SVG standard JetPunk des capitales d'Afrique, on trouve :
Il existe donc trois capitales distinctes pour l'Afrique du Sud selon l'usage sur JetPunk. Cependant, dans certains quiz (ex : Capitales du Monde - Quiz) on peut souhaitez que la saisie d'une seule de ces trois capitales suffise pour valider la réponse de l'utilisateur, et ainsi colorer trois cercles sur la carte. Mais comment faire puisque ces chemins ont chacun un identifiant distinct ?
Eh bien, comme nous l'avons vu dans la section "Les SVG sur JetPunk", chacun de ces cercles se voit attribué la classe "za-c", car la carte standard suit les conventions de JetPunk sur les noms de classe et d'id. C'est précisément cette classe qui nous permet d'éclairer les trois capitales sur la carte à partir d'une seule réponse. Dans ce cas, si nous avions combiné les trois chemins, ils auraient perdu leurs propriétés de cercles et l'adaptation de leurs tailles avec le zoom ne fonctionnerait plus.
Ainsi, en tapant "za-c" dans la colonne de gauche de l'étape 2 de l'éditeur, et "Bloemfontein | Le Cap | Pretoria" dans la case de réponse correspondante, alors les trois cercles se coloreront en vert à la saisie de n'importe laquelle de ces trois capitales. Notez que le caractère "|" agit comme un "ou", et génère automatiquement les type-ins individuels pour chacune des réponses.
Et voilà ! J'espère que cet exemple pratique vous aura aidé à mieux comprendre l'utilisation des classes sur JetPunk. N'hésitez pas à essayer vous-même d'autres combinaisons en utilisant des SVG standards.
Un type de carte populaire est la "carte vierge", comme pour ce quiz Pays du monde avec une carte vierge. Mais comment créer une telle carte ?
C'est en fait assez simple : premièrement, ouvrez la carte que vous souhaitez avec Inkscape. Sélectionnez tous les chemins et changez la couleur de fond des chemins en blanc, puis supprimez les contours en allant dans "Style de contour" et en définissant une épaisseur à 0. Maintenant, si vous utilisez un SVG standard, il est nécessaire de "bloquer" les classes qui colorent automatiquement les chemins, comme "country" et "border".
Pour cela, ouvrez l'éditeur XML d'Inkscape et cherchez le nœud "svg:style", situé dans les premières lignes. Si votre SVG ne contient pas ce nœud, vous pouvez sauter cette étape. Si ce nœud est présent, sélectionnez le texte contenu à l'intérieur. Il se peut que vous deviez cliquer sur le triangle ou le + à gauche du nœud pour le développer et ainsi accéder au nœud texte à l'intérieur. Vous devriez alors voir cet écran :
Effacez la valeur de l'attribut "content", en supprimant le texte et en validant avec la touche Entrée. Vous obtenez :
Et c'est fini ! Vous obtenez une carte vierge fonctionnelle.
Heureusement, cela peut être fait aisément en utilisant la classe intégrée à JetPunk, "svg-hidden". Cette classe masque automatiquement le chemin jusqu'à ce qu'il soit deviné. Le moyen le plus simple d'ajouter ce paramètre est d'aller dans les Options SVG du créateur de quiz et d'activer l'option "Hidden Paths". De cette façon, vous cacherez les chemins de toutes les réponses jusqu'à ce qu'elles soient devinées. Cette option est également compatible avec les quiz aléatoires.
Cependant, cette option n'est pas compatible avec les quiz Cartes (Click Map).
Si vous souhaitez uniquement masquer certains chemins, vous pouvez ajouter manuellement la classe "svg-hidden" à ces chemins dans Inkscape. Nous avons expliqué précédemment comment ajouter une classe à un chemin. Voici un rappel : ouvrez l'éditeur XML sous "Édition" dans la barre de menus et sélectionnez le chemin désiré. S'il ne possède pas déjà de classe, ajouter un attribut en cliquant sur le + et saisissez le texte suivant :
Si votre chemin possède déjà un attribut de classe, ajoutez à sa valeur "svg-hidden", séparé des classes existantes par un espace :
En ajoutant cette classe aux chemins souhaités, JetPunk les cachera automatiquement jusqu'à ce qu'ils soient devinés.
Ne réglez pas l'opacité de votre chemin sur 0 depuis Inkscape; JetPunk supprime automatiquement tous les chemins transparents lors du chargement du SVG.
Si vous voulez faire l'inverse de ce que nous venons de voir, c'est-à-dire faire disparaître le chemin une fois que vous avez deviné la réponse correspondante, il suffit d'utiliser un peu de CSS. Tout ce que vous avez à faire est d'ajouter le code suivant dans les instructions du quiz. Puisqu'il est entouré de balises <style>, le code ne sera pas affiché comme du texte dans le quiz.
Analysons brièvement cette ligne de CSS : tout d'abord nous sélectionnons le conteneur "svg-holder", à l'intérieur duquel nous sélectionnons les chemins ayant la classe "svg-correct", que JetPunk attribue automatiquement à un chemin lorsque la réponse correspondante est devinée. Nous modifions ensuite la propriété de style "opacity", que nous rendons égale à zéro. Au final, nous obtenons que tout chemin correspondant à une réponse correcte verra son opacité réglée à zero (et sera donc non visible).
Si vous souhaitez masquer les mauvaises réponses au lieu des bonnes, par exemple pour vous assurer qu'après le quiz l'utilisateur ne voit que celles qu'il a dévinées, il suffit de remplacer ".svg-correct" par ".svg-incorrect". Si en revanche vous souhaitez masquer à la fois les bonnes et les mauvaises réponses, vous pouvez copier ce code :
Cette ligne de code ne fonctionnera que sur les quiz textuels. Si vous souhaitez modifier les quiz Cartes (Click Map), vous devez remplacer "svg" par "map" dans les différentes classes, par exemple "map-correct" et "map-holder".
Il s'agit là de CSS de base. Si vous voulez en savoir plus, rendez-vous sur la section Fonctionnalités avancées de ce Guide.
Si les contours des chemins de votre SVG, par exemple les frontières sur une carte, sont gros et inesthétiques lorsque vous zoomez, sachez qu'il existe une solution très simple pour corriger ce vilain défaut : il suffit d'ajouter la classe "border" aux chemins souhaités. Pour voir comment ajouter une classe à un chemin, voir la rubrique ci-avant : "Comment cacher un chemin jusqu'à ce qu'il soit deviné ?".
Si vous utilisez déjà la classe "zoomable-circle" pour un chemin, vous n'avez pas besoin d'ajouter la classe "border" : ces deux classes héritent de la classe "small-stroke". C'est en fait cette dernière qui ajuste l'épaisseur des contours.
Si votre SVG contient des cercles ou des ellipses, il peut être pratique de les faire rétrécir lors d'un zoom avant. C'est une chose courante, par exemple, dans les quiz sur les villes, où l'utilisateur peut ainsi voir plus précisément la position de la ville sur la carte en zoomant.
Pour créer cet effet, il vous suffit d'ajouter la classe "zoomable-circle" au cercle (ou ellipse) que vous souhaitez rétrécir. Si vous ne savez pas comment ajouter des classes aux chemins, consultez la rubrique "Comment cacher un chemin jusqu'à ce qu'il soit deviné ?".
Notez que la classe "zoomable-circle" réduit également l'épaisseur des contours du chemin. Vous n'avez donc pas besoin d'ajouter également la classe "border" à votre cercle.
Pour redimensionner un chemin tout en conservant ses proportions (ratio), maintenez la touche Ctrl enfoncée et faites glisser l'une des flèches qui apparaissent aux coins lorsque vous sélectionnez le chemin. Les flèches ressemblent à ceci :
Maintenir Ctrl enfoncé verrouille le rapport d'aspect du chemin, et garantit que les proportions du chemin restent les mêmes.
Cela peut entraîner une mauvaise mise à l'échelle de l'épaisseur des contours. Dans ce cas, vous pouvez modifier manuellement l'épaisseur du contour à partir de l'onglet "Style de contour" de la fenêtre "Fond et contours".
Si vous voulez affecter des dimensions précises à votre chemin, vous pouvez saisir la largeur et la hauteur du chemin directement dans la barre de l'éditeur d'objets, juste en dessous de la barre de menus. Cliquez sur l'icône de verrouillage (cadenas) pour figer le rapport d'aspect, et ainsi toute modification de largeur ou de hauteur affectera l'autre proportionnellement.
Voici la liste des couleurs standards utilisées par JetPunk. Si certaines descriptions vous sont inconnues, consultez la section Fonctionnalités avancées pour plus de détail. Toutes les couleurs sont données sous la forme d'un code RVB hexadécimal (sur Inkscape, ajoutez "FF" à la fin du code hex dans le champ RVBA).
Ce sont les couleurs les plus utilisées dans les cartes standards de JetPunk. Vous trouverez ci-dessous les couleurs qui sont attribuées par les classes lors d'un quiz.
Si vous rencontrez un problème avec un SVG, vous trouverez certainement une solution ici. Pour obtenir de l'aide sur des sujets plus généraux, vous pouvez également essayer la Foire aux questions.
Lors du chargement d'un SVG sur JetPunk, il se peut que vous rencontriez des messages d'erreur si votre SVG n'est pas formaté correctement. Trouvez votre message d'erreur dans la liste ci-dessous et suivez les étapes pour résoudre le problème :
Invalid parameters (Paramètres non valides)
Cela se produit généralement lorsque vous ne sélectionnez pas de fichier à charger, ou sélectionnez plusieurs fichiers ou encore sélectionnez un mauvais fichier. Essayez de recharger la page et choisissez à nouveau le SVG que vous souhaitez charger.
Exceeded filesize limit (Limite de taille de fichier dépassée)
Cela signifie que vous avez essayé de télécharger un fichier dont le poids est supérieur à la valeur limite supportée par JetPunk, qui est de 2 Mb. Il est très rare qu'un SVG pèse autant, mais si c'est effectivement le cas alors cela signifie qu'il est beaucoup trop riche et détaillé. Dans tous les cas, consultez la sous-section suivante pour obtenir des conseils sur la façon de réduire le poids du fichier.
Exceeded filesize limit of 600 kilobytes (Limite de taille de 600 kb dépassée)
Contrairement à l'erreur précédente, votre fichier a été téléchargé sur JetPunk mais il dépasse la limite fixée de 600 kb. Cette limite a été fixée pour ne pas surcharger les serveurs JetPunk avec des SVG trop lourds, et également limiter les ralentissements lors de l'ouverture du quiz. Encore une fois, passez à la sous-section suivante pour obtenir des conseils sur la façon de réduire le poids de votre SVG.
Uploaded file does not contain valid XML markup (Le fichier chargé ne contient pas de balise XML valide)
Cela se produit généralement lorsque vous avez tenté de télécharger un fichier qui n'est pas un SVG, ou si le SVG est corrompu. La façon la plus simple de résoudre ce problème est d'utiliser un validateur XML. Nous vous recommandons d'utiliser W3C Markup Validation. Cet outil vérifiera si votre SVG est corrompu, il vous indiquera pour quelle(s) raison(s) et comment y remédier. N'oubliez pas qu'un SVG n'est finalement qu'fichier texte, donc si vous ne pouvez pas l'ouvrir avec Inkscape, vous pouvez toujours utiliser un éditeur de texte.
Error processing SVG file (Erreur lors du traitement du fichier SVG)
Tous les SVG téléchargés sur JetPunk sont compressés à l'aide d'un outil appelé "svgo". Cet outil épure et allège considérablement votre fichier, mais il peut également générer des erreurs s'il trouve quelque chose qui lui déplaît dans la structure du fichier. Malheureusement, si vous voyez cette erreur, cela signifie que quelque chose s'est mal passé lors de cette compression, et il n'y a aucun moyen de savoir quoi en particulier. Il s'agit d'une erreur qui ne se produit que très rarement, mais si c'est le cas vous pouvez essayer d'appliquer les autres correctifs mentionnés dans cette section, qui résoudront très certainement votre problème.
Unable to find SVG tag at the start of the file (Balise SVG introuvable au début du fichier)
Cela se produit lorsque votre SVG ne contient pas de balise "<svg" au début du fichier après compactage par svgo. Cela ne devrait pas arriver, mais si vous rencontrez cette erreur, ouvrez le SVG avec un éditeur de texte et supprimez tout ce que vous voyez écrit avant la balise "<svg".
Unable to find height / width attribute in SVG tag. Make sure it is in pixels. (Impossible de trouver la hauteur/largeur dans la balise SVG)
Cela se produit si les unités du fichier ne sont pas en pixels, ou si la largeur et/ou la hauteur du document n'ont pas été renseignées en attribut. Dans la plupart des cas, cela est lié à l'unité choisie, alors ouvrez le SVG dans Inkscape, allez dans les propriétés du document et changez les deux unités de mesure en pixels ("px"). Une fois cela fait, assurez-vous que le document ne dépasse pas 830px en largeur et 600px en hauteur afin de ne pas avoir un autre message d'erreur.
SVG exceeded the maximum size of 830 pixels wide or 600 pixels high (Le SVG dépasse 830 pixels en largeur ou 600 pixels en hauteur)
L'erreur est explicite. Pour diminuer la taille du fichier, allez dans les propriétés du document et changez sa largeur et sa hauteur à 830px et 600px respectivement. Ensuite, vous devrez probablement réduire vos chemins pour qu'ils restent contenus à l'intérieur de la page. Pour savoir comment réduire des chemins tout en conservant leur rapport d'aspect, rendez-vous à la section Foire aux questions.
Unknown error (Erreur inconnue)
C'est l'erreur la plus malheureuse qui puisse se produire. Nous ne savons pas quoi, nous ne savons pas où, mais quelque chose s'est mal passé lors du chargement. La seule option est de retenter de charger votre SVG et, si le message persiste, de vérifier la validité de votre fichier à l'aide de l'outil de validation de balises W3C Markup Validation.
Si votre SVG dépasse la limite des 600 kilobytes, vous pouvez essayer les méthodes suivantes pour réduire son poids :
Ces 3 dernières options renvoient à des outils de compression de fichiers SVG, en ligne. S'ils peuvent permettre de réduire considérablement la taille du fichier, ils peuvent aussi en affecter voire supprimer des identifiants de chemin ou des classes. Gardez donc toujours une copie de sauvegarde avant de les utiliser.
Ce problème peut avoir plusieurs explications. En voici une liste :
Si des parties de votre SVG ne sont pas visibles sur JetPunk, le problème est probablement que le dessin déborde partiellement de la page du document. Si vous ne voyez pas la bordure de la page, accédez aux propriétés du document et assurez-vous que l'option "Afficher la bordure de page" est bien cochée. Vous pouvez également changer la couleur de bordure à l'aide de l'option "Couleur de la bordure" et cochez "Bordure au-dessus du dessin". Ainsi, vous pouvez vous assurer que tout le dessin se trouve dans ces limites. Si ce n'est pas le cas, vous pouvez redimensionner votre dessin en sélectionnant tous les chemins et en ajustant leurs tailles en maintenant la touche Ctrl enfoncée pour conserver leur rapport de forme.
Il s'agit d'un vieux bug qui ne devrait plus se produire. Si vous rencontrez toujours des problèmes lorsque vous zoomez, procédez aux vérifications suivantes :
Une autre possibilité est qu'il y ait un problème avec la viewBox. "viewBox" (zone de vue) est un attribut du SVG qui indique au programme essayant de rendre l'image la taille à laquelle il doit la faire apparaître. Vous pouvez voir la valeur attribuée à la viewbox en ouvrant l'éditeur XML dans Inkscape et en sélectionnant la balise "svg:svg" :
Idéalement, la valeur de la viewBox dans l'éditeur doit être "0 0 L H", où "L" est la largeur de la page et "H" la hauteur, toutes deux en pixels. Dans les propriétés du document, vous pouvez également modifier la largeur et la hauteur de la viewBox (zone de vue), sous l'échelle. Enfin, dans le cas où votre document n'aurait pas d'attribut viewBox, vous n'êtes tout simplement pas concerné par cette solution.
Bien que ce bug de zoom ne soit plus censé se produire, ces deux explications sauront le corriger dans l'éventualité où il se produirait.
Il se peut que la police de caractères (fonte) que vous avez choisie pour un texte sur Inkscape se trouve modifiée lors du chargement de votre SVG sur JetPunk. Cela tient au fait que, à la différente d'Inkscape, les SVG simples traités par JetPunk ne stockent pas les polices. Ainsi, si vous avez utilisé une police particulière qui n'est pas reconnue par défaut par les navigateurs, le texte sera différent lors de son chargement.
La solution la plus simple est de changer la police en Helvetica ou Arial, reconnues par tous les navigateurs.
Une autre solution, si vous souhaitez conserver l'aspect "personnalisé" de votre texte, consiste à utiliser l'outil de conversion d'objet en chemin (sous "Chemin" dans la barre de menus). Cet outil convertira le texte en un groupe de chemins, avec un chemin pour chaque lettre. Pour fusionner ces chemins en un seul, séparez-les d'abord en faisant un clic droit sur le groupe et en cliquant sur "Dégrouper". Ensuite, en gardant toutes les lettres sélectionnées, cliquez sur "Combiner" sous "Chemin". De cette façon, le texte aura le même aspect sur JetPunk que sur votre SVG !
Notez que cette méthode entraîne la suppression des ids et classes préalablement définies pour l'objet texte. Il vous faudra donc les ressaisir manuellement pour le nouveau chemin. Par ailleurs, une fois le texte converti en chemin, rappelez-vous qu'il ne pourra plus être modifié avec l'outil texte.
Cette page est consacrée aux outils proposés par JetPunk, et en particulier le Dot Placer et la fonction Show Missing Dots.
Le Dot Placer, ou "Placeur de Points", est un outil qui permet d'ajouter des cercles dans le style de JetPunk aux SVG standard sans avoir à utiliser un éditeur comme Inkscape. Vous trouverez une brève explication en anglais sur la page dédiée à cet outil, mais nous vous proposons ici un tutoriel détaillé en français.
Premièrement, voyons les données nécessaires à l'utilisation de cet outil :
Dans la zone de texte de l'outil, vous devez saisir ces données séparées par une tabulation, afin de les délimiter en colonnes. Ne séparez pas les données avec des espaces, cela ne fonctionnera pas.
Vous pouvez également appliquer un style à tous vos points avant de les placer, grâce au sélecteur de style. La valeur par défaut du remplissage des ronds est #FF9900 (orange), comme c'est traditionnellement le cas sur les quiz JetPunk. L'opacité du fond est réglée à 70 % et le contour est noir uni, avec une épaisseur de 1 px. Ces valeurs sont celles par défaut, mais vous pouvez les personnaliser à votre guise.
La prochaine étape consiste à choisir le SVG standard qui fera office de fond de carte (Background). Vous avez le choix entre les cartes des différents continents, la carte du monde et celle des États-Unis, ainsi que deux autres cartes "bonus" qui sont des cartes vides utilisant différentes projections.
Une fois votre fond de carte choisi, cliquez sur "Draw Dots" (Dessiner les Points) puis téléchargez le SVG généré par l'outil. Il ne vous reste plus qu'à charger ce SVG dans votre quiz ! Les ids des cercles sont générés dans la zone de texte, où vous avez saisi vos données, en tant que cinquième colonne. Ainsi, vous pouvez aisément les collecter pour les ajouter à l'étape 2 (Step 2) du créateur de quiz, afin de colorer ces chemins lorsque les réponses sont trouvées.
Vous pouvez également télécharger la carte que vous souhaitez au préalable pour récupérer le SVG standard seul.
Remarque : si vous décidez de changer de fond de carte après avoir généré les cerles, ceux-ci seront supprimés. N'oubliez pas de cliquer à nouveau sur "Draw Dots" pour les générer sur la nouvelle carte choisie.
Cette fonctionnalité, que l'on pourrait traduire par "Afficher les points manquants", permet d'afficher ou masquer en un clic les points de repère sur un SVG. L'exemple d'utilisation le plus célèbre est bien entendu le quiz des Pays du monde, dans lequel les points indiquent les pays qui n'ont pas encore été devinés.
Pour activer cette fonctionnalité, accédez aux options SVG en cliquant sur le bouton jaune à l'étape 4 de la création d'un quiz textuel. Une fois le SVG chargé, choisissez "Yes" en face de l'option "Missing Dots". Deux nouvelles options apparaîtront, où vous pourrez modifier les textes affichés : "Show/Hide Missing Countries". En laissant ces options par défaut et si le quiz est correctement défini en Français alors JetPunk changera automatiquement ces textes en "Cacher/Révéler les pays manquants" (cela fonctionne pour toutes les langues proposées sur JetPunk). Si vous le souhaitez, vous pouvez néanmoins modifier ces textes selon votre envie.
Passons à la façon de dire à JetPunk où ces points doivent apparaître. Pour ce faire, passez à l'étape 2 et assurez-vous d'avoir au moins quatre colonnes. La première à gauche sera, comme d'habitude, réservée aux ids ou classes pour colorer les chemins. La deuxième et la troisième colonne doivent contenir les coordonnées en pixels de la position du point ; attention, dans ce cas il ne s'agit pas des coordonnées géorgaphiques, mais des coordonnées sur le SVG lui-même :
Ainsi, saisir "192" et "123" placerait un point à 192px à droite et 123px en dessous du coin supérieur gauche du SVG. Si une cellule est laissée vide, sa valeur est prise égale à 0.
L'exemple ci-dessous montre comment saisir les coordonnées de points placés sur différentes îles, sur la carte du Monde JetPunk :
À l'étape 4, vous pouvez avoir un aperçu de l'endroit où les points apparaissent et procéder aux éventuels ajustements. Malheureusement, avec cette méthode, le positionnement des points doit se faire par tâtonnement. Il existe cependant une alternative qui consiste à utiliser Inkscape pour créer et placer vos points directement sur la carte. Sélectionnez l'un de ces points et récupérez les coordonnées de son centre dans l'éditeur XML (attributs "cx" et "cy"). Vous pouvez utiliser directement ces coordonnées à l'étape 2 pour compléter les colonnes 2 et 3.
Copyright H Brothers Inc., 2008–2024
Nous contacter | Retour en haut de page | Passer à la version mobile