Wikipedia:InputBox

InputBox – rozszerzenie MediaWiki i zarazem ciekawe narzędzie stosowane w projektach Wikimedia. Wykorzystuje się je do tworzenia specjalnych pól (boxów) pozwalających na różne operacje: wyszukiwania fraz i tworzenia nowych stron, a także szybkie komentowanie na istniejących stronach (także poza główną przestrzenią nazw), W Wikinews i Wikisłowniku wykorzystywane jest do standaryzacji formy artykułów, czyli do tego, by je pisać wg określonego schematu. W Wikipedii to narzędzie wykorzystywane jest m.in. do tworzenia nowych podstron dyskusji i głosowań. Można byłoby także zastosować je dla seryjnie tworzonych artykułów (hasła o bakteriach, galaktykach, rasach kotów, wioskach itp.).

Opis w języku angielskim znajduje się na stronie: mw:Extension:InputBox.

Żeby się nie przestraszyć[edytuj | edytuj kod]

Mamy już to w Wikipedii w kilku miejscach od dłuższego czasu:

Poniżej znajdują się różne rozwiązania i ich opis, a w szczególności krótki opis – jak to działa.

Z czego się składa InputBox[edytuj | edytuj kod]

InputBox otwieramy za pomocą znacznika <inputbox> i kończymy znacznikiem </inputbox>. W jego skład wchodzą następujące parametry (w zależności od tego, do czego chcemy go użyć, możemy wykorzystać część z nich, lub tylko pojedyncze elementy):

<inputbox>
type=
bgcolor=
width=
default=
preload=
editintro=
buttonlabel=
hidden=
searchbuttonlabel=
break=
namespaces=
prefix=
</inputbox>

Parametr type[edytuj | edytuj kod]

Zacznijmy od pierwszego parametru, czyli type. Można tu użyć wyrażeń: search, create, comment, commenttitle, fulltext

kod inputboxa	efekt	uwagi
<inputbox> type=search </inputbox>		Wpisując w okienko tekst wyszukująca go osoba w pierwszym przypadku przejdzie do konkretnej strony, w drugim do listy haseł zawierających dany tekst.
<inputbox> type=create </inputbox>		W tym przypadku po wpisaniu tekstu, przejdzie się do edytowania strony o tytule, jaki wpisze się w okienku.
<inputbox> type=comment </inputbox>		Tutaj przejdziemy do edycji nowej sekcji na stronie o tytule, jaki wpisze się w okienko.
<inputbox> type=commenttitle page={{TALKPAGENAME}} </inputbox>		W tym przypadku przejdziemy do edycji dyskusji odnoszącej się do strony, na której jest inputbox. W nagłówku strony dyskusji pojawi się temat, jaki wpiszemy.
<inputbox> type=fulltext </inputbox>		To jest tylko wyszukiwarka, bez przechodzenia do strony wpisanej w okienko, nawet jeśli ta istnieje.

Preload i editintro[edytuj | edytuj kod]

Te dwa parametry są szczególnie przydatne, gdy edytujemy/tworzymy nową stronę, ponieważ możemy dzięki nim przekazać pewne informacje, jakie pojawią się po wciśnięciu przycisku w boxie. Oba działają tylko dla funkcji edytowania stron, czyli razem z parametrem type=comment lub type=create.

