BbCode Erweiterung 2 v1.0

Aus DeDi-Help

Wechseln zu: Navigation, Suche

Inhaltsverzeichnis

[bearbeiten] Einleitung

bbCode ist eine Methode, Texte auch ohne HTML-Kenntnisse zu formatieren. Dabei wird ein begrenzter Satz an HTML-ähnlichen Formatierungselementen angeboten, welche über einfache Parameter gesteuert werden können. Zusammen mit dem ContentFlex- oder DeDiFlex-Modul bietet die bbCode-Erweiterung eine Alternative zum häufig verwendeten WYSIWYG-Editor.

Es gab bereits eine bbCode-Erweiterung für DeDi, jedoch hatte diese einige entscheidende Nachteile gegenüber dem WYSIWYG-Editor. Vor allem fehlten Formulare zum einfachen Einfügen von Links, Bildern und anderen Elementen. Die neue Version versucht diese Nachteile auszugleichen.

Wenn Sie mit mir Kontakt aufnehmen wollen können Sie mich per PM oder per Mail benachrichtigen oder mir ein Feedback geben. Für Bugs und allgemeinere Fragen posten Sie bitte im Diskussionsthread

[bearbeiten] Download & Installation

Die aktuelle Version (v1.0 Beta 2) der bbCode-Erweiterung ist seit Version 1.0.2 des Dirigenten Bestandteil der Distribution und nicht mehr als Erweiterungspacket verfügbar. Bitte Upgraden Sie auf die aktuelle DeDi-Version. Diese können Sie im Downloadbereich herunterladen.

[bearbeiten] Anwendung & Konfiguration

Die bbCode-Erweiterung greift in das Verhalten des <dedi:mod type="textarea"/> ein und erweitert ihn um die Fähigkeit, bbCode zu erstellen und zu verarbeiten. Um eine Textarea mit bbCode-Funktionalität auszustatten, muss im dedi:mod-Tag der Parameter transform auf bbcode gesetzt sein. Dies ist beispielsweise eine funktionsfähige bbCode-Textarea: 

<dedi:mod 
  type = "textarea" 
  id = "3" 
  transform = "bbcode"
/>

Mit dieser Konfiguration verwendet die bbCode-Erweiterung Standardeinstellungen für alle Parameter. Allerdings lassen sich diese Parameter sehr fein an die gewünschten Verhältnisse anpassen. Alle Konfigurationseinstellungen werden über Parameter im dedi:mod-Tag festgelegt. Weiter unten in dieser Dokumentation finden Sie eine Referenz der Parameter.

[bearbeiten] Beispiele

Typische bbCode-Textarea ohne Absatzbehandlung 

<dedi:mod 
  type = "textarea" 
  transform = "bbcode" 
  id = "1" 
  title = "Typisch" 
  notext = "true" 
  filelinktpl = "Download: [b]{text}[/b] [[i]{size}[/i]]" 
  filefolders = "3, 9" 
  filesubfolders ="true" 
  filefiletypes = "gif" 
  sizemin = "75" 
  sizemax = "225" 
  fonts = "Arial,Microsoft Sans Serif,Comic Sans MS,Times New Roman" 
  classes = "waring=Warnung, adress=Adresse" 
>

Miminale bbCode-Textarea mit Absatzbehandlung 

<dedi:mod 
  type = "textarea" 
  transform = "bbcode" 
  id = "2" 
  title = "Absatzbehandlung" 
  features = "bold, italic, underline"
  paragraphs = "p" 
/>

[bearbeiten] besondere Funktionen

[bearbeiten] Absatzbehandlung

Die Absatzbehandlung ist eine Methode, sauberen und semantisch korrekten Quellcode zu erzeugen. Bei aktivierter Absatzbehandlung werden Textteile, welche als eigenständiger Absatz erkannt werden, automatisch mit <p></p> umschlossen (p = Paragraph = Absatz). Zeilen werden zu einem Absatz zusammengefasst, wenn sie entweder nur einen (singleenter="false" (Standard)) oder gar keinen (singleenter="true") Zeilenumbruch enthalten. Steht eine Leerzeile zwischen zwei Zeilen, werden die Zeilen immer in getrennte Absätze gepackt. 

Dies ist ein Absatz
der immer noch weitergeht

Hier beginnt dann ein neuer

Dies würde zu folgendem HTML-Code führen: 

<p>Dies ist ein Absatz
der immer noch weitergeht</p>
<p>Hier beginnt dann ein neuer</p>

Um die Absatzbehandlung zu aktivieren, muss der paragraphs-Parameter auf p gesetzt werden.

Ohne Absatzbehandlung wird jeder Zeilenumbruch in der HTML-Ausgabe als <br /> dargestellt. Dadurch kann man das Textlayout der Seite genauer kontrollieren. Um in einem Text mit aktivierter Absatzbehandlung einen manuellen Zeilenumbruch zu erzeugen, verwenden Sie den [br]-Tag. Dieser ist jedoch nur bei einer aktivierten Absatzbehandlung verfügbar.

[bearbeiten] Style-Attribut

Um einzelnen Elementen spezielle Formatierungen zuweisen zu können, kann das style-Attribut verwendet werden. Ihm kann eine in der classes- oder der classids-Auflistung enthaltene Klasse zugewiesen werden, welche dann auf das Element in der Ausgabe übertragen wird. Wird eine Klasse angegeben, die nicht in einer der beiden obigen Auflistungen vorhanden ist, wird nicht der ganze Tag, sondern nur die Klasse ignoriert. Um beispielsweise einen speziellen Link zu erzeugen, können Sie einen Tag wie folgt notieren: 

[link dest="http://der-dirigent.de" style="dedilink"]Der Dirigent[/link]

Voraussetzung ist, dass vorher eine Klasse dedilink definiert und im dedi:mod-Tag angegeben wurde. Das style-Attribut kann in folgenden Tags verwendet werden:

über das Einfügen eines style-Tags in einen Tag via GUI können Sie sich unter Stil-Auswahl informieren.

[bearbeiten] Strip-Tags

Die Strip-Tags-Funktion soll es erleichtern, einen bereits formatierten Text wieder von bbCode-Formatierungen zu befreien. Dazu werden nach einer Sicherheitsabfrage innerhalb des markierten Textes alle bbCodes entfernt. Es werden jedoch nur bekannte Codes entfernt, damit nicht zufällig anderer Text in eckigen Klammern verloren geht. Sollten Sie dennoch ein fehlerhaftes Verhalten feststellen, schreiben Sie bitte einen Beitrag im aktuellen Diskussionsthread. Den Link dorthin finden Sie am Ende der Einleitung.

[bearbeiten] Charmap

Die Zeichentabelle soll dem Benutzer ermöglichen, bequem Sonderzeichen einzufügen. Die Zeichen werden als benannte Entitäten in den Quelltext eingefügt. Vefügbar sind alle benannten Entitäten der HTML 4.0-Spezifikationen. Eine anschauliche Übersicht findet man in der SelfHTML Zeichenreferenz.

[bearbeiten] Entitätenbehandlung

