Extension:Kartographer/ko

미디어위키 확장 기능 설명서

Kartographer 출시 상태: 안정
구현	태그
설명	Allows to add maps to pages as a frontend to mapping services
만든 이	Yuri Astrakhan (yurik토론)
호환성 정책	스냅샷은 미디어위키와 함께 릴리스됩니다. Master is not backward compatible.
MediaWiki	1.39+
데이터베이스 변경	아니오
변수 $wgKartographerSimpleStyleMarkers $wgKartographerSrcsetScales $wgKartographerStaticFullWidth $wgKartographerUsePageLanguage $wgKartographerStaticMapframe $wgKartographerDfltStyle $wgKartographerFallbackZoom $wgKartographerParsoidVersion $wgKartographerMapServer $wgKartographerWikivoyageMode $wgKartographerMediaWikiInternalUrl $wgKartographerStyles $wgKartographerUseMarkerStyle $wgKartographerNearby
태그 mapframe maplink
사용된 훅 OutputTransformFirstStage OutputTransformLastStage ParserAfterParse ParserFirstCallInit ParserTestGlobals
Licence	MIT License
다운로드	확장 기능 다운로드 Git [?]: 저장소 보기 (GitHub) Gerrit 코드 리뷰 Git 커밋 기록 Download source tarball
도움말	Help:Extension:Kartographer/ko
예시	See below on this page
Kartographer 확장 기능 번역 (translatewiki.net에서 가능한 경우)
이슈	미해결 작업 · 버그 보고

The Kartographer extension lets you display maps (based around OpenStreetMap) in wiki pages. It was specifically designed in order to run on Wikimedia sites such as Wikivoyage and Wikipedia, although it can be used on any wiki.

The tile server at maps.wikimedia.org is not available to 3rd parties. Please use your own tileserver. If you are a Wikimedia affiliate, see Maps/External usage instead.

Usage

Kartographer defines the wikitext tags ‎<mapframe>...‎</mapframe> and ‎<maplink>, which display a map and a link to a map on the page respectively. See 도움말:확장기능:Kartographer for how to call these tags.

Example

설치

• Install the JsonConfig extension as described in its documentation which is required to run this extension.
• 파일을 다운로드하고 Kartographer 폴더를 extensions/ 디렉토리에 넣어 주세요.
  개발자와 코딩 기여자는 Git을 이용해 확장기능을 다운받는 것이 좋습니다.

  cd extensions/
  git clone https://gerrit.wikimedia.org/r/mediawiki/extensions/Kartographer
  

• Git에서 설치할 경우, PHP 의존 기능을 설치하려면 Composer를 실행하여 확장 기능 디렉터리에 composer install --no-dev를 발행하십시오. (잠재적인 문제에 대해서는 T173141 을 참고하십시오.)
• 아래의 코드를 LocalSettings.php 코드의 마지막에 추가합니다.

  wfLoadExtension( 'Kartographer' );
  

• Configure as required.
• 완료 – 위키의 ‘Special:Version’에 이동해서, 확장기능이 올바르게 설치된 것을 확인합니다.

Configuration

Configuration settings

parameter	default	comment
$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"	Default map style to be used. Must be one of the values from $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. Must be in incremental order. Doesn't need to start with 1, this happens automatically. Note that most tile servers don't support this at all and thus require setting this to an empty array.
$wgKartographerUseMarkerStyle	false	Allows Kartographer to extract marker styles from the GeoJSON to style a ‎<maplink> accordingly. Currently only the marker-color is considered.
$wgKartographerWikivoyageMode	false	Enables the group feature where different ‎<maplink> and ‎<mapframe> tags can access each others data via group="…" and show="…" attributes. See Groups. Disabled by default. Meant to be enabled on Wikivoyage.
$wgKartographerStaticMapframe	false	Disables the module that turns ‎<mapframe> tags into interactive mini-maps that can be panned and zoomed without leaving the page. Static maps are recommended on high-traffic wikis where your KartographerMapServer couldn't keep up. Clicking ‎<maplink> and ‎<mapframe> tags to open a fullscreen interactive map is always possible. Requires a static map renderer like Kartotherian.
$wg KartographerStaticFullWidth	1024	The actual width of static map images when a ‎<mapframe> uses the special value width="full". Relevant on wikis in static mode or when JavaScript is disabled. It's recommended to use one of the $wgImageLimits widths for consistency.
$wgKartographerUsePageLanguage	true	Use the language of the page instead of that of the language of the territory mapped. This sets the lang parameter of the tiles requested.
$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	Use an api to generate markers using the simplestyle-spec for features. Should be set to false for most applications outside WMF. Otherwise images of markers are assumed to be hosted on the map server.
$wgKartographerNearby	false	Enable the 주변 문서 보기 button when in fullscreen

API

This extension provides two internal APIs.

• Query mapdata
• Action sanitise mapdata

Implementation

• Kartographer developer guide
• API documentation

Kartographer makes use of a suite of open-source, open-data tools for displaying maps:

• On the client side (within the browser):
  • Leaflet, a JavaScript mapping library
• On the server side:
  • 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
• Generating the data in advance:
  • Tilerator - a tile pre-generation service also developed by the Wikimedia Foundation
  • OpenStreetMap - an open map data source, the source for the map data as well as for most of POIs.

For more information on these, see Wikimedia Maps.

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

Goals

General goals

• 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.

Wikivoyage goals

Wikivoyage tends to have a large number of POIs listed on a page (see example). 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.

Known problems

See the corresponding project(s) in 파브리케이터 for a complete list of bugs.

See also

• 확장기능:Maps - Extension to visualise and work with geographical information.
• Semantic Result Formats - Various visualisation formats for Extension:Semantic MediaWiki
• Extension:GeoData - Allows articles to specify their geographical coordinates and publishes these coordinates via the HTTP API.
• Extension:MultiMaps - Allows users to display maps and coordinate data using multiple mapping services
• Extension:VisualData/Geolocation - Allows displaying Maptiler maps in forms with reverse geocoding and draggable markers

References