Шаблон:Котва/doc

Настоящия шаблон дава възможност за вмъкване на един или няколко HTML фрагментни идентификатора (котви) в дадена страница. Към така създадените индентификатори могат да бъдат създадени препратки посредством следния синтаксис: [[#Location|...]].

Примери

• {{котва|Foo}}
  Препратка към тази котва от същата статия се осъществява посредтвом [[#Foo|...]].
  За препратка от друга статия към тази котва ползвайте следния синтаксис: [[Име на статията#Foo|...]].

• Котвите може да са по-подходящи за между-статийни препратки отколкото заглавията на разделите. Например:
  == {{котва|Foo}} Име на раздела ==
  По този начин препратки ползващи [[Име на статията#Foo]] ще са валидни дори ако радела бъде преименуван. (Обърнете внимание, че котвата се поставя преди името на раздела; инак има риск браузърите да скрият заглавието на раздела).

• Шаблонът може да се използва за създаването на множество котви при всяка имплементация. Например,
  {{котва|Foo|Bar|baz}}
  ще създаде три котви, чийто достъп се осъществява чрез следните препратки: [[#Foo]], [[#Bar]] и [[#baz]].

Ограничения

Символ	Код	Шаблон	Описание
"	" "	н/д	(двойни) кавички
#	#	н/д	диез
|	|	{{!}}	вертикална линия
=	=	{{=}}	равно

• Имена на котви съдържащи някой от символите показани в дясната таблицата няма да работят според очаквания. За заобикаляне на това ограничение е необходимо дадения символ да се замести с съотвения "&#" код. Като за символите вертикална черта и равно има и друг подход, чрез използването на съответно {{!}} и {{=}}. Уики код като например <sup> и <sub> (горен и долен индекс) не може да бъде ползван. Повечето от останалите символи и знаци, включително празно пространство и пунктуация, не са проблем.
• Всяко от имената на котвите в една страница трябва да е уникално и не трябва да се дублира с което и да било заглавие. Дублираните котви няма да имат очакваното поведение, тъй като #location препраща към първата котва с това име. Проверка за дублиране на котви може да се направи посредством обработка на страницата през W3C Markup Validation Service.
• Ако шаблонът се добави към заглавието на раздел то кодът ще се появи в прозореца обобщаващ редакцията когато този раздел бъде редактиран, като "/* {{anchor|Issues}}Limitations */ New issue". Съшо така при запазване на раздела, браузърите може да не се върнат на запазената секция. В тези случай обмислете възможността за директното използването на <span id="..."></span>, вместо да ползвате шаблона за котва.
• Котвените препратки при някой браузъри са чувствителни към големи и малки букви, тъй че винаги взимайте тази особеност предвид при създаването на котви.

Употреба в таблици

Котвите могат да се използват и в таблици с известни изключения. Позволена е употребата в заглавието и клетките на таблицата, но не и в тези части на таблицата попадащи извън упоменатите. Пример за ползване в надписа на таблицата:

|+ {{котва|FooX}} Заглавие на таблицата

и пример за пползване в клетки:

!{{котва|Foo1}} Заглавна на клетка
!style="background:white;" |{{котва|Foo2}} Заглавна на клетка с оформление
|{{котва|Foo3}} Клетка за данни
|rowspan=2 |{{котва|Foo4}} Клетка за данни обхващаща два реда

Котвата не бива да се поставя в тази част на оформлението предназначена за класове, стилове и т.н. както и където и да било на редове започващи с {| (начало на таблица) или |- (нов ред). Пример за неправилно поставяне:

!{{котва|Foo1}} |Заглавна клетка
!style="background:white;" {{котва|Foo2}} |Заглавна на клетка с оформление
|{{котва|Foo3}} |Клетка за данни
|rowspan=2 {{котва|Foo4}} |Клетка за данни обхващаща два реда

Ако е необходимо поставянето на котва на някоя от тези позиции използвайте id= белега. Поставя се в тази част от оформлението където могат да се ползват класове, стилове и т.н.

{| id=FooX class=wikitable
|- id=FooY
!id=Foo1 |Заглавна клетка
!style="background:white;" id=Foo2 |Заглавна на клетка с оформление
|id=Foo3 |Клетка за данни
|rowspan=2 id=Foo4 |Клетка за данни обхващаща два реда