Pomoc:Jak utworzyć nowy infoboks

Z Wikipedii, wolnej encyklopedii
Dla ekspertów
Te informacje dotyczą edytora wikikodu. Brak analogicznych dotyczących edytora wizualnego (Czym to się różni?)

Najpierw należy dokładnie przemyśleć sprawę i zaplanować, co w tworzonym szablonie powinno się znaleźć (w tym ile będzie parametrów i czego będą dotyczyć). Jest to o tyle ważne, że rozbudowanie szablonu o kolejne parametry wymaga zmian w artykułach, aby odzwierciedlić zmiany. Usuwanie parametrów z infoboksu nie ma negatywnych konsekwencji, gdyż nieużywane parametry są po prostu odrzucane.

Szczegóły opisane poniżej mogą być nieaktualne. Najlepiej po zrobieniu infoboksu w brudnopisie skontaktować się z Wikiprojektem Infoboksy, a jeszcze lepiej – sprawdzić, co w wikiprojekcie jest na tapecie i uwzględnić najnowszy sposób postępowania w swoim infoboksie.

Pierwsze kroki[edytuj | edytuj kod]

Wygląd i nazwa[edytuj | edytuj kod]

Dla zachowania spójności Wikipedii:

  • nagłówek tabeli (pierwszy rząd) powinien być wytłuszczony i zawierać jedynie pełną, oficjalną nazwę tematu artykułu (bez linku). Nazwa ta nie musi dokładnie pokrywać się z tytułem artykułu (np.: tytuł artykułu – Polska, nagłówek infoboksu – Rzeczpospolita Polska),
  • infoboksy powinny mieć dwie kolumny – lewą ciemniejszego koloru niż prawą, wiersze nagłówkowe powinny być najciemniejszego koloru,
  • nazwa szablonu powinna być postaci [[Szablon:Temat infobox]] (temat powinien być w liczbie pojedynczej, np. Szablon:Miejscowość infobox).

Podobnie jak w przypadku artykułów nowy infoboks najlepiej najpierw stworzyć we własnym brudnopisie. Aby w pełni przetestować infoboks, wystarczy wkleić go na stronę dyskusji brudnopisu.

Parametry[edytuj | edytuj kod]

Na stronie Pomoc:Parametry można znaleźć informacje o tym, jak one działają i w jaki sposób ich używać.

