Шаблон:Навигация/Документация

Внимание! Это один из самых используемых шаблонов. Редактируя его, вы создаёте колоссальную нагрузку на сервер. Так что сперва хорошенько подумайте.

Данный шаблон позволяет быстро создавать навигационные шаблоны, указывая в качестве параметров списки ссылок.

Заготовка для копирования

Заготовки ниже предназначены для копирования в новые шаблоны для облегчения их оформления:

Новый вариантСтарый вариант

{{Навигация
 |имя                       = {{подст:PAGENAME}}
 |state                     =  
 |стиль_основного_заголовка = 
 |заголовок                 = 
 |изображение               = 
 |стиль_тела                = <!-- (или "стиль =" если никакие другие стилевые атрибуты не используются) -->
 |стиль_заголовков          = 
 |стиль_списков             = 
 |стиль_нечетных            = 
 |стиль_четных              = background:#f0f0f0

 |стиль_вверху = 
 |вверху       = 

 |заголовок| ваш заголовок1
 |список| ваш список1

 |заголовок| ваш заголовок2
 |список| ваш список2

...

 |заголовок| ваш заголовокN
 |список| ваш списокN

 |стиль_внизу  = 
 |внизу        = 
}}<noinclude>

[[Категория:Навигационные шаблоны|{{PAGENAME}}]]
</noinclude>

Данный вариант оставлен для совместимости с уже имеющимися навигационными шаблонами. Просьба его не использовать!

{{Навигация
 |имя                       = {{подст:PAGENAME}}
 |state                     =  
 |стиль_основного_заголовка = 
 |заголовок                 = 
 |изображение               = 
 |стиль_тела                = <!-- (или "стиль =" если никакие другие стилевые атрибуты не используются) -->
 |стиль_заголовков          = 
 |стиль_списков             = 
 |стиль_нечетных            = 
 |стиль_четных              = background:#f0f0f0

 |стиль_вверху = 
 |вверху       = 

 |заголовок1   = 
 |список1      = 

 |заголовок2   = 
 |список2      =

...

 |заголовок23  = 
 |список23     = 

 |стиль_внизу  = 
 |внизу        = 
}}<noinclude>

[[Категория:Навигационные шаблоны|{{PAGENAME}}]]
</noinclude>

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

Поскольку новый вариант навигации реализуется через безымянные параметры, то использование символа = в тексте приведет к ошибкам. Это особенность языка шаблонов и тут уже ничего не попишешь. Для обхода проблемы символ = можно экранировать. Для этого существует отдельный полуофициальный шаблон {{=}}

Параметры

Обязательные

имя

Имя шаблона, необходимое для корректной работы ссылки на редактирование шаблона. Для простоты можно использовать {{subst:PAGENAME}}.

заголовок

Текст, отображаемый в верхней строке таблицы. Обычно это тема шаблона, краткое описание его содержания. Как правило, одна строка, но если требуется отобразить текст в двух строках, используйте {{-}} для корректного центрирования.

Цвета фона по умолчанию — #ccf (сокращенная форма от #ccccff), он может быть изменен через параметр стиль_основного_заголовка (см. ниже).

Необязательные

Ячейки

|заголовок|

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

например |заголовок|Книги превратится в Книги

Цвет фона по умолчанию — #ddf (сокращенная форма от #ddddff), он может быть изменен через параметр стиль_заголовков (см. ниже).

|список|

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

например |список|А, Б, В, Г, Д превратится в А, Б, В, Г, Д

изображение

Изображение, которое будет отображено под основным заголовком в правой части таблицы (правее заголовков/списков). Параметр изображение допускает стандартный викикод для отображения, то есть

[[Файл:Пример.jpg|100px]]

В шаблоне, не растянутом на всю ширину страницы, изображение будет отображено со сдвигом от правого края шаблона. Для того, чтобы этого избежать, используйте параметр right в викикоде, то есть

[[Файл:Пример.jpg|80px|right]]

вверху

Ячейка во всю ширину таблицы, располагающаяся непосредственно под основным заголовком (то есть над заголовками/списками тела шаблона).

внизу

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

Стили

стиль_основного_заголовка