kod	efekt	uwagi
<inputbox> type=create preload=Wikipedia:Standardy artykułów/bakteria </inputbox>		Dla parametru preload została przypisana strona Wikipedia:Standardy artykułów/bakteria, co oznacza, ze jeśli dajmy na to wpiszemy w pole nazwę bakterii, to wciskając przycisk "utwórz artykuł", przejdziemy na stronę z nazwą, jaką wpiszemy i jeśli wcześniej ta strona nie istniała, to w polu edycji pojawi się szablon standardu artykułu o bakterii. Następnie tylko uzupełniając tekst nieco szybciej napiszemy hasło, niż przeklejając ten szablon ręcznie. jeżeli hasło już istnieje, po prostu przejdziemy na stronę jego opisu. Tak działa m.in. inputbox na stronie WP:PInM.
<inputbox> type=create editintro=Wikipedia:Standardy artykułów/standard ogólny </inputbox>		Ponieważ czasami warto nad polem edycji dac notkę mająca na celu przekazanie dodatkowych informacji o tworzeniu hasła itp., można do tego celu wykorzystać parametr inputboxa – editintro. Podobnie jak w przypadku poprzedniego parametru podajemy stronę, na której ten komunikat się znajduje. Tu użyliśmy strony Wikipedia:Standardy artykułów/standard ogólny (ponieważ warto też pamiętać o standardzie ogólnym).
<inputbox> type=create preload=Wikipedia:Standardy artykułów/bakteria editintro=Wikipedia:Standardy artykułów/standard ogólny </inputbox>		Żeby się nie rozdrabniać – dobrze jest czasami użyć obu parametrów. Ten przypadek nie jest jednak najlepszy, bo ilość tekstu w 'editintro' może nieco przytłaczać. W przypadku, jeśli mamy rozbudowaną treść dla 'preload', 'editintro' może być nieco skromniejsze.

Parametry zmieniające wygląd inputboxa[edytuj | edytuj kod]

Kolejne parametry zmieniają wygląd inputboxa – treści w okienku i przyciskach, czy tez jego wielkość i kolor. W kolejności sa to parametry: bgcolor; width; default; buttonlabel; hidden; searchbuttonlabel i break

