Wikipedysta:Msz2001/ref-klawiatura

ref z klawiatury – narzędzie, którego celem jest ułatwienie wstawiania przypisów w edytorze kodu źródłowego. Zostało stworzone z myślą o osobach przyzwyczajonych do szablonu {{r}}, który nie współpracuje z edytorem wizualnym. Wszystkie funkcje narzędzia wywołuje się za pomocą klawiatury. Skrypt można skonfigurować do własnych potrzeb.

Funkcje

Wstawienie tagu <ref name="" /> za pomocą skrótu klawiszowego. Po wstawieniu znacznika kursor jest automatycznie umieszczany między cudzysłowami
domyślny skrót: Ctrl+; (Control + średnik)
Zamiana istniejącego szablonu {{r}} na tag ref (nazwa przypisu jest zachowywana; działa to również z szablonem, który przywołuje kilka przypisów naraz); aby przypis był zamieniony, należy umieścić kursor w obrębie szablonu (tj. między {{ i }}).
domyślny skrót: Ctrl+' (Control + apostrof)
Wstawienie tagu <ref name="" /> po wpisaniu znaków {{r|
domyślnie wyłączone

Instalacja

Gadżet (stabilny)

Wejdź w Preferencje → gadżety.
Sekcja „Edycja stron”.
Włącz gadżet „ref z klawiatury” (zaznacz i zapisz).

Wersja robocza

Kod wersji roboczej: Wikipedysta:Msz2001/ref-klawiatura.js.

W celu instalacji wersji roboczej, należy w swoim common.js umieścić poniższą linijkę:

mw.loader.load("/w/index.php?title=Wikipedysta:Msz2001/ref-klawiatura.js&action=raw&ctype=text/javascript");

Po zapisaniu zmian, narzędzie będzie aktywne.

Konfiguracja

Skróty klawiszowe

Jeżeli chcesz zmienić skróty klawiszowe do poszczególnych funkcji, skopiuj odpowiednią linijkę spośród poniższych do swojego common.js. Następnie dostosuj parametry, opisujące, które klawisze mają zostać wciśnięte (true oznacza że dany klawisz musi być wciśnięty, a false że nie może być).

Domyślne skróty klawiszowe zostały dobrane w taki sposób, aby nie kolidowały ani ze standardowym edytorem wikikodu, ani z edytorem wizualnym w trybie edycji kodu źródłowego.

Parametr	Znaczenie
`ctrl`	Control
`alt`	Alt (Option na macOS)
`meta`	Windows (Command na macOS)
`key`	Litera, cyfra, symbol itp.

W wyżej wymienionych parametrach nie ma shift. Aby ustawić skrót np. Ctrl+Shift+1, należy ustawić ctrl na true, a key na !.

Aby wyłączyć daną funkcję, należy jako wartość parametru key podać null.

// Poniższa linia ustawia skrót do wstawiania przypisu
window.Msz2001_ref_wstawRef = { ctrl: true, alt: false, meta: false, key: ";" };

// Poniższa linia ustawia skrót do zamiany {{r}} na przypis
window.Msz2001_ref_zamienR = { ctrl: true, alt: false, meta: false, key: "'" };

Możesz oba polecenia powiązać z tym samym skrótem klawiszowym. Wtedy narzędzie spróbuje najpierw zamienić szablon {{r}} na odpowiedni znacznik, a jeśli to się nie uda (kursor znajduje się poza szablonem), to znacznik zostanie po prostu wstawiony.

Włączenie zamiany szablonu na znacznik w trakcie pisania

Jeśli chcesz aktywować zamianę sekwencji {{r| na znacznik <ref name="" />, wklej do common.js poniższą linijkę:

window.Msz2001_ref_zamienWpisywaneR = true;

Zgłaszanie błędów

Błędy należy zgłaszać autorowi – Msz2001.