Wstawianie Textile w komentarzach

Z JoggerWiki
Skocz do: nawigacji, wyszukiwania

O skrypcie

Skrypt umożliwia wstawianie znaczników Textile za pomocą niewielkiego panelu umieszczonego w formularzu komentowania. Dzięki temu komentujący nie musi znać składni, by móc skorzystać z jej funkcji, np. do wstawienia linku, fragmentu kodu czy cytatu.

Dostępne są cztery wersje skryptu, obsługujące Textile i Textile Lite (z obrazkami lub bez).

Uwaga: niebawem pojawi się wersja obsługująca Markdown (Textile nie jest już obsługiwany na Joggerze).

Instalacja

  • Wybieramy wersję skryptu stosowną do używanej przez nas składni i pobieramy ją stąd.
  • Umieszczamy skrypt w katalogu /files/ naszego Joggera (Szablony > Pliki).
  • W sekcji meta szablonu komentarzy umieszczamy odwołanie do skryptu, zmieniając odpowiednio jego nazwę (poniższy przykład dotyczy wersji dla Textile z obrazkami):
<script type="text/javascript" src="/files/qt-textile-img.js"></script>
  • W miejscu, gdzie chcemy wstawić panel umieszczamy następujący kod:
<script type="text/javascript">edToolbar('commbody')</script>

gdzie commbody to identyfikator pola textarea, do którego wpisuje się treść komentarza. Aby panel pojawił się nad polem treści komentarza, kod powinien znaleźć się bezpośrednio przed znacznikiem <textarea />.

Modyfikacje skryptu

Pozycja elementów panelu

Część funkcji jest domyślnie ukryta - można je wyświetlić klikając na przycisk "więcej". Aby zmodyfikować ustawienie przycisków funkcji w panelu, musimy odszukać w skrypcie ich definicje - zaczynają się one od edButtons.push, np.

edButtons.push(
	new edButton(
		'ed_ul'
		,'ul'
		,'* '
		,
		,
	)
);

Aby dana funkcja panelu była zawsze widoczna (tzn. umieszczona w pierwszej linii), odpowiadający jej fragment kodu musi być umieszczony przed linijką

var extendedStart = edButtons.length;

Zmiana słownika

  • Domyślnie używanym słownikiem (przycisk "wiki") jest polska Wikipedia. Aby to zmienić, należy odnaleźć w skrypcie linijkę
var dictionaryUrl = 'http://pl.wikipedia.org/wiki/';

i zamiast http://pl.wikipedia.org/wiki/ wstawić adres URL innego słownika, np.

  • http://en.wikipedia.org/wiki/
  • http://answers.com/
  • http://dictionary.reference.com/browse/
  • http://sjp.pwn.pl/lista.php?co=

Uwaga: Wybrany słownik/encyklopedia musi obsługiwać przesyłanie szukanego hasła przez adres URL podstrony (np. http://sjp.pwn.pl/lista.php?co=hasło)

Wygląd przycisków

  • Przyciski można ostylować, dodając do arkusza CSS regułę:
.ed_button {
// parametry CSS
}

Credits

  • Skrypt powstał na bazie JS-Quicktags autorstwa Alexa Kinga i jest udostępniany na licencji LGPL. [1]
  • Autorem modyfikacji jest Łukasz "Lukem" Wójcik. [2]