Шаблон:Навигация/Документация: различия между версиями

Материал из Posmotrelisu
Перейти к навигации Перейти к поиску
Строка 87: Строка 87:


:; ''заголовок''
:; ''заголовок''
:: Текст, отображаемый в верхней строке таблицы. Обычно это тема шаблона, краткое описание его содержания. Это как правило одна строка, но если требуется отобразить текст в двух строках, используйте <code><nowiki>{{-}}</nowiki></code> для корректного центрирования.
:: Текст, отображаемый в верхней строке таблицы. Обычно это тема шаблона, краткое описание его содержания. Как правило, одна строка, но если требуется отобразить текст в двух строках, используйте <code><nowiki>{{-}}</nowiki></code> для корректного центрирования.
:: Цвета фона по умолчанию — <code><span style="background:#ccf; color:black;">#ccf</span></code> (сокращенная форма от <code><span style="background: #ccccff;">#ccccff</span></code>), он может быть изменен через параметр ''стиль_основного_заголовка'' (см. ниже).
:: Цвета фона по умолчанию — <code><span style="background:#ccf; color:black;">#ccf</span></code> (сокращенная форма от <code><span style="background: #ccccff;">#ccccff</span></code>), он может быть изменен через параметр ''стиль_основного_заголовка'' (см. ниже).
:; ''список<sub>n</sub>''
:: (то есть ''список1'', ''список2'' и т. д.) Тело шаблона, как правило набор ссылок. Элементы списка должны быть указаны на одной строке, но заключив их в <code><nowiki><div> </div></nowiki></code> , можно использовать перенос строки (см. [[#Пример с исходным кодом]]). Должен быть указан крайней мере один параметр ''список'' ; каждый дополнительный ''список'' отображается в отдельной строке таблицы. Каждый ''список<sub>n</sub>'' может быть сопровожден параметром ''заголовок<sub>n</sub>'' (см. ниже).
:: Цвета фона списка (и всей таблицы) по умолчанию — <code><span style="background:#f9f9f9; color:black;">#f9f9f9</span></code>, он может быть изменен через параметры ''стиль_тела'', ''стиль_нечетных'' и/или ''стиль_четных'' (см. ниже).


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


==== Ячейки ====
==== Ячейки ====
:; ''заголовок<sub>n</sub>''
:; |заголовок|
:: (то есть ''заголовок1'', ''заголовок2'' и т. д.) Если этот параметр указан, слева от ''списка<sub>n</sub>'' будет отображен заданный текст . Если параметр не указан, ''список<sub>n</sub>'' займет всю ширину таблицы.
:: После использования в шаблоне этого параметра, последующее значение будет заголовком в строке справа от списка.
:: например |заголовок|'''Книги''' превратится в '''Книги'''
:: Цвет фона по умолчанию — <code><span style="background:#ddf; color:black;">#ddf</span></code> (сокращенная форма от <code><span style="background: #ddddff;">#ddddff</span></code>), он может быть изменен через параметр ''стиль_заголовков'' (см. ниже).
:: Цвет фона по умолчанию — <code><span style="background:#ddf; color:black;">#ddf</span></code> (сокращенная форма от <code><span style="background: #ddddff;">#ddddff</span></code>), он может быть изменен через параметр ''стиль_заголовков'' (см. ниже).
:; |список|
:: После использования в шаблоне этого параметра, последующее значение будет, собственно списком.
:: например |список|'''А, Б, В, Г, Д''' превратится в '''А, Б, В, Г, Д'''


:; ''изображение''
:; ''изображение''
:: Изображение, которое будет отображено под основным заголовком в правой части таблицы (правее заголовков/списков). Для того, чтобы изображение отображалось корректно, должен быть указан параметр ''список1''. Параметр ''изображение'' допускает стандартный викикод для отображения, то есть
:: Изображение, которое будет отображено под основным заголовком в правой части таблицы (правее заголовков/списков). Параметр ''изображение'' допускает стандартный викикод для отображения, то есть
::: <code><nowiki>[[Файл:Пример.jpg|100px]]</nowiki></code>
::: <code><nowiki>[[Файл:Пример.jpg|100px]]</nowiki></code>
:: В шаблоне, не растянутом на всю ширину страницы, изображение будет отображено со сдвигом от правого края шаблона. Для того, чтобы этого избежать, используйте параметр right в викикоде, то есть
:: В шаблоне, не растянутом на всю ширину страницы, изображение будет отображено со сдвигом от правого края шаблона. Для того, чтобы этого избежать, используйте параметр right в викикоде, то есть
Строка 108: Строка 109:


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


:; ''внизу''
:; ''внизу''
:: Ячейка во всю ширину таблицы, располагающаяся внизу тела шаблона (то есть под заголовками/списками и изображением). В шаблоне без изображения ''внизу'' аналогичен указанию последнего параметра ''список<sub>n</sub>'' без соответствующего ''заголовок<sub>n</sub>''.
:: Ячейка во всю ширину таблицы, располагающаяся внизу тела шаблона (то есть под заголовками/списками и изображением).
<!-- Здесь возможно стоит добавить пример реального шаблона, использующего данный параметр -->
 


==== Стили ====
==== Стили ====
Строка 142: Строка 143:
:; ''стиль_нечетных''
:; ''стиль_нечетных''
:; ''стиль_четных''
:; ''стиль_четных''
:: CSS-стили, которые должны быть применены к нечетным (''список1'', ''список3'' и т. д.) или четным (''список2'', ''список4'' и т. д.) спискам соответственно. Обычно используется для задания цвета фона (<code>background:#''nnnnnn'';</code>), для того чтобы получить строки таблицы перемежающегося цвета. <!-- Здесь не мешало бы добавить пример -->
:: CSS-стили, которые должны быть применены к нечетным или четным спискам соответственно. Обычно используется для задания цвета фона (<code>background:#''nnnnnn'';</code>), для того чтобы получить строки таблицы перемежающегося цвета.


:; ''стиль_вверху''
:; ''стиль_вверху''

Версия 10:40, 3 августа 2024

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

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

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

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

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

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

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

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

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

...

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

 |стиль_внизу  = 
 |внизу        = 
}}<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            = 
|заголовок        = [[Lovecraft/Cthulhu|Ктулху]] фхтагн!
|стиль_тела = background-color:white

|заголовок1 = История
|список1 = [[До засыпания]] • [[До пробуждения]] • [[Планы на будущее]] 

|заголовок2 = Друзья
|список2 = [[Ньярли]] • [[Йог-Сотот]]

|заголовок3 = Любимые занятия
|список3 =<div style="margin-top:-1ex;margin-bottom:-1ex;padding:0"> 
[[Спать]] • [[Насылать сновидения]] • [[Призываться культистами]] • [[Пожирать культистов]] • [[Ждать парад планет]]</div>

|заголовок4 = Любимые книги
|список4 = [[Некрономикон]] • [[Собрание сочинений Говарда Лавкрафта]]
}}

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

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

{{Навигация
|имя = Ктулху
|state            = 
|заголовок        = [[Lovecraft/Cthulhu|Ктулху]] фхтагн!
|стиль_основного_заголовка = background:#ddffdd
|изображение = [[Файл:Fhtagn.jpg|120px]]
|стиль_тела = background-color:white
|стиль_четных = background:#f0f0f0

|заголовок1 = История
|список1 = [[До засыпания]] • [[До пробуждения]] • [[Планы на будущее]]

|заголовок2 = Друзья
|список2 = [[Ньярли]] • [[Йог-Сотот]]

|заголовок3 = Любимые занятия
|список3 =<div style="margin-top:-1ex;margin-bottom:-1ex;padding:0"> 
[[Спать]] • [[Насылать сновидения]] • [[Призываться культистами]] • [[Пожирать культистов]] • [[Ждать парад планет]]</div>

|заголовок4 = Любимые книги
|список4 = [[Некрономикон]] • [[Собрание сочинений Говарда Лавкрафта]]

|стиль_внизу = background:#ddffdd
|внизу = Website: [http://www.goominet.com/unspeakable-vault/ Unspeakable Vault (Of Doom)]
}}