Изворни код странице Шаблон:Refn/док

{{документациона подстрана}}
<!-- Категорије и међувики везе иду на дно странице. -->
== Намена ==
Овај шаблон се користи за [[Помоћ:Фусноте|прављење фуснота на Википедији]], као алтернатива за {{tag|ref|o}} таг. [[:mw:Extension:Cite/Cite.php#Substitution and embedded parser functions|Због техничких ограничења]], неки од стандардних елемената [[Викиозначавање|викиозначавања]] који су у учесталој употреби у чланцима не раде са сетовима {{tag|ref}} тагова, што укључује (али није ограничено на) [[Помоћ:Трик са усправном цртом|трик са усправном цртом]], [[Википедија:Супституција шаблона|супституцију шаблона]] те друге „угнежђене” сетове {{tag|ref}} тагова. На пример, следећи примери не раде како се то очекује:
# {{tag|ref|content=<nowiki>[[Помоћ:Фусноте|]]</nowiki>}} (даје: <nowiki>[[Помоћ:Фусноте|]]</nowiki> уместо [[Википедија:Упутства/Викивезе|викивезе]])
# {{tag|ref|content=<nowiki>{{SUBST:Датум-н}}</nowiki>}} (даје: <nowiki>{{SUBST:Датум-н}}</nowiki> уместо тренутног датума (на који је извршена измена када се шаблон употребио))
# {{tag|ref|content=<nowiki>Фуснота за објашњавање<ref>Референца</ref></nowiki>}} (даје: <span style="font-weight: bold; color: #CC0000;">Грешка цитата: Затвара <code><big>'''<nowiki></ref></nowiki>'''</big></code> који недостаје <code><big>'''<nowiki><ref></nowiki>'''</big></code> тагу</span>)

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

== Употреба ==
{{tld|refn|2=group=име групе напомена|3=name=име напомене|4=Садржај (текст) напомене|allowlinebreak=yes}}

:* '''име групе напомена''': Име групе напомена према [[Помоћ:Фусноте]] ({{tag|ref|params=group=<var>име групе</var>|content=садржај}}); уколико параметар није дефинисан, главна и угнежђене референце ће бити стављене у исту листу референци
:* '''име напомене''': Име напомене према [[Помоћ:Фусноте#Вишеструко навођење једне те исте референце|Помоћ:Фусноте]] ({{tag|ref|params=name="<var>име</var>"|content=<var>садржај</var>}}); дефинисање параметра није неопходно, а уколико се дефинише — користи томе да се текст напомене не мора преписивати ако се жели иста напомена навести више од једног пута (само треба навести исто име напомене, која мора да припада и истој групи напомена)

{{Refname правила}}

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

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

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

{{fake heading|sub=3|Напомене}}
{{reflist|group=нап.}}

{{fake heading|sub=3|Референце}}
{{reflist|close=1}}
}}

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

{{markup
|<nowiki><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}}</nowiki>
|<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|template doc demo=true}}</ref>
{{reflist|close=1}}

