Dokumentation REDAXO

Textile ist eine Textauszeichnungssprache, die validen Code aus der Eingabe von normalem Text produziert. Man braucht sich also nicht um die Konvertierung von Äs, Ös usw. zu kümmern. Auch Sonderzeichen, wie &, werden umgewandelt.

Mit Hilfe der Seite, die ganz unten nochmal steht, habe ich die folgende Übersicht gemacht.

Es ist auch nicht komplett, aber ich meine, das wichtigste ist drinne.

Falls Ihr Fehler findet, her damit.

Escapen von Textile Markup

In Zeiten der Online-Kommunikation hat es sich ja eingebürgert Smilies oder irgendwelche "sinnigen" Abkürzungen zu verwenden um seinen Gemühtszustand zu beschreiben. (z.B. *lol*, *rofl* etc.)

Speziell bei den in Sternchen eingeschlossenen Sachen, gibt es mit dem Textile "Probleme".

Diese können durch das Einschließen in doppelte Gleichheitszeichen escaped werden. *lol* ergibt lol, hingegen ==*lol*== ergibt *lol*

Blockelemente:

Überschriften:

h1. Überschrift H1
h2. Überschrift H2
h3. Überschrift H3
h4. Überschrift H4
h5. Überschrift H5
h6. Überschrift H6

die "h1. überschrift" hat die höchste Priorität, "h6. " die niedrigste
Leerzeichen zum Text der Überschrift
Leerzeile zwischen Überschrift und weiterem Text (ggf. auch davor)

erzeugt:

<h1>Überschrift H1</h1>
<h2>Überschrift H2</h2>
<h3>Überschrift H3</h3>
<h4>Überschrift H4</h4>
<h5>Überschrift H5</h5>
<h6>Überschrift H6</h6>

Zitate: (Blockquote)

bq. Zitat

Leerzeichen zum Text
Leerzeile zwischen Blockquote und weiterem Text (ggf. auch davor)
- ohne Leerzeile danach wird der folgende Text in das <blockquote></blockquote> mit eingeschlossen
erzeugt <blockquote>Zitat</blockquote>

Listen:

* Listenelement mit Aufzählungszeichen
# numerisches Listenelement

Leerzeichen zum Text

Anzahl der Aufzählungszeichen hintereinander gibt die Hierarchie an, z.B.

* la
* le
## li
## lo
* lu
* ly

erzeugt:

<ul>
  <li>la</li>
  <li>le
  <ol>
    <li>li</li>
    <li>lo</li>
  </ol></li>
  <li>lu</li>
  <li>ly</li>
</ul>

also:

    * la
    * le
         1. li
         2. lo
    * lu
    * ly

Verschachtelung (also *# o.ä.) nicht möglich

Fußnote:

fn#. (für beliebige Zahl)

Leerzeichen zum Text
bietet sich am unteren Teil einer Seite an :)
Leerzeile zum restlichen Text, auch anderen Fußnoten
erzeugt # Text der Fußnote

Modifizierungen im Fließtext:

Referenz auf die Fußnote:

