Szablon:Dts
Dts to skrót od Data – Tabela – Sortowanie (ang. Date Table Sorting). Szablon jest używany, aby prawidłowo sortować daty w tabelach. Daty w tabelach są prawidłowo sortowane wyłącznie, gdy podane są w formacie rok-miesiąc-dzień, który nie jest powszechnie używany.
Użycie[edytuj kod]
{{dts|dzień|miesiąc|rok}}
Wszystkie parametry są opcjonalne (możliwe jest "puste" wywołanie: {{dts|||}} / {{dts}}
).
Nawet jeśli rok nie będzie podawany, dobrze jest zostawić dla niego miejsce ({{dts||sty|}}
) dla edycji w przyszłości.
Szablon automatycznie dodaje ukryty kod <span style="display:none">1776-07-04 </span>
umożliwiający sortowanie i wyświetla datę w preferowanym formacie „4 lipca 1776”.
Wywołania szablonu są oznaczane znacznikiem (dts), który w przestrzeni artykułów (głównej) jest widoczny tylko podczas edycji w edytorze wizualnym (lub na podglądzie strony, jeśli używamy edytora kodu). Znacznik pomaga w odnajdywaniu dat wpisanych ręcznie, które mogą negatywnie wpływać na kolejność sortowania. Dodatkowe oznaczenia: (dts) tr - obecny jest tylko rok, (dts) br - informacja o nie podaniu roku wprost (patrz także Generowane klucze sortowania).
Parametry[edytuj kod]
Wywołanie szablonu używa trzech opcjonalnych parametrów, liczby poniżej 10 można podawać z wiodącym zerem.
| 1 =
- dzień miesiąca (1-31), dodawany tylko wtedy gdy podano miesiąc
| 2 =
- miesiąc w postaci słownej (3-lit. skrót, wikt:mianownik lub wikt:dopełniacz) lub liczbowej (1-12)
| 3 =
- rok w postaci liczby, lub linku do liczby ([[2021]]
)
Przykładowe wywołania[edytuj kod]
- Przykład 1
{{Dts|4|7|1776}}
wyświetla:
(dts)
4 lipca 1776- Przykład 2
{{Dts|4|7|[[1776]]}}
wyświetla:
1776(dts)
4 lipcaGenerowane klucze sortowania[edytuj kod]
- {{dts}} -> (dts) tr, klucz:
<span style="display:none">0000 </span>
- {{dts|||2021}} -> 2021(dts) tr, klucz:
<span style="display:none">2021 </span>
- {{dts|12|sty|2021}} -> 12 stycznia 2021(dts), klucz:
<span style="display:none">2021-01-12 </span>
- {{dts|2|sty|}} -> 2 stycznia(dts) br, klucz:
<span style="display:none">0000-01-02 </span>
Szczególne przypadki (milisekunda zapewnia pierwszeństwo mm przed mm-01):
- {{dts|1|sty|}} -> 1 stycznia(dts) br, klucz:
<span style="display:none">0000-01-01T00:00:00.001 </span>
- {{dts||sty|}} -> stycznia(dts) br, klucz:
<span style="display:none">0000-01-01T00:00:00.000 </span>
Dokumentacja VE[edytuj kod]
Szablon służący do poprawnego sortowania dat w tabelach.
Parametr | Opis | Typ | Status | |
---|---|---|---|---|
dzień | 1 | dzień miesiąca, wymaga podania miesiąca
| Liczba | sugerowany |
miesiąc | 2 | nazwa miesiąca (3-lit. skrót, mianownik, dopełniacz) lub jego numer
| Ciąg znaków | sugerowany |
rok | 3 | rok w postaci liczby, lub liczba w postaci linku
| Liczba | sugerowany |
Błędy[edytuj kod]
Błędne (niepełne) wywołania są zbierane w kategoriach:
Powyższy opis jest dołączany ze strony Szablon:Dts/opis. (edytuj | historia)
Edytorzy mogą eksperymentować w brudnopisie (edytuj | różnice) i na stronach testowych (edytuj) tego szablonu. Kategorie należy dodawać do podstrony /opis. Zobacz podstrony tego szablonu. |