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

{{Podstrona dokumentacji}}
<!-- DODAWAJ KATEGORIE I INTERWIKI NA DOLE STRONY -->
== Użycie ==
Szablon techniczny wywoływany automatycznie przez szablony: {{s|lang}}, {{s|lang2}}, {{s|język infobox}}, {{s|przetłumaczony}}, {{s|w języku}} i pochodne ({{s|ang.}}, {{s|łac.}}, {{s|ros.}} ...).

== Budowa ==
Szablon wykorzystuje [[Pomoc:Funkcje parsera|funkcję parsera]] #language do wykrywania czy dany język jest wspierany w Wikipedii. Z uwagi na to, że nie wszystkie zadeklarowane języki na stronie [[Pomoc:interwiki]] są prawidłowo rozpoznawane, całość jest ''opakowana'' w funkcję parsera #switch, która wyłapuje wszystkie wyjątki i języki popularne, które wyjątkami co prawda nie są, lecz #language nie działa w przypadku generowania strony w formacie PDF. Języki są pogrupowane w linie:
# ponad 500 wywołań szablonu językowego
# ponad 250 wywołań szablonu językowego
# ponad 100 wywołań szablonu językowego
# wyjątki nie obsługiwane funkcją #language
# ponad 50 wywołań szablonu językowego

Do prawidłowego działania szablonu potrzebne są pomocnicze szablony techniczne, po jednym na każdy kod języka. Ich nazwa musi mieć postać <code>Szablon:Lang/kody/''kod języka''</code> np.: {{s|Lang/kody/pl}}, {{s|Lang/kody/en}}, {{s|Lang/kody/ru}}, itd. Nazwa odpowiedniego szablonu językowego jest generowana i wywoływana na podstawie przekazanych parametrów.

Pomocniczy szablon techniczny dla wybranego języka składa się z [[Pomoc:Funkcje parsera|funkcji parsera]] #switch, zawierającej definicje kodów języków z listy [[Pomoc:Interwiki]] wg następującego schematu:

<code><nowiki>{{#switch:{{{1}}}|hasło=</nowiki>''tytuł artykułu o języku na Wikipedii''|skrót=''skrót nazwy języka''|mianownik=''[[mianownik (przypadek)|mianownik]] nazwy języka''|dopełniacz=''[[dopełniacz (przypadek)|dopełniacz]] nazwy języka''|miejscownik=''[[miejscownik]] nazwy języka''}}</code>

Zmienne elementy szablonu zaznaczono kursywą. Definiowanie skrótu nazwy języka jest opcjonalne, ale jeśli go nie zdefiniowano, należy zostawić parametr w kodzie, tak aby miał tę samą wartość, co parametr <code>mianownik</code>. Usunięcie tego parametru spowoduje nieprawidłową pracę szablonu {{s|lang}}.

Na przykład dla języka polskiego (kod "pl") szablon {{s|Lang/kody/pl}} zawiera następującą definicję:

<code><nowiki>{{#switch:{{{1}}}|hasło=</nowiki>''język polski''|skrót=''pol.''|mianownik=''polski''|dopełniacz=''polskiego''|miejscownik=''polskim''}}</code>

A dla języka xhosa (bez skrótu w {{s|Lang/kody/xh}}) następującą:

<code><nowiki>{{#switch:{{{1}}}|hasło=</nowiki>''język xhosa''|skrót|mianownik=''xhosa''|dopełniacz=''xhosa''|miejscownik=''xhosa''}}</code>

== Przykład wywołania ==

Szablon przyjmuje dwa parametry: kod języka jako parametr <code><nowiki>{{{1}}}</nowiki></code> oraz parametr <code>forma</code>. Przykłady:

{| class="wikitable"
! wywołanie
! efekt
|-
| <code><nowiki>{{lang/kody|en|forma=hasło}}</nowiki></code>
| {{lang/kody|en|forma=hasło}}
|-
| <code><nowiki>{{lang/kody|en|forma=skrót}}</nowiki></code>
| {{lang/kody|en|forma=skrót}}
|-
| <code><nowiki>{{lang/kody|en|forma=mianownik}}</nowiki></code>
| {{lang/kody|en|forma=mianownik}}
|-
| <code><nowiki>{{lang/kody|en|forma=dopełniacz}}</nowiki></code>
| {{lang/kody|en|forma=dopełniacz}}
|-
| <code><nowiki>{{lang/kody|en|forma=miejscownik}}</nowiki></code>
| {{lang/kody|en|forma=miejscownik}}
|}

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

{{-}}
<includeonly><!--
++++ DODAWAJ KATEGORIE I INTERWIKI PONIŻEJ TEJ LINII -->
[[Kategoria:Szablony do obsługi języków|{{PAGENAME}}]]

</includeonly>