Шаблон:Wl

Шаблон {{wl}} является элементом движка WikiLeaflet и создаёт на вики-странице географическую карту.

Имеет единственный необязательный параметр, обыкновенным значением которого является произвольная комбинация одного или нескольких вложенных шаблонов {{wl}}, имеющих специальное значение первого параметра и задающих параметры карты.

Таким образом, простой вызов шаблона {{wl}} создаёт на вики-странице карту. Чтобы управлять видом и содержанием этой карты, достаточно поместить внутрь этого шаблона (в его первый параметр) несколько других (вложенных в него) вызовов шаблона {{wl}}. Первый параметр этих вложенных шаблонов и их последующие параметры позволяют контролировать изменения, налагаемые на карту.

   Загружается карта…
 

Список специальных значений первого параметра

{{wl|редактор}} или {{wl|edit}}

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

• при каждом таскании карты мышкою, а также при увеличении и уменьшении карты под нею появляется код шаблона {{wl|центр|lat|lon|zoom}}, все параметры которого ужé заполнены;
• при каждом жмяке мышóю по свободному месту карты на этом месте появляется всплывающее пояснение, содержащее код шаблона {{wl|точка|lat|lon}}, первые три параметра в котором ужé заполнены.

Эти коды могут быть затем выделены (троекратным жмяком мышóю) и скопированы в буфер обмена.

Таким образом, для редактирования карты, находящейся на вики-странице, достаточно войти в режим редактирования страницы, затем добавить шаблон {{wl|edit}} внутрь внешнего шаблона {{wl}} и нажать «Предварительный просмотр» — после чего откроется возможность определить желаемые координаты карты и точек на ней, дополнить ими или заменить прежние внутренние вызовы шаблона {{wl}}, снова задействовать «Предварительный просмотр».

Перед окончательным сохранением страницы вызов «{{wl|edit}}» следует убрать с неё.

{{wl|высота|height}}

Задаёт высоту карты равной height пикселов. Этот второй параметр (height) должен быть натуральным числом.

{{wl|центр|lat|lon|zoom}}

Задаёт начальное положение карты широтою lat, долготою lon и увеличением zoom.

{{wl|точка|lat|lon|text|типЗначка}}

Создаёт на карте точку широтою lat и долготою lon.

Параметр text, если не пуст, создаёт пояснение для этой точки, всплывающее по жмяку мышóю.

Параметр типЗначка, если не пуст, задаёт тот значок, которым точка на карте будет помечена. Различные значки можно задавать при помощи параметра {{wl|значок|…}} (см. ниже).

Также могут использоваться дополнительные параметры надписей.

{{wl|значок|…}}

Сложный вариант шаблона, описывающий значок (маркер), которым в дальнейшем можно помечать точки на карте. Содержит до двенадцати параметров:

• Первым параметром служит слово «значок» (без кавычек).
• Вторым параметром служит идентификатор значка.
• Третий параметр задаёт имя файла, содержащего изображение значка. Файл должен быть загружен в ту же вики, что и карта, поэтому указывается только хвост имени, следующий за адресом папки картинок вики. Скажем, для файла с адресом «http://имя.сервера.вики/images/f/f3/filename.png» указывается имя «f/f3/filename.png».
• Четвёртый и пятый параметры — числа, задающие (в пикселах) ширину и высоту значка.
• Шестой параметр задаёт имя файла, содержащего изображение тени от значка. (Именем служит хвост адреса, аналогично третьему параметру.) Изображение тени подкладывается под изображение самогó значка таким образом, чтобы левые верхние углы изображений совпали, и поэтому должно быть нарисовано с учётом этого. Этот параметр не обязателен, если изображение тени не планируется или если оно включено в изображение самогó значка. Тем не менее, отдельная тень полезна в тех случаях, когда сразу несколько значков накладываются друг на друга (тогда тени отходят на второй план).
• Седьмой и восьмой параметры — числа, задающие (в пикселах) ширину и высоту тени. (Эти параметры обязательны только тогда, когда тень указана.)
• Девятый и десятый параметры — числа, задающие (в пикселах) расстояние (по горизонтали и по вертикали соответственно) от левого верхнего угла значка до той точки на карте, на которую значок ставится. Эти параметры не обязательны; при их отстутствии расстояние по вертикали принимается равным высоте значка, а по горизонтали — половине ширины значка, так что прямоугольный значок оказывается стоящим на середине нижней стороны, а круглый — на нижней точке вертикального диаметра.
• Одиннадцатый и двенадцатый параметры — числа, задающие (в пикселах) сдвиг по горизонтали вправо и сдвиг по вертикали вниз от той точки на карте, на которую значок ставится, до той точки, на которую ляжет кончик тени от пояснения, всплывающего по жмяку мышóю. Отрицательные числа указывают на сдвиг в противоположном направлении (влево и вверх соответственно). Эти параметры не обязательны; при их отстутствии сдвиг по горизонтали принимается нулевым, а сдвиг по вертикали — отрицательным (то есть направленным вверх), причём по модулю на два пикселя меньшим, чем десятый параметр (то есть чем расстояние от точки на карте до верха значка). Так как размер тени от пояснения как раз равен двум пикселам, то получается, что если параметры с девятого по двенадцатый (включительно) не заданы, тогда прямоугольному значку пояснение станет указывать на середину верхней стороны, а круглому — на верхнюю точку вертикального диаметра.