Die bbCode-Erweiterung hat eine besondere Art der Entitätenbehandlung. Zum einen werden die HTML-eigenen Zeichen &, < und > durch ihre entsprechenden Entitäten ersetzt, zum anderen werden, alle benannten Entitäten der HTML-4.0-Standards sowie bis zu 5-stellige numerische und bis zu 4-stellige hexadezimale Entitäten durchgelassen, mit denen Sie jedes UTF-8-Zeichen einfügen können.

Da das Aussortieren benannter Entitäten bei sehr großen Seiten recht lange dauern kann, können Sie die Verarbeitung benannter Entitäten mit dem namedentities-Parameter deaktivieren. Dann sind nur noch numerische und hexadezimale Entitäten erlaubt.

In wie weit die Erweiterung nativ UTF-8 unterstützt, ist noch nicht getestet. Falls Sie Erfahrungen damit haben oder ein Fehlverhalten feststellen, würde ich mich über ein kurzes Feedback im aktuellen Diskussionsthread freuen. Den Link dorthin finden Sie am Ende der Einleitung.

[bearbeiten] Linktemplates

Es ist möglich, verschiedene Templates für die verschiedenen Linkarten zu definieren. Linktemplates sind Vorlagen, mit denen das Aussehen und die Funktion eines Links bestimmt werden kann. Die Linktemplates ihrerseits werden wiederum auch mit bbCodes formatiert. Das Standard-Linktemplate für alle Links lautet: 

[link='{url}']{text}[/link]

Sie können aber auch Ihre eigenen Templates mit weiteren Tags und eigenen Texten bestücken. Folgende Tags sind innerhalb der Linktemplates erlaubt:

Die Templates werden über Parameter im dedi:mod-Tag definiert. Es gibt getrennte Templates für normale Links (linktpl), externe Links (extlinktpl), E-Mail-Links (maillinktpl) und Dateilinks (filelinktpl).

Innerhalb der Templates können bestimmte Variablen gesetzt werden. In den Templates für normale, externe und Maillinks wird {url} mit dem Zielpfad ersetzt und sollte dem dest-Attribut eines [link]-Tags übergeben werden. Außerdem wird {text} mit dem Linktext ersetzt.

Zusätzlich zu den oben genannten Variablen, können im Dateilink noch folgende Variablen verwendet werden:

  • {size}: Die Dateigröße mit Einheit (Bytes, KB, MB, GB, TB)
  • {title}: Der im Dateimanager eingegebene Titel
  • {desc}: Die im Dateimanager angegebene Beschreibung
  • {type}: Die Dateinamenserweiterung ohne Punkt, also z. B. "gif", "jpg", "zip" oder "pdf"
  • {typedesc}: Eine Beschreibung des Typs, z.B. "GIF" oder "Cascading Style Sheet"
  • {file}: Der eigentliche Dateiname

Anwendungsbeispiele würen z. B. ein Icon vor E-Mail-, Download- oder externen Links: 

[img]223[/img][link='{url}']{text}[/link]

eine Größenangabe bei Downloadlinks: 

[link='{url}']{text}[/link] [i]({size})[/i]

oder ein typenabhängiges Icon bei Downloadlinks: 

[img]{mediapath}typeicons/{type}.png[/img][link='{url}']{text}[/link]

Eine Ausnahme bildet das Template für Fußnotenlinks (footnotelinktpl). Da die Fähigkeiten des [link]-Tags nicht für die Fußnotenlinks ausreichen (hier muss zusätzlich eine ID als Ansprungziel für den Rücklink in den Fußnoten definiert werden), kann hier nur der Linktext festgelegt werden. Einziger Parameter ist hier {id}, welcher durch die fortlaufend nummerierte ID der Fußnote ersetzt wird. Das Standardtemplate ist: 

[{id}]

[bearbeiten] kein Linktext

Einige der Tags erlauben es, ihren Standardparameter über den Inhalt zu beziehen. So kann man z. B. statt 

[email="info@der-dirigent.de"][/email]

auch einfach 

[email]info@der-dirigent.de[/email]

schreiben. Genauer gesagt geht das mit folgenden Tags:

Wobei es beim [link]-Tag noch eine Besonderheit gibt, auf die im entsprechenden Abschnitt näher eingegangen wird.

[bearbeiten] Fußnoten

Die bbCode-Erweiterung unterstützt die automatische Fußnotengenerierung. Dazu muss das Fußnotenmodul aus der Erweiterung im Dirigenten importiert werden und unterhalb der bbCode-Textarea(s) im Template eingebaut werden.

Um eine Fußnote zu erstellen, wird an entsprechender Stelle ein [footnote]-Tag notiert und in seinem Inhalt der Text der Fußnote eingetragen. Dieser Text kann mit allen bbCodes formatiert werden. Die Fußnoten werden dann alle der Reihe nach durchnummeriert und mit den Einträgen aus dem Modul verlinkt. Es wird auch automatisch ein Rücklink aus dem Modul in den Text generiert.

[bearbeiten] Notation der bbCode-Tags

Die bbCode-Erweiterung 2 kennt mehrere Möglichkeiten bbCodes zu definieren. Folgende Möglichkeiten stehen zur Auswahl: 

[tag]text[/tag]

Ein einfacher Tag ohne weitere Parameter. 

[tag: value]text[/tag]

Ein Tag mit nur einem Parameter (dem Standardparameter). Dieser Parameter darf keine Leerzeichen beinhalten. 

[tag=value]text[/tag]

Identisch zu oben stehender Notation. Ohne Anführungszeichen darf der Wert dieses Parameters kein Leerzeichen enthalten. 

[tag="more value"]text[/tag]

Wie oben, nur diesmal mit Anführungszeichen. Hier sind auch Leerzeichen kein Problem. Anführungszeichen müssen mit \" escaped werden. 

[tag='value value']text[/tag]

Wie oben, nur diesmal mit einfachen Anführungszeichen. Diesmal können normale Anführungszeichen problemlos verwendet werden. Einfache Anführungszeichen müssen mit \' escaped werden. 

[tag par1=value1 par2=value2]text[/tag]

Ein Tag mit benannten Parametern. Auf diese Art können auch mehrere Parameter übergeben werden. Selbstverständlich können auch hier beide Arten von Anführungszeichen gesetzt werden, um Leerzeichen in Parameterwerten zu ermöglichen.

[bearbeiten] Anpassung vorhandener Module

