====== RTE (rtehtmlarea) ======

Der standardmäßig installierte Rich Text Editor lässt sich umfangreich konfigurieren. Im //Extension Manager// ist zwischen drei Voreinstellungen (Minimal, Typical, Demo) wählbar. Auch lässt sich die Nutzung von Bildern im RTE bequem einstellen. Für die Nutzung einiger Buttons muss ''enableInlineElements'' aktiviert werden (z.B. ''emphasis''). Über die TSconfig kann man den RTE auch individuell gestalten.

----

===== Die Ausgabe im Frontend =====

Einige Angaben fügen HTML-Elemente mit Klassen zum Text hinzu, z.B. ''textstyle''. Diese haben zwar Auswirkungen auf die Ansicht im RTE, nicht aber im Frontend. Hierfür müssen noch Definitionen in der entsprechenden CSS-Datei definiert werden.

Zudem werden einige HTML-Elemente, die dem RTE hinzugefügt wurden (z.B. <cite>), standardmäßig nicht geparst, wodurch diese Quellcode-Elemente im Frontend ausgegeben werden (-> <cite>Das Zitat</cite>). Das Parsen dieser Elemente kann jedoch konfiguriert werden.

===== CSS im RTE =====

Damit die Ansicht im RTE der Frontendausgabe nahe kommt, kann ein CSS-Dokument mit dem RTE verknüpft werden. In diesem sollten nur relevante Formatierungen vorhanden sein; die Verwendung des Frontend-CSS mit Angaben zum Aufbau etc. wird nicht empfohlen.

Auch wichtig: Um eigene Klassen im RTE verwenden zu können, **müssen** diese Klassen in der CSS-Datei des RTE vorhanden sein!

<code typoscript>
RTE.default {
  contentCSS = path/to/rte.css
}
</code>

----
===== Buttons =====

Die RTE-Buttons lassen sich einzeln ein- und ausblenden und neu sortieren. Diese Einstellungen werden in der **Page TSconfig** vorgenommen.

==== Button-Übersicht ====