[#] (für beliebige Zahl)

ACHTUNG! muß direkt im anschluß an einen Buchstaben erfolgen, da es sonst kein Hyperlink, sondern lediglich hochgestellte Zahl im Fließtext ist
erzeugt: <a href="#fn#">#</a>

Betonen: (em)

Unterstrich "_" am Anfang und am Ende des zu betonenden Textabschnittes
Bsp. _betonter Text_ erzeugt betonter Text
funktioniert nicht über Zeilenumbrüche (ENTER) hinweg

Kursiv:

zwei Unterstriche "__" am Anfang und am Ende des kursiv zu schreibenden Textabschnittes
Bsp. __kursiver Text__ erzeugt kursiver Text
funktioniert nicht über Zeilenumbrüche (ENTER) hinweg

Fettschrift:

Sternchen "*" am Anfang und am Ende des fett zu schreibenden Textabschnittes
Bsp. *fetter Text* erzeugt fetter Text
funktioniert nicht über Zeilenumbrüche (ENTER) hinweg

Zitieren von Titel oder Ausdrücken (cite):

zwei Fragezeichen "??" am Anfang und am Ende des zitierten Textabschnittes
Bsp. ??Max und Moritz?? von Wilhelm Busch erzeugt <cite>Max und Moritz</cite> von Wilhelm Busch
funktioniert nicht über Zeilenumbrüche (ENTER) hinweg

durchgestrichener Text (deleted):

Bindestrich "-" am Anfang und am Ende des durchzustreichenden Textabschnittes
Bsp. -durchgestrichener Text- erzeugt <del>durchgestrichener Text</del>
funktioniert nicht über Zeilenumbrüche (ENTER) hinweg

unterstrichener Text (inserted):

Plus "+" am Anfang und am Ende des zu unterstreichenden Textabschnittes
Bsp. +unterstrichener Text+ erzeugt <ins>unterstrichener Text</ins>
funktioniert nicht über Zeilenumbrüche (ENTER) hinweg

hochgestellter Text (superscript):

Häckchen "^" am Anfang und am Ende des hoch zu stellenden Textabschnittes
Bsp. ^hochgestellter Text^ erzeugt hochgestellter Text
funktioniert nicht über Zeilenumbrüche (ENTER) hinweg

tiefgestellter Text (subscript):

Tilde "~" am Anfang und am Ende des tief zu stellenden Textabschnittes
Bsp. ~tiefgestellter Text~ erzeugt tiefgestellter Text
funktioniert nicht über Zeilenumbrüche (ENTER) hinweg

Bilder/Grafiken:

Bsp. !http://www.domain.xyz/ordner/grafik.gif(ergibt den alternativen Text im ALT-Tag)! erzeugt

<img src="http://www.domain.xyz/ordner/grafik.gif" 
title="ergibt den alternativen Text im ALT-Tag" 
alt="ergibt den alternativen Text im ALT-Tag" />

muß nicht der absolute Pfad sein, !/ordner/grafik.gif(ALT-Text)! funktioniert auch

Hyperlinks:

Bsp. "Linktext (alternativer Linktext im TITLE-Tag)":http://www.domain.xyz erzeugt <a href="http://www.domain.xyz" title="alternativer Linktext im TITLE-Tag">Linktext</a>
Bsp. für einen redaxointernen Link "Linktext (alternativer Linktext im TITLE-Tag)":redaxo://24 erzeugt <a href="index.php?article_id=24" title="alternativer Linktext im TITLE-Tag">Linktext</a>

Hyperlinks auf Bildern/Grafiken:

Bsp. !http://www.domain.xyz/ordner/grafik.gif(alternativer Text im ALT-Tag)!:http://www.domain.xyz erzeugt

<a href="http://www.domain.xyz"><img src="http://www.domain.xyz/ordner/grafik.gif" 
title="alternativer Text im ALT-Tag" alt="alternativer Text im ALT-Tag" /></a>

Hyperlinks in neuem Fenster öffnen:

Das geht mit dem Standardtextile nicht. Textile selbst erzeugt strict XHTML Code. Dort ist das Attribut target nicht erlaubt. Einen Ausweg aus dem Dilemma bietet ein Textile-Hack der mit Hilfe von JavaScript ein neues Fenster öffnet.
Genaueres dazu ist hier beschrieben: Externe Links mit Textile

eMail-Links:

Bsp. "Linktext (alternativer Linktext im TITLE-Tag)":mailto:adresse@domain.xyz erzeugt <a href="mailto:adresse@domain.xyz" title="alternativer Linktext im TITLE-Tag">Linktext</a>
funktioniert auch mit Angabe des Subjects und Body-Inhaltes (Body nur zusammenhängender Text oder tricksen: Text_mit_Unterstrichen) Bsp. "Linktext (alternativer Linktext im TITLE-Tag)":mailto:adresse@domain.xyz?subject=Betreff&body=Inhalt erzeugt <a href="mailto:adresse@domain.xyz?subject=Betreff&body=Inhalt" title="alternativer Linktext im TITLE-Tag">Linktext</a>

Abkürzungen erklären (Akronyme):

zu erklärender Begriff muß zusammenhängend sein: bei GREEN PEACE(Umweltschutz) wird nur PEACE erklärt
Bsp. SPD(Sozialdemokratische Partei Deutschlands) erzeugt <acronym title="Sozialdemokratische Partei Deutschlands">SPD</acronym>
- SPD wird unterstrichen angezeigt (nicht als Hyperlink)
- wenn der Cursor das Wort SPD berührt, erscheint "Sozialdemokratische Partei Deutschlands" als Tooltip

Tabellen:

Bsp.

|_. Spaltenkopf1|_. Spaltenkopf2|
|Zelle1.1|Zelle1.2|
|Zelle2.1|Zelle2.2|
|Zelle3.1|Zelle3.2|

erzeugt

<table>
  <tr>
    <th>Spaltenkopf1</th>
    <th>Spaltenkopf2</th>
  </tr>
  <tr>
    <td>Zelle1.1</td>
    <td>Zelle1.2</td>
  </tr>
  <tr>
    <td>Zelle2.1</td>
    <td>Zelle2.2</td>
  </tr>
  <tr>
    <td>Zelle3.1</td>
    <td>Zelle3.2</td>
  </tr>
</table>

weitere Formatierungsmöglichkeiten (speziell für Tabellen, aber auch für Spans - samt class, id oder style) unter

    http://textism.com/tools/textile/  (Textile 1.0)
    http://textile.thresholdstate.com/ (Textile 2.0)
    gute Beispiele
    http://hobix.com/textile/

svenalbert

Edit Page - Page History - Aktuelle Änderungen - Suchen

Page last modified on 25.10.2007 21:52 Uhr