Szablon:Uwagi/opis: Różnice pomiędzy wersjami
Usunięta treść Dodana treść
Nie podano opisu zmian |
|||
Linia 1:
{{Podstrona dokumentacji}}
{{wysokie ryzyko|liczba=ponad 25 000}}
{{Lua|Moduł:Przypisy}}
<!-- DODAWAJ KATEGORIE I INTERWIKI NA DOLE STRONY -->
Ten szablon automatycznie generuje przypisy rzeczowe. Umieszczamy go w końcowej części artykułu,
Przypisy rzeczowe – w przeciwieństwie do bibliograficznych – są (automatycznie) oznaczane nie kolejnymi liczbami, lecz kolejnymi literami alfabetu łacińskiego.
== Użycie ==
Aby użyć szablonu w postaci standardowej, bez jawnego wskazania parametrów, należy skopiować tekst z ramki i wkleić do artykułu.
<pre>
{{Uwagi}}
</pre>
Szablon wyświetli listę przypisów należących do grupy "uwaga",
:'''''<nowiki><ref group="uwaga">tutaj treść przypisu/uwagi</ref></nowiki> Podobnie jak dla przypisów, możliwe jest nadawanie nazw uwagom, aby wykorzystać je wielokrotnie, według wzoru:
:'''''<nowiki><ref group="uwaga" name="uwaga1">tutaj treść przypisu/uwagi</ref></nowiki>'''''.
Kolejne wywołanie:
:'''''<nowiki>{{u|uwaga1}}</nowiki>''''' lub '''''<nowiki><ref group="uwaga" name="uwaga1"/></nowiki>'''''.
== Przykład ==
'''Kod''':
<div style="text-align:left;border:1px grey dashed; background: #F5F5F5; padding:0.5em;margin:0em">
<code>
"Pingyuan"'''<font color=red><nowiki><ref group="uwaga" name="uwaga1"></nowiki></font>'''<nowiki>Nazewnictwo zwyczajowe.</nowiki>'''<font color=red><nowiki></ref></nowiki></font>''' był chińskim'''<font color=red><nowiki><ref group="uwaga"></nowiki></font>'''<nowiki>Prawdopodobnie.</nowiki>'''<font color=red><nowiki></ref></nowiki></font>''' okrętem pancernym'''<font color=red><nowiki><ref group="uwaga" name="uwaga1"/></nowiki></font>'''.
<nowiki>=== Uwagi ===</nowiki><br/>
'''<font color=red><nowiki>{{Uwagi}}</nowiki></font>'''
</code></div>
:'''Co wygląda następująco:'''
{{cytat|
"Pingyuan"<ref group="uwaga" name="uwaga1"> Nazewnictwo zwyczajowe.</ref> był chińskim<ref group="uwaga"> Prawdopodobnie.</ref> okrętem pancernym<ref group="uwaga" name="uwaga1"/>.
=== Uwagi ===
{{Uwagi}}
}}
== Opis parametrów ==
{| class="wikitable"
! pole
! opis
! status
! wartość domyślna
! uwagi
|-
| ''bez nazwy''
| nazwa grupy przypisów
| opcjonalny
| uwaga
| inne typowe to <tt>mini</tt> lub <tt>infobox</tt>
|-
| <tt>1</tt>
| lista przypisów
| opcjonalny
| ''brak''
| pozwala na umieszczenie treści wszystkich uwag w jednym miejscu w kodzie – patrz [[Pomoc:Przypisy#Definiowanie_przypis.C3.B3w_w_jednym_miejscu|Pomoc:Przypisy]]
|-
| ''nazwa''
| treść przypisu o podanej nazwie
| opcjonalny
| ''brak''
| alternatywna metoda na grupowanie uwag; nazwa nie może być liczbą; szablon przyjmuje dowolną liczbę takich parametrów
|}
== Wstawianie przypisów ==
Jak w przypadku wszystkich innych merytorycznych informacji, zastosowanie do merytorycznych uwag ma zasada weryfikowalności. Dlatego też pozostaje często niezbędnym opatrzenie uwagi przypisem rzeczowym, kierującym do stanowiącego podstawę informacji źródła. Ze wzglądów technicznych nie można tego zrobić stosując znaczniki <code><nowiki><ref></nowiki></code>, jednak można w tym celu wykorzystać szablon {{s|refn}} lub <nowiki>{{#tag:ref}}</nowiki>.
<br>
;Szablon <nowiki>{{refn}}</nowiki>
: <code><nowiki>{{refn|grupa=uwaga|Tekst adnotacji<ref>Treść przypisu</ref>.}}</nowiki></code>
lub (z przywołaniem istniejącego już przypisu o zdefiniowanej nazwie):
: <code><nowiki>{{refn|grupa=uwaga|Tekst adnotacji<ref name="nazwa"/>.}}</nowiki></code>
Jeśli istnieje potrzeba przywołania jednej uwagi wielokrotnie, należy ją nazwać za pomocą parametru "nazwa=":
: <code><nowiki>{{refn|grupa=uwaga|nazwa=xxx|Tekst adnotacji<ref>Treść przypisu</ref>.}}</nowiki></code>
Tak zdefiniowaną uwagę można przywoływać wielokrotnie przez '''<nowiki><ref group="uwaga" name="xxx" /></nowiki>''' lub '''<nowiki>{{u|xxx}}</nowiki>'''.
Kolejność pól w szablonie nie ma znaczenia, może to być np. <code><nowiki>{{refn|Tekst adnotacji<ref>Treść przypisu</ref>.|grupa=uwaga}}</nowiki></code>.
<br>
<br>
;Szablon <nowiki>{{#tag:ref}}</nowiki>
Wywołanie to ma analogiczną konstrukcję:
:<code><nowiki>{{#tag:ref|Tekst adnotacji<ref>Treść przypisu.</ref>.|group=uwaga}}</nowiki></code>
:<code><nowiki>{{#tag:ref|Tekst adnotacji<ref>Treść przypisu.</ref>.|group=uwaga|name=xxx}}</nowiki></code>
:*Pola "group" i "name" muszą być umieszczone na końcu szablonu.
:*Pole <code>name=</code> jest opcjonalne.
; Uwagi
* W szablonie <code><nowiki>{{refn}}</nowiki></code> należy stosować polskie nazwy pól, <code>grupa=</code> i <code>nazwa=</code>.
* W szablonie <code><nowiki>{{#tag:ref}}</nowiki></code> należy stosować angielskie nazwy pól, <code>group=</code> i <code>name=</code>.
* Niezależnie od użytej metody:
** <u>oba szablony uwag muszą być umieszczane bezpośrednio w treści</u>, w przeciwnym razie nie działają;
** <u>nazwa grupy musi brzmieć "uwaga"</u>, natomiast zamiast "xxx" można użyć dowolnej nazwy (nie mogą to być jednak same cyfry).
=== Przykład ===
'''Kod''':
<nowiki>Przykładowy tekst{{refn|grupa=uwaga|nazwa=u1|To jest przykładowa uwaga o nazwie u1<ref>A tu jest przypis.</ref>.}} z rozwinięciem{{u|u1}}.</nowiki>
lub
<nowiki>Przykładowy tekst{{#tag:ref|To jest przykładowa uwaga o nazwie u1<ref>A tu jest przypis</ref>.|group=uwaga|name=u1}} z rozwinięciem{{u|u1}}.</nowiki>
'''Wynik''':
{{cytat|
:Przykładowy tekst{{refn|grupa=uwaga|nazwa=u1|To jest przykładowa uwaga o nazwie u1<ref>A tu jest przypis.</ref>.}} z rozwinięciem{{u|u1}}.
{{Uwagi}}
== Przypisy ==
{{Przypisy}}
}}
== Grupa <code>mini</code> ==
Wyróżnione znaczenie ma grupa o nazwie ''mini''. Stosuje się ją w szablonie umieszczanym na końcu sekcji w której były stosowane ''mini-przypisy''. W szczególności pozwala na definiowanie listy przypisów lub uwag tuż pod tabelką, w której zostały one zdefiniowane.
Aby użyć szablonu w postaci standardowej, bez jawnego wskazania parametrów, należy skopiować tekst z ramki i wkleić do artykułu.
<pre>
{{Uwagi|=mini}}
</pre>
Szablon wyświetli listę przypisów należących do grupy "mini", wstawianych w tekście według wzoru: '''''<nowiki><ref group="mini">tutaj treść przypisu</ref></nowiki>'''''.
Podobnie jak dla przypisów, możliwe jest nadawanie nazw mini-przypisom, aby wykorzystać je wielokrotnie, według wzoru: '''''<nowiki><ref group="mini" name="p1">tutaj treść przypisu</ref></nowiki>'''''; kolejne wywołanie: '''''<nowiki><ref group="mini" name="p1"/></nowiki>'''''.
:'''Przykładowy kod tekstu:'''
<div style="text-align:left;border:1px grey dashed; background: #F5F5F5; padding:0.5em;margin:0em">
<code>
<nowiki>{| class=wikitable</nowiki><br/>
! Rok !! Ludność <br/>
|-<br/>
| 1800 || 1123<br/>
|-<br/>
| 1840 || 2342'''<span style="color:red"><nowiki><ref group="mini" name="spis"></nowiki></span>'''<nowiki>Spis powszechny.</nowiki>'''<span style="color:red"><nowiki></ref></nowiki></span>'''<br/>
|-<br/>
| 1900 || 5425<br/>
|-<br/>
| 1923 || 4327'''<span style="color:red"><nowiki><ref group="mini"></nowiki></span>'''<nowiki>za Ciamciara 1988, s. 127</nowiki>'''<span style="color:red"><nowiki></ref></nowiki></span>'''<br/>
|-<br/>
| 1938 || 6842<br/>
|-<br/>
| 1950 || 8345<br/>
|-<br/>
| 1960 || 11034'''<span style="color:red"><nowiki><ref group="mini" name="spis"/></nowiki></span>'''<br/>
<nowiki>|}</nowiki>
'''<font color=red><nowiki>{{Uwagi|=mini}}</nowiki></font>'''
</code></div>
:'''Co wygląda następująco:'''
<div style="background:#fea; padding-left:2em; padding-right:2em; padding-top:1ex; padding-bottom:1ex; ">
{| class=wikitable
! Rok !! Ludność
|-
| 1800 || 1123
|-
| 1840 || 2342<ref group="mini" name="spis">Spis powszechny.</ref>
|-
| 1900 || 5425
|-
| 1923 || 4327<ref group="mini">za Ciamciara 1988, s. 127</ref>
|-
| 1938 || 6842
|-
| 1950 || 8345
|-
| 1960 || 11034<ref group="mini" name="spis"/>
|}
{{Uwagi|=mini}}
</div>
== Alternatywne grupowanie ==
Oprócz standardowego grupowania przypisów w sekcji końcowej w postaci tagów <tt><ref></tt> szablon wspiera metodę polegającą na przekazywaniu treści nazwanego przypisu w polu o nazwie takiej samej jak stosowana w treści do ich przywołania.
{| class="wikitable" style="width:100%"
!style="width:50%"| Kod
!style="width:50%"| Wynik
|- style="vertical-align:top"
|style="font-family: monospace"|
<nowiki>To jest tekst z uwagą{{u|uwaga 1}}. A to jest drugi tekst z inną uwagą{{u|uwaga 1}}{{u|uwaga 2}} do siebie zawierającą{{u|uwaga 2}} przypis{{r|Ala|Ola}}.</nowiki><br />
<br />
<nowiki>=== Uwagi ===</nowiki><br />
<nowiki>{{Uwagi</nowiki><br />
<nowiki>|uwaga 1=To jest uwaga z przypisem{{r|P1}}</nowiki><br />
<nowiki>|uwaga 2=To jest inna{{r|P1}} uwaga{{u|uwaga 1}} z innym przypisem{{r|P2}} i uwagą{{u|uwaga 2}} do siebie</nowiki><br />
<nowiki>}}</nowiki><br />
<br />
<nowiki>=== Przypisy ===</nowiki><br />
<nowiki>{{Przypisy</nowiki><br />
<nowiki>|P1=To jest przypis do uwagi</nowiki><br />
<nowiki>|P2=To jest inny przypis do innej uwagi</nowiki><br />
<nowiki>|Ala=Ala</nowiki><br />
<nowiki>|Ola=Ola</nowiki><br />
<nowiki>}}</nowiki>
|
To jest tekst z uwagą{{u|uwaga 1}}. A to jest drugi tekst z inną uwagą{{u|uwaga 1}}{{u|uwaga 2}} do siebie zawierającą{{u|uwaga 2}} przypis{{r|Ala|Ola}}.
=== Uwagi ===
{{Uwagi
|uwaga 1=To jest uwaga z przypisem{{r|P1}}
|uwaga 2=To jest inna{{r|P1}} uwaga{{u|uwaga 1}} z innym przypisem{{r|P2}} i uwagą{{u|uwaga 2}} do siebie
}}
=== Przypisy ===
{{Przypisy
|P1=To jest przypis do uwagi
|P2=To jest inny przypis do innej uwagi
|Ala=Ala
|Ola=Ola
}}
|}
== Błędy ==
Błędy należy zgłaszać na stronie
* {{ln|Kategoria:Szablon:Uwagi do sprawdzenia}}
<!--
* {{ln|Kategoria:Szablon:Uwagi z poprawnym parametrem stopień}}
* {{ln|Kategoria:Szablon:Uwagi z błędnym parametrem stopień}}
* {{ln|Kategoria:Szablon:Uwagi ze zbędnym parametrem stopień}}
* {{ln|Kategoria:Szablon:Uwagi z nietypowym parametrem stopień}}
-->
== Zobacz też ==
*
* [[Pomoc:Przypisy#Przypisy ogólne (tzw._uwagi)]]
{{clear}}
<includeonly><!--
++++ DODAWAJ KATEGORIE I INTERWIKI PONIŻEJ TEJ LINII -->
[[Kategoria:Szablony do formatowania przypisów|{{PAGENAME}}]]
</includeonly>
| |||