Шаблон:Wl

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

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

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

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

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

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

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

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

Следует отметить, что в режиме редактирования страницы (после нажатия кнопки «Предварительный просмотр») карта и без того автоматически обретает возможность считывания координат, поэтому ставить вызов «{{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, как наиболее свежую.)
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.
openmapsurfer: Используется сервер тайлов OpenMapSurfer (данные OpenStreetMap, подготовленные географическим факультетом Гейдельбергского университета в Германии).; Увеличение (zoom) в пределах от 0 до 18.

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

{{wl|GeoJSON|…}}

Вторым параметром этого варианта шаблона является код в формате GeoJSON, описывающий географические объекты, накладываемые на карту.

Второй параметр следует непременно обрамлять парою тегов <nowiki>…</nowiki> — в противном случае квадратные и особенно фигурные скобки GeoJSON могут интерпретироваться как элементы оформления гиперссылок и шаблонов MediaWiki.

В настоящее время возможность создавать и редактировать данные geoJSON средствами wl отсутствует. Для этого применяются внешние редакторы. Как вариант, для подготовки данных, предлагается следующая схема:

С помощью GoogleMaps создаются объекты (кривые линии, полигоны, точки и т.д., пример), и с его же помощью эти объекты импортируются в формат KML (жмяком по "KML" в левой части экрана) после чего файл с данными в формате KML сохраняется на диске.
Копируем содержимое этого файла и вставляем в нижнее поле на этой странице. После вставки данных выбираем формат KML в выпадающем меню Format и жмем на кнопку add feature. Тем самым мы добавили все созданные в GoogleMaps объекты на карту "конвертера". Далее, в выпадающем меню Format, выбираем GeoJSON и жмякаем на требуемый объект в карте, после чего в правой части страницы должен появиться требуемый набор данных в формате geoJSON. В целом этот код уже готов для вставки в wl.
Для редактирования цвета объекта необходимо удалить "styleUrl":"#style*" и вставить "style":{"color":"#хеш_цвета"}

{{wl|меню|…}}, {{wl|фильтры|…}}, {{wl|пункт|…}}: Эти параметры имеют отношение к созданию списков, управляющих созданием и отображением значков. Пока ещё не документированы.

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

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

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

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

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

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

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

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

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