Es ist zwar möglich, mit nur einer bbCode-Textarea eine komplette Seite zu erstellen, jedoch ist das nicht besonders elegant. Darum ist es interessant, die bbCode-Erweiterung mit anderen Modulen wie z. B. dem ContentFlex oder dem DeDiFlex zu kombinieren. Derzeit läßt sich die bbCode-Erweiterung im ContentFlex durch einen einfachen Schalter in der Modulkonfiguration aktivieren, zum Konfigurieren ist jedoch noch Sourcecodeeingriff nötig. Im DeDiFlex ist bbCode standardmäßig nicht aktiviert und kann auch nicht ohne Sourcecodeeingriff aktiviert werden. Ich rate daher dazu, das ContentFlex-Modul dem DeDi-Flex vorzuziehen. Um den bbCode im ContentFlex zu konfigurieren, suchen Sie dazu im Moduloutput nach den entsprechenden <dedi:mod type="textarea" />-Tags und fügen Sie die gewünschten Parameter ein. Es ist geplant das Modul Textarea sowie das Modul ContentFlex so anzupassen, dass auch die komplette Konfiguration über die Modulkonfiguration möglich ist. Da ich jedoch mit der Weiterentwicklung der Erweiterung selbst, einger anderen Projekten und der Schule mehr als ausgelastet bin, wäre ich froh wenn sich jemand um diese Module kümmern würde. Die bbCode-Erweiterung unterstützt auch mehrere bbCode-Textareas in einer Typegroup.

[bearbeiten] Die GUI-Elemente

Zusätzlich zu der Möglichkeit, bbCodes im Text zu verarbeiten, bietet die bbCode-Erweiterung auch eine GUI, um diese Tags während des Bearbeitens in den Text einzufügen. Hier wird diese GUI, ihre Elemente und Funktionsweisen beschrieben. Zu beachten ist, dass diese Elemente nur angezeigt werden, wenn die entsprechenden Features aktiviert wurden. Ebenso können einige Eingabefelder in den Dialogen ausgeblendet sein. Die Dialoge, die von der GUI geöffnet werden, merken sich ihre Größe bis zum Ende der Sitzung. Dazu muss der Browser Session-Cookies erlauben.

[bearbeiten] Schriftgrößen-Auswahl

Die Auswahlbox für die Schriftgröße wird angezeigt, wenn das size-Feature aktiviert ist. Die Anzahl der Elemente in der Auswahlbox und deren Werte werden von den beiden Parametern sizemin & sizemax bestimmt. Dabei wird in 5er-Schritten von der minimalen zur maximalen Schriftgröße gezählt und jeweils ein Eintrag angelegt. Das Auswählen einer Schriftgröße legt einen [size]-Tag mit der ausgewählten Schriftgröße an.

[bearbeiten] Schriftartenauswahl

Die Schriftartenauswahl benötigt das font-Feature und mindestens eine angegebene Schriftart. Welche Schriftarten angezeigt werden, wird vom fonts-Parameter bestimmt. Die Auswahlbox versucht dabei, eine Vorschau der gewählten Schriftart zu zeigen. Allerdings funktioniert das nicht in allen Browsern. Wird eine Schriftart ausgewählt, wird ein [font]-Tag mit der gewählten Schriftart eingefügt.

[bearbeiten] Stil-Auswahl

Das Auswahlfeld für Stile wird angezeigt, wenn entweder das class und/oder das stylebox-Feature sowie mindestens eine CSS-Klasse per class- oder classids-Parameter angegeben wurde. Es übernimmt dabei je nach angegebenen Features verschiedene Aufgaben.

  1. Wurde nur das class-Feature aktiviert, so fügt die bbCode-Erweiterung beim Auswählen eines Stils einen [class]-Tag mit der ausgewählten Klasse ein.
  2. Ist nur das stylebox-Feature ausgewählt, wird ein Style-Attribut mit der ausgewählten Klasse in den nächsten Tag eingebaut. Dazu wird erst der gewünschte Stil im Auswahlfeld ausgewählt, anschließend der Button für den einzufügenden Tag gedrückt und ein eventuell erscheinender Dialog ausgefüllt. Erzeugt werden Tags wie z. B. [hr style="meinstil"].
  3. Ist sowohl das class als auch das stylebox-Feature aktiviert, wird hinter der Stilauswahl eine Checkbox eingeblendet. Ist diese deaktiviert (Ausgangszustand), verhält sich die Stil-Auswahl wie 1.. Wird die Checkbox jedoch aktiviert, bevor ein Stil gewählt wird, verhält sich die Auswahl wie 2..

[bearbeiten] Farbwahl-Dialog

Der Farbwahl-Dialog bietet dem Benutzer die Möglichkeit, einen Farbcode auszuwählen. Je nach Button wird entweder ein [forecol]-Tag oder ein [backcol]-Tag eingefügt. Im Farbwahl-Dialog kann neben den aufgeführten Farben auch ein eigener Hexadezimaler Farbcode eingegeben werden. Farbnamen sind nicht erlaubt.

[bearbeiten] Bild-Dialog

Das Bild-Dialogfenster besteht aus zwei Teilen. Zum Einen gibt es die Eingabefelder auf der linken Seite, zum Anderen den Dateibaum auf der rechten. Die Eingabefelder bedeuten konkret Folgendes:

  • Quelle: Eine Datei-ID aus dem DeDi-Dateimanager, eine externe URL zu einer Bildressource oder eine lokale URL zu einer Bilddatei auf dem Webserverser selbst. Zusätzlich kann der {mediapath}-Platzhalter verwendet werden, um manuell (ohne Datei-ID) auf Dateien im media-Verzeichnis des Projektes zuzugreifen. Wird im Dateibaum eine Datei ausgewählt, wird die Quelle automatisch auf dessen Datei-ID gesetzt.
  • Beschreibung: Eine einzeilige Kurzbeschreibung des Bildes, die als Alternativtext und Bildertitel verwendet wird. Wählt man im Dateibaum eine Datei aus und das Beschreibungsfeld ist noch leer, wird der im Dateimanager vergebene Dateititel übernommen. Diese Beschreibung kann im Dateibaum als ToolTipText eingesehen werden, bevor man eine Datei anklickt.
  • Höhe & Breite: Diese beiden Attribute geben Größenangaben für die Grafik an. Genaueres können Sie unter Breite und Höhe von Grafiken nachlesen.

Der Dateibaum auf der rechten Seite zeigt die Dateien und Ordner aus dem DeDi-Dateimanager an, die der angemeldete DeDi-Benutzer sehen darf. Zusätzlich werden die angezeigten Ordner durch die Werte der imgfolders-, imgfolderids-, imgsubfolders-Parameter beeinflusst werden. Welche Dateien innerhalb der Ordner angezeigt werden, kann mit dem imgfiletypes- und dem imgfiletypeids-Parameter bestimmt werden. Der Baum merkt sich bis zum Ende der Sitzung welche Ordner geöffnet waren. Dazu muss der Browser Sessioncookies akzeptieren.

[bearbeiten] Abkürzungs-Dialog

Der Abkürzungs-Dialog für [abbr]- und [acroym]-Tags hat zwei Eingabefelder

  • Titel: Hier kann der Titel oder die Beschreibung zu der Abkürzung oder dem Akronym eingetragen werden. Dieser Titel wird in dem meisten Browsern als ToolTipText über der Abkürzung angezeigt.
  • Sprache: Hier kann die Sprache, aus der die Abkürzung oder das Akronym stammt, angegeben werden. Erwartet wird ein Sprachenkürzel nach RFC 1766.

Genaueres über den Sinn und auch den Unterschied zwischen Abkürzungen und Akronymen, können den entsprechenden Wikipedia-Artikeln Akronym und Abkürzung entnommen werden.

