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

от Уикипедия, свободната енциклопедия
Направо към навигацията Направо към търсенето
[редактиране] [почистване] Template-info.png Документация

Настоящия шаблон дава възможност за вмъкване на един или няколко 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 |Клетка за данни обхващаща два реда