Уикипедия:Шаблони – Уикипедия
Първи стъпки | Правна рамка | Енциклопедично съдържание | Уикиетикет | Редактиране на страници | Портал на общността | Навигация |
Шаблоните в Уикипедия са страници, които се вграждат в страниците на статиите, с цел лесно повтаряне на информация. Съществуват много причини дадена информация да бъде изнесена в шаблон, но основните са:
- лесно обновяване на често променаща се иформация, която трябва да присъства в повече на брой страници (пример: шаблонът за настоящия състав на някой футболен отбор);
- лесно оформление на важна информация и оформането ѝ по кретивен начин.
В статиите е прието да се вграждат единствено шаблон от именното пространство Шаблон:, въпреки че фукционалностите на Уикипедия позволяват дадена страница да бъде вградена в друга.
Използване на шаблони
[редактиране на кода]Шаблоните се използват, като името на шаблона се включи на желаното място в желаната страница, оградено от двойка фигурни (къдрави) скоби:
{{нобел литература}}
С изключение на първата буква, останалите букви от името на шаблона правят разлика между малки и главни, т.е. извикването {{Нобел литература}}
ще проработи, но извикването {{Нобел Литература}}
– няма.
Ако шаблонът се използва с параметри, употребата му става като те се добавят в страницата:
{{Биография инфо | име = | портрет = | описание = | наставка = | роден-дата = [[]] [[]] | роден-място = [[]], [[]] | починал-дата = [[]] [[]] | починал-място = [[]], [[]] }}
и попълнят:
{{Биография инфо | име = Васил Левски | портрет = Vasil_Levski.jpg | описание = български национален герой | наставка = | роден-дата = [[18 юли]] [[1837]] | роден-място = [[Карлово]], [[България]] | починал-дата = [[18 февруари]] [[1873]] | починал-място = [[София]], [[България]] }}
Незадължителните параметри могат да бъдат спокойно изтрити, ако е ясно, че няма да бъдат никога използвани, например параметъра наставка
от шаблон {{Биография инфо}}
, попълнен в статия за мъж. Незадължителните параметри, които има смисъл да бъдат попълнени, но за които вие нямате нужната информация, е по-добре да се оставят – те няма да се виждат на страницата и да пречат, но могат във всеки момент от време да бъдат попълвани от други уикипедианци.
Изнасянето на отделните параметри на нови редове не е задължително, но изглежда по-прегледно при по-голям брой на параметрите.
Освен че спазват един и същ формат, шаблоните обикновено си имат и традиционни места, където стоят в рамките на статиите. Например шаблонът {{Биография инфо}}
и други сходни ({{Тенисист}}
, {{Актьор}}
, {{Монарх}}
, ...) се разполагат най-горе в статията, като могат да бъдат предшествани например от шаблони за техническа поддръжка като {{Сливане}}
, {{Обработка}}
, {{Друго значение}}
. Други шаблони обикновено се разполагат в края на статията, като хоризонталните навигационни шаблони, шаблоните за мъничета и т.н.
Ако за първи път използвате даден шаблон или не сте сигурни по отношение на параметрите и употребата му, проверете на страницата му за инструкции или се ориентирайте от видяното в други статии, които вече то ползват.
Избор на шаблон в режим на редактиране
[редактиране на кода]Някои от често използваните в Българоезичната Уикипедия шаблони са достъпни през падащи менюта в режим на редактиране. Имайте предвид, че този изглед е локално направена настройка и в други сродни проекти и чуждоезични версии на Уикипедия изгледът в режим на редактиране ще изглеждат по различен начин.
Към януари 2008 година в режим на редактиране са достъпни шаблоните:
- От меню „Елементи от статията“ –
{{Сортиране по ключ}}
,{{Мъниче}}
,{{Към пояснение}}
- От меню „Тематични шаблони“ –
{{Биография инфо}}
,{{Книга}}
,{{Писател}}
,{{Музикален албум}}
,{{Личност/Музикант}}
,{{Музикална група}}
,{{Филм}}
,{{Актьор}}
,{{Футболен отбор}}
,{{Футболист}}
,{{Тенисист}}
,{{Таксокутия}}
,{{Самолет}}
- От меню „Работни шаблони“
- От подменю „Шаблони за статии“ –
{{Авторски права}}
,{{Бързо изтриване}}
,{{Друго значение}}
,{{Изтриване}}
,{{Източник}}
,{{Микромъниче}}
,{{Обработка}}
,{{Пояснение}}
,{{Превод от}}
,{{Редактирам}}
,{{Сливане}}
,{{Сюжет}}
,{{Цитат}}
,{{Цитат уеб}}
,{{Уикицитат}}
,{{Commons}}
,{{Commonscat}}
,{{IMDB Name}}
,{{IMDB Title}}
- От подменю „Шаблони за беседи“ –
{{Добре дошли}}
,{{Неподписано}}
- От подменю „Шаблони за категории“ –
{{Категория}}
,{{Категория инфо}}
- От подменю „Шаблони за шаблони“ –
{{Навигационен шаблон}}
- От подменю „Шаблони за статии“ –
В менютата са включени и някои други елементи, които обаче не са изброени тук, тъй като не са шаблони. Ако ви интересуват подробности за употребата на всеки от тези шаблони, кликнете на препратката под името му, за да отидете на страницата му. Повечето от шаблоните съдържат инструкции за употребата, а можете и да се ориентирате по кода на шаблона (погледнат в режим на редактиране).
Списък на абсолютно всички шаблони има на тази специална страница. Голяма част от тях са категоризирани в Категория:Шаблони.
Модификатори. Динамична и статична употреба
[редактиране на кода]Има два основни начина за употреба на шаблоните в страниците:
- динамична употреба (чрез включване, transclusion), когато в страницата пишете
{{Име на шаблона}}
(например{{нобел литература}}
) - статична употреба (чрез заместване, substitution), когато пишете
{{замест:Име на шаблона}}
(например{{замест:добре дошли}}
)
Модификаторът замест:
(или ЗАМЕСТ:
или subst:
) е вълшебна думичка, която в шаблона работи, като заменя низа {{Име на шаблона}}
с пълно копие на съдържанието на шаблона и го запазва наред с останалата част от текста на страницата. Така заместеното съдържание представлява „моментна снимка“ на шаблона към момента на съхраняване на редакцията и е невъзможно повече да отразява по автоматичен начин настъпилите в шаблона промени след този момент.
Дали шаблонът ще се използва статично или динамично зависи от неговия тип, конкретната ситуация и потребността, която удовлетворява. Някои общи насоки са, че:
- Ако шаблонът е предназначен за беседа, т.е. съдържа текст, който ще се включва като част от реплика в дискусия, или приветствие към новодошли редактори, е препоръчително да се използва със заместване.
- Ако съдържанието на шаблона се променя често и статиите, в които той се включва, трябва да отразяват актуалното състояние, шаблонът следва да се използва без заместване.
- Ако е нужно да се поддържа статистика за страниците, които съдържат шаблона, той трябва да се използва без заместване. Статистиката е достъпна с инструмента „Какво сочи насам“.
Съществува още един начин за употреба на шаблон в страница, но той се използва сравнително рядко: употреба с модификатора {{msgnw:}}
. При тази команда на екран се извежда не резултатът от шаблона, а неговият пълен програмен код (включително includeonly- и noinclude-секциите, които не се извеждат при субституция). Например след съхранение на следното:
{{msgnw:икона|en}}
на екрана на страницата се извежда кодът на извикания шаблон {{икона|en}}
(кодът е актуален към момента на четене):
- <includeonly>{{#ifeq:{{#language:{{{1}}}|bg}}|{{{1}}}|<strong class="error">Грешка в записа: Неразпознат езиков код "{{{1}}}"</strong>|<span style="color:blue; font-size:0.8em; cursor:help;" title="На {{#language:{{{1}}}|bg}} език">'''('''({{{1}}})''')'''</span>}}</includeonly><noinclude>{{документация}}</noinclude>
но в кода на страницата продължава да стои само {{msgnw:икона|en}}
без да се е получила субституция.
Следващата таблица обобщава всичко казано по-горе в раздела:
Текстови препратки към шаблони
[редактиране на кода]Ако искате просто да направите текстова препратка към шаблон, без да го използвате реално, вариантите са няколко:
1. кодът [[Шаблон:Биография инфо]] | извежда Шаблон:Биография инфо |
2. кодът [[Шаблон:Биография инфо|Биография инфо]] | извежда Биография инфо |
3. кодът {{ш|Биография инфо}} | извежда {{Биография инфо}} |
4. кодът {{ш2|Биография инфо}} | извежда {{Биография инфо}} |
Видове шаблони
[редактиране на кода]Съществуват множество различни шаблони и множество различни категоризации на шаблоните. Шаблоните се различават по много неща, като например:
- предназначението, с което са създадени,
- информацията, която съдържат,
- именното пространство и мястото в страницата, където се поставят,
- сериозността на проблема, за който сигнализират,
- реакцията, която се очаква да предизвикат,
- тематичната област, към която принадлежат...
Шаблони се ползват и в статиите, и в дискусионните страници, и в описателните страници на картинките, и в категориите, и в служебните страници от именно пространство Уикипедия, както и в личните потребителски страници (наричат се потребителски шаблони). Един от първичните признаци на разграничение между шаблоните е и дали съдържат параметри за попълване или не.
Шаблони в статиите
[редактиране на кода]Съществуват различни видове шаблони, които се използват в рамките на основното именно пространство, това на статиите. Най-общо тези шаблони биват два вида:
- шаблони за организиране на енциклопедична информация, и
- шаблони за техническа поддръжка.
Шаблоните за организиране на енциклопедична информация от своя страна биват с параметри и без параметри.
Инфокутии
[редактиране на кода]- Шаблоните, които съдържат параметри за попълване, се наричат инфокутии (още: карета с показатели, инфобокс-шаблони, от английски: infobox), а другите – навигационни шаблони. Обикновено техните имена са в ед.ч., понеже се отнасят само за един обект.
- Инфокутиите използват в максимална степен софтуерните заложби на шаблона. Те са широк клас шаблони, необходими да представят най-важната информация за дадения обект да се поднесе в максимално синтезиран, фактологичен вид и то по начин, изискващ от редакторите минимални познания по уикиформатиране и програмиране.
- По принцип полетата на инфокутиите трябва да са оформени и попълнени еднотипно във всички статии, които ползват даден шаблон, но на практика това невинаги е нужно или възможно, затова и добре направените шаблони са реализирани така, че гъвкаво да се адаптират към разполагаемата информация или в определени случаи отделни елементи от дизайна на шаблона (размер на картинки, цвят на рамката) да могат също да се променят на място.
- При създаването на инфокутия трябва да се има предвид следното нещо: веднъж когато бъде направен и започне включването му по статиите, е силно нежелателно да се правят промени на имената на параметрите или добавяне на нови. Премахването в последствие на параметри не се отразява по никакъв начин, но промяната или добавянето на параметри изисква обхождане и корекции на страниците викащи шаблона, което при голям брой такива страници е неефективно. Затова още във фазата на проектиране на инфокутията е добре да се мисли за евентуалните бъдещи надграждания.
Пример за употреба на инфокутията {{Планина}} {{Планина | име = Мусала̀ | изглед = Musala_IMG_1447.jpg | изглед-описание = Връх Мусала, сниман от района на Близнаците | карта = България Софийска област | гео-ширина = 42.1797 | гео-дължина = 23.5867 | местоположение = [[Софийска област]], [[България]] | част-от = [[Рила]] | височина = 2 925,4 | първо-изкачване = | карта-файл2 = }}
|
|
Навигационни шаблони
[редактиране на кода]- Навигационният шаблон обикновено съдържа списък от препратки към известен брой статии, свързани по силата на някакъв критерий (отразен в името на шаблона). Поради тази причина техните имена се изписват най-често в мн.ч. Включва се в статиите от този списък и не предполага да съдържа параметри. Особеност на навигационния шаблон е, че препратката към съответната статия, в която е включен, е форматирана в получер шрифт и изпъква на фона на останалите препратки. Навигационните шаблони биват изцяло текстови или комбинирани – текст + подходяща тематично подбрана картинка.
- Навигационните шаблони са особено подходящи да демонстрират мястото на някой обект на енциклопедична статия в съответен на него добре дефиниран окръжаващ контекст.
- Например в статията за България са поставени няколко навигационни шаблона, които ситуират страната ни в няколко различни контекста:
{{Европа}}
– България сред страните географски разположени на територията на континента Европа,{{Балкани}}
– България сред страните географски разположени на територията на Балканския полуостров,{{Европейски съюз}}
– България сред страните-членки на Европейския съюз,{{НАТО}}
– България сред страните-членки на НАТО{{Антарктически нации}}
– България сред страните, изпратили мисии на континента Антарктида.
- Не е добра идея критерият на включване в навигационен шаблон да е твърде общо формулиран, тъй като така шаблонът ще стане твърде голям, връзката между понятията ще е по-слаба и дори неочевидна, и ще наложи по-малък кегел на буквите в шаблона. За дълги и по-общо формулирани списъци от статии има други форми на организация на информацията – не е задължително това да е шаблон. Предимството на шаблона е неговата стройна организация и съпътстващите я лаконичност и изчерпателност.
Шаблони за поддръжка на статии
[редактиране на кода]- Освен да организират енциклопедична информация, в основното именно пространство се ползват и служебни шаблони, които дават определена информация за съдържанието на статиите (не за обектите им): например, че статията е избрана или че в нея е установен някакъв проблем, който трябва да бъде изчистен. Шаблоните за техническа поддръжка, сигнализиращи за проблеми, варират много по отношение естеството и сериозността на проблема, както и по отношение на ситуациите, в които могат да се слагат и махат.
- Опитът е показал, че съществуват пет степени на градация на шаблоните за поддръжка, по отношение на сериозността на проблема, за който съобщават.
type=serious – При най-сериозните поводи, които могат да доведат до изтриване на статията, като {{микромъниче}} , {{изтриване}} и {{бързо изтриване}} |
type=content – При проблеми със съдържанието, като {{спорна неутралност}} , {{без източници}} и други. |
type=style – При проблеми с форматирането и стила, като {{обработка}} и други. |
type=notice – Бележки към редакторите и читателите, например {{редактирам}} и други. |
- Шаблоните за поддръжка могат да бъдат форматирани и по друг начин и с други картинки. Посетете описателните им страници за допълнителна информация за употребата им.
- При много от шаблоните, редакторите могат спокойно да премахнат шаблона, когато вече са извършили изисканите подобрения. В други случаи, обаче, премахването на шаблона е нежелателно и е препоръчително да се проведе дискусия на беседата на страницата или с потребителя, поставил шаблона. Понякога тези дискусии могат да се проточат по-дълго време от очакваното, но премахването на шаблона преди достигане до консенсус може само да влоши обстановката и да се възприеме като вандализъм. Като форма на вандализъм може да се възприеме и произволното поставяне на служебни шаблони, и да се санкционира по съответен начин.
- Добрата практика е, когато се поставя такъв шаблон, това да се отразява и в резюмето на редакцията. Колкото по-сериозен е поставеният шаблон, толкова повече нараства необходимостта от обосновка на това решение – тъй като невинаги и не за всекиго е очевидно защо той е поставен. Обосновката може да се направи в рамките на шаблона (ако той борави с такъв параметър), в резюмето на редакцията или на беседата на статията. Също така при поставяне на шаблони, сигнализиращи за сериозни нередности, не е редно редакцията да се отбелязва като малка промяна.
Други шаблони за статии
[редактиране на кода]- Текстови шаблони:
{{overline}}
,{{underline}}
, ... – форматират текста - Езикови шаблони:
{{lang|en}}
,{{lang|de}}
, ... с един параметър съдържащ изписването в оригинал на лично име или заглавие на творба. - Езикови икони:
{{икона|en}}
,{{икона|de}}
,{{икона|ru}}
,... – знак, който се поставя пред външна препратка и указва на какъв език (какви езици) е съдържанието в препратката - Шаблони към сродни проекти:
{{уикицитат}}
,{{уикикниги}}
,{{уикиизточник}}
,{{общомедия}}
и други, представляващи красиво оформени кутийки с препратки към страници в сродни на Уикипедия проекти с допълнителна информация по дадена тема. - Графични шаблони
- Други:
{{цитат}}
, ...
- Текстови шаблони:
Шаблони за дискусионни страници
[редактиране на кода]– Основно – | Беседа: |
Потребител: | Потребител беседа: |
Уикипедия: | Уикипедия беседа: |
Картинка: | Картинка беседа: |
МедияУики: | МедияУики беседа: |
Шаблон: | Шаблон беседа: |
Помощ: | Помощ беседа: |
Категория: | Категория беседа: |
С изключение на специалните страници, останалите именни пространства са асоциирани със съответни дискусионни именни пространства. Когато разглеждаме шаблоните за дискусионни страници, ще имаме предвид всички тях.
За разлика от статиите в основното именно пространство, които не се подписват, в рамките на обсъжданията репликата трябва да се подписват. Когато по някаква причина дадена реплика не е подписана, е уместно след края ѝ да се постави шаблон {{неподписано}}
с параметър потребителското име или IP адреса на автора на репликата.
Нова реплика може да се оформи и като в началото ѝ се постави шаблон {{коментар}}
, {{въпрос}}
. При обсъждания с гласуване пък се използват шаблоните {{за}}
, {{против}}
, {{пас}}
.
Потребителски шаблони
[редактиране на кода]Потребителските шаблони, наричани още потребителски кутийки са шаблони, предвидени да се поставят от редакторите в личните им потребителски страници и да дават определена информация като лични интереси и компетенции, географско разположение и друга информация свързана с личността и приносите им в Уикипедия. Потребителските кутийки обикновено представляват цветна кутийка с картинка и текст в трето лице „Този потребител…“
Най-често използваният потребителски шаблон е {{Вавилон}}
, чрез който уикипедианците посочват езиците, които ползват, и степента им на владеене. По-подробни обяснения има на Уикипедия:Вавилон. Често се ползват и шаблони, с които редакторите указват, че излизат в уикиваканция.
Потребителските кутийки са особен вид шаблони, тъй като от една страна смисълът да са реализирани именно като шаблони е само в случай, че се ползват от достатъчно много потребители. От друга страна потребителите понякога желаят да персонализират допълнително тези кутийки. Преди да се пристъпи към промени по потребителската кутийка, редно е да се провери дали тя не се ползва и от други редактори (с инструмента „Какво сочи насам“) и ако да, да не се внасят (значителни) изменения в съдържанието преди да е получено и тяхното съгласие.
Шаблони за категории
[редактиране на кода]В страниците от именно пространство Категория:
се използват само няколко шаблона.
Най-често използваният е шаблон {{категория}}
, който би трябвало да стои на всички страници от това именно пространство. Много често той е придружен и от шаблон {{категория инфо}}
, който има за единствен параметър заглавието на статия, която е възможно най-пряко свързана с името на категорията. Например, основна за Категория:Българи е едноименната статия Българи, а за Категория:Носители на Нобелова награда за физика смислово най-близката статия е Нобелова награда за физика.
Освен това, в категориите е полезно да се съдържат препратки и към страници от други сродни на Уикипедия проекти, чието съдържание е свързано с категорията. Например в Категория:България е подходящо да се постави препратка към Category:Bulgaria в Общомедия, а в Категория:Земноводни - препратка към Amphibia от Уикивидове. Тези препратки са реализирани с шаблони за сродни проекти. Освен в категории е подходящо те да се поставят и в страници от основното именно пространство.
Предложенията за изтриване на категории също се отразяват с {{изтриване}}.
Шаблони за ... шаблони
[редактиране на кода]Създаване на шаблони
[редактиране на кода]Шаблонът е страница от именно пространство Шаблон:
и може да се създаде по същия начин както и всяка друга страница, с тази разлика, че името задължително се предшества от префикса на именното пространство.
Един възможен вариант е чрез формуляра по-долу, в който предварително е вписан необходимият за тази цел префикс Шаблон:
и от потребителя се иска само да добави името на новия шаблон:
Другите варианти са като се използва полето „Търсене“ в навигационната лента, като се заложи червена препратка в страница или като шаблонът се създаде направо от адресната лента на браузъра (работи само при някои браузъри).
Трябва да се има предвид, че правенето на шаблони изисква повече умения от обикновеното уики-форматиране, а в определени случаи са нужни и умения по програмиране.
Въпреки това много уикипедианци без специални умения успешно си правят нови шаблони, като копират от кода на подобни стари, добре работещи шаблони и правят необходимите замени. Трудности могат да възникнат когато промяната се състои в добавяне или премахване на параметри, или в промяна на задължителни параметри в опционални, или обратно. Също така по-трудни са шаблоните, които използват някои вълшебни думички или викат на свой ред други шаблони.
Ако имате проблем с някой шаблон, най-добре потърсете помощ на Уикипедия:Желани шаблони или Уикипедия:Разговори.
Параметри
[редактиране на кода]Шаблоните се използват за включване на повтарящи се текстове и картинки в множество страници и за стандартизиране на оформлението. Понякога обаче се налага част от текста да бъде „индивидуализиран“ спрямо конкретната страница, в която се вмъква. Тези елементи на шаблоните, които могат да са различни в различните страници, се наричат параметри. Напр. в шаблона за личности като параметър ще се включва годината на раждане, да кажем 1983. В случая 1983 е стойност на параметъра за година.
На практика повечето шаблони в Уикипедия се използват с параметри, тъй като те правят възможно шаблоните по-добре да се приспособяват към конкретни ситуации или потребности в статиите и другите страници.
Параметрите могат да изискват разнообразни стойности: числа, букви, произволен текст, вътрешни препратки, външни препратки, имена на файлове, подписи, и какво ли още не.
Най-общо, в кода на шаблона параметърът се оформя между тройка отварящи и затварящи фигурни скоби {{{}}}
. Между тях се слага името на параметъра. Може след името да се сложи вертикална чертица (|
) и стойността по подразбиране. Ако искаме по подразбиране да не се показва нищо, след чертата няма да се сложи нищо ({{{1|}}}
). Ако не се укаже стойност по подразбиране, тогава по подразбиране параметърът ще се покаже както изглежда в кода (например: от {{{ааа}}}
ще излезе {{{ааа}}}), освен ако не се даде стойност на параметъра.
В рамките на страница, която вика шаблона, отделните параметри се разделят с вертикална чертица: |
. След чертичката се слага името на параметра, = и стойността му. Ако името на параметра е число, може да се напише само стойността и автоматично ще се предположи, че първата стойност важи за параметъра 1, следващата за 2 и т.н...
Пример: {{цитат|ааа|еее}}
= {{цитат|1=ааа|2=еее}}
= {{цитат|2=еее|1=ааа}}
Наименувани и позиционни (безименни)
[редактиране на кода]В кода на шаблона на мястото, където трябва да се включи стойността на параметъра, се указва името на параметъра.
Когато името на параметъра е просто неговият пореден номер, т.е. естествено число, този параметър се нарича позиционен. При включването на такива шаблони в страниците поначало не е необходимо да се посочва номерът на параметъра, напр. {{обработка|форматиране}}
. Затова тези параметри се наричат и безименни.
Когато името на параметъра е една или повече думи, той се нарича наименуван. Когато шаблонът се въвежда в страница, името на параметъра трябва да бъде последвано от знак за равенство =
, след което се изписва стойността му. Например {{Цитат уеб | уеб_адрес = bg.wikipedia.org}}
.
Няма правило, което да регламентира кога даден шаблон да се реализира с именувани, и кога с безименни (позиционни) параметри. Практиката показва, че при малък брой параметри, до 3, могат да се използват безименни параметри. Оттам нагоре възниква проблемът, че освен че трябва да се помни какви типове стойности иска всеки параметър, трябва да се съблюдава и последователността им. Например при включване на шаблона за {{превод от}}
друга Уикипедия в края на някоя статия не е едно и също дали ще се напише (вярното) {{превод от|en|Jimbo Wales}}
или (грешното) {{превод от|Jimbo Wales|en}}
.
Затова при по-сложните шаблони обикновено се използват именувани параметри. При тях окръжаващите интервали нямат значение, както е без значение и редът, в който са попълнени параметрите. За прегледност в рамките на кода, обикновено всеки параметър се изнася и попълва на нов ред.
Поради техническа особеност на позиционните параметри в МедияУики, стойностите им не могат да съдържат символа = (равно). За дадени параметри обаче това може да е необходимо. Напр., ако параметърът е създаден за стойности, които са интернет адреси, понякога те могат да съдържат =. В такива случаи за коректна визуализация ще се наложи да бъде посочен номерът на безименния параметър, т.е. да се процедира като с наименуван параметър. Например: {{превод от|en|2=E=mc2}}
.
Възможно е в рамките на един шаблон да има и безименни, и именувани параметри, но с такива шаблони се работи трудно и не са препоръчителни.
Задължителни и незадължителни
[редактиране на кода]Параметрите също така могат да бъдат задължителни или незадължителни (опционални). Ако остане непопълнен незадължителният параметър, съответните части от шаблона, които го съдържат, няма да се визуализират на екрана. Непопълнените задължителни параметри обаче си личат. За да се направи един параметър незадължителен, се използва парсерна функция, като например #if:
.
Вълшебните думички като параметри
[редактиране на кода]Освен всичко, като параметри могат да се използват и променливи от списъка със заложените в софтуера „вълшебни думички“. За разлика от именуваните и безименните параметри, вълшебните думички стоят между двойки, а не между тройки от фигурни скоби.
Име на шаблона и параметрите
[редактиране на кода]По принцип е прието шаблоните да се наименуват на български език и на кирилица, освен ако няма сериозни основания за друго. Важат и някои технически ограничения.
Софтуерно е заложено, първата буква в името винаги да се капитализира. По тази причина шаблонът може да се вика и с малка, и с главна първа буква. При останалите букви от името, обаче, софтуерът прави разлика между малки и главни букви. Затова е по-удобно е да се използват изцяло малки букви, както и лаконични, но информативни имена на шаблоните.
Лаконични, но информативни имена са за предпочитане и при параметрите на шаблона. Съветът е и тях да изписвате с изцяло малки букви. Съществува тази особеност, че ако в шаблона са заложени параметри с малки букви, то шаблонът ще работи и ако при извикването му първите букви на параметрите са изписани като главни. Обратното не е в сила: ако първите букви на параметрите са заложени в шаблона да са главни, при извикването му с малки букви в началото на параметрите, ще дава грешка. Тоест по-надеждно е параметрите винаги да се изписват с малки букви.
Имената на различните параметри трябва да бъдат уникални. Могат да съдържат кирилица или латиница. Препоръчва се името на параметъра достатъчно ясно да говори за типа данни, които се очакват като вход, или това да е описано в инструкцията за ползване на шаблона.
Блокове noinclude, includeonly и onlyinclude
[редактиране на кода]Освен кода на шаблона, такъв какъвто ще излиза на страниците, които го използват, в страницата на шаблона може да се съдържа и друга информация, обособена в блокове <noinclude> и <includeonly> и <onlyinclude>. Те не са задължителни, но обикновено има основания да присъства <noinclude>-блок.
- Блок <noinclude>
- Всичко, което се съдържа в блока между двойката команди
<noinclude>...</noinclude>
, се обработва и визуализира само и единствено на страницата на шаблона, и не се появява в страниците, които динамично или статично използват шаблона. Приложенията на този блок са например за:- въвеждане на инструкции за употреба на шаблона,
- категоризиране на шаблона,
- междуезикови препратки към страници от други уикита, съдържащи аналогичния шаблон, и други.
- Блок <includeonly>
- Работи на обратния принцип. Всичко, което се съдържа в блока между двойката команди
<includeonly>...</includeonly>
, се обработва и визуализира само и единствено в страниците, които динамично или статично използват шаблона, но не и в самата негова страница. Приложенията на този блок са например за автоматично категоризиране на страниците, съдържащи даден шаблон, в подходяща категория, в която самият шаблон няма място.
- Блок <onlyinclude>
- Съдържанието между двойката команди
<onlyinclude>...</onlyinclude>
, се третира по следния начин: в страниците, викащи шаблона, се визуализира само това съдържание (без тялото на шаблона, без <includeonly> блока), а на страницата на шаблона се визуализират съдържанието, блокът <onlyinclude> и блокът <noinclude> (т.е. всичко без <includeonly>).
- Възможни проблеми
Трябва да се има предвид, че новите редове и интервалите в началото са от значение. Например ако в кода на шаблона, с цел прегледност, командата <noinclude>
е изведена на нов ред:
... <noinclude>...</noinclude>
това означава, че този нов ред ще се появи в края на шаблона и ще се визуализира в страницата, а в някои случаи и да създаде проблем. Обикновено точно този проблем е трудно да се диагностицира, тъй като е известно, че само един нов ред (Enter) при уики-форматирането не се отчита.
Същото е и положението с интервалите в началото на шаблона или на блок от шаблона. Например ако в кода на шаблона е написано
...<includeonly> ... </includeonly>
с интервал след командата <includeonly>
, тогава в страниците, съдържащи шаблона, този интервал ще форматира принудително текста като програмен код: с шрифт с фиксирана ширина и на сив фон.
Скриване и показване на шаблони
[редактиране на кода]Управление на шаблони
[редактиране на кода]Пренасочвания между шаблони
[редактиране на кода]Някои от често използваните шаблони си имат „синоними“, с които също могат да се викат за удобство. Например шаблонът {{Бързо изтриване}}
има синоними {{Бързо}}
и {{Fast}}
. Такива пренасочвания между шаблони се правят по същия начин като пренасочванията между статии, с командата #виж
.
Защита на шаблони. Езотерични шаблони
[редактиране на кода]Някои шаблони се използват в голямо количество статии и, същевременно, в тях не се налагат чести промени. В определени случаи се преценява тези шаблони да бъдат частично или напълно защитени, тъй като необоснованите промени и вандализмите по тях биха довели до ненужна промяна на всички статии, в които са включени, и излишно претоварване на сървърите. Подобренията по такива шаблони е добре да бъдат обсъждани първо на съответните дискусионни страници и изпробвани в тестова страница.
Някои шаблони, наречени „езотерични“, използват доста усложнени свойства на синтаксиса и промяната им може да произведе неочаквани резултати. Препоръчва се да не бъдат променяни от потребители, които не са сигурни, че разбират съдържанието и целта на шаблона, както и също да бъдат предварително тествани на място за експерименти.
Особености
[редактиране на кода]- Шаблонът
{{!}}
- В някои шаблони е необходимо да се вмъкват таблици, а при таблиците също се използват вертикални чертици
|
. За да се прави разграничение между двете употреби на вертикалните чертици, за таблиците се използва шаблонът{{!}}
. Ако просто е необходимо символът|
да се покаже на екран, трябва да се използва|
или<nowiki>|</nowiki>
.
- Fair-use картинки в именно пространство
Шаблон:
- Според изискванията за честна употреба на файлове, в частност изображения, те могат да се ползват единствено в основното именно пространство и никъде другаде, в частност не могат да се използват в именно пространство
Шаблон:
.
- Проблеми при превод на шаблони от други уикипедии
- Както и при статиите, използването, преводът и адаптацията на готови шаблони от други уикипедии е един от най-разпространените начини за създаване на нови локални шаблони. Един от най-често срещаните проблеми е, ако шаблонът включва в себе си други шаблони, дефинирани в другото уики, но все още не съществуващи локално. Не е задължително всеки път да се създават всички такива извиквани шаблони, понякога това може да се избегне с известна адаптация на кода. Как ще се процедира в такива случаи зависи най-вече от броя и сложността на шаблоните, които допълнително трябва се създадат, за да проработи желаният.
- Добавката 1= при позиционни (безименни) параметри
- В редки случаи при шаблоните с безименни параметри може да се наблюдава аномалията стойността на параметъра да не се визуализира в режим на четене, въпреки че присъства в кода на страницата в режим на редактиране. Проблемът се отстранява, като безименният параметър изкуствено се кръщава с поредния номер, под който присъства в кода на шаблона. Например:
{{бързо изтриване|1 = вандализъм}}
.
- Активиране на промяна в шаблон с „празна редакция“
- Когато се направи редакция в шаблон, промяната не се отразява автоматично в статиите, които съдържат шаблона. За да се форсира тази промяна, е необходима така наречената празна редакция (null edit), с която се опреснява кешът. Празната редакция се прави, като се отвори страницата в режим на редактиране и се съхрани, без да се правят никакви промени. Такава редакция не се запазва в историята на страницата, нито в Последните промени, а евентуалното резюме на редакцията се игнорира.
Категории
[редактиране на кода]- Литература:
{{Герой поредица}}
,{{Навигатор поредица}}
,{{Колелото на времето}}
,{{Гръцка митология 1}}
,{{Гръцка митология 2}}
,{{Гръцка митология 3}}
,{{Олимпийски богове}}
,{{Древногръцки морски божества}}
,{{Хтонични божества}}
,{{Изначални богове}}
,{{Титани}}
,{{Нимфи}}
,{{Аргонавти}}
,{{Херкулес}}
,{{Римска митология}}
- Средна земя:
{{Айнури от Средната земя}}
,{{Джуджета от Средната земя}}
,{{Оръжия от Средната земя}}
,{{Полуелфи}}
,{{Род на Финарфин}}
- Средна земя:
- Забавление:
{{Игра}}
,{{Fps}}
,{{Blizzard}}
,{{Quake}}
- Шахмат:
{{Шахматна позиция}}
,{{Шахматни фигури}}
- Шахмат:
- Култура:
{{ОСН Югоизточна Европа}}
,{{ОСН Италия}}
,{{Чудеса на света}}
,{{Древни цивилизации}}
- Религии:
{{Теми свързани с религията}}
,{{Християнство}}
,{{Ислям}}
,{{Бахаизъм}}
,{{Сатанизъм}}
,{{Православни празници}}
,{{Апостоли}}
,{{Сура}}
- Наука и техника:
{{Количество байтове}}
,{{Програмен език}}
,{{Химически елемент}}
,{{Огнестрелни оръжия}}
,{{GTLD}}
,{{Компютърен хардуер}}
- Техника:
{{Автомобил}}
,{{Плавателен съд}}
,{{Летателен апарат}}
- Астро:
{{Нептун}}
,{{Юпитер}}
,{{Сатурн}}
,{{Звезда}}
,{{Малки планети}}
,{{Съзвездие}}
,{{Съзвездия}}
,{{Астероиден навигатор}}
,{{Зодиак}}
- Космически изследвания:
{{Пилотирани космически полети на САЩ}}
,{{Пилотирани космически полети на СССР и Русия}}
,{{Космически совалки}}
,{{Космически апарат}}
,{{Програма Вояджър}}
,{{Програма Венера}}
,{{Програма Луна}}
,{{Програма Аполо}}
,{{Хора, стъпили на Луната}}
- Техника:
- Спорт:
{{Екипи}}
,{{Екип отбор}}
,{{Екип}}
,{{Олимпийски игри}}
,{{„А“ футболна група}}
,{{Западна Б Група}}
,{{Конструктори Формула 1}}
,{{Конструктор Ф1}}
,{{Пилот Ф1}}
,{{Бивш пилот Ф1}}
,{{Състезание Ф1}}
,{{Футболен отбор}}
,{{Футболист}}
,{{Стадион}}
,{{Баскетболен отбор}}
,{{Волейболен отбор}}
- Медали:
{{МедалНачало}}
,{{ЗлатенМедал}}
,{{СребъренМедал}}
,{{БронзовМедал}}
,{{МедалКрай}}
- Футболни отбори:
{{Бела}}
,{{Берое}}
,{{БотевПд}}
,{{Вихрен}}
,{{Левски}}
,{{Литекс}}
{{ЛокоПд}}
,{{ЛокоСф}}
,{{Марек}}
,{{Рилецо}}
,{{Родопа}}
,{{Славия}}
,{{СпартакВн}}
,{{ЦСКА}}
,{{Черноморе}}
,{{ЧерноморецСф}}
- Медали:
- Време:
{{Календар}}
,{{Месеци}}
,{{Век}}
- Писмени знаци:
{{Глаголица}}
- Древен Египет:
{{Hiero}}
,{{Hiero/рамка}}
,{{Hiero/фон}}
,{{Hiero/1картуш}}
,{{Hiero/2картуша}}
,{{Hiero/3имена}}
,{{Hiero/Имена}}
,{{Hiero/серех}}
- IPA:
{{Гласни}}
,{{Съгласни}}
- Древен Египет:
- Източници: виж Уикипедия:Шаблони/Източници
- Потребителски кутийки: виж Уикипедия:Шаблони/Потребителски кутийки
- Беседа:
{{Архиви}}
,{{Архив беседа}}
, виж още Уикипедия:Емотикони
Вижте също
[редактиране на кода]- Страници на български език
- Информация за шаблоните в Наръчника на уикипедианеца
- Уикипедия:Проектиране на шаблони – уикипроект, посветен на дългосрочното планиране и проектиране на шаблони
- Уикипедия:Проектиране на шаблони/Инфокарета/Налични
- Уикипедия:Желани шаблони
- Уикипедия:Вълшебни думички
- Уикипедия:Организиране на информацията – сравняване на навигационните шаблони с таблиците, списъците и категориите
- Страници на английски език
- Wikipedia:Template namespace
- Wikipedia:Navigational templates
- Wikipedia:Template messages
- Wikipedia:Transclusion, Wikipedia:Template substitution
- Wikipedia:Categories, lists, and navigational templates
- Help:Template в МетаУики
- Template:String templates see also text – списък от шаблони за обработка на текстови низове, много от които вече са копирани тук