Paweł Niemczuk: Utworzenie podstrony dokumentacji

2026-09-15T21:06:59Z

Utworzenie podstrony dokumentacji

Nowa strona

{{Podstrona dokumentacji}}

== Zastosowanie ==

Szablon '''Lw metryka pojazdu''' służy do tworzenia metryki wąskotorowego pojazdu trakcyjnego.

Wyświetla między innymi:
* typ i numer pojazdu;
* aktualny stan pojazdu;
* podstawowe dane techniczne i ewidencyjne;
* aktualne albo ostatnie oznaczenie, rozstaw toru i miejsce stacjonowania;
* dane o użytkowniku, właścicielu i kolei;
* historię stacjonowania, oznaczeń i rozstawu;
* główne zdjęcie pojazdu;
* dodatkowe informacje i szczegółowy opis;
* galerię zdjęć;
* źródła.

Szablon zapisuje również właściwości semantyczne wykorzystywane przez Semantic MediaWiki.

== Użycie ==

Minimalne wywołanie:

<pre>
{{Lw metryka pojazdu
|Stan=Sprawna
|Typ=L45H
|Numer=20567
|Rok produkcji=1967
}}
</pre>

Przykład bardziej rozbudowany:

<pre>
{{Lw metryka pojazdu
|Stan=W trakcie remontu
|Producent=FAUR
|Typ=L45H
|Numer=20567
|Rok produkcji=1967
|Rok odstawienia=2014
|Ostatnie oznaczenie=Lxd2-352
|Ostatni rozstaw=785 mm
|Ostatni typ silnika=Maybach MB 836 Bb
|Ostatnie stacjonowanie=Bytom Karb Wąskotorowy
|Ostatni kraj=Polska
|Użytkownik=Stowarzyszenie Górnośląskich Kolei Wąskotorowych
|Właściciel=Urząd Miasta Bytomia
|Kolej=Górnośląskie Koleje Wąskotorowe
|Uwagi=Brak prądnicy tachometrycznej
|Opis=Przykładowy szczegółowy opis pojazdu.
|Stacjonowanie={{Lw stacjonowanie|Rudy|1968|1990}}{{Lw stacjonowanie|Bytom Karb Wąskotorowy|1990|nadal}}
|Oznaczenie={{Lw oznaczenie|Lxd2-352|1968|nadal}}
|Rozstaw={{Lw rozstaw|785 mm|1967|nadal}}
|Grafika=Lxd2-352-karb.jpg
|Opis grafiki=Lxd2-352 w Bytomiu
|Foto1=Lxd2-352-lxd2-364-karb.jpg
|Opis1=Lxd2-352 i Lxd2-364
}}
</pre>

== Parametry ==

