Кышкар:Географик аҥа/Документаций велыжын важшым ончымаш

{{docpage}}
Данный шаблон создан для упрощения кода геокарточек.

== Шаблоны, работающие на Геокаре ==

{{Географик аҥа-влак}}

== Разработка подшаблонов ==
Все параметры, перечисленные ниже, нужно обернуть следующими тегами:
<pre><table class="infobox" cellspacing="2" style="width: 22em; text-align: left; font-size: 88%; line-height: 1.5em;">
...
</table></pre>

=== Параметр-влак ===
==== Параметр ====
* <nowiki>{{Географик аҥа|Параметр|викифицировать значение? 0/1|Название ячейки|{{{Название параметра|}}}|приписка}}</nowiki>

==== Множественный параметр ====
* <nowiki>{{Географик аҥа|Множественный параметр|викиф. значение? 0/1|Ед. число назв. ячейки 1|Мн. число назв. ячейки 2|{{{Назв. параметра 1|}}}|{{{Назв. параметра 2|}}}|{{{Назв. параметра 3|}}}|{{{Назв. параметра 4|}}}}}</nowiki>

Множественные параметры задаются не одной строкой, а несколькими значениями. Например, для стран сначала идет {{cn|Эл}}, затем {{cn|Эл 1}} и т. д. Максимальное их количество ограничено пятью включениями.

Если необходимо включить поддержку разделения параметров любым символом, отличным от запятой, добавьте {{cn|<nowiki>|Разделитель=<Символ></nowiki>}}.

==== Лӱм ====
* <nowiki>{{Географик аҥа|Лӱм|{{{Лӱм|}}}|{{{Национал лӱм|}}}}}</nowiki>

==== Сӱрет ====
* <nowiki>{{Географик аҥа|Сӱрет|{{{Карте|}}}|{{{Подпись карты|}}}}}</nowiki>
* <nowiki>{{Географик аҥа|Сӱрет|{{{Сӱрет|}}}|{{{Подпись|}}}}}</nowiki>

==== Вставка ====
* <nowiki>{{Географик аҥа|Вставка|<Текст>}}</nowiki>
Добавляет поле с указанным текстом на всю ширину карточки. Позволяет разбивать параметры по смыслу на блоки.

==== Калыкчот ====
* <nowiki>{{Географик аҥа|Калыкчот|{{{Калыкчот|}}}|{{{Год переписи|}}}}}</nowiki>

