Szablon:Koordynaty

 Dokumentacja szablonu [zobacz] [edytuj] [historia] []

Instrukcja "na szybko"
Aby wstawić współrzędne geograficzne 57°18′22″N 4°27′32″W na górę strony artykułu, użyj zapisu: {{koordynaty|57|18|22|N|4|27|32|W}}
Dla współrzędnych podanych z dziesiętnymi częściami stopnia 44.112°N 86.913°W, użyj jednej z dwóch form: {{koordynaty|44.112|N|87.913|W}} {{koordynaty|44.112|-87.913}}
Wartości (również stopnie, minuty i sekundy} są oddzielane pionową kreską. Szerokość geograficzna (N/S) powinna być podawana przed długością (E/W). Nie ma potrzeby być nadmiernie dokładnym (0.0001° to mniej niż 11 metrów, 1″ to mniej niż 31 metrów).

Użycie

Podstawowe wywołanie ma postać jak powyżej – kolejne parametry to informacje o współrzędnych geograficznych w jednym z akceptowanych formatów, oddzielone pionowymi kreskami. Powoduje ono wyświetlenie szablonu w prawym górnym rogu strony.

• {{koordynaty|57|18|22|N|4|27|32|W}} → 57°18′22″N 4°27′32″W
• {{koordynaty|44.112|N|87.913|W}} → 44°06′43.2″N 87°54′46.8″W
• {{koordynaty|44.112|-87.913}} → 44°06′43.2″N 87°54′46.8″W

Obsługiwane są wszystkie rozsądne kombinacje parametrów (np. wywołania o niesymetrycznej dokładności, odwrócona kolejność szerokości i długości geogr.), zalecane są jednak wywołania takie, jak powyżej.

Szablon wykrywa większość możliwych błędów (poza zupełnie nieprawidłowymi konstrukcjami także np. dane poza zakresem), dodając do strony kategorię Strony z błędami w parametrach szablonów współrzędnych geograficznych.

Użycie zaawansowane

Dodatkowo obsługiwane są parametry:

• umieść – na górze (domyślne), w tekście lub w tekście i na górze
  • na górze – wyświetla współrzędne w prawym górnym rogu strony, niezależnie od tego, gdzie umieszczono wywołanie szablonu
  • w tekście – wyświetla współrzędne w miejscu wywołania szablonu
  • w tekście i na górze – wyświetla w obu tych miejscach

• zapis – dziesiętnie lub kątowo (domyślne)
  • Dotyczy tylko wyświetlania, nie formatu, w którym podane są dane.
  • {{koordynaty|57|18|22|N|4|27|32|zapis=dziesiętnie}} → 57.306111111111, -4.4588888888889
  • {{koordynaty|57|18|22|N|4|27|32|zapis=kątowo}} → 57°18′22″N 4°27′32″W
  • {{koordynaty|44.112|-87.913|zapis=dziesiętnie}} → 44.112, -87.913
  • {{koordynaty|44.112|-87.913|zapis=kątowo}} → 44°06′43.2″N 87°54′46.8″W

• dokładność – dla zapisu dziesiętnego: liczba cyfr po przecinku (domyślnie bez limitu). Dla zapisu kątowego: st (do stopni), min (do minut), sek (do sekund), sek+ (do sekund z częściami dziesiętnymi, domyślne).
  • Dotyczy tylko wyświetlania, nie formatu, w którym podane są dane.
  • {{koordynaty|57|18|22|N|4|27|32|zapis=dziesiętnie|dokładność=1}} → 57.3, -4.5
  • {{koordynaty|57|18|22|N|4|27|32|dokładność=st}} → 57°N 4°W
  • {{koordynaty|44.112|-87.913|dokładność=min}} → 44°06′N 87°54′W

• linkuj – tak (domyślne) lub nie
  • Pozwala uniknąć tworzenia linku. Może być przydatne np. przy podawaniu współrzędnych na innych ciałach niebieskich, dla których nie ma map.
  • {{koordynaty|57|18|22|N|4|27|32|linkuj=nie}} → 57°18′22″N 4°27′32″W
  • {{koordynaty|57|18|22|N|4|27|32|linkuj=tak}} → 57°18′22″N 4°27′32″W

• nazwa
  • Służy do podania skróconego opisu obiektu, do którego odnoszą się współrzędne. Do użytku tylko w artykułach wykorzystujących szablon {{mapa obiektów}}; podana nazwa zostanie wyświetlona jako opis danego markera na wygenerowanej mapce.

• ostatni nienazwany parametr – dodatkowe informacje dotyczące obiektu, na który wskazują współrzędne
  • Jest przekazywany bezpośrednio do URL-a do map. Nie może mieć formatu przypominającego dane współrzędnych (liczby lub litery NSEW).
  • Na przykład type:country. Pełna lista na angielskiej Wikipedii.
  • {{koordynaty|52|N|20|E|type:country}} → 52°N 20°E (Polska)
  • {{koordynaty|50|03|41|N|19|56|18|E|type:city}} → 50°03′41″N 19°56′18″E (Kraków)

Dokumentacja techniczna

Szablon wykorzystuje sześć podszablonów:

• {{koordynaty}} (główny) – obsługuje parametry umieść i ostatni nienazwany, zajmuje się pustymi polami, przekazuje uproszczone wywołanie do {{koordynaty/core}}
• {{koordynaty/core}} – rozpoznaje typ wywołania i formatuje je przy pomocy {{koordynaty/format}}, wykrywa nieprawidłowe wywołania
• {{koordynaty/dokładność}} – określa dokładność podanych parametrów
• {{koordynaty/format}} – obsługuje parametr linkuj i zapis, buduje link i mikroformat geograficzny, przekazuje dane do {{koordynaty/format1}}
• {{koordynaty/format1}} – formatuje jedną grupę współrzędnych, obsługuje parametr zapis, wykrywa błędy merytoryczne (np. sekundy > 59)
• {{koordynaty/błąd}} – wywoływany przez szablon główny, gdy którykolwiek z podszablonów zwróci błąd

Ponadto wykorzystywane są szablony:

• {{args compact/10}} (w szablonie głównym)
• {{miejsca dziesiętne}} (w {{koordynaty/format1}})

Szablon został skonstruowany tak, aby wartość parametru expansion depth była jak najniższa. (Wynosi ona w najgorszym przypadku 23 poziomy.)

Test prawidłowego działania szablonu (a zarazem dokumentacja obsługiwanych i nieobsługiwanych formatów) znajduje się na stronie Szablon:koordynaty/test.

Błędy

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