Help:TemplateData/pl

 jest sposobem na przechowywanie informacje o wikitekstowych szablonach i ich parametrów, dzięki czemu edytor wizualny może je wyświetlać w oknie edycji wstawianego szablonu.

Rozszerzenie TemplateData jest zainstalowane na wszystkich wiki obsługiwanych przez Wikimedia Foundation. Jeżeli masz swoją wiki i chcesz też z niego korzystać, zainstaluj odpowiednie rozszerzenie.

Składnia TemplateData pozwala użytkownikom na napisanie małej porcji danych strukturalnych na stronie szablonu lub na transkludowanej na niej stronie (na przykład podstronie dokumentacji szablonu). Gdy szablon będzie miał już dodane dane strukturalne, będzie on poprawnie wyświetlany w edytorze wizualnym. Może to brzmi skomplikowanie, ale jest bardzo proste.

Edytor TemplateData
Jest wbudowane narzędzie do łatwego edytowania TemplateData.

Aby użyć edytora TemplateData, przejdź na stronę wybranego szablonu (lub na jego podstronę dokumentacji) i kliknij przycisk "Edytuj". Na stronie edycji kodu szablonu, tuż nad polem tekstowym będzie widoczny przycisk "":

Kliknij ten przycisk, aby wejść do narzędzia GUI służącego do edycji TemplateData.

Ten edytor umożliwia dodanie parametrów szablonu i ustawienia ich najważniejszych atrybutów. Jeżeli strona zawiera już TemplateData to już udokumentowane informacje zostaną wyświetlone jeżeli otworzysz edytor TemplateData przy edycji właściwej strony. W pierwszym polu możesz dodać lub zmienić krótki opis szablonu (czysty tekst). Następnie możesz użyć przycisków "Dodaj proponowane parametry" i "Dodaj parametr", aby opisać nazwy i właściwości parametrów używanych przez szablon.

Jeśli dokumentacja szablonu znajduje się na podstronie, przycisk "Dodaj proponowane parametry" pojawi się tylko na stronie szablonu. Rozwiązaniem jest edytowanie strony szablonu, kliknięcie na "Dodaj proponowane parametry" w edytorze TemplateData, a następnie skopiowanie i wklejenie zawartości TemplateData (między znacznikami i ) na podstronie dokumentacji.

Jeśli strona szablonu jest zabezpieczona, możesz skopiować kod szablonu i wkleić na podstronie, użyć tam przycisku "Dodaj proponowane parametry", skopiować zawartość szablonu TemplateData, następnie edytować podstronę, aby pozbyć się kodu szablonu i wkleić zawartość TemplateData. Aby zobaczyć, gdzie należy wkleić zawartość TemplateData na podstronie, możesz edytować TemplateData bez dodawania czegokolwiek; następnie możesz zastąpić znaczniki i oraz ich zawartość, wklejając zawartość na nie.

Możesz podać nazwę parametru, dowolne jego aliasy, etykietę i opis, który będzie wyświetlany użytkownikom. Można również podać przykład użycia tego parametru. Jedynym wymaganym polem jest Nazwa (pierwsze pole w każdym wierszu), gdzie zapisujesz dokładną nazwę parametru, pamiętając, że wielkość liter ma znaczenie. W rozwijanym menu "Typ" możesz wybrać typ zawartości, którą powinien mieć ten parametr, na przykład ciąg znaków (dla tekstu bez formatowania), strona (odnośnik do innej strony) lub data. Jeśli szablon spowoduje błąd, gdy parametr pozostanie pusty, oznacz go jako "Wymagane". Jeśli parametr jest powszechnie używany lub zalecany, zaznacz go jako "Sugerowany". Przycisk "Usuń informację o parametrze" spowoduje usunięcie parametru z szablonu TemplateData.



Po zakończeniu opisywania parametrów kliknij przycisk "Zastosuj", aby wstawić wstępnie sformatowany TemplateData do otwartego okna edycji. Musisz jeszcze zapisać stronę, używając zwykłego przycisku "Zapisz" pod oknem edycji.

Uwaga: Edytor TemplateData umieści dokumentację na stronie szablonu lub na podstronie dokumentacji. Ty decydujesz, gdzie TemplateData zostanie dodana, otwierając (edytując) stronę, na której chcesz umieścić TemplateData. Jeśli jednak w tym samym szablonie znajduje się wiele bloków TemplateData, zostanie użyty tylko jeden z nich. Jeśli na stronie jest już TemplateData, musisz zmodyfikować stronę, na której TemplateData została wcześniej umieszczona, aby uniknąć przypadkowego utworzenia wielu bloków TemplateData.