[bearbeiten] Link-Dialog

Der Link-Dialog besteht wie der Bild-Dialog aus zwei Teilen: den Eingabefeldern und einem Auswahlbaum. Der Baum zeigt hier aber nicht die Dateistruktur, sondern die für den angemeldeten Benutzer sichtbaren Seiten an. Folgende Eingabefelder sind verfügbar:

  • Ziel: Kann eine absolute URL oder eine Seitennummer sein. Wird eine Seite im Seitenbaum gewählt, wird das Ziel automatisch auf deren Seitennummer gesetzt.
  • Zielframe: Hier kann der Frame ausgewählt werden, in dem der Link geöffnet wird. Näheres über die Bedeutung der einzelnen Werte können Sie unter "Zielfenster für Verweise bestimmen" nachlesen.
  • Anker: Anker sind markierte Stellen innerhalb von Seiten, die es dem Browser ermöglichen, direkt einen bestimmten Punkt innerhalb der Seite anzuspringen. In dieses Eingabefeld kann der Name eines Ankers angegeben werden, welcher in der Zielseite angesprungen werden soll. Das funktioniert sowohl mit Seitennummern als auch mit absoluten URLs als Ziel. Im bbCode können Sie Ankerpunkte mit dem [anchor]-Tag erstellen (anchor = Anker).
  • kein Linktext: Diese CheckBox gehört zu der "kein Linktext"-Funktion und wird im zugehörigen Abschnitt näher erläutert. Sie wird nur angezeigt, wenn der notext-Parameter gesetzt ist.

Der Seitenbaum auf der rechten Seite zeigt die Seiten an, die der angemeldete Benutzer sehen darf. Die Startseiten werden mit einer kleinen roten Eins im Symbol markiert. Wird eine Seite angeklickt, wird ihre Nummer in das Ziel-Feld übernommen. Der Baum merkt sich bis zum Ende der Sitzung welche Ordner geöffnet waren. Dazu muss der Browser Session-Cookies akzeptieren.

[bearbeiten] E-Mail-Dialog

Der E-Mail-Dialog hilft beim Einfügen von [email]-Tags. Es werden folgende Eingabefelder angezeigt:

  • Mailadresse: Hier wird die Mailadresse eingegeben, auf die der Link verweisen soll. Es werden ausgeschriebene E-Mail-Adressen erwartet, Stilisierungen wie info AT der-dirigent DOT de werden nicht akzeptiert.
  • Name: In diesem Feld kann ein Name zu der zuvor angegeben E-Mail-Adresse definiert werden. Dieser Name wird dann statt der Adresse im Mailprogramm des Benutzers angezeigt.
  • Betreff: Es kann auch ein Betreff vorgegeben werden, der dann in den meisten Mailprogrammen als Vorbelegung genommen wird.
  • kein Linktext: Diese CheckBox gehört zu der "kein Linktext"-Funktion und wird im zugehörigen Abschnitt näher erläutert. Sie wird nur angezeigt, wenn der notext-Parameter gesetzt ist.

[bearbeiten] Ankerdialog

Mit dem Ankerdialog kann ein Anker in einer Seite definiert werden, den man dann mit einem Ankerlink anspringen kann. Der Dialog fügt einen [achor]-Tag in den Text ein. Es gibt folgende Eingabefelder:

  • AnkerID: Hier wird der eindeutige Name (ID) des Ankers eingegeben, auf den mit dem [link]-Tag verwiesen wird.
  • kein Linktext: Diese Checkbox gehört zu der "kein Linktext"-Funktion und wird im zugehörigen Abschnitt näher erläutert. Sie wird nur angezeigt, wenn der notext-Parameter gesetzt ist.

[bearbeiten] Dateilink-Dialog

Um bequem [filelink]-Tags einzufügen, gibt es den Dateilink-Dialog. Das Dialogfenster besteht fast ausschlieölich aus einem Dateibaum, der ähnlich dem Dateibaum im Bild-Dialog die Dateien aus dem Dateimanager anzeigt, die der angemeldete Benutzer sehen darf. Welche Ordner angezeigt werden, können Sie mit den filefolders-, filefolderids-, filesubfolders-Parametern beeinflussen. Die angezeigten Dateien können mit dem imgfiletypes- und dem imgfiletypeids-Parameter ausgewählt werden. Der Baum merkt sich bis zum Ende der Sitzung welche Ordner geöffnet waren. Dazu muss der Browser Session-Cookies akzeptieren. Zusätzlich kann noch eine kein Linktext-Checkbox angezeigt werden. Diese gehört zu der "kein Linktext"-Funktion und wird im zugehörigen Abschnitt näher erläutert. Sie wird nur angezeigt, wenn der notext-Parameter gesetzt ist.

[bearbeiten] Listen-Dialog

Der Listen-Dialog setzt sich aus einer Liste, einem Eingabefeld und mehreren Funktionsbuttons zusammen. Die Liste dient als Vorschau für die Anzeige und Sortierung der Listenelemente. über das Eingabefeld können neue Elemente hinzugefügt werden. Dazu geben Sie den Text des Elements in das Feld ein und klicken Sie auf Hinzufügen oder bestätigen Sie mit Enter. Um ein Element aus der Liste zu löschen, markieren Sie es und klicken auf Entfernen.

Um ein Element zu bearbeiten, markieren Sie es zuerst in der Liste. Sie können nun im Textfeld den Wert des Eintrages ändern und mit einem Klick auf übernehmen in der Liste ändern.

Mit den Buttons auf der rechten Seite, können markierte Elemente Hoch, Runter, Nach Oben und Nach Unten verschoben werden. Sie können mit gedrückter Strg- oder Shift-Taste auch mehrere Elemente markieren und mit den Buttons verschieben. Mit einem Klick auf Umkehren kehrt sich die Reihenfolge aller Listenelemente um.

Um schließlich den [list]-Tag mit seinen Listenelementen zu erzeugen, klicken Sie auf OK.

[bearbeiten] Tabellen-Dialog

Der Tabellendialog hat zwei Eingabefelder für die Anzahl der Zeilen und der Spalten. Mit einem Klick auf OK wird ein [table]-Tag mit vorbereiteten [row]- und [cell]-Tags erzeugt.

[bearbeiten] Die Parameter des dedi:mod-Tags

Der jeweils erste angegebene Wert entspricht dem Standard-Wert.

[bearbeiten] features

features = "true|bold, italic, underline, strike, sub, sup, 
                 size, font, class, backcol, forecol, img, 
                 abbr, acronym, email, link, br, hr, anchor, 
                 filelink, list, footnote, code, source, 
                 table, stylebox, striptags, charmap"

