Szablon:Koordynaty

Z PrePedia
Skocz do: nawigacja, szukaj
Template-info.png Dokumentacja szablonu [zobacz] [edytuj] [historia] [odśwież]


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[edytuj]

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.

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[edytuj]

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
  • 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.

Dokumentacja techniczna[edytuj]

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:

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[edytuj]

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