letwist

Textile przetwarza tekst w całych blokach lub pojedynczych liniach. Blok można także rozumieć jako akapit, ponieważ bloki są od siebie oddzielone pustą linią. Bloki mogą się rozpoczynać sygnaturą, która pomaga zidentyfikować ich zawartość. Oto lista sygnatur bloków:

• p - akapit

  Domyślna sygnatura bloku. Akapity są formatowane z wykorzystaniem wszystkich reguł formatowania elementów liniowych (patrz: rozdział o elementach liniowych), a każda z linii opatrywana jest odpowiednim znacznikiem HTML. Na przykład, na końcu nowych linii wstawiany jest znacznik <br /> (za wyjątkiem ostatniej linii akapitu). Akapity umieszczane są wewnątrz znaczników <p>.

• pre - tekst preformatowany

  Textile nie wstawi w liniach należących do tego bloku żadnych dodatkowych znaczników. Zostaną również wyświetlone wszelkie spacje czy zwykłe końce linii.

  Miej na uwadze, że znaki < oraz > znajdujące się wewnątrz takiego bloku zostaną automatycznie zamienione na encje HTML.

• bc - blok kodu

  Blok taki zostanie potraktowany w podobny sposób co blok tekstu preformatowanego, z tą różnicą, że zostanie dodatkowo opatrzony znacznikami <code> (a w przypadku XHTML 2 - znacznikami <blockcode>).

  Miej na uwadze, że znaki < i > znajdujące się wewnątrz takiego bloku zostaną automatycznie zamienione na encje HTML.

• table - tabela

  Blok odpowiedni dla tabel HTML. Więcej informacji znajdziesz w rozdziale dotyczącym tabel.

• bq - blok cytatu

  Bloki takie formatowane są tak jak akapity i opatrywane znacznikami <blockquote>. W odpowiednich miejscach wewnątrz bloku wstawiane są również znaczniki <p>.

• h1, h2, h3, h4, h5, h6 - nagłówki

  Sygnatury nagłówków generujące znaczniki <h1> i temu podobne. Możesz zmienić sposób wyświetlania nagłówków korzystając z atrybutu head_offset.

• clear

  Sygnatura "clear" używana jest do nadania następującemu po niej blokowi właściwości "tamującej" pływające elementy. Domyślnie właściwości "clear" przypisywana jest wartość "both", jednak możesz nadać jej również wartość "left" lub "right", wprowadzając znaki < lub > (patrz: wyrównywanie).

• dl - lista-definicja

  Blok zawierający listę-definicję. Więcej informacji znajdziesz w rozdziale dotyczącym list.

• fn - przypis

  Dzięki takiemu blokowi możesz numerować przypisy - wpisując po "fn" odpowiednią liczbę - oraz dostosowywać ich wygląd poprzez arkusze stylów (bloki takie traktowane są jak zwykłe akapity, jednak dodatkowo nadawana jest im specjalna klasa CSS).

Wszystkie sygnatury bloków powinny być zakończone kropką, a poprzedzać je powinna spacja. Pomiędzy spacją a kropką wpisać możesz dodatkowe parametry by bardziej dostosować wygląd bloku:

• {reguła stylu}

  Reguła stylu CSS. Reguły takie mogą się odnosić do wielu linii naraz.

• [pl]

  Identyfikator języka (dla atrybutu "lang").

• (klasa), (#identyfikator) lub (klasa#identyfikator)

  Nadawanie klas i identyfikatorów kaskadowych arkuszów stylów.

• >, <, =, <>

  Znaki kontrolujące wyrównywanie elementów bloku. Wyrównywanie do prawej, lewej, wyśrodkowywanie oraz wyjustowywanie.

• ( (jeden lub więcej)

  Dodaje wcięcie (tzw. dopełnienie) po lewej. Każdy znak otwarcia nawiasu to wcięcie wielkości 1 em. W połączeniu z wyrównywaniem umożliwia "pływanie" bloków.

• ) (jeden lub więcej)

  Dodaje wcięcie (tzw. dopełnienie) po prawej. Każdy znak otwarcia nawiasu to wcięcie wielkości 1 em. W połączeniu z wyrównywaniem umożliwia "pływanie" bloków.

• |filtr| lub |filtr|filtr|filtr|

  Bloki oznaczane za pomocą sygnatur zawierających ten parametr mogą być przetwarzane przez dodatkowe filtry. Jeśli zdefiniujesz jakiś filtr, wtedy tekst zostanie najpierw przetworzony przez niego, a dopiero potem z pomocą reguł wbudowanych w Textile.

Bloki rozszerzone

Zwykle blok kończy się w miejscu, w którym występuje pierwsza pusta linia. Może się jednak zdarzyć, że będziesz chciał by blok zawierał kilka osobnych akapitów tekstu. By rozszerzyć blok o więcej niż jeden akapit, zakończ jego sygnaturę dwiema kropkami zamiast jednej. W ten sposób poinformujesz Textile by kontynuował przetwarzanie z wykorzystaniem tej samej sygnatury póki nie napotka na kolejną.

Na przykład:
bq.. Oto pierwszy akapit bloku z cytatem.
A to drugi akapit tego bloku.
p. To z kolei blok ze zwykłym akapitem.

Możesz postępować tak ze wszystkimi sygnaturami bloków (choć nie dla wszystkich bloków ma to sens - np. dla nagłówków). Rozwiązanie to jest szczególnie przydatne w przypadku bloków kodu, który może zawierać wiele pustych linii.