Aktiviert bestimmte Features der bbCode-Erweiterung. Erwartet wird das Wort "true" (aktiviert alle Features) oder eine kommaseparierte Liste folgender Begriffe:

  • bold, italic, underline, strike, sub, sup, size, font, class, backcol, forecol, img, abbr, acronym, email, link, br, hr, anchor, filelink, list, footnote, code, source, table:
    Aktiveren die gleichnamigen Tags sowie damit verbundene Tags (z.B row und cell bei table).
  • stylebox:
    Aktiviert die Möglichkeit, über die Stil-Auswahl-Elemente mit Style-Attributen einzufügen. Die dazu nötige Vorgehensweise und die Rolle des stylebox-Features dabei, kann im Abschnitt über die Stil-Auswahl nachgelesen werden.
  • striptags:
    Aktiviert die Strip-Tags-Funktion. Näheres dazu kann im entsprechenden Abschnitt nachgelesen werden.
  • charmap:
    Aktiviert die Charmap-Funktion.

[bearbeiten] fonts

fonts = "[Font #1], [Font #2], [Font #n], ..."

Mit dieser kommaseparierten Liste können Sie die Schriftarten, die der Redakteur in der Schriftartenauswahl auswählen und im [font]-Tag benutzen kann, bestimmen. Die angegeben Schriftartennamen können auch Leerzeichen enthalten. Andere als die hier angezeigten Schriftarten können nicht verwendet werden.

[bearbeiten] classes

classes = "[Class #1]=[Classname #1], [Class #2]=[Classname #2], [Class #n]=[Classname #n]"

Diese kommaseparierte Liste definiert die möglichen Klassen, welche über die Stil-Auswahl ausgewählt und im [class]-Tag verwendet werden können. Zusätzlich zu den Klassennamen kann ein Anzeigename angegeben werden, welcher in der Auswahlbox ausgegeben wird.

[bearbeiten] classids

classids="[ID #1], [ID #2], [ID #n]"

Zusätzlich zu den über den classes-Parameter angegeben Klassen können hier auch noch IDs zu in der Datenbank gespeicherten Klassen angegeben werden. Das ist besonders für die automatische Konfiguration über mip_forms wichtig und für die manuelle Konfiguration eher uninteressant.

[bearbeiten] sizemin & sizemax

sizemin = "75|[Prozentwert]"
sizemax = "125|[Prozentwert]"

Diese beiden Parameter geben die minimale bzw. maximale Schriftgröße an. Schriftgrößen können ausschließlich in Prozentangaben definiert werden. Die Auswahlbox im Bearbeitungsbereich zeigt zwar nur die Prozentwerte zwischen diesen beiden Grenzen in Fünferschritten an, jedoch können in den Tags auch numerische Werte dazwischen angegeben werden. Standardmäßig sind Schriftgrößen von 75% bis 125% erlaubt.

[bearbeiten] paragraphs

paragraphs = "br|p"

Gibt an, auf welche Weise Absätze behandelt werden. Ist p als Wert angegeben, werden Absätze mit der Absatzbehandlung verarbeitet. Bei br werden Absätze durch <br> bzw. <br />, abhängig vom htmlmode, dargestellt.

[bearbeiten] notarget

notarget = "false|true"

Gibt an, ob im Link-Dialog das Target-Feld ausgeblendet werden soll. Außerdem wird in der Frontendausgabe die Ausgabe des target-Attrbutes unterdrückt. Sollte bei Seiten, die XHTML-konform sein sollen, aktiviert werden.

[bearbeiten] notext

notext = "false|true"

Gibt an, dass in den Formularen zu [email], [anchor], [filelink] und [link] eine Checkbox 'Kein Text' angezeigt wird, die die bbCode-Erweiterung dazu veranlasst, die bbCode-Tags in der Form 

[link]http://www.google.de[/link]

einzufügen, welche den code sauberer hält, jedoch keinen Linktext ermöglicht. Diese Form ist identisch zu 

[link="http://www.google.de"][/link]

Dieser Schalter hat nur Auswirkung auf die (nicht-)Anzeige der Checkbox, die Tags werden trotzdem immer interpretiert. Eine Besonderheit beim [link]-Tag gibt es aber:

Bei einem Link-Tag der Form 

[link anchor="dedi"]zum DeDi[/link]

ist nicht klar, ob "zum DeDi" ein Linktext oder ein -ziel darstellen soll. Solange der Text nicht mit einer URL zu verwechseln ist, geht das noch, aber spätestens bei 

[link anchor="dedi"]33[/link]

Kann die 33 sowohl als Seitenzahl als auch als Linktext gemeint sein. Darum wurde eine Einschränkung vorgenommen, welche die Eindeutigkeit wieder herstellt: Wenn ein anchor-Attribut angegeben wurde, wird der Inhalt des Tags immer als Linktext gewertet. Eine zusätzliche Zielangabe muss über ein dest-Attribut gemacht werden.

[bearbeiten] linkexternal

linkexternal = "true|false"

Gibt an, ob [link]-Tags auch auf externe URLs verweisen dürfen. Ansonsten sind nur Seiten-IDs als Ziele zugelassen.

[bearbeiten] imgexternal

imgexternal = "true|false"

Genauso wie linkexternal, nur für [img]-Tags. Wird imgexternal deaktiviert, können Bilder nur noch mittels Dateinummer referenziert werden.

[bearbeiten] linktpl, extlinktpl, maillinktpl & filelinktpl

Templates für normale, externe, E-Mail- und Dateilinks. Diese Templates können mit den meisten bbCodes formatiert werden. Welche das sind und welche Variablen in den Templates ersetzt werden, können Sie im Abschnitt über Linktemplates nachlesen. Das Standardtemplate ist: 

[link='{url}']{text}[/link]

[bearbeiten] footnotelinktpl

Template für die Links des [footnote]-Tags. Weitere Informationen über die Verwendung dieses Templates können Sie im Abschnitt über Linktemplates nachschlagen. Der Standardwert ist 

[{id}]

[bearbeiten] singleenter

singleenter = "false|true"

Wird dieser Parameter auf true gesetzt, wird bei aktivierter Absatzbehandlung schon nach einem einzelnen Zeilenumbruch ein neuer Absatz begonnen.

[bearbeiten] imgalwaysalt

imgalwaysalt = "true|false"

Gibt an, ob ein von einem [img]-Tag erzeugter <img>-Tag immer ein alt-Attribut erhält, auch wenn kein Titel angegeben wurde. Sollte für XHTML-Konformität aktiviert sein.

[bearbeiten] htmlmode

htmlmode = "XHTML|HTML4"

Bestimmt, auf welche HTML-Version die bbCode-Erweiterung ihre Ausgabe abstimmen soll.

  • XHTML: Erzeugt XHTML1 und XHTML1.1 kompatible Ausgabe.
  • HTML4: Stimmt die Ausgabe nach den HTML4-Spezifikationen ab.

[bearbeiten] htmltags

htmltags = "convert|allow|strip"

Legt fest, was mit HTML-Tags im Text geschehen soll.

  • convert: <, > und & werden in die entsprechenden Entitäten verwandelt
  • allow: Lässt <, > und & und alle HTML-Tags zu
  • strip: Versucht alle HTML-Formatierungen aus dem Text zu entfernen. Dazu wird die PHP-Funktion strip_tags() verwendet.

[bearbeiten] namedentities

namedentities = "true|false"

