Расширение:Kartographer

Справка по расширениям MediaWiki

Kartographer Статус релиза: стабильно
Реализация	Тег
Описание	Позволяет добавлять карты на страницы пользовательского интерфейса из картографических сервисов
Автор(ы)	Yuri Astrakhan (yurikобсуждение)
Политика совместимости	Снэпшоты выходят вместе с MediaWiki. Мастер не имеет обратной совместимости.
MediaWiki	1.39+
Изменения в БД	Нет
Лицензия	MIT License
Скачать	Скачать расширение Git [?]: репозиторий (GitHub) Обзор кода Gerrit журнал Git-коммитов Download source tarball
Помощь	Help:Extension:Kartographer/ru
Пример	Смотрите ниже на этой странице
Параметры $wgKartographerSimpleStyleMarkers $wgKartographerSrcsetScales $wgKartographerStaticFullWidth $wgKartographerUsePageLanguage $wgKartographerStaticMapframe $wgKartographerDfltStyle $wgKartographerFallbackZoom $wgKartographerParsoidVersion $wgKartographerMapServer $wgKartographerWikivoyageMode $wgKartographerMediaWikiInternalUrl $wgKartographerStyles $wgKartographerUseMarkerStyle $wgKartographerNearby
Метки mapframe maplink
Используемые хуки ParserAfterParse ParserFirstCallInit ParserTestGlobals
Переведите расширение Kartographer, если оно доступно на translatewiki.net
Проблемы	Открытые задачи · Сообщить об ошибке

Расширение Картограф (Kartographer) позволяет вам отображать карты на вики-страницах, частично полагаясь на OpenStreetMap. Оно было специально разработано для работы на таких сайтах Викимедиа, как Викигид и Википедия, хотя его можно использовать в любой вики.

Сервер тайлов на maps.wikimedia.org не доступен третьим лицам. Пожалуйста, используйте свой собственный тайловый сервер. If you are a Wikimedia affiliate, see Maps/External usage instead.

Использование

Kartographer определяет теги викитекста ‎<mapframe>...‎</mapframe> и ‎<maplink>, которые отображают карту и ссылку на карту на странице соответственно. См. Помощь:Расширение:Картограф , чтобы определить правила вызова этих тегов.

Установка

• Установите расширение JsonConfig так, как это описано в его документации, которая требуется для запуска расширения.
• Скачайте и распакуйте файл(ы) в папку с названием Kartographer в вашей папке extensions/.
  Вместо этого разработчикам и соавторам кода следует установить расширение из Git, используя:

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

• Если и только если устанавливаете из git, запустите Composer для установки зависимостей PHP, запустив composer install --no-dev в каталоге расширений. (Смотрите T173141 о возможных осложнениях.)
• Добавьте следующий код в конце вашего файла LocalSettings.php :

  wfLoadExtension( 'Kartographer' );
  

• Настройте так, как это требуется.
• Готово – Перейдите на страницу Special:Version на своей вики, чтобы удостовериться в том, что расширение успешно установлено.

Настройка

Настройки конфигурации

параметр	по умолчанию	комментарий
$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. Должно быть, в порядке возрастания. Необязательно начинать с 1, это происходит автоматически. Note that most tile servers don't support this at all and thus require setting this to an empty array.
$wgKartographerUseMarkerStyle	false	Позволяет Kartographer извлекать стили маркеров из GeoJSON, чтобы стилизовать ‎<maplink> соответствующим образом. Currently only the marker-color is considered.
$wgKartographerWikivoyageMode	false	Включает групповые функции, где различные теги ‎<maplink> и ‎<mapframe> могут получить доступ к данным друг друга через атрибуты group="…" и show="…". See Groups. Disabled by default. Meant to be enabled on Wikivoyage.
$wgKartographerStaticMapframe	false	Отключает модуль, который превращает теги ‎<mapframe> в интерактивные мини-карты, которые можно просмотривать и увеличивать без выхода со страницы. Статические карты рекомендуются для вики-сайтов с высокой посещаемостью, где ваш картографический сервер не может за ними угнаться. Нажатие на теги ‎<maplink> и ‎<mapframe> для открытия интерактивной карты на полном экране всегда возможно. 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". Актуально для вики-сайтов в статическом режиме или при отключенном JavaScript. 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

Это расширение поддерживает два внутренних API.

• Запросы к картографическим данным
• Действия по очистке картографических данных

Внедрение

• Руководство разработчика Kartographer
• Документация API

Для отображения карт Kartographer использует набор инструментов с открытыми источниками и открытыми данными:

• На стороне клиента (в браузере):
  • Leaflet, библиотека JavaScript для рисования карт
• На стороне сервера:
  • 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
• Предварительное генерирование данных:
  • Tilerator - сервис предварительной генерации плиток, также разработанный Фондом Викимедиа
  • 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.

Цели

Основные цели

• Простой метод вставки карты в статью без необходимости изменений кода common.js
• Возможность добавления дополнительной информации (отметки, область, всплывающие окна, текст, ссылки) на карту
• Возможность собирать статистику использования карт (KPI), чтобы лучше оценить, как и что следует улучшить.
• TBD: экспериментирование - если пользователь осведомлен о последствиях для конфиденциальности, карта должна иметь возможность отображать внешние данные из непроизводственного источника, например, статические изображения, отрисованные на стороне сервера, не будут включать дополнительные данные, добавленные с помощью этого метода, до тех пор, пока дополнительный источник данных не будет размещен в защищенная производственная среда и может быть показана без участия пользователя.

Цели Викигида

Wikivoyage tends to have a large number of POIs listed on a page (see example). Каждый POI обычно добавляется с помощью шаблона, но все они должны появиться на одной карте. Кроме того, каждый объект должен быть обозначен значком с номером, как в тексте статьи, так и на карте:

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

Известные проблемы

See the corresponding project(s) in Фабрикатор for a complete list of bugs.

См. также

• Расширение:Maps - Extension to visualise and work with geographical information.
• Semantic Result Formats - Various visualisation formats for Расширение:Semantic MediaWiki
• Расширение: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