{| class="wikitable"
! Parametr
! Znaczenie
! Uwagi
|-
| <code>Stan</code>
| Stan pojazdu
| Określa wygląd belki stanu i wartość właściwości semantycznej. Dozwolone wartości opisano poniżej.
|-
| <code>Typ</code>
| Typ fabryczny pojazdu
| Wykorzystywany również w tytule strony i w odsyłaczu do strony typu.
|-
| <code>Numer</code>
| Numer fabryczny / seryjny pojazdu
| Wyświetlany razem z typem.
|-
| <code>Rok produkcji</code>
| Rok produkcji pojazdu
|
|-
| <code>Podtyp</code>
| Podtyp lub odmiana pojazdu
| Pole opcjonalne. Puste pole nie jest wyświetlane.
|-
| <code>Producent</code>
| Producent pojazdu
| Pole opcjonalne.
|-
| <code>Rok odstawienia</code>
| Rok odstawienia pojazdu
| Pole opcjonalne.
|-
| <code>Rok złomowania</code>
| Rok złomowania pojazdu
| Pole opcjonalne.
|-
| <code>Ostatnie oznaczenie</code>
| Aktualne lub ostatnie oznaczenie pojazdu
| Dla pojazdów istniejących wyświetlane jako „Aktualne oznaczenie”, a dla pojazdów zezłomowanych jako „Ostatnie oznaczenie”.
|-
| <code>Ostatni rozstaw</code>
| Aktualny lub ostatni rozstaw toru
| Dla pojazdów istniejących wyświetlany jako „Aktualny rozstaw”, a dla pojazdów zezłomowanych jako „Ostatni rozstaw”.
|-
| <code>Ostatnie stacjonowanie</code>
| Aktualne lub ostatnie miejsce stacjonowania
| Nazwa pola zależy od stanu pojazdu.
|-
| <code>Ostatni kraj</code>
| Kraj stacjonowania
|
|-
| <code>Ostatni typ silnika</code>
| Aktualny lub ostatni typ silnika
| Domyślna wartość: <code>Nieznany</code>.
|-
| <code>Kolej</code>
| Kolej, na której pojazd jest użytkowany lub stacjonuje
| Nie jest wyświetlana dla pojazdów o stanie <code>Złom</code>.
|-
| <code>Użytkownik</code>
| Aktualny użytkownik pojazdu
| Nie jest wyświetlany dla pojazdów o stanie <code>Złom</code>.
|-
| <code>Właściciel</code>
| Aktualny właściciel pojazdu
| Nie jest wyświetlany dla pojazdów o stanie <code>Złom</code>.
|-
| <code>Stacjonowanie</code>
| Historia miejsc stacjonowania
| Należy używać szablonu pomocniczego <code>Lw stacjonowanie</code>.
|-
| <code>Rozstaw</code>
| Historia zmian rozstawu toru
| Należy używać szablonu pomocniczego <code>Lw rozstaw</code>.
|-
| <code>Oznaczenie</code>
| Historia oznaczeń pojazdu
| Należy używać szablonu pomocniczego <code>Lw oznaczenie</code>.
|-
| <code>Uwagi</code>
| Krótkie dodatkowe informacje
| Sekcja nie jest wyświetlana, jeżeli parametr jest pusty.
|-
| <code>Opis</code>
| Szczegółowy opis pojazdu
| Może zawierać zwykły wikikod, listy oraz przypisy. Sekcja nie jest wyświetlana, jeżeli parametr jest pusty.
|-
| <code>Grafika</code>
| Nazwa głównego pliku graficznego
| Bez prefiksu <code>Plik:</code>. Jeżeli parametr jest pusty, główna grafika nie jest wyświetlana.
|-
| <code>Opis grafiki</code>
| Podpis głównej grafiki
| Pole opcjonalne.
|-
| <code>Foto1</code> – <code>Foto10</code>
| Dodatkowe zdjęcia pojazdu
| Galeria jest wyświetlana, jeżeli podano <code>Foto1</code>. Zdjęcia należy numerować kolejno od <code>Foto1</code>.
|-
| <code>Opis1</code> – <code>Opis10</code>
| Podpisy zdjęć <code>Foto1</code> – <code>Foto10</code>
| Podpis może być pusty.
|}

== Stan pojazdu ==

Parametr <code>Stan</code> może przyjmować następujące wartości:

{| class="wikitable"
! Wartość
! Znaczenie
|-
| <code>Sprawna</code>
| Pojazd sprawny.
|-
| <code>Odstawiona</code>
| Pojazd odstawiony z eksploatacji.
|-
| <code>Złom</code>
| Pojazd zezłomowany.
|-
| <code>Eksponat</code>
| Pojazd zachowany jako eksponat.
|-
| <code>Pomnik</code>
| Pojazd ustawiony jako pomnik.
|-
| <code>W trakcie remontu</code>
| Pojazd znajdujący się w trakcie remontu.
|-
| <code>Sprzedana za granicę</code>
| Pojazd sprzedany za granicę.
|-
| <code>Przebudowana</code>
| Pojazd przebudowany.
|-
| <code>Wrak</code>
| Pojazd zachowany w stanie wraku.
|-
| <code>Nieznany</code>
| Stan pojazdu nie jest znany.
|}

Wyświetlanie belki stanu oraz zapis właściwości semantycznych <code>Lw typ fabryczny</code>, <code>Lw numer seryjny</code> i <code>Lw stan</code> realizuje [[Szablon:Lw stan]].