Mit diesem Parameter kann die Verarbeitung von benannten Entitäten deaktiviert werden. Das kann sinnvoll sein, da das Sortieren von benannten Entitäten bei sehr großen Seiten sehr lange dauern kann. Weitere Informationen können im Abschnitt über die Entitätenbehandlung nachgelesen werden.

[bearbeiten] classescontainer

classescontainer = "inline|block"

Dieser Konfigurationsparameter gibt an, in welcher Umgebung die Klassen des [class]-Tags ausgegeben werden.

  • inline bedeutet, dass ein Inline-Element mit der Klasse belegt wird, genauer gesagt wird ein <span>-Element erzeugt.
  • block erzeugt ein Blocklevel-Element (<div>) und weist ihm die angegeben Klasse zu.

[bearbeiten] filefolders

filefolders = "true|[iddirectorys]"

Mit diesem Parameter kann gesteuert werden, welche Ordner im Dateilink-Dialog-Dialog auftauchen. Für filefolders können Sie kommasepariert eine Liste von OrdnerIDs angeben. Diese bekommt man am bequemsten über phpMyAdmin, Tabelle <prefix>_directories, Feld iddirectory. Es werden dann nur Dateien aus diesen Ordnern (und mit filesubfolders auch Dateien aus deren Unterordnern) angezeigt. Werden hier Ordner angegeben, die nicht auf der obersten Ebene des Dateibaumes stehen, werden diese trotzdem als solche angezeigt. So können dem Redakteur auch tatsächlich nur Ordner angezeigt werden, welche für ihn relevant sind. Wird der Parameter weggelassen oder mit true angegeben, werden alle Ordner angezeigt. Unabhängig vom Wert dieses Parameters, werden nur Ordner gezeigt, für die der Benutzer auch ausreichende Rechte hat.

[bearbeiten] filefolderids

Dieser Parameter ist von seiner Bedeutung her identisch mit dem filefolders-Parameter, nur dass dieser für die Verwendung mit mip_forms bestimmt ist.

[bearbeiten] filesubfolders

filesubfolders = "true|false"

Gibt an, ob auch die Unterordner der im filefolders-Parameter aufgelisteten Ordner angezeigt werden sollen.

[bearbeiten] filefiletypes

filefiletypes = "true|[filetypes]"

Hier kann eine Liste an Dateierweiterungen angegeben werden, welche im Dateilink-Dialog angezeigt werden sollen (z.B. "gif, jpeg, jpg, png, bmp" für Bilder). Falls der Parameters fehlt oder mit true angegeben wurde, werden alle vorhandene Dateien angezeigt, sofern der Benutzer die entsprechenden Rechte hat.

[bearbeiten] filefiletypeids

filefiletypeids = "[filetypeids]"

Zusätzlich zu den mittels filefiletypes angegebenen Dateierweiterungen, kann hier eine kommaseparierte Liste von IDs angegeben werden, die zu den in der Datenbank abgespeicherten Dateitypen gehören. Dieser Parameter ist vor Allem für die automatische Konfiguration mittels mip_forms gedacht.

[bearbeiten] imgfolders

Wie filefolders, nur für den Bild-Dialog. Ob Unterordner mit einbezogen werden sollen, wird durch den imgsubfolders-Parameter bestimmt.

[bearbeiten] imgfolderids

Dieser Parameter ist von seiner Bedeutung her identisch mit dem imgfolders-Parameter, nur dass dieser für die automatische Konfiguration via mip_forms gedacht ist.

[bearbeiten] imgsubfolders

Wie filesubfolders, nur auf den imgfolders-Parameter und den Bild-Dialog bezogen.

[bearbeiten] imgfiletypes

Wie filefiletypes, nur auf den Bild-Dialog bezogen.

[bearbeiten] imgfiletypeids

Wie imgfiletypeids, nur auf den Bild-Dialog bezogen.

[bearbeiten] Die bbCode-Tags

Der fett dargestellte Parameter ist der Standardparameter, welcher auch ohne Parametername direkt mit einem Gleichzeichen an den Tag angehängt werden kann (s. Notation der bbCode-Tags). Die Tags [email], [anchor], [link] und [filelink] unterstützen noch eine besondere Notation, bei der der Standardparameter zwischen die beiden Tags gesetzt wird. Näheres dazu in den Beschreibungen der Tags. Nahezu alle Konfigurationsmöglichkeiten, die hier aufgelistet sind, können auch über die Formularfelder der bbCode-Eingabe eingestellt werden.

[bearbeiten] b

Formatiert den enthaltenen Text fett.

[bearbeiten] i

Formatiert den enthaltenen Text kursiv (schräg).

[bearbeiten] u

Formatiert den enthaltenen Text unterstrichen. Sparsam verwenden da die Darstellung u. U. mit der Standarddarstellung von Links kollidieren könnte.

[bearbeiten] s

Formatiert den enthaltenen Text durchgestrichen. Ideal um gelöschte oder überarbeitete Textteile als solche deutlich zu machen, ohne sie ganz löschen zu müssen.

[bearbeiten] sub

Stellt den enthaltenen Text tiefgestellt (sub = unter) dar.

[bearbeiten] sup

Stellt den enthaltenen Text Hochgestellt (sup = super = über) dar.

[bearbeiten] size

Parameter:

  • percent - Gibt die Größe des Textes relativ zur ursprünglichen Textgröße in Prozent an.

Stellt Text in einer bestimmten Schriftgröße dar.

[bearbeiten] font

Parameter:

  • family - Gibt den Namen der Schriftart an, welche dem aktuellen Text zugewiesen werden soll.

Stellt den enthaltenen Text in einer anderen Schriftart dar. Die möglichen Schriftarten sind durch den fonts-Parameter festgelegt.

[bearbeiten] class

Parameter:

  • class - Gibt eine Klasse für den enthaltenen Text an.

Stellt den enthaltenen Text mit einer anderen Klasse dar. Mit Klassen können verschiedene besondere Stile für Texte umgesetzt werden. Welche Klassen verfügbar sind, wird über den classes-Parameter gesteuert.

[bearbeiten] forecol