CSS-стили, которые должны быть применены для основного_заголовка, как правило цвет фона:

background:#nnnnnn;

background:name;

стиль_тела или стиль

CSS-стили, которые должны быть применены для тела шаблона. Если никакие другие стилевые параметры не указываются, может быть использована сокращенная форма стиль. Эта опция должна применяться в редких случаях, так как может вести к визуальным расхождениям. Примеры:

background:#nnnnnn;

text-align:[right/center/left/justified];

width:N[em/%/px];

float:[left/right/none];

clear:[right/left/both/none];

Для получения таблицы, похожей на вариант из англовики en:template:navbar, нужно задать стиль:

|стиль_тела= font-size:85%;

стиль_заголовков

CSS-стили, которые должны быть применены для ячеек заголовок_n. Этот параметр имеет более высокий приоритет по сравнению со стилями, примененными к таблице целиком. Примеры:

background:#nnnnnn;

text-align:[left/center/right];

vertical-align:[top/middle/bottom];

white-space:nowrap;

стиль_списков

CSS-стили, которые должны быть применены ко всем спискам. Имеет более низкий приоритет по сравнению с параметрами стиль_нечетных и стиль_четных (если они указаны).

стиль_нечетных

стиль_четных

CSS-стили, которые должны быть применены к нечетным или четным спискам соответственно. Обычно используется для задания цвета фона (background:#nnnnnn;), для того чтобы получить строки таблицы перемежающегося цвета.

стиль_вверху

стиль_внизу

CSS-стили, которые должны быть применены к верхней (указанной параметром вверху) и нижней (указанной параметром внизу) ячейкам. Обычно используется для задания цвета фона или выравнивания текста:

background:#nnnnnn;

text-align:[left/center/right];

Другое

state

По умолчанию — autocollapse. Если указано значение state = collapsed, навигационная таблица всегда будет появляться в скрытом состоянии. Если указано пустое значение или любое значение за исключением autocollapse и collapsed, навигационная таблица будет всегда появляться в раскрытом состоянии. Навигационная таблица с параметром autocollapse будет появляться в скрытом состоянии, если на странице есть две или более таблицы с атрибутом collapsible. Технически продвинутым сюда: MediaWiki:Common.js.

Иногда редакторам требуется навигационный шаблон с состоянием по умолчанию, которое можно переопределить в статье. Для этого в Вашем промежуточном шаблоне создайте одноименный параметр «state», просто передающий значение базовому шаблону:

| state = <includeonly>{{{state|состояние по умолчанию}}}</includeonly>

(<includeonly> нужно для того, чтобы при просмотре шаблона на его странице он всегда оставался в раскрытом состоянии).

Примеры

Обычный

Исходный код:

{{Навигация
|имя = Уютненькая Лисапедия
|state            = 
|заголовок        = Великая и прекрасная Лисапедия
|стиль_тела = background-color:white

|заголовок|История
|список|[[История posmotre.li|Старая посмотрелка]] • [[Участник:ЗаяцВолк/История Posmotreli.su|Текущая история]] • [[Захватить мир|Будущее]]

|заголовок|Нвахи
|список|[[История posmotre.li/posmotre.ch|Posmotre.ch – все просравшие нвахи]] • [[Участник:ЗаяцВолк/История_Posmotreli.su#Нео,_это_не_те_таблетки!|Neolurk.org – больные нвахи]] 

|заголовок|Любимые занятия
|список|[[Заглавная страница|Любоваться шлюхами]] • [[Служебная:Требуемые_страницы|Писать статьи]] • [[Переименование статей|Переименовывать статьи]]

|заголовок|Любимые авторы
|список|[[Метавселенная Рудазова|Александр Метавселенная Рудазова]] • [[Лавкрафтианские ужасы|Говард Лавкрафтианские ужасы]]
}}

С картинками и кастомными стилями

Исходный код:

{{Навигация
|имя = Уютненькая Лисапедия
|state            = 
|заголовок        = Великая и прекрасная Лисапедия
|стиль_основного_заголовка = background:#ddffdd
|стиль_тела = background-color:white
|изображение = [[Файл:Девушка_в_фартуке.png|120px]]
|стиль_четных = background:#f0f0f0

|заголовок|История
|список|[[История posmotre.li|Старая посмотрелка]] • [[Участник:ЗаяцВолк/История Posmotreli.su|Текущая история]] • [[Захватить мир|Будущее]]

|заголовок|Нвахи
|список|[[История posmotre.li/posmotre.ch|Posmotre.ch – все просравшие нвахи]] • [[Участник:ЗаяцВолк/История_Posmotreli.su#Нео,_это_не_те_таблетки!|Neolurk.org – больные нвахи]] 

|заголовок|Любимые занятия
|список|[[Заглавная страница|Любоваться шлюхами]] • [[Служебная:Требуемые_страницы|Писать статьи]] • [[Переименование статей|Переименовывать статьи]]

|заголовок|Любимые авторы
|список|[[Метавселенная Рудазова|Александр Метавселенная Рудазова]] • [[Лавкрафтианские ужасы|Говард Лавкрафтианские ужасы]]

|стиль_внизу = background:#ddffdd
|внизу = [[Дамы сайта в отставке|Больше дам, богу дам!]]
}}

Подгруппы навигации

Если вы хотите, чтобы навигационная таблица делилась на подразделы, то дополнительно используйте Шаблон:Поднавигация

---

Текст ниже подгружается с соответствующей страницы документации

---

Это шаблон – который позволяет делать дополнительные блоки в навигационных шаблонах (см. Шаблон:Навигация).

Для быстрой вставки

{{Поднавигация
|заголовок|Ваш заголовок
|список|Ваш список

|заголовок|Ваш заголовок №2
|список|Ваш список №2

|заголовок|Ваш заголовок №Х
|список|Ваш список №Х
}}

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

стиль_тела или стиль

CSS-стили, которые должны быть применены для тела шаблона. Если никакие другие стилевые параметры не указываются, может быть использована сокращенная форма стиль. Эта опция должна применяться в редких случаях, так как может вести к визуальным расхождениям. Примеры:

background:#nnnnnn;

text-align:[right/center/left/justified];

width:N[em/%/px];

float:[left/right/none];

clear:[right/left/both/none];

Для получения таблицы, похожей на вариант из англовики en:template:navbar, нужно задать стиль:

|стиль_тела= font-size:85%;

стиль_заголовков

CSS-стили, которые должны быть применены для ячеек заголовок_n. Этот параметр имеет более высокий приоритет по сравнению со стилями, примененными к таблице целиком. Примеры:

background:#nnnnnn;

text-align:[left/center/right];

vertical-align:[top/middle/bottom];

white-space:nowrap;

стиль_списков

CSS-стили, которые должны быть применены ко всем спискам. Имеет более низкий приоритет по сравнению с параметрами стиль_нечетных и стиль_четных (если они указаны).

стиль_нечетных

стиль_четных

CSS-стили, которые должны быть применены к нечетным или четным спискам соответственно. Обычно используется для задания цвета фона (background:#nnnnnn;), для того чтобы получить строки таблицы перемежающегося цвета.

Примеры

Код

{{Навигация
|имя = Уютненькая Лисапедия
|state            = 
|заголовок        = Великая и прекрасная Лисапедия
|стиль_тела = background-color:white

|заголовок|История
|список|
{{Поднавигация
|заголовок|Додревняя
|список|[[История posmotre.li]] 

|заголовок|Настоящее
|список|[[Участник:ЗаяцВолк/История Posmotreli.su|Летописи старпома]] 

|заголовок|В планах
|список|[[Захватить мир]]
}}

|заголовок|Любимые занятия
|список|[[Заглавная страница|Любоваться шлюхами]] • [[Служебная:Требуемые_страницы|Писать статьи]] • [[Переименование статей|Переименовывать статьи]]

|заголовок|Любимые авторы
|список|
{{Поднавигация
|заголовок|Российские
|список|[[Метавселенная Рудазова|Александр Метавселенная Рудазова]] 

|заголовок|Зарубежные
|список|[[Лавкрафтианские ужасы|Говард Лавкрафтианские ужасы]]
}}
}}