Wstawianie Textile w komentarzach

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]