Parameter:

  • color - Gibt eine Farbreferenz im Hex-Format (#RRGGBB) an. Mehr Informationen über dieses Format können Sie hier nachlesen: Hexadezimale Angabe von Farben.

Stellt den enthaltenen Text mit einer anderen Vordergrundfarbe dar.

[bearbeiten] backcol

Parameter:

Stellt den enthaltenen Text mit einer anderen Hintergrundfarbe dar.

[bearbeiten] img

Parameter:

  • title - Gibt einen Titel oder eine Beschreibung für das Bild an.
  • width - Gibt eine Breite für das Bild an.
  • height - Gibt eine Höhe für das Bild an.
  • style - über diesen Parameter kann man dem Bild einen speziellen Stil zuweisen. Näheres dazu kann im Abschnitt über das Style-Attribut nachgelesen werden.

Als Bildquelle wird der Inhalt des Tags verwendet. Es kann sowohl eine Datei-ID als auch eine relative oder absolute URL angegeben werden. Wenn eine URL angegeben wird, kann auch der {mediapath}-Platzhalter benutzt werden. Näheres zu den Größenangaben können Sie unter Breite und Höhe von Grafiken nachlesen. Mit dem imgexternal-Parameter können Sie das Verlinken auf externe Bilder und URLs verbieten.

Beispiele: 

[img]10[/img]

Zeigt das Bild der mit Datei-ID 10 an. 

[img="ein Elch"]10[/img]
[img title="ein Elch"]10[/img]

Vergibt zusätzlich noch einen Titel. 

[img height="300" title="ein Elch"]10[/img]

Definiert eine andere Größe sowie einen Titel. 

[img]http://www.google.com/intl/en/images/logo.gif[/img]

Zeigt das Google-Logo. 

[img title="Google"]http://www.google.com/intl/en/images/logo.gif[/img]
[img="Google"]http://www.google.com/intl/en/images/logo.gif[/img]

Zeigt das Logo mit Titel 

[img]{mediapath}/logo.gif[/img]

Verlinkt auf das Bild logo.gif im media-Verzeichnis.

[bearbeiten] abbr

Parameter:

  • title - gibt einen Titel oder eine Beschreibung zu der Abkürzung an. Dieser Titel wird in dem meisten Browsern als ToolTipText über der Abkürzung angezeigt.
  • lang - gibt die Sprache, aus der die Abkürzung stammt, an. Erwartet wird ein Sprachenkürzel nach RFC 1766.
  • style - über diesen Parameter kann man der Abkürzung einen speziellen Stil geben. Näheres dazu kann im Abschnitt über das Style-Attribut nachgelesen werden.

Markiert Text als Abkürzung.

[bearbeiten] acronym

Parameter:

  • title - Wie bei [abbr], nur für Akronyme.
  • lang - Wie bei [abbr], nur für Akronyme.
  • style - über diesen Parameter kann man dem Akronym einen speziellen Stil geben. Näheres dazu kann im Abschnitt über das Style-Attribut nachgelesen werden.

Markiert Text als Akronym.

Genaueres über den Sinn und auch den Unterschied zwischen Abkürzungen und Akronymen, können den entsprechenden Wikipedia-Artikeln entnommen werden: Akronym und Abkürzung.

[bearbeiten] link

Parameter:

  • dest - Gibt das Ziel der Verknüpfung an.
  • anchor - Gibt einen Anker an, der angesprungen werden soll.
  • target - Gibt ein Zielfenster für die Verknüpfung an.
  • style - über diesen Parameter kann man der Verknüpfung einen speziellen Stil geben. Näheres dazu kann im Abschnitt über das Style-Attribut nachgelesen werden.

Erzeugt eine Verknüpfung auf eine interne oder externe Seite. Das Verknüpfungsziel wird über den dest-Parameter angegeben. Es kann sich dabei um eine Seiten-ID, eine relative oder eine absolute URL handeln. Das Ziel des Links kann auch als Inhalt des Tags notiert werden, sofern kein anchor-Attribut angegeben wurde. (Begründung siehe Beispiele) Zusätzlich kann ein Anker andgegeben werden, der auf der Zielseite angesprungen wird. Es kann sogar nur ein Anker (ohne dest) angegeben werden. Im bbCode erzeugen Sie Anker über den [anchor-Tag. Es kann auch ein Zielfenster definiert werden. Nähreres zu Zielfensterangaben kann unter Zielfenster für Verweise bestimmen nachgelesen werden.

Ist kein Linktext angegeben, wird dieser aus dem Seiten- bzw. Ankernamen (bei Nur-Anker-Verknüpfungen) und dem linktpl bzw. dem extlinktpl dargestellt. Dabei wird das Linktpl für Links auf Seiten-IDs benutzt, das ExtLinkTpl für URL-Links.

Beispiele: 

[link]10[/link]
[link="10"][/link]
[link dest="10"][/link]

Erzeugt einen Link auf die Seite mit der ID 10 und benutzt deren Seitennamen als Linktext. 

[link="10"]Seite 10[/link]
[link dest="10"]Seite 10[/link]

Erzeugt den selben Link und gibt einen Linktext an. 

[link dest="10" anchor="anker"][/link]

Verlinkt auf die Seite mit der ID 10 und springt dort zu einem Anker. Als Linktext wird der Seitenname herangezogen. 

[link anchor="anker"]10[/link]

Achtung: Dieser Tag würde so nicht funktionieren, da hier nicht eindeutig ist, ob 10 jetzt Linktext oder Ziel ist.

[bearbeiten] hr

Parameter:

  • style - über diesen Parameter kann man der horizontalen Linie einen speziellen Stil geben. Näheres dazu kann im Abschnitt über das Style-Attribut nachgelesen werden.

Fügt eine horizontale Linie ein.

[bearbeiten] br

Bei aktivierter Absatzbehandlung erzeugt dieser Tag innerhalb eines Absatzes einen Zeilenumbruch, ohne einen kompletten neuen Absatz zu beginnen.

[bearbeiten] email

Parameter:

  • adress - Gibt eine E-Mail-Adresse an.
  • name - Gibt einen Namen zu der im adress-Parameter angegebenen E-Mail-Adresse an.
  • subject - Gibt einen Betreff an, welcher als Voreinstellung an das Mailprogramm übergeben wird.
  • style - über diesen Parameter kann man dem E-Mail-Link einen speziellen Stil geben. Näheres dazu kann im Abschnitt über das Style-Attribut nachgelesen werden.

Erzeugt eine Verknüpfung auf eine E-Mail-Adresse. Die Mailadresse wird mit dem adress-Parameter festgelegt, oder zwischen den beiden Tags angegeben. Zusätzlich kann ein Name und/oder ein Betreff angegeben werden. Diese Angaben werden beim Anklicken des Links an das Mailprogramm weitergegeben.

Ist kein Linktext angegeben, wird die E-Mail-Adresse als Linktext angenommen. Beachten Sie, dass auch der maillinktpl-Parameter die Ausgabe des Links beeinflusst.

Beispiele 

[email="info@der-dirigent.de"][/email]
[email adress="info@der-dirigent.de"][/email]
[email]info@der-dirigent.de[/email]

Erzeugt einen einfachen E-Mail-Link und benutzt die E-Mail-Adresse als Linktext. 

[email="info@der-dirigent.de"]Das Der-Dirigent Team[/email]
[email adress="info@der-dirigent.de"]Das Der-Dirigent Team[/email]

Erzeugt einen E-Mail-Link mit Linktext. 

[email name="Das Der-Dirigent" subject="Der-Dirigent v1.0.3"]info@der-dirigent.de[/email]
[email name="Das Der-Dirigent Team" subject="Der-Dirigent v1.0.3" adress="info@der-dirigent.de"][/email]

Erzeugt einen E-Mail-Link und übergibt einen Namen sowie einen Betreff. Als Linktext wird die E-Mail-Adresse benutzt. 

[email name="Das Der-Dirigent Team" subject="Der-Dirigent v1.0.3" adress="info@der-dirigent.de"]Das Der-Dirigent Team[/email]

Erzeugt den selben Link und gibt zusätzlich noch einen Linktext an.

[bearbeiten] anchor

Parameters:

  • id - Gibt die Anker-ID an.

Erzeugt einen Anker, der dann über den [link]-Tag angesprungen werden kann. Mehr Informationen über Anker können Sie unter Anker definieren und Verweise zu Ankern nachschlagen.

Wenn Sie Probleme mit CSS-Hover-Effekten auf Ankern haben, sollten Sie sich folgenden, hilfreichem (englischen) Artikel lesen: A:hover and named anchors.

[bearbeiten] filelink

  • id -
  • style - über diesen Parameter kann man dem Dateilink einen speziellen Stil geben. Näheres dazu kann im Abschnitt über das Style-Attribut nachgelesen werden.

Erzeugt einen Downloadverweis zu einer Datei im DeDi-Dateimanager. Für id muss eine gültige Datei-ID angegeben werden. Wird dieser Tag ohne id-Parameter notiert, versucht die bbCode-Erweiterung den enthaltenen Text als Datei-ID zu interpretieren.

Wird kein Linktext angegeben, verwendet die Erweiterung den Dateinamen. Beachten Sie dass der generierte Link auch vom filelinktpl-Parameter abhängig ist.

[bearbeiten] list

Parameter:

  • format - Kann entweder "numbered" oder einfach leer sein.
  • style - über diesen Parameter kann man der Liste einen speziellen Stil geben. Näheres dazu kann im Abschnitt über das Style-Attribut nachgelesen werden.

Erzeugt eine normale oder eine numerierte Liste (wird mit Hilfe des format-Parameters festgelegt). Innerhalb des list-Tags können mit Hilfe von [*] (=Listitem) einzelne Listenelemente festgelegt werden.

Beispiele: 

[list]
 [*]Element A
 [*]Element B
 [*]Element C
[/list]

Eine normale Liste. 

[list=numbered]
 [*]Element 1
 [*]Element 2
 [*]Element 3
[/list]

Eine numerierte Liste.

[bearbeiten] * (=Listitem)

Parameter:

  • style - über diesen Parameter kann man dem Listitem einen speziellen Stil geben. Näheres dazu kann im Abschnitt über das Style-Attribut nachgelesen werden.

Erzeugt einen Eintrag innerhalb einer Liste. Der Eintrag kann über mehrere Zeilen gehen und wird erst von einem darauf folgenden weiteren Listeneintrag oder dem Ende der Liste beendet.

[bearbeiten] footnote

Erzeugt eine Fußnote im Fußnotenmodul. Die angelegte Fußnote wird mit der Stelle kreuzverknüpft, an der der [footnote]-Tag im Text notiert wurde. Die Fußnoten werden von Beginn des Textes an durchgehendend nummeriert. Die erzeugten Verknüpfungen werden vom footnotelinktpl-Parameter mit bestimmt. Mehr Informationen zur Verwendung der Fußnoten, können Sie im Abschnitt über die Fußnoten nachlesen.

[bearbeiten] code

Parameter:

  • format - Kann entweder "php" oder einfach leer sein. Gibt an, ob der enthaltene Code als PHP-Code formatiert werden soll.

Der enthaltene Text wird als Code dargestellt, d. h. dickengleich und vorformatiert. Außerdem werden andere bbCode-Angaben innerhalb des Codebereiches nicht interpretiert. Ist das format-Attribut auf php gesetzt, wird der enthaltene PHP-Code farblich formatiert. Für Beispiele lesen Sie sich bitte die Dokumentation zur PHP-Funktion "highlight_string" durch.

[bearbeiten] source

Innerhalb dieses Tags ist es möglich, HTML-Code direkt einzubinden. Im enthaltenen Code werden nur alle Vorkommen von <? und ?> maskiert, da diese XML-Anweisungen Probleme mit DeDi provozieren können.

[bearbeiten] table

Parameter:

  • caption - Gibt einen Titel / eine Beschreibung für die Tabelle an.
  • style - über diesen Parameter kann man der Tabelle einen speziellen Stil geben. Näheres dazu kann im Abschnitt über das Style-Attribut nachgelesen werden.

Erzeugt das Grundgerüst für eine Tabelle. Diese Tabelle kann dann mit Zeilen, Tabellenköpfen und Zellen befüllt werden. Beinhaltet der [table]-Tag nicht mindestens eine gültige Zeile, wird er ignoriert.

Mehr über das Caption-Attribut kann der Tabelle eine Überschrift gegeben werden. Näheres zu dieser Beschriftungsmöglichkeit können Sie unter Tabellenüberschrift / Tabellenunterschrift definieren nachlesen.

[bearbeiten] row/tr

Parameter:

  • style - über diesen Parameter kann man der Tabellenzeile einen speziellen Stil geben. Näheres dazu kann im Abschnitt über das Style-Attribut nachgelesen werden.

Erzeugt eine Tabellenzeile. Diese Zeile kann dann mit Tabellenköpfen oder Zellen befüllt werden. Beinhaltet die Zeile nicht mindestens eine gültige Zelle oder einen Tabellenkopf, wird sie ignoriert.

[bearbeiten] head/th

Parameter:

  • span - Synonym zu colspan.
  • colspan - Gibt an, wie viele Zellen dieser Tabellenkopf in der horizontalen überspannen soll.
  • rowspan - Gibt an, wie viele Zellen dieser Tabellenkopf in der vertikalen überspannen soll.
  • style - über diesen Parameter kann man dem Tabellenkopf einen speziellen Stil geben. Näheres dazu kann im Abschnitt über das Style-Attribut nachgelesen werden.

[bearbeiten] cell/td

Parameter:

  • span - Synonym zu colspan.
  • colspan - Gibt an, wieviele Zellen diese Zelle in der horizontalen überspannen soll.
  • rowspan - Gibt an, wieviele Zellen diese Zelle in der vertikalen überspannen soll.
  • style - über diesen Parameter kann man der Zelle einen speziellen Stil geben. Näheres dazu kann im Abschnitt über das Style-Attribut nachgelesen werden.

Näheres über das Zusammenspiel von Tabellenzeilen, -zellen und -köpfen, kann unter Tabellen definieren nachgelesen werden.

[bearbeiten] Danksagung

Besonders Danke möchte ich

  • Olaf, der mich mit hunderten Tipps und Vorschlägen versorgt hat und dem wir sehr viele Features verdanken. Außerdem stammt das CSS gesteuerte Layout der PopUps aus seiner Feder. Er hat sich auch als eifriger Alphatester hervorgetan, der mir geholfen hat viel Bugs schon vor der Veröffentlichung zu finden.
  • Mika, der in meinem Auftrag diese Dokumentation Korrektur gelesen hat und mir so eine der unschöneren Arbeiten abgenommen hat.
  • allen, die mich mit Ideen, Vorschlägen, Feature-Wünschen und Bugreports versorgt haben und so maßgeblich zum Funktionsumfang der Erweiterung beigetragen haben.

[bearbeiten] Quellen

Von „https://help.der-dirigent.de/index.php?title=BbCode_Erweiterung_2_v1.0“