kod	efekt i uwagi
<inputbox> type=search bgcolor=Silver </inputbox> <inputbox> type=create bgcolor=Silver </inputbox>	Powyżej dla wyszukiwania, poniżej dla tworzenia nowego artykułu. Tu użyty został parametr bgcolor. Aby zdefiniować kolor, zobacz na stronę pomocy: Pomoc:Kolory. W powyższych przykładach został użyty kolor zdefiniowany jako srebrny.
<inputbox> type=create width=32 bgcolor=Orange </inputbox> <inputbox> type=create width=64 bgcolor=Olive </inputbox>	Powyższe przykłady (już wyróżnione kolorami) pokazują użycie parametru width, określającego szerokość okna inputboxa. Niezdefiniowany rozciąga się na cały dostępny ekran (pole w tabelce itd.).
<inputbox> type=comment default=Dyskusja wikipedysty:Przykuta width=32 bgcolor=Olive </inputbox> <inputbox> type=create default=Wikipedia:Brudnopis/ width=32 bgcolor=Gold </inputbox>	Kolejny parametr, jaki został użyty w powyższym przykładzie, czyli default daje w efekcie w oknie inputboxa treść nazwy strony, kŧórej nowa sekcja byłaby edytowana po naciśnięciu przycisku (type=comment) wyżej i utworzenie podstrony brudnopisu niżej (jeśli wpiszemy coś po znaku "/"). Zobacz Wikipedia:Podstrony
<inputbox> type=comment default=Dyskusja wikipedysty:Przykuta buttonlabel=Dodaj wiadomość w nowej sekcji strony dyskusji wikipedysty Przykuta </inputbox> <inputbox> type=create buttonlabel=Znasz zasady Wikipedii? Utwórz nowy artykuł. </inputbox> <inputbox> type=create default=Wikipedia:Brudnopis/ width=32 buttonlabel=Utwórz podstronę brudnopisu, dodając nazwę podstrony po "/" </inputbox>	Zmiany nazwy przycisku dokonuje się za pomocą parametru buttonlabel. Jeżeli parametr width określa małą szerokość, to w efekcie tekst w okienku może nie być widoczny, ale kursorem można dotrzeć do jego końca klikając w okno edycji i klikając w "end" na klawiaturze, lub przesuwając na koniec kursor.;) Wielkość przycisku dostosowuje się do długości tekstu w buttonlabel.
<inputbox> type=comment default=Dyskusja Wikipedii:Sprzątanie Wikipedii editintro=Szablon:Ogłoszenia lokalne hidden=yes buttonlabel=Co sądzisz o akcji sprzątania Wikipedii? Skomentuj. </inputbox> <inputbox> type=search default=skarby hidden=yes </inputbox>	Zapraszamy do skomentowania prac porządkowych... i do szukania skarbów W przypadku parametru hidden, jeśli wpiszemy yes, wówczas okno inputboxa zostanie ukryte, a zostanie jedynie sam przycisk (którego treść można oczywiście zdefiniować przez parametr buttonlabel. Jeżeli nie zdefiniujemy strony (nie użyjemy parametru default), na którą mamy przejść/treści, której mamy szukać, to przejdziemy na stronę główną Wikipedii. Dlatego parametr hidden wymaga także użycia parametru default.
<inputbox> type=search default=skarb hidden=yes buttonlabel=znajdź skarb searchbuttonlabel=szukaj innych skarbów </inputbox>	Poprzez parametr buttonlabel opisujemy przycisk kierujący nas na daną stronę, przy opcji search (w parametrze type) pojawiają się dwa przyciski, wtedy butonlabel opisuje przycisk kierujący na daną stronę (o ile istnieje), a searchbuttonlabel do wyszukiwarki. W powyższym przykładzie – dla opcji search default kieruje na stronę 'skarb'. Ponieważ strona istnieje, buttonlabel=znajdź skarb kieruje na stronę skarb, a searchbuttonlabel=szukaj innych skarbów kieruje do wyszukiwarki stron z treścią 'skarb'.
<inputbox> type=commenttitle width=22 break=no page={{TALKPAGENAME}} buttonlabel=skomentuj stronę, którą czytasz </inputbox>	Ostatni parametr zmieniający wygląd inputboxa, to break, jeśli wpiszemy go z opcją "no" (braek=no), to okno i przycisk znajdą się w jednej linii ((linia nie zostanie "złamana"). W tym przypadku przy użyciu type=commenttitle po wpisaniu tekstu w okno trafimy na dyskusję tej strony – do nowej sekcji, której tytułem będzie (commenttitle) to, co sobie wpiszemy w okno. Potrzeba dodać dodatkowy parametr: page=Dyskusja Wikipedii:InputBox

Namespaces i prefix[edytuj | edytuj kod]

To już ostatnie parametry (stan na 7 kwietnia 2010), jakie można w inputboxie zastosować. Obie one dotyczą rodzajów stron, do których się odnoszą. W przypadku pierwszego parametru chodzi o kwestię przestrzeni nazw, w drugim chodzi o użycie prefiksu dla konkretnych podstron (np. podstron archiwizacji).

kod	efekt i uwagi
<inputbox> type=search width=40 namespaces=Pomoc,Wikipedia,Szablon searchbuttonlabel=Przeszukaj na stronach meta, pomocy lub szablonów bgcolor=yellowgreen </inputbox> <inputbox> type=fulltext width=24 namespaces=Pomoc,Wikipedia,MediaWiki searchbuttonlabel=Wybierz bgcolor=Moccasin break=no </inputbox>	Pomoc Wikipedia Szablon i drugi przykład: Pomoc Wikipedia MediaWiki Użycie parametru namespaces powoduje, że pod oknem inputboxa lub obok, jeśli użyjemy parametru 'break' pojawią się okienka z nazwami przestrzeni nazw, które można zaznaczyć. Zależnie od tego, która przestrzeń nazw zostanie potem zaznaczona – w tej nastąpi przeszukiwanie. ten parametr działa tylko dla przeszukiwania (type=search type=fulltext). Jeżeli po nazwie przestrzeni nazw wpiszemy **, automatycznie będzie ona w inputboxie zaznaczona, jako ta, która będzie przeszukiwana.
<inputbox> bgcolor=transparent type=fulltext prefix=Dyskusja:Globalne ocieplenie break=yes width=60 searchbuttonlabel=Przeszukaj "Dyskusja:Globalne ocieplenie" i jej podstrony </inputbox>	W przykładzie przeszukana zostanie strona "Dyskusja:Globalne ocieplenie" oraz jej podstrony. Jako prefix można podać dowolny ciąg znaków, od których mają zaczynać się przeszukiwane strony. W tej formie narzędzie jest szczególnie przydatne do przeszukiwania stron dyskusji z wieloma podstronami archiwalnymi.