Help:Templates
Jeśli masz standardowy tekst który chcesz dołączyć do kilku
stron, szablony MediaWiki wkraczają do akcji.
Contents
Tworzenie szablonów
Szablony są poprzedzone: Template:,[[Help:Starting
a new page|tworzysz je tak jak nową stronę wiki].
Używanie szablonów
Szablony są stronami wiki które mogą być używane na trzy
sposoby:
{{Name}}'transcludes'
(zawierają kopię) zawartość szablonu (zgromadzona na stronie
[[Template:Name]])
{{subst:Name}}zastępuje ciąg
znaków z zawartością szablonu, kopia szablonu może być potem
edytowana normalnie (oddzielnie od oryginalnego szablonu).
{{msgnw:Name}}zawiera szablon w
takiej formie, która wyświetla go jako surowca składnię wiki.
Używanie prametrów
| Template:Hl2 colspan="2" align="center" |Szablon z numerowanymi
paramertrami | |
'''A little thank you...'''<br>
<small>for {{{1}}}.<br>
hugs, {{{2}}}</small>
| |
| Template:Hl2|Twój typ | Template:Hl2|Otrzymujesz |
{{Thankyou|all your hard work|Joe}}
|
|
| Template:Hl2 colspan="2" align="center" |with named
parameters | |
'''A little thank you...'''<br>
<small>for {{{reason}}}.<br>
hugs, {{{signature}}}</small>
| |
| Template:Hl2|Twój typ | Template:Hl2|Otrzymujesz |
{{Thankyou
|reason=all your hard work
|signature=Joe}}
|
|
Możesz zdefiniować numerowane parametry w szablonie
{{{1}}} albo nazwane
{{{param}}}.
Przykład: Chcesz napisać notkę z podziękowaniem. Będzie
zawierała wyjaśnienie i podpis. Możesz stworzyć
Template:Thankyou do wpisania swojego tekstu, tak jak w
przykładzie w tabelce.
Kiedy używasz szablonów na stronie, wypełniasz wartość
parametru, rozdzieloną zankiem (|):
{{Thankyou|all your hard work|Joe}}. Żeby
nazwać parametry użyj: "name=value" pary rozdzielone znakiem
(|): {{Thankyou|reason=all your hard
work|signature=Joe}}. Zaletą nazywania
parametrów w szablonie jest jest to że są one w elastycznej
kolejnośći. To także sprawia że szablon jest łatwiejszy w
zrozumieniu jeśli ma wiele parametrów.
Możesz także zadeklarować domyślną wartość parametru, tzn.
wartość która będzie używana jeśli żadna wartość parametru nie
zostanie podana. Na przykład: {{{reason|all your
hard work}}} da rezultat "all your hard
work" jeśli ni zostanie podana żadna wartość parametru:
reason.
Kontrola włączania szablonu
Możesz kontrolować włączanie szablonu przy pomocy:
<noinclude> oraz
<includeonly>.
Wszystko pomiędzy <noinclude>
oraz </noinclude> tylko wtedy gdy
storna jest oglądana bezpośrednio.
Możliwe aplikacje to:
- Kategoryzacja szablonów
- Linki do podobnych szablonów w innych językach
- Wyjaśniające jak korzystać z szablonów
The converse is <includeonly>. Text between <includeonly> and
</includeonly> will be processed and displayed only when the page is
being included. The obvious application is to add all pages containing a given template to a category, without putting the template itself into that category.
Note: when you change the categories applied by a template, the categorization of the pages that use that template may not be updated until some time later: this is handled by the {{ #ifeq: FamiLAB Wiki | MediaWiki | job queue | [[{{#if:|{{#ifexist:Manual:Job_queue||mediawikiwiki:}}}}Manual:Job_queue|job queue]] }}.
Organizing templates
For templates to be effective users need to find them and be able to use them. A simple technique is to include an example on the template page. For example:
<noinclude>
==Usage==
Allows to establish a link to a subject:
{{NameOfTemplate|Term1+Term2+Term3}}
</noinclude>
Then, an editor can simply copy and paste the example to create a similar page.
See Also
- Help:External searches -- a template special use case example
- Help:Variables -- fancy stuff you may find in some templates
- {{ #ifeq: FamiLAB Wiki | MediaWiki | meta:Help:Embed page
| [[{{#if:|{{#ifexist:meta:Help:Embed page||mediawikiwiki:}}}}meta:Help:Embed page|meta:Help:Embed page]]
}} -- embedding pages from {{ #ifeq: FamiLAB Wiki | MediaWiki | namespaces
| [[{{#if:|{{#ifexist:namespace||mediawikiwiki:}}}}namespace|namespaces]]
}} other than Template:.Template:Languages