Zalecenia i rady:

  • parametry infoboksu muszą być nazywane.
  • parametr {{{grafika}}} nie powinien pozwalać na dodatkowe formatowanie z poziomu artykułu, najlepiej użyć kodu takiego jak [[Plik:{{{grafika}}}|240x240px|{{#if:{{{opis grafiki}}}|{{{opis grafiki}}}|{{{nazwa}}}}}]]{{#if:{{{opis grafiki}}}|<br />{{{opis grafiki}}}}}
  • z narzucaniem linkowania całej wartości parametru trzeba ostrożnie.

Nagłówki w infoboksie[edytuj | edytuj kod]

Szablony {{Infobox nagłówek}} i {{Infobox nagłówek dodaj}} ułatwiają wstawianie wiersza z pojedynczą komórką (nagłówka) w szablonie infoboksu. Taki nagłówek tworzy razem z następującymi polami coś w rodzaju sekcji infoboksu.

{{Infobox nagłówek}} wywołuje się z jednym, dwoma lub trzeba parametrami:

{{Infobox nagłówek
 |  treść komórki
 |  parametry komórki (CSS)
 |  parametry wiersza tabeli (np.CSS)
}}


{{Infobox nagłówek dodaj}} pozwala na dodanie z przodu jako pierwszego parametru warunku - jeżeli ten parametr będzie pusty, to nagłówek nie zostanie wyświetlony w ogóle. W ten sposób można pominąć cały zestaw pól infoboksu razem z nagłówkiem, jeżeli z jakiegoś powodów cała sekcja infoboksu nie ma zastosowania do opisywanego obiektu.

{{Infobox nagłówek dodaj
 |  warunek
 |  treść komórki
 |  parametry komórki (CSS)
 |  parametry wiersza tabeli (np.CSS)
}}

Parametry komórki i wiersza mogą być pominięte albo dodane z nazwami:

{{Infobox nagłówek
 |        treść komórki
 |pole=   parametry komórki (CSS)
 |wiersz= parametry wiersza tabeli (np.CSS)
}}

{{Infobox nagłówek dodaj
 |        warunek
 |        treść komórki
 |pole=   parametry komórki (CSS)
 |wiersz= parametry wiersza tabeli (np.CSS)
}}

Przykładowy infoboks[edytuj | edytuj kod]

Przykładowy infoboks (oparty na {{tenisista infobox}}) zawiera wstawkę:

 {{Infobox nagłówek dodaj|{{{S RG|}}}{{{S WM|}}}{{{S US|}}}
  |Gra pojedyncza
  |pole=style="background:#d0d0d0; font-weight:bold; text-align:center;"
 }}

Taka definicja oznacza, że nagłówek Gra pojedyncza ma się pojawić wtedy i tylko wtedy gdy będzie określony co najmniej jeden parametr S RG, S WM, S US, które oznaczają udział gracza w turniejach Rolanda Garrosa, Wimbledon i US Open.

Gdy gracz nie brał udziału w jednym z tych turniejów, nie zostanie podany odpowiedni parametr. Gdy będzie brakowało wszystkich z nich (gracz nie brał udziału w żadnym tych z turniejów), nagłówek nie zostanie wyświetlony.

Przykład z nagłówkiem widocznym[edytuj | edytuj kod]

W przypadku wywołania powyższego szablonu z parametrami:

{{Infobox nagłówek/przykład
|nazwa                = Gustavo Kuerten
|data urodzenia       = 10 września 1976
|S RG                 = W (1997, 2000 - 2001)
|S WM                 = QF (1999)
|S US                 = QF (1999, 2001)
|www                  = http://guga.com/
}}

Otrzymamy efekt:


Gustavo Kuerten
Data urodzenia

10 września 1976

Gra pojedyncza
Roland Garros

W (1997, 2000 - 2001)

Wimbledon

QF (1999)

US Open

QF (1999, 2001)

Strona internetowa

Przykład z nagłówkiem pominiętym[edytuj | edytuj kod]

W przypadku gdy zabraknie osiągnięć tenisisty na turniejach Roland Garros, Wimbledonie lub US Open, opisujemy gracza w następujący sposób:

{{Infobox nagłówek/przykład
|nazwa                = Gustavo Kuerten
|data urodzenia       = 10 września 1976
|www                  = http://guga.com/
}}

I otrzymamy efekt:


Gustavo Kuerten
Data urodzenia

10 września 1976

Strona internetowa

W ten sposób pusty nagłówek Gra indywidualna nie pojawi się w infoboksie.


Do wstawiania wierszy wstawia się również {{Infobox wiersz}} i {{Infobox wiersz dodaj}}.

Przeniesienie szablonu do przestrzeni Szablon[edytuj | edytuj kod]

Po dokładnym przetestowaniu dla różnych danych można przenieść infobox do przestrzeni nazw Szablon, korzystając z odpowiedniej zakładki.

Każdy szablon powinien posiadać opis na oddzielnej stronie opisu. Wystarczy umieścić w kodzie infoboksu konstrukcję:

<noinclude>{{Dokumentacja}}</noinclude>

Po zapisaniu zmian można stworzyć opis infoboksu korzystając z przycisku stwórz. System stworzy wówczas gotową stronę opisu według wzorca.

Dokładniejsze informacje są dostępne na stronie opisującej tworzenie dokumentacji szablonów.

Należy też na stronie opisu dodać infoboks do odpowiedniej kategorii (zobacz Kategoria:Infoboksy).

Czego się wystrzegać[edytuj | edytuj kod]

  • Zbyt długiego infoboksu. Najprawdopodobniej część informacji powinna się znaleźć wtedy w artykule, a nie w infoboksie
  • Kodu HTML i parametrów HTML. Zamiast tego używać wikitabel i stylów
  • Dużej liczby nawiasów klamrowych

Zobacz też[edytuj | edytuj kod]