==== Чаклык ====
* <nowiki>{{#ifeq:{{{Калыкчот|}}}|0||{{#if:{{{Кумдык|}}}|{{Географик аҥа|Чаклык|{{{Калыкчот|}}}|{{{Кумдык|}}}}}}}}}</nowiki>

==== Эл ====
* <nowiki>{{Географик аҥа|Эл|{{{Эл|}}}|{{{Эл 1|}}}|{{{Эл 2|}}}|{{{Эл 3|}}}}}</nowiki>

==== Категорий Викиклатыште ====
* <nowiki>{{Географик аҥа|Категорий Викиклатыште|{{#property:p373}}|{{{Лӱм|}}}}}</nowiki>

=== Координаты и вывод позиционных карт ===
==== Координат-влак ====
* <nowiki>{{Географик аҥа|Координат-влак|{{{lat_deg|}}}|{{{lat_min|}}}|{{{lat_sec|}}}|{{{lat_dir|}}}|{{{lon_deg|}}}|{{{lon_min|}}}|{{{lon_sec|}}}|{{{lon_dir|}}}|Эл={{{Эл|}}}|CoordScale={{{CoordScale|}}}}}</nowiki>
Для того чтобы не возникло ошибок при отсутствии координат или обязательного параметра {{cn|Эл}}, следует дописать два условия:
* <nowiki>{{#if:{{{lat_deg|}}}|{{#if:{{{Эл|}}}|<...>}}}}</nowiki>

==== Позиций карте ====
* <nowiki>{{Географик аҥа|Позиций карте|{{#if:{{{Позиций карте 1|}}}|{{{Позиций карте 1|}}}|{{{Эл|}}}|{{{lat_deg|}}}|{{{lat_min|}}}|{{{lat_sec|}}}|{{{lat_dir|}}}|{{{lon_deg|}}}|{{{lon_min|}}}|{{{lon_sec|}}}|{{{lon_dir|}}}|Ук. карты={{{Ук. карты|physical}}}|Ук. арены={{{Ук. арены|}}}}}</nowiki>
Для возможности отключения позиционных карт и исключения ошибок, следует дописать два условия:
* <nowiki>{{#ifeq:{{{Позиций карте 1|}}}|0||{{#if:{{{Позиций карте 1|}}}{{{Эл|}}}|<...>}}}}</nowiki>

Аналогично для второй позиционной карты:
* <nowiki>{{#ifeq:{{{Позиций карте 2|}}}|0||{{#if:{{{Позиций карте 2|}}}{{{Субъект страны|}}}{{{Регион|}}}|{{Географик аҥа|Позиций карте|{{{lat_deg|}}}|{{{lat_min|}}}|{{#if:{{{Позиций карте 2|}}}|{{{Позиций карте 2|}}}|{{#iferror:{{ПозКарта|{{{Эл|}}} {{{Субъект страны|}}}{{{Регион|}}}}}||{{{Эл|}}} {{{Субъект страны|}}}{{{Регион|}}}}}}}|{{{lat_sec|}}}|{{{lat_dir|}}}|{{{lon_deg|}}}|{{{lon_min|}}}|{{{lon_sec|}}}|{{{lon_dir|}}}|Ук. карты={{{Ук. карты 1|physical}}}|Ук. арены={{{Ук. арены 1|}}}}}}}}}</nowiki>

* Ук. арены — указатель на [[ВП:IMAGEMAP|арену картоссылок]], прописан в конкретных шаблонах-позкартах.
* Ук. карты — указатель на карту, прописан в конкретных шаблонах-позкартах. Существуют три распространённых типа: default, physical, hydro.

Более подробную информацию о назначении параметров вы можете узнать в документации шаблона {{tl|ПозКарта}}

==== Позиций карте + ====
Для отображения нескольких точек на позиционной карте:
* <nowiki>{{Географик аҥа|Позиций карте|<Карта, которую нужно вывести>|Ук. карты={{{Ук. карты|physical}}}|Ук. арены={{{Ук. арены|}}}|Тамга-влак=}}</nowiki>
В параметр {{cn|Тамга-влак}} можно добавить любое количество меток:
* <nowiki>{{Географик аҥа|Тамга|<Карта, которую нужно вывести>|{{{s_lat_deg|}}}|{{{s_lat_min|}}}|{{{s_lat_sec|}}}|{{{s_lat_dir|}}}|{{{s_lon_deg|}}}|{{{s_lon_min|}}}|{{{s_lon_sec|}}}|{{{s_lon_dir|}}}|Позиция подписи=<left, right, top или bottom>|Подпись метки=<Выводимое название метки>|Ук. метки=<Название метки в стилях>}}</nowiki>

==== Небесное тело ====
Чтобы добавить возможность отображения внеземных координат для объектов рельефа других планет (таких, как кратер, вулкан и т.д.), следует вписать:
* <nowiki>{{#if:{{{lat_deg|}}}|{{#if:{{{Эл|}}}{{{Небесное тело|}}}|{{Географик аҥа|Координат-влак|{{{lat_deg|}}}{{{широта|}}}|{{{lat_min|}}}|{{{lat_sec|}}}|{{{lat_dir|}}}{{{N_S|}}}|{{{lon_deg|}}}{{{долгота|}}}|{{{lon_min|}}}|{{{lon_sec|}}}|{{{lon_dir|}}}{{{E_W|}}}|Эл={{#if:{{{Небесное тело|}}}||{{{Эл|}}} }}|CoordScale={{{CoordScale|}}}|Небесное тело={{{Небесное тело|}}}}}}}}}</nowiki>

Пример прямого использования: 
{| class="wikitable"
|-
|<nowiki>{{Географик аҥа|Координат-влак|14|35|43.96|S|175|31|56.43|E|Небесное тело=Марс|CoordScale=9}}</nowiki>
|{{Географик аҥа|Координат-влак|14|35|43.96|S|175|31|56.43|E|Небесное тело=Марс|CoordScale=9}}
|}

Затем, чтобы вывести позиционную карту космического объекта (планеты, спутника), добавьте дополнительное условие:
* <nowiki>{{#if:{{{Небесное тело|}}}|{{{Небесное тело|}}}|{{#if:{{{Позиций карте|}}}|<...>}}}}</nowiki>

Таким образом, полный код для позиционной карты будет следующим:
*<nowiki>{{#ifeq:{{{Позиций карте|}}}|0||{{#if:{{{Позиций карте|}}}{{{Эл|}}}{{{Небесное тело|}}}|{{Географик аҥа|Позиций карте|{{#if:{{{Небесное тело|}}}|{{{Небесное тело|}}}|{{#if:{{{Позиций карте|}}}|{{{Позиций карте|}}}|{{{Эл|}}}}}}}|{{{lat_deg|}}}{{{широта|}}}|{{{lat_min|}}}|{{{lat_sec|}}}|{{{lat_dir|}}}{{{N_S|}}}|{{{lon_deg|}}}{{{долгота|}}}|{{{lon_min|}}}|{{{lon_sec|}}}|{{{lon_dir|}}}{{{E_W|}}}|Ук. карты=physical|Ук. арены={{{Ук. арены|}}}}}}}}}</nowiki>

{| class="wikitable"
|-
|<nowiki>{{Географик аҥа|Позиций карте|Марс|14|35|43.96|S|175|31|56.43|E|Ук. карты=physical}}</nowiki>
|{{Географик аҥа|Позиций карте|Марс|14|35|43.96|S|175|31|56.43|E|Ук. карты=physical}}
|}

=== Пример ===
<table class="infobox" cellspacing="2" style="width: 22em; text-align: left; font-size: 88%; line-height: 1.5em;">
{{Географик аҥа|Лӱм|Джомолунгмо|bo/ཇོ་མོ་གླང་མ|Стиль=3_1}}
{{Географик аҥа|Сӱрет|The Earth seen from Apollo 17.jpg|Мланде}}<tr>
{{Географик аҥа|Вставка|Единичные параметры|Стиль=3_1}}
{{Географик аҥа|Параметр|0|[[Кумдык]]|123|км²|Стиль=3}}
{{Географик аҥа|Параметр|1|[[Кумдык]]|123|км²|Стиль=3}}
{{Географик аҥа|Вставка|А здесь множественные|Стиль=3_1}}
{{Географик аҥа|Множественный параметр|0|[[Акваторий]]|[[Акваторий|Акватории]]|Адриатическое море|Средиземное море|Стиль=3}}
{{Географик аҥа|Множественный параметр|1|[[Акваторий]]|[[Акваторий|Акватории]]|Адриатическое море|Средиземное море|Стиль=3}}
{{Географик аҥа|Эл|Россий|Франций|Китай|Стиль=3}}
{{Географик аҥа|Вставка|Координат-влак да ПозКарта|Стиль=3_1}}
{{Географик аҥа|Координат-влак|55|45|0|N|37|37|0|E|Эл=Россий}}
{{Географик аҥа|Позиций карте|Россий|55|45|0|N|37|37|0|E|Ук. карты=physical}}
{{Географик аҥа|Категорий Викиклатыште|World|Статья|Стиль=3_1}}
</table>
<pre>
<table class="infobox" cellspacing="2" style="width: 22em; text-align: left; font-size: 88%; line-height: 1.5em;">
{{Географик аҥа|Лӱм|Джомолунгмо|bo/ཇོ་མོ་གླང་མ}}
{{Географик аҥа|Сӱрет|The Earth seen from Apollo 17.jpg|Мланде}}
{{Географик аҥа|Вставка|Единичные параметры}}
{{Географик аҥа|Параметр|0|[[Кумдык]]|123|км²}}
{{Географик аҥа|Параметр|1|[[Кумдык]]|123|км²}}
{{Географик аҥа|Вставка|А здесь множественные}}
{{Географик аҥа|Множественный параметр|0|[[Акваторий]]|[[Акваторий|Акватории]]|Адриатик теҥыз|Мландыпокшел теҥыз}}
{{Географик аҥа|Множественный параметр|1|[[Акваторий]]|[[Акваторий|Акватории]]|Адриатик теҥыз|Мландыпокшел теҥыз}}
{{Географик аҥа|Эл|Россий|Франций|Китай}}}
{{Географик аҥа|Вставка|Координат-влак да ПозКарта}}
{{Географик аҥа|Координат-влак|55|45|0|N|37|37|0|E|Эл=Россий}}
{{Географик аҥа|Позиций карте|Россий|55|45|0|N|37|37|0|E|Ук. карты=physical}}
{{Географик аҥа|Категорий Викиклатыште|World|Статья}}
</table>
</pre>

=== Оформление и стили ===
Для всех параметров можно добавить собственный стиль оформления. Они добавлются на отдельную страницу {{tl|Географик аҥа/Стили}}. Так, например, для вставки это будет выглядеть следующим образом:
* <nowiki>{{Географик аҥа|Вставка|<Текст>|Стиль=<Название стиля>}}</nowiki>
При этом рекомендуется использовать два стиля: один с расположением текста по центру для названия и категории на Викискладе, второй - для остальных параметров.

Для того чтобы задать другой маркер для позиционных карт, нужно в стилях прописать название изображения и добавить параметр {{cn|Тамга}} в код шаблона. Например:
* <nowiki>{{Географик аҥа|Позиций карте|{{#if:{{{Позиций карте|}}}|{{{Позиций карте|}}}|{{{Эл|}}}}}|{{{lat_deg|}}}|{{{lat_min|}}}|{{{lat_sec|}}}|{{{lat_dir|}}}|{{{lon_deg|}}}|{{{lon_min|}}}|{{{lon_sec|}}}|{{{lon_dir|}}}|Ук. метки=<Название метки>}}</nowiki>

Все метки прописаны в [[Кышкар:Географик аҥа/Стили]].

=== Автоматическое включение в категории ===
Для того, чтобы добавить категорию, сначала вставьте условие {{cn|<nowiki>{{#if:{{NAMESPACE}}||<условия, при которых выводятся категории>}}</nowiki>}}, которое не позволит включать в категории нестатьи. Чтобы добавить статьи в определенную категорию достаточно использовать одну из [[ВП:Функции парсера|функций парсера]]. Примеры можно посмотреть в шаблонах из списка выше.

<includeonly>
[[Категорий:Кышкар-аҥа-влак:Пӱртӱс географик объект-влак‎| ]]
</includeonly>
[[Категорий:Кышкар-влак:Блоки Геокара| ]]