Ograniczenia i pytania

 * Brakujące funkcje — TemplateData jest przykładem narzędzia, które zostało udostępnione z nielicznymi funkcjami, w nadziei, że użytkownicy pomogą kierować rozwojem funkcji, których potrzebują. Jeśli chcesz poprosić o nowe funkcje dla TemplateData, prosimy daj nam znać.
 * Opóźnienia w wyświetlaniu w szablonach — Po dodaniu TemplateData do szablonu, metadane powinny być widoczne natychmiast po otwarciu szablonu w edytorze wizualnym. Jest jednak możliwe, że zajmie to kilka godzin zanim metadane się pojawią. Możesz wymusić aktualizację, wprowadzając pustą edycję do samej strony szablonu (nie do podstrony dokumentacji). Aby przeprowadzić pustą edycję, otwórz stronę szablonu do edycji i zapisz stronę bez dokonywania żadnych zmian i bez dodawania opisu zmian.
 * Aktualne problemy — Aktualna lista błędów i żądań funkcji jest dostępna w trackerze błędów Wikimedia.

Lokalizacja TemplateData
TemplateData powinien być na stronie, którą opisuje, lub dołączony do niej. W szablonie zazwyczaj jest otoczony znacznikami. Przy normalnym wyświetleniu strony, pokazuje automatycznie wygenerowaną dokumentację, jak w #Przykładzie.

Struktura TemplateData
Struktura TemplateData bazuje na standardzie JSON. Zauważ, że wszystkie opisy w TemplateData muszą być zwykłym tekstem (bez wikitekstu, bez linków, itd.).

Pierwsza rzecz, jaką trzeba zrobić, jest wpisanie pary znaczników  gdziekolwiek na podstronie dokumentacji szablonu, w ten sposób:

Przekazuje to oprogramowaniu, że wszystko pomiędzy dwoma znacznikami to TemplateData i powinno być wywołane, gdy szablon jest używany.

Przykład
Opisy wewnątrz TemplateData podlegają standardowemu układowi. Powiedzmy, że masz szablon nazwany "Kategorie" do przypisywania kategorii do artykułu. Wymaga to jednego obowiązkowego parametru: Nazwa kategorii w Kategorie. TemplateData wyglądałby tak:

Spowoduje to wyświetlenie w szablonie czegoś takiego:

{   "description": "Szablon przypisujący kategorię do artykułu", "params": { "1": {           "label": "Nazwa kategorii", "description": "Nazwa kategorii, którą chcesz przypisać.", "default": "Category:CommonsRoot", "type": "string", "required": true }   } }

Opis i parametry
Once you're done, hit "save". If you've made errors, it will not let you save (which is disruptive, but means you can't break anything). Should you run into errors, explain on the feedback page what you were trying to do, and we will be happy to help.

Note that each bit of information is enclosed in quotation marks (except for  and  ), and separated from the next bit by a comma (unless it's the last one).

Parameter aliases
Some templates allow a same parameter to have different names.

For example,  could also be written as   or.

To add this information to TemplateData, you simply need to add the aliases to the parameter's information:

Auto value
You can specify an "autovalue" for a parameter. When users add the template to a page, this value will be added automatically. For example, many clean-up templates need to have the date added; if you specify an autovalue for the template's date parameter, then the date will be filled in automatically.

To add this information to TemplateData, simply add the autovalue to the parameter's information. You will probably want to use the prefix  with the values to make them stick:

Multiple parameters
If you have multiple parameters, just repeat each section (starting from the "1" tag) and fill it out as you see fit. Note that if a template has multiple parameters, you need to separate them with a comma in the templatedata, like so:

Similar parameters
When a template has multiple parameters, sometimes some of them can be of the same kind. In this case, you only need to provide full properties for the first one, and the others can "inherit" their properties from it.

Blank boilerplate
You can copy the blank boilerplate below to add new TemplateData to a template. Only the most common tags are included.

Other tools

 * TemplateDataEditor: A user script that makes the process of adding TemplateData easier. It currently exists in French (contains English, Italian, Japanese and Korean translations), and can easily be translated into other languages.
 * TemplateData Wizard: A tool that generates TemplateData through an interactive interface.
 * Skeleton TemplateData generator: A tool that reads the source wikicode of a template, tries to find all the parameters used and outputs a skeleton document with the parameters listed.
 * JSONLint: A tool that allows you to validate manually-written JSON to help find errors in the syntax.
 * List of all templates with TemplateData on this wiki
 * With dewiki template TemplateData template data is shown in a box, and the template is added to a category of templates with template data