Шаблон:Рефн/док

Ово је документациона подстраница за Шаблон:Refn.
Садржи информације о коришћењу, категоријама и другом садржају који није део оригиналне странице.

Намена

Овај шаблон се користи за прављење фуснота на Википедији, као алтернатива за <ref> таг. Због техничких ограничења, неки од стандардних елемената викиозначавања који су у учесталој употреби у чланцима не раде са сетовима <ref>...</ref> тагова, што укључује (али није ограничено на) трик са усправном цртом, супституцију шаблона те друге „угнежђене” сетове <ref>...</ref> тагова. На пример, следећи примери не раде како се то очекује:

<ref>[[Помоћ:Фусноте|]]</ref> (даје: [[Помоћ:Фусноте|]] уместо викивезе)
<ref>{{SUBST:Датум-н}}</ref> (даје: {{SUBST:Датум-н}} уместо тренутног датума (на који је извршена измена када се шаблон употребио))
<ref>Фуснота за објашњавање<ref>Референца</ref></ref> (даје: Грешка цитата: Затвара </ref> који недостаје <ref> тагу)

Заменом спољашњег <ref>...</ref> сета са {{Refn}} омогућиће се коришћење елемената викиозначавања приказаних изнад.

Употреба

{{refn|group=име групе напомена|name=име напомене|Садржај (текст) напомене}}

име групе напомена: Име групе напомена према Помоћ:Фусноте (<ref group=име групе>садржај</ref>); уколико параметар није дефинисан, главна и угнежђене референце ће бити стављене у исту листу референци
име напомене: Име напомене према Помоћ:Фусноте (<ref name="име">садржај</ref>); дефинисање параметра није неопходно, а уколико се дефинише — користи томе да се текст напомене не мора преписивати ако се жели иста напомена навести више од једног пута (само треба навести исто име напомене, која мора да припада и истој групи напомена)

Имена фуснота и група морају да поштују следећа правила:

