Wstawianie Textile w komentarzach: Różnice pomiędzy wersjami

Z JoggerWiki
Skocz do: nawigacji, wyszukiwania
(Instalacja)
(Instalacja)
Linia 7: Linia 7:
 
==Instalacja==
 
==Instalacja==
  
* Wybieramy wersję skryptu stosowną do używanej przez nas składni i pobieramy ją [http://blog.lukem.net/2008/09/05/tagi-textile-w-komentarzach-skrypt-js/ stąd].
+
* Wybieramy wersję skryptu stosowną do używanej przez nas składni i pobieramy ją [http://varia.lukem.net/qt-jogger/ stąd].
 
* Umieszczamy skrypt w katalogu /files/ naszego Joggera (Szablony > Pliki).
 
* 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):
 
* 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):

Wersja z 21:49, 11 sty 2009

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).

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]