|<nowiki>{{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}}</nowiki>
|{{refn|{{cite web |accessdate={{#time:j. F Y|{{LOCALYEAR}}{{padleft:{{LOCALMONTH}}|2|0}}{{padleft:{{LOCALDAY}}|2|0}}000000 {{#expr:-0}} days}} |title=Languages |work=Apache HTTP Server |agency=Ohloh |publisher= Black Duck Software |url=https://www.ohloh.net/p/apache/analyses/latest/languages_summary}}}}
{{reflist|close=1}}
}}

=== Грешке ===
* Уколико се којим случајем употреби шаблон са именом групе напомена, са именом напомене и без текста напомене (нпр., {{tld|refn|2=group=име групе напомена|3=name=име напомене|4=|allowlinebreak=yes}}), порука која ће бити приказана је:
::<span style="font-weight: bold; color: #CC0000;">Грешка цитата: Лоша ознака <code><big>'''<nowiki><ref></nowiki>'''</big></code>; нема текста за ref-ове под именом <code><big>'''<nowiki>име напомене</nowiki>'''</big></code></span>

* Уколико се којим случајем употреби шаблон без имена групе напомена, са именом напомене и без текста напомене (нпр., {{tld|refn|2=group=|3=name=име напомене|4=|allowlinebreak=yes}}), порука која ће бити приказана, и то у листи референци (не напомена), је:
::<span style="font-weight: bold; color: #CC0000;">Грешка цитата: Лоша ознака <code><big>'''<nowiki><ref></nowiki>'''</big></code>; нема текста за ref-ове под именом <code><big>'''<nowiki>.D0.B0.D0.B1.D0.B2</nowiki>'''</big></code></span>

* Уколико се којим случајем употреби шаблон са именом групе напомена, без имена напомене и без текста напомене (нпр., {{tld|refn|2=group=име групе напомена|3=name=|4=|allowlinebreak=yes}}), порука која ће бити приказана је:
::<span style="font-weight: bold; color: #CC0000;">Грешка цитата: Лоша ознака <code><big>'''<nowiki><ref></nowiki>'''</big></code>; ref-ови без имена морају имати садржај.</span>&emsp;<small>(као и у случају испод, јер име напомене у овом шаблону игра улогу имена референце; в. [[Шаблон:Refn#Употреба]])</small>

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

* Уколико се којим случајем употреби шаблон без имена групе напомена, са именом напомене и са текстом напомене ({{tld|refn|2=group=|3=name=име напомене|4=Садржај (текст) напомене|allowlinebreak=yes}}), ''Садржај (текст) напомене'' ће бити исписан у листи референци (не напомена) као што би и текст обичне референце/навода био обрађен.&emsp;<small>(као и у случају изнад)</small>

* Уколико се којим случајем употреби шаблон без имена групе напомена, без имена напомене и без текста напомене, тј. ако се ниједан од могућа три параметра не попуни ({{tld|refn|2=group=|3=name=|4=|allowlinebreak=yes}}), порука која ће бити приказана је:
::<span style="font-weight: bold; color: #CC0000;">Грешка цитата: Лоша ознака <code><big>'''<nowiki><ref></nowiki>'''</big></code>; ref-ови без имена морају имати садржај.</span>


* Уколико се којим случајем употреби једно име за именовање групе напомена, а друго при навођењу кода за излиставање напомена (нпр., {{tld|refn|2=group=једно име групе напомена|3=name=име напомене|4=Садржај (текст) напомене|allowlinebreak=yes}} за именовање; {{tld|reflist|2=group=друго име групе напомена|allowlinebreak=yes}} за излиставање), порука која ће бити приказана (за пример малопре наведен, са називима група ''једно име групе напомена'' и ''друго име групе напомена'') је:
::<span style="font-weight: bold; color: #CC0000;">Грешка цитата: Постоје ознаке <code><big>'''<nowiki><ref></nowiki>'''</big></code> за групу с именом „једно име групе напомена“, али нема одговарајуће ознаке <code><big>'''<nowiki><references group="једно име групе напомена"/></nowiki>'''</big></code></span>


* Уколико недостаје садржај референце унутар шаблона (а и иначе, било где где се употреби <code><nowiki><ref></ref></nowiki></code>), порука која ће бити приказана је:
::<span style="font-weight: bold; color: #CC0000;">Грешка цитата: Лоша ознака <code><big>'''<nowiki><ref></nowiki>'''</big></code>; ref-ови без имена морају имати садржај.</span>


* Уколико се у садржају референце употреби знак „=” (нпр., {{tld|refn|2=group=име групе напомена|3=name=име напомене|4=Садржај (текст) напомене са знаком „=”|allowlinebreak=yes}}), порука која ће бити приказана је:
::<span style="font-weight: bold; color: #CC0000;">Грешка цитата: Лоша ознака <code><big>'''<nowiki><ref></nowiki>'''</big></code>; нема текста за ref-ове под именом <code><big>'''<nowiki>име напомене</nowiki>'''</big></code></span>
:Проблем са знаком једнако као и са осталим знаковима који дадну грешку може се решити замењивањем истих њиховим одговарајућим -{[[ASCII]]}- декадским кодовима на следећи начин: <code>&#''код'';</code>. За знак једнако треба употребити <code>''код''</code> 61.

=== Листом-дефинисане референце ===
Тренутно, овај шаблон се не може користити са више од једном [[Помоћ:Фусноте|листом-дефинисаном референцом]]. Ако се ово којим случајем учини, резултат ће бити приказивање порука о грешкама цитата; за више информација в. [https://phabricator.wikimedia.org/T22707 -{bug}- 20707].

== Види још ==

<includeonly>
<!-- Категорије и међувики везе иду овде: -->

</includeonly>