Extension:Kartographer

Manuel des extensions MediaWiki

Kartographer État de la version : stable
Implémentation	Balise
Description	Permet d'ajouter des cartes aux pages en tant qu'interface avec les services de cartographie.
Auteur(s)	Yuri Astrakhan (yurikdiscussion)
Politique de compatibilité	Versions ponctuelles alignées avec MediaWiki. Le master n'est pas compatible arrière.
MediaWiki	1.39+
Modifie la base de données	Non
Licence	Licence MIT
Téléchargement	Télécharger l'extension Git [?]: Télécharger la branche master de Git parcourir le dépôt (GitHub) historique des validations (commits) contributeurs du dépôt (GitHub) relecture du code
Aide	Help:Extension:Kartographer/fr
Exemple	Voir ci-dessous
Paramètres $wgKartographerSimpleStyleMarkers $wgKartographerSrcsetScales $wgKartographerStaticFullWidth $wgKartographerUsePageLanguage $wgKartographerParsoidVersion $wgKartographerStaticMapframe $wgKartographerDfltStyle $wgKartographerFallbackZoom $wgKartographerParsoidSupport $wgKartographerMapServer $wgKartographerWikivoyageMode $wgKartographerMediaWikiInternalUrl $wgKartographerStyles $wgKartographerUseMarkerStyle $wgKartographerNearby
Balises mapframe maplink
Accroches utilisées ParserAfterParse ParserFirstCallInit
Téléchargements trimestriels	58 (Ranked 73rd)
Utilisé par les wikis publics	898 (Ranked 289th)
Traduire l’extension Kartographer sur translatewiki.net si elle y est disponible
Problèmes	Tâches ouvertes · Signaler un bogue

L'extension Kartographer permet d'afficher des cartes (basées sur OpenStreetMap) dans les pages wiki. Elle a été spécialement conçue pour fonctionner sur les sites Wikimedia tels que Wikipédia ou Wikivoyage mais elle peut être utilisé sur n'importe quel wiki.

Le serveur maps.wikimedia.org n'est pas disponible pour les tiers. Merci d'utiliser votre propre serveur de tuiles. If you are a Wikimedia affiliate, see Maps/External usage instead.

Utilisation

Cartographer définit les balises de wikitext ‎<mapframe>...‎</mapframe> et ‎<maplink>, lesquelles affichent respectivement une carte et un lien vers une carte sur la page. Voir Aide:Extension:Kartographer pour savoir comment appeler ces balises.

Installation

• Installez l'extension JsonConfig telle que décrite dans sa documentation. Elle est nécessaire pour exécuter cette extension.
• Téléchargez et placez le(s) fichier(s) dans un répertoire appelé Kartographer dans votre dossier extensions/.
  Les développeurs et les contributeurs au code doivent à la place installer l'extension à partir de Git en utilisant:cd extensions/
git clone https://gerrit.wikimedia.org/r/mediawiki/extensions/Kartographer
• Seulement lorsque vous installez à partir de Git, exécutez Composer pour installer les dépendances PHP, en entrant composer install --no-dev après vous être positionné dans le répertoire de l'extension. (Voir tâche T173141 pour des complications potentielles.)
• Ajoutez le code suivant à la fin de votre fichier LocalSettings.php  :

  wfLoadExtension( 'Kartographer' );
  

• Configuration requise
•  Fait – Accédez à Special:Version sur votre wiki pour vérifier que l'extension a bien été installée.

Configuration

Paramètres de configuration

