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

{{Podstrona dokumentacji}}
<!-- DODAWAJ KATEGORIE I INTERWIKI NA DOLE STRONY -->
{{Wysokie ryzyko|częste użycie|liczba=200000}}

{{Spis treści}}

== Zastrzeżenia ==

'''Uwaga!''' Nie używaj szablonu R, jeśli nie jest to konieczne. Wykorzystuje on niestandardowe mechanizmy, które nie są obsługiwane m.in. przez [[Pomoc:VisualEditor#Edycja_przypisów|VisualEditor]]. Aby zminimalizować ryzyko błędu, <u>szablon nie obsługuje nazw przypisów zaczynających się dwukropkiem</u>. Takie nazwy są generowanie automatycznie przez edytor wizualny.

Do szybkiej konwersji R na normalne przypisy możesz użyć gadżetu [[WP:SK]].

== Użycie ==
Szablony {{s|r}} i {{s|u}} służą do skracania przypisów w tekście.
<pre><ref name="nazwa przypisu" /><ref name="nazwa przypisu2" /> → {{r|nazwa przypisu|nazwa przypisu2}}
<ref name="nazwa uwagi" group="uwaga" />                 → {{u|nazwa uwagi}}</pre>

Umożliwiają wstawienie jednocześnie do 10 przypisów. 
<pre>{{r|nazwa przypisu}}
{{r|nazwa przypisu|nazwa przypisu2|nazwa przypisu3|...|nazwa przypisu10}}</pre>

Szablon {{s|r}} służy głównie do stosowania wraz z szablonem {{s|Przypisy}}, w którym przypisy zgrupowane są w jednym miejscu (w odpowiednim parametrze szablonu).

<pre>{{r|nazwa przypisu|nazwa przypisu2|nazwa przypisu3}}

== Przypisy ==
{{Przypisy|
<ref name="nazwa przypisu">przypis</ref>
<ref name="nazwa przypisu2">przypis2</ref>
<ref name="nazwa przypisu3">przypis3</ref>
}}
</pre>

Z kolei {{s|u}} pozwala skracać zapis przypisów rzeczowych (szablon {{s|Uwagi}}).

<pre>{{u|nazwa przypisu|nazwa przypisu2|nazwa przypisu3}}

== Uwagi ==
{{Uwagi|
<ref name="nazwa przypisu">uwaga</ref>
<ref name="nazwa przypisu2">uwaga2</ref>
<ref name="nazwa przypisu3">uwaga3</ref>
}}</pre>

== Opis parametrów ==
* '''<code>1</code>''', ..., '''<code>10</code>''' – nazwy przypisów (atrybut <code>name</code> znacznika <code><nowiki><ref></nowiki></code>).
* '''<code>grupa1</code>''', ..., '''<code>grupa10</code>''' – grupa przypisów (atrybut <code>group</code> znacznika <code><nowiki><ref></nowiki></code>) (tylko szablon {{s|r}}).

Szablony obsługują do 10 parametrów. W przypadku wypełnienia 11 parametru pojawi się komunikat ''Szablon obsługuje maksymalnie 10 przypisów (zmień go!)'' w miejscu wstawienia szablonu.

Nazwy przypisów nie mogą być samymi liczbami, mogą zawierać spacje. W szablonach {{s|r}} / {{s|u}} nie stosuje się cudzysłowów, jednak zaleca się ich stosowanie przy podawaniu przypisów w postaci <code><nowiki><ref name="nazwa przypisu">...</ref></nowiki></code>.

== Przykład ==
<div style="width:50%; float:right; overflow:auto; margin:0px 0px 0px 10px;"><pre>Ten tekst napisany został{{r|przypis1}}, aby jak najdokładniej
wyjaśnić działanie szablonu{{r|przypis2|przypis3}} i umożliwić stosowanie go jak
najszerszej grupie użytkowników{{u|uwaga1}}. Znacznie ułatwia on edycję
tekstów{{r|nota1|grupa1=nota}}, w których został
użyty{{r|przypis4|uwaga2|grupa2=uwaga}}, gdyż poprawia przejrzystość kodu
artykułu{{r|uwaga3|grupa1=uwaga|nota2|grupa2=nota}} i skraca wywołania
przypisów. Nagłówek ''Adnotacje'' został dodany jedynie po
to{{r|przypis5|uwaga4|grupa2=uwaga|nota3|grupa3=nota}}, aby pokazać
możliwość grupowania przypisów w więcej niż jednej grupie. Zazwyczaj
nie ma potrzeby stosowania go w artykułach.

; Uwagi
{{Uwagi|
* <ref name="uwaga1">uwaga 1.</ref>
* <ref name="uwaga2">uwaga 2.</ref>
* <ref name="uwaga3">uwaga 3.</ref>
* <ref name="uwaga4">uwaga 4.</ref>
}}

; Adnotacje
{{Przypisy|=nota|
* <ref name="nota1">nota 1.</ref>
* <ref name="nota2">nota 2.</ref>
* <ref name="nota3">nota 3.</ref>
}}

; Przypisy
{{Przypisy|
* <ref name="przypis1">przypis 1.</ref>
* <ref name="przypis2">przypis 2.</ref>
* <ref name="przypis3">przypis 3.</ref>
* <ref name="przypis4">przypis 4.</ref>
* <ref name="przypis5">przypis 5.</ref>
}}</pre></div>
Ten tekst napisany został{{r|przypis1}}, aby jak najdokładniej wyjaśnić działanie szablonu{{r|przypis2|przypis3}} i umożliwić stosowanie go jak najszerszej grupie użytkowników{{u|uwaga1}}. Znacznie ułatwia on edycję tekstów{{r|nota1|grupa1=nota}}, w których został użyty{{r|przypis4|uwaga2|grupa2=uwaga}}, gdyż poprawia przejrzystość kodu artykułu{{r|uwaga3|grupa1=uwaga|nota2|grupa2=nota}} i skraca wywołania przypisów. Nagłówek ''Adnotacje'' został dodany jedynie po to{{r|przypis5|uwaga4|grupa2=uwaga|nota3|grupa3=nota}}, aby pokazać możliwość grupowania przypisów w więcej niż jednej grupie. Zazwyczaj nie ma potrzeby stosowania go w artykułach.

; Uwagi
{{Uwagi|
* <ref name="uwaga1">uwaga 1.</ref>
* <ref name="uwaga2">uwaga 2.</ref>
* <ref name="uwaga3">uwaga 3.</ref>
* <ref name="uwaga4">uwaga 4.</ref>
}}

; Adnotacje
{{Przypisy|=nota|
* <ref name="nota1">nota 1.</ref>
* <ref name="nota2">nota 2.</ref>
* <ref name="nota3">nota 3.</ref>
}}

; Przypisy
{{Przypisy|
* <ref name="przypis1">przypis 1.</ref>
* <ref name="przypis2">przypis 2.</ref>
* <ref name="przypis3">przypis 3.</ref>
* <ref name="przypis4">przypis 4.</ref>
* <ref name="przypis5">przypis 5.</ref>
}}
{{clear}}

== Automatyczne przenoszenie przypisów ==
Istnieje narzędzie (skrypt) o nazwie [[Wikipedysta:Matma_Rex/prettyref.js|prettyref.js]] przenoszące zawartość przypisów do sekcji końcowych (Uwagi, Przypisy). Opis jego użycia znajduje się w tekście wskazanego skryptu.

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

== Zobacz też ==
* [[:Szablon:Uwagi]]
{{clear}}
<includeonly><!--
++++ DODAWAJ KATEGORIE I INTERWIKI PONIŻEJ TEJ LINII -->
[[Kategoria:Szablony do formatowania przypisów|{{PAGENAME}}]]
</includeonly>