Drupal Polska

Texy to…

narzędzie pozwalające, podobnie jak Textile czy Markdown, na zamianę prostych znaków na znaczniki HTML. W czym Texy jest lepsze? Jego możliwości są szersze, jest bardziej „odporne” na błędy użytkowników, takie jak źle zamknięte znaczniki, a jego działanie jest bardziej „przewidywalne”.

Jeśli zezwolić użytkownikom na bezpośrednie wprowadzanie znaczników HTML, Texy potrafi efektywnie poprawiać popełniane przez nich błędy. Udostępnia też wiele opcji konfiguracyjnych, pozwalających na przykład na ustalenie dopuszczalnych klas i identyfikatorów CSS oraz znaczników.

Texy wyposażone jest również w moduły odpowiadające za typograficzną stronę tekstu – może zamieniać zwykłe cudzysłowy na cudzysłowy „drukarskie”, zawijać tekst, dodawać wcięcia, itd. Doskonały jest także sposób umieszczania obrazków w tekście – jeśli ustawiliśmy nazwę katalogu, w którym zwykle umieszczamy obrazki, wystarczy wpisać samą nazwę pliku.

Texy dla Drupala 5

Texy stało się jeszcze bardziej sexy, gdy przywdziało szaty Drupala 5. Dzięki moim skromnym modyfikacjom powstała wersja kompatybilna z tym właśnie – przedpremierowym jeszcze – Drupalem, i wyposażona w kilka dodatkowych opcji konfiguracyjnych (m.in. zawijanie linii, nazwa klasy dla obrazków wyrównanych do lewej lub prawej i dodawanie atrybutu rel=nofollow do odnośników). Za pośrednictwem drupal.org udostępniłem również polskie tłumaczenie modułu.

Całość można pobrać ze strony utworzonej dla tego wydania modułu Texy. Konieczne jest również pobranie i instalacja samego Texy.

Texy jako filtr

Texy nienajlepiej działa we współpracy ze standardowym Filtrem HTML Drupala, więc jeśli chce się uniknąć kłopotów, trzeba go wyłączyć. Zamiast niego można posłużyć się mechanizmem wbudowanym w Texy. W tym celu, w pliku modułu (texy.module), po wierszu zawierającym tekst // optional configuration dodać należy fragment podobny do poniższego:

$texy->allowedTags = array(
  'a'         => array('title', 'lang', 'href', 'rel'),
  'abbr'      => array('title', 'lang'),
  'acronym'   => array('title', 'lang'),
  'br'        => array(),
  'cite'      => array('title', 'lang'),
  'code'      => array('title', 'lang'),
  'em'        => array('title', 'lang'),
  'h3'        => array('title', 'lang', 'id'),
  'h4'        => array('title', 'lang', 'id'),
  'h5'        => array('title', 'lang', 'id'),
  'h6'        => array('title', 'lang', 'id'),
  'kbd'       => array('title', 'lang'),
  'q'         => array('title', 'lang', 'cite'),
  'samp'      => array('title', 'lang'),
  'small'     => array('title', 'lang'),
  'span'      => array('title', 'lang'),
  'strong'    => array('title', 'lang'),
  'sub'       => array('title', 'lang'),
  'sup'       => array('title', 'lang'),
);

Jest to lista elementów i atrybutów HTML, którymi mogą się posługiwać (wpisując odpowiednie znaczniki bezpośrednio – bez pośrednictwa Texy) użytkownicy. Można ją poszerzyć o inne elementy.

Opcje

Jeśli nie podobają nam się „fikuśne” cudzysłowy i apostrofy, wystarczy objąć znakami komentarza linie zawierające tekst // double "" i // single '' w pliku quick-correct.php, który znajduje się w podkatalogu modules paczki z Texy.

Lista wszystkich możliwych ustawień znajduje się na stronie Implementace (po czesku).