paramètre	par défaut	commentaire
$wgKartographerMapServer	null	Server providing the map tiles. This is the only setting that doesn't have a default. You must provide a value. Note that the Wikimedia tile server https://maps.wikimedia.org can't be used outside of the Wikimedia cluster. See openstreetmap:Tile servers for tile servers.
$wgKartographerStyles	["osm-intl", "osm"]	Available map styles users can request from your $wgKartographerMapServer via mapstyle="…".
$wgKartographerDfltStyle	"osm-intl"	Style de carte par défaut à utiliser. Doit être l'une des valeurs à partir de $wgKartographerStyles.
$wgKartographerSrcsetScales	[ 1.3, 1.5, 2, 2.6, 3 ]	Set of allowed high-DPI pixelratios supported by your $wgKartographerMapServer, to be used in <img srcset="…"> and $wgKartographerMapServer URLs. Doit être dans un ordre progressif. Il n'est pas nécessaire de commencer par 1, c'est automatique. Il est à noter que la plupart des serveurs de tuiles ne prennent pas cela en charge et nécessitent de le définir sur un tableau vide.
$wgKartographerUseMarkerStyle	false	Permet à Kartographer d'extraire les styles de marqueurs du GeoJSON pour styliser un ‎<maplink> en conséquence. Currently only the marker-color is considered.
$wgKartographerWikivoyageMode	false	Active la fonctionnalité de groupe où différentes balises ‎<maplink> et ‎<mapframe> peuvent accéder aux données des autres via les attributs group="…" et show="…". See Help:Extension:Kartographer#Groups. Disabled by default. Meant to be enabled on Wikivoyage.
$wgKartographerStaticMapframe	false	Désactive le module qui transforme les balises ‎<mapframe> en mini-cartes interactives pouvant être panoramiques et zoomées sans quitter la page. Les cartes statiques sont recommandées sur les wikis à fort trafic où le serveur de cartes Kartographer n'a pas pu suivre. Il est toujours possible de cliquer sur les balises ‎<maplink> et ‎<mapframe> pour ouvrir une carte interactive en plein écran. Requires a static map renderer like Kartotherian.
$wg KartographerStaticFullWidth	1024	La largeur réelle des images de la carte statique lorsqu'un ‎<mapframe> utilise la valeur spéciale width="full". Pertinent sur les wikis en mode statique ou lorsque le JavaScript est désactivé. Il est recommandé d'utiliser l'une des largeurs de $wgImageLimits pour des raisons de cohérence.
$wgKartographerUsePageLanguage	true	Utilisez la langue de la page au lieu de celle du territoire cartographié. Ceci définit le paramètre de langue des tuiles demandées.
$wgKartographerFallbackZoom	13	Fallback zoom value when no zoom="…" is given. Must be an integer between 0 (map shows the entire earth) and 19 (as close as possible). Currently only works with dynamic maps.
$wgKartographerSimpleStyleMarkers	true	Utilisez une API pour générer des marqueurs à l'aide de la spécification simplestyle pour les fonctionnalités. Doit être défini sur false pour la plupart des applications en dehors de la WMF. Sinon, les images des marqueurs sont supposées être hébergées sur le serveur de cartes.

API

Cette extension fournit deux API internes.

• Interroger des données cartographiques
• Action de nettoyage des données cartographiques

Implémentation

• Guide du développeur de Kartographer
• Documentation de l'API

Kartographer utilise une suite d'outils opensource et opendata pour afficher des cartes :

• Côté client (dans le navigateur web) :
  • Leaflet, une bibliothèque de cartographie JavaScript
• Côté serveur :
  • Kartotherian, a map tile service developed by the Wikimedia Foundation, which itself contains code from Mapbox. Third party installations should use non-Wikimedia tile servers listed on openstreetmap:Tile servers
• Générer les données à l'avance :
  • Tilerator - un service de pré-génération de tuiles également développé par la Wikimedia Foundation
  • OpenStreetMap - une source de données cartographiques ouverte, la source des données cartographiques ainsi que de la plupart des points d'intérêt (POI).

For more information on these, see Wikimedia Maps.

For more information on the production aspects of running these services, see the Wikitech Maps page.

Objectifs

Objectifs généraux

• A simple method to insert a map into an article without requiring common.js code changes

• Ability to add extra information (marks, area, popups, text, links) to the map

• Ability to gather map usage statistics (KPI) to better gauge how and what should be improved.

• TBD: experimentation - if the user is aware of the privacy implications, the map should be able to show external data from non-production source, e.g. Static, server-side rendered images will not include the extra data added via this method until the extra data source is hosted in the secure production environment and can be shown without the user action.

Objectifs de Wikivoyage

Wikivoyage tends to have a large number of points of interest (POIs), such as museums and restaurants, listed on a page (see example and scroll down to the "See" section). Each POI is usually added with a template, but all of them should appear on the same map. Also, each POI should be referable by showing an icon with a number, both in the text of the article, and on the map:

• Ability to incrementally add features to the map. For example, each usage of the restaurant template adds a single POI, and the map shows all of them.

• Added features need to be indexable. E.g. the first restaurant template would show ^[1] on the page, and map would show POI as a clickable ^[1] element. There could be multiple index counters at the same time, each for its own type of POIs.

Problèmes connus

Voir le(s) projet(s) correspondant(s) dans Phabricator pour une liste complète des bugs.

Voir aussi

• Extension:Maps