^blockstylelabel|Bezeichnung vor dem Blockstil-Dropdownmenü.|
^blockstyle|Fügt dem Absatz den gewählten Klassennamen zu.\\ __Achtung:__ Es können mehrere Klassen nacheinander ausgewählt werden, die sich im Frontend ungewünscht ergänzen könnten (z.B. zwei verschiedene Rahmen oder Ausrichtungen). Mit //remove block style// bzw. //no block style// können die Klassen nacheinander wieder entfernt werden.|
^textstylelabel|Bezeichnung vor dem Textstil-Dropdownmenü.|
^textstyle|Fügt dem Text ein ''span'' mit dem gewählten Klassennamen zu.|
^fontstyle|Fügt per Inline-Style eine ''font-family''-Angabe hinzu.|
^fontsize|Fügt per Inline-Style eine ''font-size''-Angabe hinzu.|
^formatblock|Formatiert den Textblock z.B. zu einer Überschrift. Teilweise lassen sich die Formatierungen ergänzen. Mit //remove block format// bzw. //no block format// können die Formatierungen nacheinander wieder entfernt werden.|
^blockquote|Fügt ein <blockquote> (langes Zitat) hinzu.|
^insertparagraphbefore|Fügt einen (leeren) Absatz ''<p></p>'' vor dem aktuell gewählten Absatz hinzu.|
^insertparagraphafter|Fügt einen (leeren) Absatz ''<p></p>'' nach dem aktuell gewählten Absatz hinzu.|
^lefttoright|Fügt dem Absatz das Attribut ''dir="ltr"'' hinzu (Textfluss links von nach rechts).|
^righttoleft|Fügt dem Absatz das Attribut ''dir="rtl"'' hinzu (Textfluss von rechts nach links).|
^language|Markiert den gewählten Text als gewählte Sprache.|
^showlanguagemarks|(De)aktiviert einen Marker vor Inhalten, die ein Sprachattribut ''lang="xy"'' enthalten.|
^left|Fügt dem Element eine Klasse //align-left// hinzu, die im FE noch definiert werden muss.|
^center|Fügt dem Element eine Klasse //align-center// hinzu, die im FE noch definiert werden muss.|
^right|Fügt dem Element eine Klasse //align-right// hinzu, die im FE noch definiert werden muss.|
^justifyfull|Fügt dem Element eine Klasse //align-justify// hinzu, die im FE noch definiert werden muss.|
^orderedlist|Fügt eine nummerierte Liste hinzu.|
^unorderedlist|Fügt eine unsortierte Liste hinzu.|
^definitionlist|Ermöglicht das Anlegen einer Definitionsliste. Der Button wird nur angezeigt, wenn ''orderedlist'' oder ''unorderedlist'' ebenfalls aktiviert ist!|
^definitionitem|Ermöglicht das Umschalten zwischen Ausdruck und Definition einer Definitionsliste.|
^outdent|Entfernt ein ''<div class="indent">'', die zuvor gesetzt wurde.|
^indent|Fügt dem Element ein ''<div class="indent">'' (einrücken) hinzu. Das Verschachteln mehrerer dieser Elemente ist möglich.|
^formattext|Bietet ein Dropdownmenü für Textformatierungen (bold, citation, keyboard, ...).|
^bidioverride|Erzwingt die Textrichtung von Fremdsprachen beim ausgewählten Text mit ''<bdo dir="rtl">'', wenn die automatische Ausrichtung nicht funktionieren sollte.|
^big|Markiert den gewählten Text mit ''<big>''.|
^bold|Fügt ein ''<span style="font-weight: bold;">'' hinzu.|
^citation|Markiert den gewählten Text mit ''<cite>'' (kurzes Zitat).|
^code|Markiert den gewählten Text mit ''<code>'' (Quellcode).|
^definition|Markiert den gewählten Text mit ''<dfn>'' (Definition eines Begriffs).|
^deletedtext|Markiert den gewählten Text mit ''<del>'' (gelöscht).|
^emphasis|Markiert den gewählten Text mit ''<em>'' (betont).|
^insertedtext|Markiert den gewählten Text mit ''<ins>'' (hinzugefügt).|
^italic|Fügt ein ''<span style="font-style: italic;">'' hinzu.|
^keyboard|Markiert den gewählten Text mit ''<kbd>'' (Benutzereingabe).|
^monospaced|Markiert den gewählten Text mit ''<tt>'' (Festbreitenschrift).|
^quotation|Markiert den gewählten Text mit ''<q>'' (Zitat mit Quellenangabe [<q cite="Quelle">]).|
^sample|Markiert den gewählten Text mit ''<samp>'' (Beispiel).|
^small|Markiert den gewählten Text mit ''<small>''.|
^span|Markiert den gewählten Text mit ''<span>''.|
^strikethrough|Fügt ein ''<span style="text-decoration: line-through;">'' hinzu.|
^strong|Markiert den gewählten Text mit ''<strong>''.|
^subscript|Fügt ein ''<span style="vertical-align: sub;">'' hinzu.|
^superscript|Fügt ein ''<span style="vertical-align: super;">'' hinzu.|
^underline|Fügt ein ''<span style="text-decoration: underline;">'' hinzu.|
^variable|Markiert den gewählten Text mit ''<var>'' (Variable).|
^textcolor|Bietet eine Auswahl an Textfarben.|
^bgcolor|Bietet eine Auswahl an Hintergrundfarben.|
^textindicator|Zeigt die aktuelle Formatierung des gewählten Textes an.|
^editelement|Ermöglicht ein Menü, mit dem einem Element Attribute wie //id//, //lang// und //onmouseover// hinzugefügt werden können.|
^showmicrodata|ab TYPO3 4.7: (De)aktiviert einen Marker vor Inhalten, die Mikrodaten (//itemscope//, //itemtype// ...) enthalten.|
^emoticon|Bietet eine Auswahl von 16 Smilies an, die von TYPO3 mitgeliefert werden.|
^insertcharacter|Bietet eine Auswahl an Sonderzeichen an, die der Benutzer bequem im RTE verwenden kann (Durchmesser, Copyright, etc.).|
^insertsofthyphen|ab TYPO3 4.7: Ermöglicht das Setzen eines weichen Trennzeichens (Worttrennung durch den Browser an den angegebenen Stellen).|
^line|Fügt an der gewählten Stelle eine Linie mit ''<hr />'' ein.|
^link|Ermöglicht das Setzen von Ankern: interne/externe Links, Dateilinks, E-Mails.|
^unlink|Entfernt einen zuvor gesetzten Anker.|
^image|Ermöglicht das Einbetten von Bildern im RTE.|
^table|Ermöglicht das Anlegen einer Tabelle mit vielen Einstellungsmöglichkeiten.|
^user|Ermöglicht die Verwendung selbst erstellter HTML-Elemente. Diese müssen noch erstellt werden, sonst ist das Feld leer (siehe unten).|
^acronym|Markiert den gewählten Text mit ''<acronym>''.|
^findreplace|Ermöglicht das Suchen und Ersetzen von Wörtern und Wortteilen.|
^spellcheck|Ermöglicht eine Rechtschreibprüfung. Hierzu muss allerdings noch zusätzliches in TYPO3 installiert werden (z.B. aspell), vorher wird der Button nicht angezeigt.|
^chMode|Zwischen RTE-Ansicht und Quelltext wechseln.|
^inserttag|Einer Textauswahl ein HTML-Element mit Attributen hinzufügen.|
^removeformat|Ermöglicht das Entfernen verschiedener Formatierungen, z.B. MS Word.|
^copy|Auswahl kopieren.|
^cut|Auswahl ausschneiden.|
^paste|Auswahl einfügen.|
^pastetoggle|Das Einfügen ohne Formatierungen ein-/ausschalten.|
^pastebehaviour| |
^undo|Widerrufen von Arbeitsschritten.|
^redo|Wiederherstellen von Arbeitsschritten.|
^about|Zeigt den Hinweis über die RTE-Version mit Browser-Support etc. an.|
^toggleborders|Tabellenränder im RTE ein-/ausblenden.|
^tableproperties|Tabelleneinstellungen anpassen (Breite, Textausrichtung, Rahmen, etc.).|
^tablerestyle| |
^rowproperties|Zeileneinstellungen anpassen (Breite, Textausrichtung, Rahmen, etc.).|
^rowinsertabove|Zeile oben hinzufügen.|
^rowinsertunder|Zeile unten hinzufügen.|
^rowdelete|Gewählte Zeile löschen.|
^rowsplit|Gewählte Zeile teilen.|
^columnproperties|Spalteneinstellungen anpassen.|
^columninsertbefore|Spalte links hinzufügen.|
^columninsertafter|Spalte rechts hinzufügen.|
^columndelete|Gewählte Spalte löschen.|
^columnsplit|Gewählte Spalte teilen.|
^cellproperties|Zelleneinstellungen anpassen (Breite, Textausrichtung, Rahmen, etc.).|
^cellinsertbefore|Zelle links hinzufügen.|
^cellinsertafter|Zelle rechts hinzufügen.|
^celldelete|Einzelne gewählte Zelle löschen.|
^cellsplit|Eine Zelle aufteilen.|
^cellmerge|Zellen verbinden (vorhandene Zellen werden verschoben, nicht überschrieben). Zwei Abfragen: column, row.|

==== Buttons ein-/ausblenden ====

<code typoscript>
# Kommaseparierte Liste aller möglichen Werte:
blockstylelabel, blockstyle, textstylelabel, textstyle, fontstyle, fontsize, formatblock, blockquote, insertparagraphbefore, insertparagraphafter, lefttoright, righttoleft, language, showlanguagemarks, left, center, right, justifyfull, orderedlist, unorderedlist, definitionlist, definitionitem, outdent, indent, formattext, bidioverride, big, bold, citation, code, definition, deletedtext, emphasis, insertedtext, italic, keyboard, monospaced, quotation, sample, small, span, strikethrough, strong, subscript, superscript, underline, variable, textcolor, bgcolor, textindicator, editelement, showmicrodata, emoticon, insertcharacter, insertsofthyphen, line, link, unlink, image, table, user, acronym, findreplace, spellcheck, chMode, inserttag, removeformat, copy, cut, paste, pastetoggle, pastebehaviour, undo, redo, about, toggleborders, tableproperties, tablerestyle, rowproperties, rowinsertabove, rowinsertunder, rowdelete, rowsplit, columnproperties, columninsertbefore, columninsertafter, columndelete, columnsplit, cellproperties, cellinsertbefore, cellinsertafter, celldelete, cellsplit, cellmerge
</code>

<code typoscript>
RTE.default {
  showButtons := addToList(pastetoggle,insertcharacter)
  hideButtons = deletedtext
}
</code>

==== Buttons sortieren ====

Die Buttons lassen sich in der Reihenfolge neu sortieren und mit Linien, kleinen Abständen und Zeilenumbrüchen unterteilen. Buttons, die nicht mit ''showButtons'' aktiviert wurden, werden auch nicht angezeigt. Buttons, die zwar aktiviert wurden, aber nicht in ''toolbarOrder'' gesetzt sind, werden ebenfalls nicht angezeigt.

Schlüsselwörter zur Unterteilung:\\
**space** -> kleiner Abstand (mehrere hintereinander folgende haben keine Auswirkung auf die Abstandgröße)\\
**bar** -> Trennlinie\\
**linebreak** -> Zeilenumbruch\\

<code typoscript>
RTE.default {
  toolbarOrder = bold, italic, bar, left, center, right, justifyfull, linebreak, undo, redo, chMode
}
</code>

----
===== Button-Definitionen anpassen =====

Die Basiskonfiguration kann nach Belieben verändert oder ergänzt werden. So kann man andere Schriften, Farben oder Rahmen für den Anwender bereitstellen.

==== Farbwähler ====

Der Farbwähler hat eine voreingestellte Liste von 72 Farben sowie ein Feld zur Eingabe von eigenen Farben im Hexadezimalwert. Er kann um eigene Farben ergänzt werden.

{{ :typo3:about:rte-farbwaehler.png?direct&200 |}}

<code typoscript>
# Button für Textfarbe hinzufügen, ohne die bestehende Liste der Buttons zu überschreiben.
RTE.default.showButtons := addToList (textcolor)

# Standardfarben ausblenden. Ist nicht zwingend notwendig, um eigene Farben zu definieren.
RTE.default.disableColorPicker = 1

# Farben mit Hexadezimalwert anlegen. Die Farbnamen sind frei wählbar.
RTE.default.colors = rot, gruen, blau
RTE.colors {
  rot {
    name = Rot
    value = #FF0000
  }
  gruen {
    name = Grün
    value = #00FF00
  }
  blau {
    name = Blau
    value = #0000FF
  }
}
</code>

===== <select> Elemente ausblenden =====

==== formatblock ====

Mit **TSconfig** können unliebsame Optionen einfach entfernt werden:

<code>
RTE.default {
  buttons.formatblock.removeItems = address,h5,h6,article,footer,header,nav,section,aside,div
}
</code>

==== blockstyle ====

Für das select-Menü ''blockstyle'' gibt es hierzu kein TSconfig! Was aber die Lösung bringt: In der **CSS** des RTE einfach die nicht gewünschten Klassen entfernen.

----

==== RTE-Dialogfenster anpassen ====

Mit dem folgenden Snippet lässt sich die Fenstergröße des Link Wizards anpassen.

**Page TSconfig:**
<code typoscript>
RTE.default { 
    buttons.link.dialogueWindow.width = 750 
    buttons.link.dialogueWindow.height = 750 
    buttons.link.dialogueWindow.positionFromTop = 10 
    buttons.link.dialogueWindow.positionFromLeft = 10 
} 
</code>