Szablon:Lang/opis

To jest podstrona dokumentacji dla szablonu {{Lang}}.
Zawiera ona informacje na temat sposobu użycia, kategoryzacji szablonu i inną zawartość niebędącą częścią oryginalnej strony.

Szablon służy wyłącznie do oznaczania języka linków zewnętrznych.
Do wskazania, że fragment tekstu został napisany w danym języku, służą m.in. szablony {{w języku}} ({{ang.}}, {{ros.}} itp.), {{j}} czy {{k}}.

Użycie

Szablon służy do oznaczania języka, w jakim są napisane strony, na które wskazuje link zewnętrzny.

Przykład: {{lang|en}} daje: (ang.)

Zwykle preferuje się umieszczanie szablonu po linku:

* [http://de.wikipedia.org/wiki/Wikipedia:Hauptseite Niemiecka Wikipedia] {{lang|de}}
* [http://en.wikipedia.org/wiki/ Angielska Wikipedia] {{lang|en}}
* [http://pl.wikipedia.org/wiki/Strona_główna Polska Wikipedia] {{lang|pl}}

Jeżeli strona ma kilka wersji językowych, można podać więcej kodów na dwa sposoby:

oddzielając je znakiem odstępu np. {{lang|en fr pl}}, co daje (ang. • fr. • pol.)
podawać każdy kod jako oddzielny parametr np. {{lang|en|fr|pl}}, co daje (ang. • fr. • pol.)

Sposobów tych nie można jednak łączyć.

Lista kodów języków znajduje się m.in. na stronie Interwiki.

Parametry szablonu (strukturyzacja Wizualnego Edytora)

Szablon służy do oznaczania języka, w jakim są napisane strony, na które wskazuje link zewnętrzny.

Parametry szablonu[Zarządzaj danymi szablonu]
Parametr		Opis	Typ	Status
Kod języka	`1`	Kod języka	Ciąg znaków	wymagany
Kod języka	`2`	Kod języka	Ciąg znaków	opcjonalny
Kod języka	`3`	Kod języka	Ciąg znaków	opcjonalny
Kod języka	`4`	Kod języka	Ciąg znaków	opcjonalny
Kod języka	`5`	Kod języka	Ciąg znaków	opcjonalny
Kod języka	`6`	Kod języka	Ciąg znaków	opcjonalny
Kod języka	`7`	Kod języka	Ciąg znaków	opcjonalny
Kod języka	`8`	Kod języka	Ciąg znaków	opcjonalny
Kod języka	`9`	Kod języka	Ciąg znaków	opcjonalny
Kod języka	`10`	Kod języka	Ciąg znaków	opcjonalny
Kod języka	`11`	Kod języka	Ciąg znaków	opcjonalny
Kod języka	`12`	Kod języka	Ciąg znaków	opcjonalny

Budowa

Szablon korzysta z dwóch modułów napisanych w Lua:

Moduł:Lang zawiera metody zamieniające kod języka na różne reprezentacje tekstowe,
Moduł:Lang/data zawiera dane dla wszystkich wspieranych kodów języków.

Aby skorzystać z funkcji językowych należy zastosować następującą konstrukcję:

{{#invoke:lang|nazwa funkcji|kod języka}}

Wykaz funkcji

Funkcja	Opis	Przykład	Wynik
`hasło`	tytuł artykułu w Wikipedii na temat języka	`{{LinkPediaGłówna\|{{#invoke:lang\|hasło\|en}}}}`	język angielski
`mianownik`	nazwa języka w mianowniku	`{{#invoke:lang\|mianownik\|en}}`	angielski
`dopełniacz`	nazwa języka w dopełniaczu	`{{#invoke:lang\|dopełniacz\|en}}`	angielskiego
`miejscownik`	nazwa języka w miejscowniku	`{{#invoke:lang\|miejscownik\|en}}`	angielskim
`skrót`	skrót nazwy języka lub forma w mianowniku jeśli skrót nie jest zdefiniowany	`{{#invoke:lang\|skrót\|en}}`	ang.
`istnieje`	zwraca argument wywołania lub pusty tekst jeśli kod języka nie jest rozpoznany	`{{#invoke:lang\|istnieje\|en}}`	en

Wskazówki

Aby ustrzec się błędów związanych z przekazaniem nierozpoznanego kodu języka warto korzystać z funkcji istnieje według następującego schematu:

{{#if:{{#invoke:lang|istnieje|{{{kod języka}}}}}|...treść szablonu korzystająca z pozostałych funkcji językowych...}}

Niepusty ale błędny kod języka można raportować według następującego schematu:

{{#ifeq:{{#invoke:lang|istnieje|{{{kod języka}}}}}|{{{kod języka}}}||[[Kategoria:Nierozpoznany kod języka w szablonie lang]]}}

Zobacz też

{{j}} — oznaczenie fragmentu tekstu w innym języku
{{lang2}} - szablon podlinkowuje dowolny tekst do artykułu o języku, którego kod został podany.
{{lang3}} - szablon ustawia język i jednocześnie jego klasą CSS, tekstu, kierunek i inny tekst po jego prawej stronie.