Имена су осетљива на велика и мала слова (енгл. case-sensitive).
Имена не морају да буду чисто нумеричка.
Имена морају да буду јединствена — не сме се користити исто име за дефинисање различитих група или фуснота.
Знаци навода су опциони али само ако су једини коришћени карактери/знакови слова A—Z или a—z, цифре 0—9, те симболи !$%&()*,-.:;<@[]^_`{|}~.
Коришћење било којих других карактера/знакова, укључујући размаке, захтева затварање имена у наводнике: name="име референце". (Како сви будући уређивачи неће знати о овом техничком ограничењу, препоручује се коришћење наводника у свим случајевима.)
Знакови навода морају да буду стандардни равни наводници, који се користе у енглеском језику ("); извијени или било који други наводници ће бити рашчлањени/обрађени као део имена референце.
Имена затворена у знаке навода не смеју да укључују знак „је мање” (<) или сам дупли равни знак навода ("). „Кршење” ових правила је могуће избећи коришћењем < и ", редом, а резултат ће бити исти као и да су директно употребљени < од. ".
Молимо имати у виду коришћење што једноставнијих имена, те стандардног енглеског алфабета и стандардних цифара.
Дефинисање имена је опционо и име је могуће дефинисати чак и када то није нужно. Ово ће учинити евентуалну поновну употребу референце у одређеном чланку лакшом, те тиме убрзати уређивање.

Примери употребе

Фусноте са референцама

Викиозначавање

Резултат у чланку

Пример.{{refn|group=нап.|name=прва|Напомена.<ref>Укључена референца.</ref>}}
Други пример.{{refn|group=нап.|Друга напомена.<ref>Друга укључена референца.</ref>}}
Трећи пример.{{refn|group=нап.|Трећа напомена.<ref>Референца треће напомене.</ref>}}
Понављање првог примера.{{refn|group=нап.|name=прва}}

== Напомене ==
{{reflist|group=нап.}}

== Референце ==
{{reflist}}

Пример.^{[нап. 1]} Други пример.^{[нап. 2]} Трећи пример.^{[нап. 3]} Понављање првог примера.^{[нап. 1]}

Напомене

^ ^а ^б Напомена.^[1]
^ Друга напомена.^[2]
^ Трећа напомена.^[3]

Референце

^ Укључена референца.
^ Друга укључена референца.
^ Референца треће напомене.

Супституција

Први пример испод показује да супституција не ради са регуларним <ref>...</ref> тагом (датум приступања се не приказује како треба). Други пример показује да се датум приступања супституише како треба при коришћењу {{refn}}.

Викиозначавање Резултат у чланку

<ref>{{cite web |accessdate={{Subst:Датум-н}} |title=Languages |work=Apache HTTP Server |agency=Ohloh |publisher= Black Duck Software |url=https://www.ohloh.net/p/apache/analyses/latest/languages_summary}}</ref>
{{reflist}}

^[1]

^ „Languages”. Apache HTTP Server. Black Duck Software. Ohloh. Приступљено {{Subst:Датум-н}}. Проверите вредност парамет(а)ра за датум: |access-date= (помоћ)

{{refn|{{cite web |accessdate={{Subst:Датум-н}} |title=Languages |work=Apache HTTP Server |agency=Ohloh |publisher= Black Duck Software |url=https://www.ohloh.net/p/apache/analyses/latest/languages_summary}}}}
{{reflist}}

^[1]

^ „Languages”. Apache HTTP Server. Black Duck Software. Ohloh. Приступљено 7. новембар 2024.

Грешке

Уколико се којим случајем употреби шаблон са именом групе напомена, са именом напомене и без текста напомене (нпр., {{refn|group=име групе напомена|name=име напомене|}}), порука која ће бити приказана је:

Грешка цитата: Лоша ознака <ref>; нема текста за ref-ове под именом име напомене

Уколико се којим случајем употреби шаблон без имена групе напомена, са именом напомене и без текста напомене (нпр., {{refn|group=|name=име напомене|}}), порука која ће бити приказана, и то у листи референци (не напомена), је:

Грешка цитата: Лоша ознака <ref>; нема текста за ref-ове под именом .D0.B0.D0.B1.D0.B2

Уколико се којим случајем употреби шаблон са именом групе напомена, без имена напомене и без текста напомене (нпр., {{refn|group=име групе напомена|name=|}}), порука која ће бити приказана је:

Грешка цитата: Лоша ознака <ref>; ref-ови без имена морају имати садржај. (као и у случају испод, јер име напомене у овом шаблону игра улогу имена референце; в. Шаблон:Refn#Употреба)

Уколико се којим случајем употреби шаблон без имена групе напомена, без имена напомене и са текстом напомене ({{refn|group=|name=|Садржај (текст) напомене}}), Садржај (текст) напомене ће бити исписан у листи референци (не напомена) као што би и текст обичне референце/навода био обрађен.

Уколико се којим случајем употреби шаблон без имена групе напомена, са именом напомене и са текстом напомене ({{refn|group=|name=име напомене|Садржај (текст) напомене}}), Садржај (текст) напомене ће бити исписан у листи референци (не напомена) као што би и текст обичне референце/навода био обрађен. (као и у случају изнад)

Уколико се којим случајем употреби шаблон без имена групе напомена, без имена напомене и без текста напомене, тј. ако се ниједан од могућа три параметра не попуни ({{refn|group=|name=|}}), порука која ће бити приказана је:

Грешка цитата: Лоша ознака <ref>; ref-ови без имена морају имати садржај.

Уколико се којим случајем употреби једно име за именовање групе напомена, а друго при навођењу кода за излиставање напомена (нпр., {{refn|group=једно име групе напомена|name=име напомене|Садржај (текст) напомене}} за именовање; {{reflist|group=друго име групе напомена}} за излиставање), порука која ће бити приказана (за пример малопре наведен, са називима група једно име групе напомена и друго име групе напомена) је:

Грешка цитата: Постоје ознаке <ref> за групу с именом „једно име групе напомена“, али нема одговарајуће ознаке <references group="једно име групе напомена"/>

Уколико недостаје садржај референце унутар шаблона (а и иначе, било где где се употреби <ref></ref>), порука која ће бити приказана је:

Грешка цитата: Лоша ознака <ref>; ref-ови без имена морају имати садржај.

Уколико се у садржају референце употреби знак „=” (нпр., {{refn|group=име групе напомена|name=име напомене|Садржај (текст) напомене са знаком „=”}}), порука која ће бити приказана је:

Грешка цитата: Лоша ознака <ref>; нема текста за ref-ове под именом име напомене

Проблем са знаком једнако као и са осталим знаковима који дадну грешку може се решити замењивањем истих њиховим одговарајућим ASCII декадским кодовима на следећи начин: &#код;. За знак једнако треба употребити код 61.

Листом-дефинисане референце

Тренутно, овај шаблон се не може користити са више од једном листом-дефинисаном референцом. Ако се ово којим случајем учини, резултат ће бити приказивање порука о грешкама цитата; за више информација в. bug 20707.

Види још

[прва-2] а ^б Напомена.^[1]

[4] Друга напомена.^[2]

[6] Трећа напомена.^[3]

[1] Укључена референца.

[3] Друга укључена референца.

[5] Референца треће напомене.

[7] „Languages”. Apache HTTP Server. Black Duck Software. Ohloh. Приступљено {{Subst:Датум-н}}. Проверите вредност парамет(а)ра за датум: |access-date= (помоћ)

[8] „Languages”. Apache HTTP Server. Black Duck Software. Ohloh. Приступљено 7. новембар 2024.

[нап. 1]

[нап. 2]

[нап. 3]

[1]

[2]

[3]

[1]

[1]