Шаблон:Navbox/doc
Предлага се този шаблон да се обедини с Шаблон:Навигационен шаблон/doc. |
Това е подстраница с документация за Шаблон:Navbox (вижте там за самия шаблон). Тя съдържа упътване за употреба, категории и друго помощно съдържание, което не е част от самата шаблон страница. |
Този шаблон позволява да бъдат създавани лесно различни навигационни шаблони.
Употреба[редактиране на кода]
{{Navbox |name = {{ЗАМЕСТ:PAGENAME}} |state = |title = |image = |above = |group1 = |list1 = |group2 = |list2 = |group3 = |list3 = ... |group20 = |list20 = |below = }}
Списък на параметрите[редактиране на кода]
|
navbox използва параметри написани на латиница, както е показано в кутийката. Задължителните параметри name и title създават навигационен шаблон с големина един ред.
Основните и най-често използвани параметри са:
name -
името на шаблонаtitle -
текстът в заглавната лента, например [[Области на България]]state -
контролира дали шаблонът е разгънат или сгънат
titlestyle -
CSS стил на заглавния ред, напримерbackground:gray;
groupstyle -
CSS стил на колоната с групи, напримерbackground:#eee;
image -
незадължителна картинка от дясната страна. Обикновено е с чисто декоративна цел, например [[Image:XX.jpg|90px|link=|alt=]]imageleft -
незадължителна картинка от лявата страна
above -
текстът над раздела за групи/списъци
groupn -
текстът в лявата колона, до n-тия списък (ако този параметър е пропуснат, n-тият списък започва в левия край на кутията)listn -
списък с уикипрепратки, често разделени със средни точки, например [[A]]{{·}}
[[B]]below -
незадължителен текст под раздела за групи/списъци
Повече подробности за тези и останалите параметри се съдържат в следващия раздел Описание на параметрите.
Описание на параметрите[редактиране на кода]
Параметри за настройка[редактиране на кода]
- name*
- Името на шаблона необходимо, за да работят правилно връзките: "п · б · р" ("преглед · беседа · редактиране"). Може да въведете
{{ЗАМЕСТ:PAGENAME}}
за по-кратко.
- navbar*
- Ако е настроен на
plain
, връзките на "п · б · р" в лявата страна на заглавния ред няма да бъдат показани, а заглавието (title) ще бъде автоматично центрирано в реда. Ако се използваoff
, връзките ще бъдат премахнати, но заглавието няма да бъде центрирано (това е за специални случаи, обикновено се използва "plain", когато не са необходими връзките). Имайте в предвид, че силно се препоръчва да не се премахват връзките, за да могат потребителите да редактират шаблона и да се запази еднаквия изглед на страниците.
- state* [
autocollapse, uncollapsed, collapsed, plain, off
]
- По подразбиране параметърът е
autocollapse
. Навигационен шаблон сautocollapse
ще се показва сгънат, ако има два или повече сгъваеми шаблона на страницата. В противен случай шаблонът ще се показва разгънат. - Ако е настроен на
collapsed
, шаблонът винаги ще се показва сгънат. - Ако е настроен на
plain
, шаблонът винаги ще се показва разгънат без бутона [скриване] вдясно, а заглавието ще остане центрирано на същото си място. - Ако е настроен на
off
, шаблонът винаги ще се показва разгънат без бутона [скриване] вдясно, а заглавието ще бъде центрирано в останалото празно място. Това е само за извънредни случаи; когато трябва да се скрива бутона [показване/скриване] е препоръчително да се използва "plain". - Ако е настроен на нещо друго освен
autocollapse
,collapsed
,plain
илиoff
(например "uncollapsed"), шаблонът винаги ще се показва в разгънат вид и ще има бутон [скриване].
- state* [
- За да се показва шаблонът разгънат, но да се сгъва автоматично, когато е в поставен самостоятелно в статия, сложете "collapsed" в тагове <includeonly>:
state =
<includeonly>collapsed</includeonly>
- border*
- Ако е настроен на
child
илиsubgroup
навигационния шаблон може да бъде вложен без рамка в друг навигационен шаблон. Рамката се скрива и няма допълнителни отстояния отстрани на шаблона, така че той се разполага точно на мястото на list в родителския шаблон. Ако е настроен наnone
рамката е скрита и отстоянията са премахнати и шаблонът може да бъде вложен във всеки друг шаблон (не използвайтеnone
, за да влагате в друг навигационен шаблон; използвайте самоchilde/subgroup
). Ако е настроен на каквото и да е друго, тогава се показва нормален навигационен шаблон с дебелина на рамката 1px. Друг начин за задаване на подгрупа в навигационния шаблон е следният (без да се използва параметъра border):{{Navbox|child
...
}}
Клетки[редактиране на кода]
- title*
- Този текст се появява в средата на най-горният ред на таблицата. Най-често това е темата на таблицата. Текстът трябва да е на един ред, но ако искате да добавите и втори ред използвайте
{{-}}
, за да бъде правилно центриран текста.
- groupn
- (например group1, group2, и т.н.) Ако е посочен параметъра текстът се появява отляво на клетката listn. Ако параметъра е пропуснат listn използва цялата ширина на клетката.
- listn
- (например list1, list2, и т.н.) Обикновено тялото на шаблона е списък от препратки. Препратките се въвеждат на един ред, но могат и да бъдат въведеждани на отделни редове с
<div> </div>
. Един параметър list е задължителен; всеки допълнителен list се появява на отделен ред в таблицата. Всеки listn може да бъде предшестван от съответен параметър groupn.
- (например list1, list2, и т.н.) Обикновено тялото на шаблона е списък от препратки. Препратките се въвеждат на един ред, но могат и да бъдат въведеждани на отделни редове с
- image
- Картинката се появява по заглавието от дясната страна на тялото (groups/lists). За да се показва картинката правилно параметърът list1 трябва да бъде зададен. Параметърът приема стандартен уикикод за показване на изображението:
[[File:XX.jpg|100px|link=|alt=]]
- imageleft
- Изображението се появява в клетката под заглавието и отляво на тялото (lists). За да се показва картинката правилно параметърът list1 трябва да бъде зададен. Използва същия уикиформат като image.
- above
- Клетка с пълната ширина на шаблона, която се появява между заглавието и group/list, т.е. над първото тяло на шаблона (група, списък или картинка).
- below
- Клетка с пълната ширина на шаблона, която се появява най-отдолу в шаблона.
Документацията е недовършена!