Nieznana lub nieobsługiwana wartość parametru <code>Stan</code> jest traktowana przez ten szablon jako stan nieznany.

=== Stan „Złom” ===

Dla pojazdu o stanie:

<pre>
|Stan=Złom
</pre>

szablon używa określeń:
* „Ostatnie oznaczenie”;
* „Ostatni rozstaw”;
* „Ostatnie miejsce stacjonowania”;
* „Ostatni typ silnika”.

Nie są wówczas wyświetlane pola:
* Kolej;
* Użytkownik;
* Właściciel.

Zezłomowany pojazd nie ma aktualnego użytkownika, właściciela ani kolei, na której jest eksploatowany lub stacjonuje.

== Dane historyczne ==

Historia pojazdu jest zapisywana w trzech parametrach: <code>Stacjonowanie</code>, <code>Rozstaw</code> i <code>Oznaczenie</code>.

=== Stacjonowanie ===

Przykład:

<pre>
|Stacjonowanie=
{{Lw stacjonowanie|Rudy|1968|1990}}
{{Lw stacjonowanie|Bytom Karb Wąskotorowy|1990|nadal}}
</pre>

Składnia:

<pre>
{{Lw stacjonowanie|miejsce|od|do}}
</pre>

=== Rozstaw ===

Przykład:

<pre>
|Rozstaw=
{{Lw rozstaw|785 mm|1967|nadal}}
</pre>

Składnia:

<pre>
{{Lw rozstaw|rozstaw|od|do}}
</pre>

=== Oznaczenie ===

Przykład:

<pre>
|Oznaczenie=
{{Lw oznaczenie|Lxd2-352|1968|nadal}}
</pre>

Składnia:

<pre>
{{Lw oznaczenie|oznaczenie|od|do}}
</pre>

Wartość <code>nadal</code> oznacza stan aktualny.

Dane historyczne są prezentowane przez szablony [[Szablon:Lw dane historyczne1]] i [[Szablon:Lw dane historyczne2]].

Na szerokim ekranie historia stacjonowania zajmuje szerszą kolumnę, natomiast historia rozstawu i oznaczeń dwie węższe kolumny. Na małych ekranach wszystkie trzy bloki są wyświetlane jeden pod drugim.

== Grafika i galeria ==

Główne zdjęcie podaje się za pomocą parametrów:

<pre>
|Grafika=Nazwa-pliku.jpg
|Opis grafiki=Podpis zdjęcia
</pre>

Za wyświetlanie głównej grafiki odpowiada [[Szablon:Lw grafika]].

Galeria dodatkowych zdjęć może zawierać do 10 pozycji:

<pre>
|Foto1=Zdjęcie-1.jpg
|Opis1=Opis pierwszego zdjęcia
|Foto2=Zdjęcie-2.jpg
|Opis2=Opis drugiego zdjęcia
</pre>

Elementy galerii są tworzone przez [[Szablon:Lw galeria element]].

Pusty parametr zdjęcia nie generuje elementu galerii.

Nie należy pomijać numeracji zdjęć. Jeżeli używane są dodatkowe zdjęcia, pierwsze z nich powinno znajdować się w parametrze <code>Foto1</code>.

== Źródła ==

Przypisy można umieszczać między innymi w parametrze <code>Opis</code>:

<pre>
|Opis=Informacja o pojeździe.<ref>Źródło informacji</ref>
</pre>

Sekcja „Źródła” jest zawsze wyświetlana, także wtedy, gdy strona nie zawiera jeszcze żadnych przypisów.

Pusta sekcja może wskazywać, że informacje wymagają uzupełnienia źródeł.

== Dane semantyczne ==

Szablon wraz z używanymi przez niego podszablonami zapisuje dane jako właściwości Semantic MediaWiki.

Do najważniejszych należą między innymi:

{| class="wikitable"
! Właściwość
! Źródło danych
|-
| <code>Lw typ fabryczny</code>
| parametr <code>Typ</code>, za pośrednictwem <code>Lw stan</code>
|-
| <code>Lw numer seryjny</code>
| parametr <code>Numer</code>, za pośrednictwem <code>Lw stan</code>
|-
| <code>Lw stan</code>
| parametr <code>Stan</code>, za pośrednictwem <code>Lw stan</code>
|-
| <code>Lw rok produkcji</code>
| parametr <code>Rok produkcji</code>
|-
| <code>Lw podtyp</code>
| parametr <code>Podtyp</code>
|-
| <code>Lw producent</code>
| parametr <code>Producent</code>
|-
| <code>Lw rok odstawienia</code>
| parametr <code>Rok odstawienia</code>
|-
| <code>Lw rok złomowania</code>
| parametr <code>Rok złomowania</code>
|-
| <code>Lw ostatnie oznaczenie</code>
| parametr <code>Ostatnie oznaczenie</code>
|-
| <code>Lw ostatni rozstaw</code>
| parametr <code>Ostatni rozstaw</code>
|-
| <code>Lw ostatnie stacjonowanie</code>
| parametr <code>Ostatnie stacjonowanie</code>
|-
| <code>Lw ostatni kraj</code>
| parametr <code>Ostatni kraj</code>
|-
| <code>Lw ostatni typ silnika</code>
| parametr <code>Ostatni typ silnika</code>
|-
| <code>Lw kolej</code>
| parametr <code>Kolej</code>
|-
| <code>Lw użytkownik</code>
| parametr <code>Użytkownik</code>
|-
| <code>Lw właściciel</code>
| parametr <code>Właściciel</code>
|-
| <code>Lw uwagi</code>
| parametr <code>Uwagi</code>
|-
| <code>Lw strona</code>
| pełna nazwa strony zawierającej metrykę
|}

== Szablony podrzędne i pomocnicze ==

=== Szablony wywoływane bezpośrednio ===

`Lw metryka pojazdu` korzysta bezpośrednio z następujących szablonów:

* [[Szablon:Lw stan]] – wyświetla belkę stanu pojazdu oraz zapisuje właściwości <code>Lw typ fabryczny</code>, <code>Lw numer seryjny</code> i <code>Lw stan</code>;
* [[Szablon:Lw dane]] – wyświetla pojedynczy kafelek danych i zapisuje odpowiadającą mu właściwość semantyczną;
* [[Szablon:Lw grafika]] – wyświetla główną grafikę pojazdu i jej podpis;
* [[Szablon:Lw dane historyczne1]] – wyświetla blok historii stacjonowania;
* [[Szablon:Lw dane historyczne2]] – wyświetla bloki historii rozstawu i oznaczeń;
* [[Szablon:Lw galeria element]] – tworzy pojedynczy element przekazywany do galerii.

=== Szablony pomocnicze używane w parametrach historii ===

Poniższe szablony nie są wywoływane bezpośrednio przez `Lw metryka pojazdu`, lecz służą do przygotowania zawartości parametrów historii:

* [[Szablon:Lw stacjonowanie]] – pojedynczy wpis historii miejsca stacjonowania;
* [[Szablon:Lw rozstaw]] – pojedynczy wpis historii rozstawu toru;
* [[Szablon:Lw oznaczenie]] – pojedynczy wpis historii oznaczenia pojazdu.

== Uwagi techniczne ==

* Puste opcjonalne kafelki nie są wyświetlane.
* Układ kafelków jest responsywny i dostosowuje liczbę elementów w wierszu do szerokości ekranu.
* Główna grafika ma nominalną szerokość 300 px, ale jest skalowana responsywnie na węższych ekranach.
* Dane historyczne na szerokich ekranach są wyświetlane w proporcji około 2:1:1: szersze „Stacjonowanie” oraz węższe „Rozstaw” i „Oznaczenie”.
* Na małych ekranach bloki danych historycznych są wyświetlane jeden pod drugim.
* Galeria jest generowana tylko wtedy, gdy podano parametr <code>Foto1</code>.
* Sekcja „Źródła” jest zawsze wyświetlana.
* Wygląd szablonu jest definiowany głównie w [[MediaWiki:Common.css]].

Szablon:Lw metryka pojazdu/opis - Historia wersji

Paweł Niemczuk: Utworzenie podstrony dokumentacji