Также могут использоваться дополнительные параметры надписей.

{{wl|тайлы|имяСервераТайлов}}

Позволяет выбрать (в зависимости от значения второго параметра), с какого сервера будут подкачиваться тайлы, то есть двумерные плитки 256×256 пикселов, из которых формируется карта. Допустимые значения второго параметра:

osm

Используется основной сервер тайлов OpenStreetMap (рендерер «mapnik»).

Увеличение (zoom) в пределах от 0 до 18.

local

Тайлы OpenStreetMap берутся из папки «/tiles/» на сервере вики. (Предполагается, что они скопированы туда заблаговременно с сервера OpenStreetMap.)

Этот параметр предназначен для употребления или тестирования вики в интранете, закрытом от Интернета.

(В общедоступных вики следует использовать не собственную копию, а общедоступную версию тайлов OpenStreetMap, как наиболее свежую.)

osmarender

Используется альтернативный сервер тайлов OpenStreetMap (рендерер «osmarender», проект «tiles@home»).

Увеличение (zoom) в пределах от 0 до 17.

cycle

Используется сервер тайлов OpenCycleMap (карта для велосипедистов).

Увеличение (zoom) в пределах от 0 до 16.

mapquest

Используется сервер тайлов MapQuest (данные OpenStreetMap, в небольших масштабах дополненные элементами физической карты мира).

Увеличение (zoom) в пределах от 0 до 18.

openaerial

Используется сервер тайлов MapQuest Open Aerial (данные спутниковой съёмки и аэрофотосъёмки).

Увеличение (zoom) в пределах от 0 до 11.

osmosnimki

Используется сервер тайлов Scanex (Kosmosnimki.Ru: данные OpenStreetMap с изменёнными стилями и рендерингом).

Увеличение (zoom) в пределах от 0 до 17.

kosmosnimki

Используется сервер тайлов Scanex (Kosmosnimki.Ru: данные спутниковой съёмки — базовое покрытие Kosmosnimki.Ru).

Увеличение (zoom) в пределах от 0 до 18.

Подробнее о характеристиках тайловых серверов рассказывает статья в вики OpenStreetMap.

{{wl|меню|…}}, {{wl|фильтры|…}}, {{wl|пункт|…}}

Эти параметры имеют отношение к созданию списков, управляющих созданием и отображением значков. Будут документированы с выходом WikiLeaflet 0.4.

Дополнительные параметры надписей

В шаблонах {{wl|точка|…}} и {{wl|значок|…}} может использоваться дополнительный именованный параметр «надпись=текстНадписи», вызывающий появление означенной им надписи:

• Если он задан в шаблоне {{wl|точка|…}}, то тогда этот параметр вызывает появление надписи у точки, означенной этим шаблоном.

• Если он задан в шаблоне {{wl|значок|…}}, то тогда этот параметр вызывает появление надписи у всех точек, помеченных этим значком.

Параметру «надпись» могут сопутствовать другие именованные параметры, задающие смещение надписи:

сдвигНадписи

Задаёт величину горизонтального сдвига надписи (в пикселах).

подъёмНадписи

Задаёт величину вертикального подъёма надписи (в пикселах).

По умолчанию у точки эти параметры равны нулю (так что надпись появляется у точки), а у значка принимаются такими, которые необходимы для появления надписи у правого верхнего угла значка.

Также у точки может быть дополнительный именованный параметр категории, имеющий отношение к созданию списков, управляющих отображением значков. Будет документирован с выходом WikiLeaflet 0.4.