Tekst źródłowy strony Szablon:Refn/opis

{{Podstrona dokumentacji}}
<!-- DODAWAJ KATEGORIE NA DOLE STRONY -->
== Użycie ==

Szablon służy do [[Pomoc:Przypisy|tworzenia przypisów w Wikipedii]] i jest alternatywą (i uzupełnieniem) dla standardowego tagu <code><nowiki><ref></nowiki></code>. Z powodu [[:mw:Extension:Cite/Cite.php#Substitution and embedded parser functions|ograniczeń technicznych oprogramowania MediaWiki]] niektóre standardowe elementy składni często używane w artykułach nie współpracują z tagami <code><nowiki><ref></nowiki></code>, ale też opartymi na nich szablonami {{s|R}} i {{s|U}}. W szczególności wewnątrz tagów <code><nowiki><ref>...</ref></nowiki></code> nie działa [[:w:en:Help:Pipe trick|trick z pionową kreską]], [[:w:en:Wikipedia:Substitution|substytucja szablonów]] za pomocą polecenia <code>subst:</code> oraz osadzanie przypisów wewnątrz przypisów: 
# <code><nowiki><ref>[[Pomoc:Przypisy|]]</ref></nowiki></code> zamiast wikilinku da w efekcie <nowiki>[[Pomoc:Przypisy|]]</nowiki>
# <code><nowiki><ref>{{#time:Y-m-d}}</ref></nowiki></code> zamiast wstawić dzisiejszą datę da w efekcie <nowiki>{{#time:Y-m-d}}</nowiki>
# <code><nowiki><ref>{{subst:Witaj}}</ref></nowiki></code> zamiast wstawić szablon {{s|Witaj}} da w efekcie <nowiki>{{Witaj}}</nowiki>
# <code><nowiki><ref>Jakaś treść<ref name="nazwa">Przypis do treści przypisu</ref></ref></nowiki></code> zamiast wstawić przypis wewnątrz przypisu lub uwagi wygeneruje kod błędu <span style="font-weight: bold; color: #CC0000;">Błąd w [[Pomoc:Przypisy#Komunikaty_b.C5.82.C4.99d.C3.B3w|przypisach]]: Znacznik <nowiki><ref></nowiki> o nazwie „CITEREFDu.nazwa”, zdefiniowany w <nowiki><references></nowiki>, nie był użyty wcześniej w treści.</span>
# Nie zadziała również próba umieszczenia przypisu rzeczowego do treści uwagi w formie przypisu zwykłego bądź oksfordzkiego <code><nowiki><ref name="uwaga1" group="uwaga">Treść.{{odn|Kowalski|2014}}</ref></nowiki></code>

Zastąpienie zewnętrznych znaczników <code><nowiki><ref></nowiki></code> niniejszym szablonem pozwala na obejście powyższych ograniczeń.

== Opis parametrów ==

<code><nowiki>{{refn|grupa=nazwa grupy|nazwa=nazwa|Treść przypisu}}</nowiki></code>

:* '''nazwa grupy''': Nazwa grupy zgodnie z [[WP:GRUPOWANIE]]
:* '''nazwa''': Nazwa przypisu (patrz strona pomocy [[Pomoc:Przypisy#Wielokrotne użycie danego przypisu|Pomoc:Przypisy § Wielokrotne użycie przypisu]]
:* opcjonalnie: '''allowlinebreak''': parametr decyduje czy szablon dopuści łamanie linii, czy też nie (dopuszczalne odpowiedzi: tak/nie/yes/no)
:* ''Treść przypisu'': <nowiki>Dozwolony jest zarówno zwykły tekst (Kowalski 2012), jak i szablony i tagi, w tym tagi ref i szablony {{odn}}</nowiki>. '''Uwaga''': Jeśli w treści występuje znak '''<code>=</code>''', całą treść przypisu należy wprowadzić wywołaniem <code><nowiki>{{refn|</nowiki>''' 1 = ''' Treść przypisu}}</code>

== Przykład ==
Szablon {{s|refn}} musi być umieszczony w treści artykułu (a nie wewnątrz szablonów {{s|Przypisy}} itp.).
* <pre>Tekst artykułu{{r|P}}, w którym umieszczamy uwagę{{refn|grupa=uwaga|Tekst uwagi<ref name="P">Przypis wewnątrz uwagi.</ref>.}} z przypisem wewnątrz niej.</pre>

: Tekst artykułu{{r|P}}, w którym umieszczamy uwagę{{refn|grupa=uwaga|Tekst uwagi<ref name="P">Przypis wewnątrz uwagi.</ref>.}} z przypisem wewnątrz niej.

; Uwagi
<references group="uwaga" />

; Przypisy
<references />

== Błędy ==
Błędy należy zgłaszać na stronie [[Wikipedia:Kawiarenka/Kwestie techniczne]].

== Parametry szablonu ([[Pomoc:Jak dodać TemplateData|strukturyzacja VE]]) ==
<templatedata>
{
	"params": {
		"1": {
			"label": "treść przypisu",
			"description": "Treść przypisu. Dozwolony jest zarówno zwykły tekst (Kowalski 2012), jak i szablony i tagi, w tym tagi ref i szablony {{odn}}. Uwaga: Jeśli w treści występuje znak =, całą treść przypisu należy wprowadzić wywołaniem {{refn| 1 = Treść przypisu}}",
			"example": "Potwierdza to Kowalski{{odn|Kowalski|2015|s=1}}",
			"required": true,
			"suggested": true
		},
		"grupa": {
			"label": "nazwa grupy",
			"example": "uwagi",
			"type": "content",
			"suggested": true,
			"description": "Nazwa grupy przypisów, które będą wywoływane wspólnie, na przykład za pomocą szablonu {{Uwagi}}"
		},
		"nazwa": {
			"label": "nazwa przypisu",
			"example": "Kowalski-2001",
			"type": "content",
			"suggested": true,
			"description": "Nazwa konkretnego przypisu"
		},
		"allowlinebreak": {
			"label": "łamanie linii",
			"description": "Czy pozwolić na łamanie linii",
			"example": "tak",
			"type": "boolean"
		}
	},
	"description": "Szablon zastępuje zestaw tagów ref używanych w edytorze kodu, dzięki czemu możliwe jest obejście niektórych ograniczeń oprogramowania MediaWiki. Dzięki niemu możliwe jest m.in. umieszczanie przypisów wewnątrz przypisów.",
	"paramOrder": [
		"grupa",
		"nazwa",
		"1",
		"allowlinebreak"
	]
}
</templatedata>
== Zobacz też ==
{{clear}}
<includeonly><!--
++++ DODAWAJ KATEGORIE PONIŻEJ TEJ LINII -->
[[Kategoria:Szablony do formatowania przypisów]]
</includeonly>