BbCode Erweiterung 2 v1.0

Aus DeDi-Help

(Unterschied zwischen Versionen)
Wechseln zu: Navigation, Suche
Version vom 15:43, 28. Nov. 2005 (bearbeiten)
Mika (Diskussion | Beiträge)
K (→Anpassung vorhandener Module)
← Zum vorherigen Versionsunterschied		 Aktuelle Version (10:15, 6. Okt. 2009) (bearbeiten) (Entfernen)
Eppi (Diskussion | Beiträge)

 
(Der Versionsvergleich bezieht 51 dazwischen liegende Versionen mit ein.)
Zeile 1: Zeile 1:
=Einleitung= =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 knnen. Zusammen mit dem [[Dokumentation_ContentFlex|ContentFlex]]- oder [[Dokumentation_DeDi-Flex|DeDiFlex-Modul]] bietet die bbCode-Erweiterung eine Alternative zum hufig verwendeten [[Dokumentation_WYSIWYG|WYSIWYG-Editor]].+[http://de.wikipedia.org/wiki/BBcode 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 [[Dokumentation_ContentFlex|ContentFlex]]- oder [[Dokumentation_DeDi-Flex|DeDiFlex-Modul]] bietet die bbCode-Erweiterung eine Alternative zum häufig verwendeten [[Dokumentation_WYSIWYG|WYSIWYG-Editor]].
-Es gab bereits eine bbCode-Erweiterung fr DeDi, diese hatte jedoch einige entscheidende Nachteile gegenber dem [[Dokumentation_WYSIWYG|WYSIWYG-Editor]]. Vor allem fehlten Formulare zum einfachen Einfgen von Links, Bildern und anderen Elementen. Die neue Version versucht diese Nachteile auszugleichen.+Es gab bereits eine bbCode-Erweiterung für DeDi, jedoch hatte diese einige entscheidende Nachteile gegenüber dem [[Dokumentation_WYSIWYG|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 knnen Sie mich [http://forum.der-dirigent.de/index.php?act=Msg&CODE=4&MID=989 per PM] oder [mailto:koerner-familie@t-online.de per Mail] benachrichtigen oder mir ein Feedback geben. Fr Bugs und allgemeinere Fragen posten Sie bitte im [http://forum.der-dirigent.de/index.php?act=ST&f=30&t=5402 Diskussionsthread]+Wenn Sie mit mir Kontakt aufnehmen wollen können Sie mich [http://forum.der-dirigent.de/index.php?act=Msg&CODE=4&MID=989 per PM] oder [mailto:koerner-familie@t-online.de per Mail] benachrichtigen oder mir ein Feedback geben. Für Bugs und allgemeinere Fragen posten Sie bitte im [http://forum.der-dirigent.de/index.php?act=ST&f=30&t=5402 Diskussionsthread]
=Download & Installation= =Download & Installation=
-Downloaden kann man die aktuelle Version ('''v1.0 Beta 1''') der bbCode-Erweiterung hier: [http://forum.der-dirigent.de/index.php?s=&act=Attach&type=post&id=48541 Download im Forum]. Um die Erweiterung zu installieren, entpacken Sie zunchst das komplette Archiv auf Ihren Computer in ein beliebiges Verzeichnis. Kopieren Sie dann den Ordner ''backend'' per FTP in den Ordner der DeDi-Installation und den Inhalt des ''projekt01''-Ordners in jedes Frontendverzeichnis. Vorhandene Dateien mssen berschrieben werden.+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 [http://www.der-dirigent.de/de/dedi/download/index.html Downloadbereich] herunterladen.
- +
-'''Achtung:''' Bitte stellen Sie sicher, dass Sie '''VORHER''' den aktuellen [http://forum.der-dirigent.de/index.php?act=ST&f=30&t=5395 Sicherheitspatch vom 22. November 2005] eingespielt haben. Die bbCode-Erweiterung 2 funktioniert zwar auch mit einem originalen DeDi v1.0.1, allerdings wird es '''dringend empfohlen''' diesen Patch zu verwenden.+
=Anwendung & Konfiguration= =Anwendung & Konfiguration=
-Die bbCode-Erweiterung greift in das Verhalten des [[Referenz DeDi-Tags#a_.3Cdedi:mod_type.3D.22textarea.22.2F.3E|<dedi:mod type="textarea"/>]] ein und erweitert ihn um die Fhigkeit, bbCode zu erstellen und zu verarbeiten. Um eine Textarea mit bbCode-Funktionalitt auszustatten, muss im dedi:mod-Tag der Parameter ''transform'' auf ''bbcode'' gesetzt sein. Dies ist beispielsweise eine funktionsfhige bbCode-Textarea:+Die bbCode-Erweiterung greift in das Verhalten des [[Referenz DeDi-Tags#a_.3Cdedi:mod_type.3D.22textarea.22.2F.3E|<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 <dedi:mod
type = "textarea" type = "textarea"
Zeile 18: Zeile 16:
transform = "bbcode" transform = "bbcode"
/> />
-Mit dieser Konfiguration verwendet die bbCode-Erweiterung Standardeinstellungen fr alle Parameter. Allerdings lassen sich diese Parameter sehr fein an die gewnschten Verhltnisse anpassen. Alle Konfigurationseinstellungen werden ber Parameter im dedi:mod-Tag festgelegt. Weiter unten in dieser Dokumentation finden Sie eine [[#a_Die_Parameter_des_dedi:mod-Tags|Referenz der Parameter]].+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 [[#a_Die_Parameter_des_dedi:mod-Tags|Referenz der Parameter]].
=Beispiele= =Beispiele=
Typische bbCode-Textarea ohne Absatzbehandlung Typische bbCode-Textarea ohne Absatzbehandlung
<dedi:mod <dedi:mod
- type="textarea" + type = "textarea"
- transform="bbcode" + transform = "bbcode"
id = "1" id = "1"
title = "Typisch" title = "Typisch"
- nl2br = "true" + [[#a_notext|notext]] = "true"
- notext = "true" + [[#a_linktpl.2C_extlinktpl.2C_maillinktpl_.26_filelinktpl|filelinktpl]] = "Download: [b]{text}[/b] [[i]{size}[/i]]"
- filelinktpl = "Download: [b]{text}[/b] [[i]{size}[/i]]" + [[#a_filefolders|filefolders]] = "3, 9"
- filefolders = "3, 9" + [[#a_filesubfolders|filesubfolders]] ="true"
- filesubfolders ="true" + [[#a_filefiletypes|filefiletypes]] = "gif"
- filefiletypes = "gif" + [[#a_sizemin_.26_sizemax|sizemin]] = "75"
- sizemin = "75" + [[#a_sizemin_.26_sizemax|sizemax]] = "225"
- sizemax = "225" + [[#a_fonts|fonts]] = "Arial,Microsoft Sans Serif,Comic Sans MS,Times New Roman"
- fonts = "Arial,Microsoft Sans Serif,Comic Sans MS,Times New Roman" + [[#a_classes|classes]] = "waring=Warnung, adress=Adresse"
- classes = "waring=Warnung, adress=Adresse" +
> >
Zeile 44: Zeile 41:
transform = "bbcode" transform = "bbcode"
id = "2" id = "2"
- features = "bold, italic, underline" 
title = "Absatzbehandlung" title = "Absatzbehandlung"
- handleparagraphs = "true" + [[#a_features|features]] = "bold, italic, underline"
 + [[#a_paragraphs|paragraphs]] = "p"
/> />
Zeile 52: Zeile 49:
==Absatzbehandlung== ==Absatzbehandlung==
Die Absatzbehandlung ist eine Methode, sauberen und [http://de.wikipedia.org/wiki/Semantik semantisch] korrekten Quellcode zu erzeugen. Die Absatzbehandlung ist eine Methode, sauberen und [http://de.wikipedia.org/wiki/Semantik semantisch] korrekten Quellcode zu erzeugen.
-Bei aktivierter Absatzbehandlung werden Textteile, welche als eigenstndiger Absatz erkannt werden, automatisch mit &lt;p&gt;&lt;/p&gt; umschlossen ''(p = Paragraph = Absatz)''.+Bei aktivierter Absatzbehandlung werden Textteile, welche als eigenständiger Absatz erkannt werden, automatisch mit &lt;p&gt;&lt;/p&gt; umschlossen ''(p = Paragraph = Absatz)''.
-Zeilen werden zu einem Absatz zusammengefasst, wenn sie entweder nur einen ([[#a_singleenter|singleenter]]="false" (Standard)) oder gar keinen ([[#a_singleenter|singleenter]]="true") Zeilenumbruch enthalten. Steht eine Leerzeile zwischen zwei Zeilen, werden diese in getrennte Abtze gepackt.+Zeilen werden zu einem Absatz zusammengefasst, wenn sie entweder nur einen ([[#a_singleenter|singleenter]]="false" (Standard)) oder gar keinen ([[#a_singleenter|singleenter]]="true") Zeilenumbruch enthalten. Steht eine Leerzeile zwischen zwei Zeilen, werden die Zeilen immer in getrennte Absätze gepackt.
Dies ist ein Absatz Dies ist ein Absatz
der immer noch weitergeht der immer noch weitergeht
Zeile 59: Zeile 56:
Hier beginnt dann ein neuer Hier beginnt dann ein neuer
-Dies wrde zu folgendem HTML-Code fhren:+Dies würde zu folgendem HTML-Code führen:
&lt;p>Dies ist ein Absatz &lt;p>Dies ist ein Absatz
der immer noch weitergeht&lt;/p&gt; der immer noch weitergeht&lt;/p&gt;
&lt;p&gt;Hier beginnt dann ein neuer&lt;/p&gt; &lt;p&gt;Hier beginnt dann ein neuer&lt;/p&gt;
-Ohne Absatzbehandlung wird jeder Zeilenumbruch in der HTML-Ausgabe als <nowiki><br /></nowiki> 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 [[#a_br|<nowiki>[br]</nowiki>]]-Tag, dieser ist jedoch auch nur bei aktivierter Absatzbehandlung verfgbar.+Um die Absatzbehandlung zu aktivieren, muss der [[#a_paragraphs|paragraphs]]-Parameter auf ''p'' gesetzt werden.
 + 
 +Ohne Absatzbehandlung wird jeder Zeilenumbruch in der HTML-Ausgabe als <nowiki><br /></nowiki> 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 [[#a_br|<nowiki>[br]</nowiki>]]-Tag. Dieser ist jedoch nur bei einer aktivierten Absatzbehandlung verfügbar.
==Style-Attribut== ==Style-Attribut==
-Um einzelnen Elemente spezielle Formatierungen zuweisen zu knnen, kann das style-Attribut verwendet werden. Ihm kann eine in der [[#a_classes|classes]]- oder der [[#a_classids|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, knnen Sie einen Tag wie folgt notieren: +Um einzelnen Elementen spezielle Formatierungen zuweisen zu können, kann das style-Attribut verwendet werden. Ihm kann eine in der [[#a_classes|classes]]- oder der [[#a_classids|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:
<nowiki>[</nowiki>[[#a_link|link]] dest="http://der-dirigent.de" style="dedilink"]Der Dirigent[/link] <nowiki>[</nowiki>[[#a_link|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: Voraussetzung ist, dass vorher eine Klasse ''dedilink'' definiert und im dedi:mod-Tag angegeben wurde. Das style-Attribut kann in folgenden Tags verwendet werden:
Zeile 82: Zeile 81:
*[[#a_cell.2Ftd|<nowiki>[cell]/[td]</nowiki>]] *[[#a_cell.2Ftd|<nowiki>[cell]/[td]</nowiki>]]
*[[#a_head.2Fth|<nowiki>[head]/[th]</nowiki>]] *[[#a_head.2Fth|<nowiki>[head]/[th]</nowiki>]]
-ber das Einfgen eines style-Tags in einen Tag via GUI knnen Sie sich unter [[#a_Stil-Auswahl| Stil-Auswahl]] informieren.+über das Einfügen eines style-Tags in einen Tag via GUI können Sie sich unter [[#a_Stil-Auswahl| Stil-Auswahl]] informieren.
==Strip-Tags== ==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 zufllig kein 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 [[#a_Einleitung|Einleitung]].+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 [[#a_Einleitung|Einleitung]].
==Charmap== ==Charmap==
-Die Zeichentabelle soll dem Benutzer ermglichen, bequem Sonderzeichen einzufgen. Die Zeichen werden als benannte Entitten in den Quelltext eingefgt. Vefgbar sind alle benannten Entitten der [http://www.sagehill.net/livedtd/html40loose/ HTML 4.0]-Spezifikationen. Eine anschauliche bersicht findet man in der [http://de.selfhtml.org/html/referenz/zeichen.htm SelfHTML Zeichenreferenz].+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 [http://www.sagehill.net/livedtd/html40loose/ HTML 4.0]-Spezifikationen. Eine anschauliche Übersicht findet man in der [http://de.selfhtml.org/html/referenz/zeichen.htm SelfHTML Zeichenreferenz].
-==Entittenbehandlung==+==Entitätenbehandlung==
-Die bbCode-Erweiterung hat eine besondere Art der Entittenbehandlung. Zum einen werden die HTML-eigenen Zeichen &, < und > durch ihre entsprechenden Entitten ersetzt, zum anderen werden, alle benannten Entitten der HTML-4.0-Standards sowie bis zu 5-stellige numerische und bis zu 4-stellige hexadezimale Entitten durchgelassen, mit denen Sie jedes UTF-8-Zeichen einfgen knnen. In wie weit die Erweiterung nativ UTF-8 untersttzt, ist '''noch nicht getestet'''. Falls Sie Erfahrungen damit haben oder ein anderes Fehlverhalten feststellen, wrde ich mich ber ein kurzes Feedback im aktuellen Diskussionsthread freuen. Den Link dorthin finden Sie am Ende der [[#a_Einleitung|Einleitung]].+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 [[#a_namedentities|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 [[#a_Einleitung|Einleitung]].
==Linktemplates== ==Linktemplates==
-Es ist mglich, verschiedene Templates fr 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 fr alle Links lautet:+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:
<nowiki>[</nowiki>[[#a_link|link]]='{url}']{text}[/link] <nowiki>[</nowiki>[[#a_link|link]]='{url}']{text}[/link]
-Sie knnen aber auch Ihre eigenen Templates mit weiteren Tags und eigenen Texten bestcken. Folgende Tags sind innerhalb der Linktemplates erlaubt:+Sie können aber auch Ihre eigenen Templates mit weiteren Tags und eigenen Texten bestücken. Folgende Tags sind innerhalb der Linktemplates erlaubt:
*[[#a_b|<nowiki>[b]</nowiki>]] *[[#a_b|<nowiki>[b]</nowiki>]]
*[[#a_i|<nowiki>[i]</nowiki>]] *[[#a_i|<nowiki>[i]</nowiki>]]
Zeile 112: Zeile 115:
*[[#a_acronym|<nowiki>[acronym]</nowiki>]] *[[#a_acronym|<nowiki>[acronym]</nowiki>]]
*[[#a_link|<nowiki>[link]</nowiki>]] *[[#a_link|<nowiki>[link]</nowiki>]]
-Die Templates werden ber [[#a_Die_Parameter_des_dedi:mod-Tags|Parameter im dedi:mod-Tag]] definiert. Es gibt getrennte Templates fr [[#a_linktpl|normale Links (linktpl)]], [[#a_extlinktpl|externe Links (extlinktpl)]] und [[#a_filelinktpl|Dateilinks (filelinktpl)]].+Die Templates werden über [[#a_Die_Parameter_des_dedi:mod-Tags|Parameter im dedi:mod-Tag]] definiert. Es gibt getrennte Templates für [[#a_linktpl.2C_extlinktpl.2C_maillinktpl_.26_filelinktpl|normale Links (linktpl), externe Links (extlinktpl), E-Mail-Links (maillinktpl) und Dateilinks (filelinktpl)]].
-Innerhalb der Templates knnen bestmmte Variablen gesetzt werden. In den Templates fr normale, externe und Maillinks wird ''{url}'' mit dem Zielpfad ersetzt und sollte dem ''dest''-Attribut eines [[#a_link|<nowiki>[link]</nowiki>]]-Tags bergeben werden. Auerdem wird ''{text}'' mit dem Linktext ersetzt.+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 [[#a_link|<nowiki>[link]</nowiki>]]-Tags übergeben werden. Außerdem wird ''{text}'' mit dem Linktext ersetzt.
-Zustzlich zu den oben genannten Variablen, knnen im Dateilink noch folgene Variablen verwendet werden:+Zusätzlich zu den oben genannten Variablen, können im Dateilink noch folgende Variablen verwendet werden:
-*''{size}'': Die Dateigre mit Einheit (Bytes, KB, MB, GB, TB)+*''{size}'': Die Dateigröße mit Einheit (Bytes, KB, MB, GB, TB)
*''{title}'': Der im Dateimanager eingegebene Titel *''{title}'': Der im Dateimanager eingegebene Titel
*''{desc}'': Die im Dateimanager angegebene Beschreibung *''{desc}'': Die im Dateimanager angegebene Beschreibung
Zeile 124: Zeile 127:
*''{file}'': Der eigentliche Dateiname *''{file}'': Der eigentliche Dateiname
-Anwendungsbeispiele wren z. B. ein Icon vor E-Mail-, Download- oder externen Links:+Anwendungsbeispiele würen z. B. ein Icon vor E-Mail-, Download- oder externen Links:
<nowiki>[</nowiki>[[#a_img|img]]]223[/img]<nowiki>[</nowiki>[[#a_link|link]]='{url}']{text}[/link] <nowiki>[</nowiki>[[#a_img|img]]]223[/img]<nowiki>[</nowiki>[[#a_link|link]]='{url}']{text}[/link]
-eine Grenangabe bei Downloadlinks:+eine Größenangabe bei Downloadlinks:
<nowiki>[</nowiki>[[#a_link|link]]='{url}']{text}[/link] [i]({size})[/i] <nowiki>[</nowiki>[[#a_link|link]]='{url}']{text}[/link] [i]({size})[/i]
-oder ein typenabhngiges Icon bei Downloadlinks:+oder ein typenabhängiges Icon bei Downloadlinks:
<nowiki>[</nowiki>[[#a_img|img]]]{mediapath}typeicons/{type}.png[/img]<nowiki>[</nowiki>[[#a_link|link]]='{url}']{text}[/link] <nowiki>[</nowiki>[[#a_img|img]]]{mediapath}typeicons/{type}.png[/img]<nowiki>[</nowiki>[[#a_link|link]]='{url}']{text}[/link]
-Eine Ausnahme bildet das Template fr [[#a_footnotelinktpl|Funotenlinks (footnotelinktpl)]]. Da die Fhigkeiten des [[#a_link|<nowiki>[link]</nowiki>]]-Tags nicht fr die Funotenlinks ausreichen (hier muss zustzlich eine ID als Ansprungziel fr den Rcklink in den Funoten definiert werden), kann hier nur der Linktext festgelegt werden. Einziger Parameter ist hier ''{id}'', welcher durch die fortlaufend nummerierte ID der Funote ersetzt wird. Das Standardtemplate ist:+Eine Ausnahme bildet das Template für [[#a_footnotelinktpl|Fußnotenlinks (footnotelinktpl)]]. Da die Fähigkeiten des [[#a_link|<nowiki>[link]</nowiki>]]-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}] [{id}]
==kein Linktext== ==kein Linktext==
-Einige der Tags erlauben es, ihren Standardparameter ber den Inhalt zu beziehen. So kann man z. B. statt+Einige der Tags erlauben es, ihren Standardparameter über den Inhalt zu beziehen. So kann man z. B. statt
<nowiki>[</nowiki>[[#a_email|email]]="info@der-dirigent.de"][/email] <nowiki>[</nowiki>[[#a_email|email]]="info@der-dirigent.de"][/email]
auch einfach auch einfach
Zeile 145: Zeile 148:
*[[#a_filelink|<nowiki>[filelink]</nowiki>]] *[[#a_filelink|<nowiki>[filelink]</nowiki>]]
*[[#a_link|<nowiki>[link]</nowiki>]] *[[#a_link|<nowiki>[link]</nowiki>]]
-Wobei es beim [[#a_link|<nowiki>[link]</nowiki>]]-Tag noch eine Besonderheit gibt, auf die im entsprechenden Abschnitt nher eingegangen wird.+Wobei es beim [[#a_link|<nowiki>[link]</nowiki>]]-Tag noch eine Besonderheit gibt, auf die im entsprechenden Abschnitt näher eingegangen wird.
-==Funoten==+==Fußnoten==
-Die bbCode-Erweiterung untersttzt die automatische Funotengenerierung. Dazu muss das Funotenmodul aus der Erweiterung im Dirigenten importiert werden und unterhalb der bbCode-Textarea(s) im Template eingebaut werden.+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 Funote zu erstellen, wird an entsprechener Stelle ein [[#a_footnote|<nowiki>[footnote]</nowiki>]]-Tag notiert und in seinem Inhalt der Text der Funote eingetragen. Dieser Text kann mit allen [[#a_Die_bbCode-Tags|bbCodes]] formatiert werden. Die Funoten werden dann alle der Reihe nach durchnummeriert und mit den Eintrgen aus dem Modul verlinkt. Es wird auch automatisch ein Rcklink aus dem Modul in den Text generiert.+Um eine Fußnote zu erstellen, wird an entsprechender Stelle ein [[#a_footnote|<nowiki>[footnote]</nowiki>]]-Tag notiert und in seinem Inhalt der Text der Fußnote eingetragen. Dieser Text kann mit allen [[#a_Die_bbCode-Tags|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.
=Notation der bbCode-Tags= =Notation der bbCode-Tags=
-Die bbCode-Erweiterung 2 kennt mehrere Mglichkeiten bbCodes zu definieren. Folgende Mglichkeiten stehen zur Auswahl:+Die bbCode-Erweiterung 2 kennt mehrere Möglichkeiten bbCodes zu definieren. Folgende Möglichkeiten stehen zur Auswahl:
[tag]text[/tag] [tag]text[/tag]
Ein einfacher Tag ohne weitere Parameter. Ein einfacher Tag ohne weitere Parameter.
Zeile 159: Zeile 162:
Ein Tag mit nur einem Parameter (dem Standardparameter). Dieser Parameter darf keine Leerzeichen beinhalten. Ein Tag mit nur einem Parameter (dem Standardparameter). Dieser Parameter darf keine Leerzeichen beinhalten.
[tag=value]text[/tag] [tag=value]text[/tag]
-Identisch zu oben stehender Notation. Ohne Anfhrungszeichen darf der Wert dieses Parameters kein Leerzeichen enthalten.+Identisch zu oben stehender Notation. Ohne Anführungszeichen darf der Wert dieses Parameters kein Leerzeichen enthalten.
[tag="more value"]text[/tag] [tag="more value"]text[/tag]
-Wie oben, nur diesmal mit Anfhrungszeichen. Hier sind auch Leerzeichen kein Problem. Anfhrungszeichen mssen mit \" escaped werden.+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] [tag='value value']text[/tag]
-Wie oben, nur diesmal mit einfachen Anfhrungszeichen. Diesmal knnen normale Anfhrungszeichen problemlos verwendet werden. Einfache Anfhrungszeichen mssen mit \' escaped werden.+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] [tag par1=value1 par2=value2]text[/tag]
-Ein Tag mit benannten Parametern. Auf diese Art knnen auch mehrere Parameter bergeben werden. Selbstverstndlich knnen auch hier beide Arten von Anfhrungszeichen gesetzt werden, um Leerzeichen in Parameterwerten zu ermglichen.+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.
=Anpassung vorhandener Module= =Anpassung vorhandener Module=
-Es ist zwar mglich, 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 [[Dokumentation_ContentFlex|ContentFlex]] oder dem [[Dokumentation_DeDi-Flex|DeDiFlex]] zu kombinieren. Derzeit lt sich die bbCode-Erweiterung im ContentFlex durch einen einfachen Schalter in der Modulkonfiguration aktivieren, zum Konfigurieren ist jedoch noch Sourcecodeeingriff ntig. Im DeDiFlex ist bbCode standardmig nicht aktiviert und kann auch nicht ohne Sourcecodeeingriff aktiviert werden. '''Ich empfehle daher dazu, das ContentFlex-Modul dem DeDi-Flex vorzuziehen.'''+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 [[Dokumentation_ContentFlex|ContentFlex]] oder dem [[Dokumentation_DeDi-Flex|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 fgen Sie die gewnschten [[#a_Parameter_des_dedi:mod-Tags|Parameter]] ein.+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 [[#a_Die_Parameter_des_dedi:mod-Tags|Parameter]] ein.
-Es ist geplant das Modul [[#Dokumentation_Textarea|Textarea]] sowie das Modul [[#Dokumentation_ContentFlex|ContentFlex]] so anzupassen, dass auch die komplette Konfiguration ber die Modulkonfiguration mglich ist. Da ich jedoch mit der Weiterentwicklung der Erweiterung selbst, einger anderen Projekten und der Schule mehr als ausgelastet bin, '''wre ich froh wenn sich jemand um diese Module kmmern wrde'''.+Es ist geplant das Modul [[Dokumentation_Textarea|Textarea]] sowie das Modul [[Dokumentation_ContentFlex|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 untersttzt auch mehrere bbCode-Textareas in einer Typegroup.+Die bbCode-Erweiterung unterstützt auch mehrere bbCode-Textareas in einer Typegroup.
=Die GUI-Elemente= =Die GUI-Elemente=
-Zustzlich zu der Mglichkeit, bbCodes im Text zu verarbeiten, bietet die bbCode-Erweiterung auch eine GUI, um diese Tags whrend des Bearbeitens in den Text einzufgen. Hier wird diese GUI, ihre Elemente und Funktionsweisen beschrieben. Zu beachten ist, dass diese Elemente nur angezeigt werden, wenn die entsprechenden [[#a_features|Features]] aktiviert wurden. Ebenso knnen einige Eingabefelder in den Dialogen ausgeblendet sein.+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 [[#a_features|Features]] aktiviert wurden. Ebenso können einige Eingabefelder in den Dialogen ausgeblendet sein.
-Die Dialoge, die von der GUI geffnet werden, merken sich ihre Gre bis zum Ende der Sitzung. Dazu muss der Browser Session-Cookies erlauben.+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.
-==Schriftgren-Auswahl==+==Schriftgrößen-Auswahl==
-Die Auswahlbox fr die Schriftgre wird angezeigt, wenn das ''size''-[[#a_features|Feature]] aktiviert ist. Die Anzahl der Elemente in der Auswahlbox und deren Werte werden von den beiden Parametern [[#a_sizemin|sizemin]] und [[#a_sizemax|sizemax]] bestimmt. Dabei wird in 5er-Schritten von der minmalen zur maximalen Schriftgre gezhlt und jeweils ein Eintrag angelegt. Das Auswhlen einer Schriftgre legt einen [[#a_size|<nowiki>[size]</nowiki>]]-Tag mit der ausgewhlten Schriftgre an.+Die Auswahlbox für die Schriftgröße wird angezeigt, wenn das ''size''-[[#a_features|Feature]] aktiviert ist. Die Anzahl der Elemente in der Auswahlbox und deren Werte werden von den beiden Parametern [[#a_sizemin_.26_sizemax|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 [[#a_size|<nowiki>[size]</nowiki>]]-Tag mit der ausgewählten Schriftgröße an.
==Schriftartenauswahl== ==Schriftartenauswahl==
-Die Schriftartenauswahl bentigt das ''font''-[[#a_features|Feature]] und mindestens eine angegebene Schriftart. Welche Schriftarten angezeigt werden, wird vom [[#a_fonts|fonts]]-Parameter bestimmt. Die Auswahlbox versucht dabei eine Vorschau der gewhlten Schriftart zu zeigen, allerdings funktioniert das nicht in allen Browsern. Wird eine Schriftart ausgewhlt, wird ein [[#a_font|<nowiki>[font]</nowiki>]]-Tag mit der gewhlten Schriftart eingefgt.+Die Schriftartenauswahl benötigt das ''font''-[[#a_features|Feature]] und mindestens eine angegebene Schriftart. Welche Schriftarten angezeigt werden, wird vom [[#a_fonts|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 [[#a_font|<nowiki>[font]</nowiki>]]-Tag mit der gewählten Schriftart eingefügt.
==Stil-Auswahl== ==Stil-Auswahl==
-Das Auswahlfeld fr Stile wird angezeigt, wenn entweder das ''class'' und/oder das ''stylebox''-[[#a_features|Feature]] sowie mindestens eine CSS-Klasse per [[#a_class|class]]- oder [[#a_classids|classids]]-Parameter angegeben wurde. Es bernimmt dabei je nach angegebenen Features verschiedene Aufgaben.+Das Auswahlfeld für Stile wird angezeigt, wenn entweder das ''class'' und/oder das ''stylebox''-[[#a_features|Feature]] sowie mindestens eine CSS-Klasse per [[#a_class|class]]- oder [[#a_classids|classids]]-Parameter angegeben wurde. Es übernimmt dabei je nach angegebenen Features verschiedene Aufgaben.
-#Wurde nur das ''class''-Feature aktiviert, so fgt die bbCode-Erweiterung beim Auswhlen eines Stils einen [[#a_class|[class]-Tag mit der ausgewhlten Klasse ein.+#Wurde nur das ''class''-Feature aktiviert, so fügt die bbCode-Erweiterung beim Auswählen eines Stils einen [[#a_class|<nowiki>[</nowiki>class<nowiki>]</nowiki>]]-Tag mit der ausgewählten Klasse ein.
-#Ist nur das ''stylebox''-Feature ausgewhlt, wird ein [[#a_Style-Attribut|Style-Attribut]] mit der ausgewhlten Klasse in den nchsten Tag eingebaut. Dazu wird erst der gewnschte Stil im Auswahlfeld ausgewhlt, anschlieend der Button fr den einzufgenden Tag gedrckt und ein eventuell erscheinender Dialog ausgefllt. Erzeugt werden Tags wie z. B. ''<nowiki>[</nowiki>[[#a_hr|hr]] style="meinstil"]''.+#Ist nur das ''stylebox''-Feature ausgewählt, wird ein [[#a_Style-Attribut|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. ''<nowiki>[</nowiki>[[#a_hr|hr]] style="meinstil"]''.
-#Ist sowohl das ''class'' als auch das ''stylebox''-Feature aktiviert, wird hinter der Stilauswahl eine Checkbox eingeblendet. Ist diese deaktiviert (Ausgangszustand), verhlt es sich wie 1.. Wird die Checkbox jedoch aktiviert, bevor ein Stil gewhlt wird, verhlt sich die Erweiterung wie 2..+#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..
==Farbwahl-Dialog== ==Farbwahl-Dialog==
-Der Farbwahl-Dialog bietet dem Benutzer die Mglichkeit, einen Farbcode auszuwhlen. Je nach Button wird entweder ein [[#a_forecol|<nowiki>[forecol]</nowiki>]]-Tag oder ein [[#a_backcol|<nowiki>[backcol]</nowiki>]]-Tag eingefgt. Im Farbwahl-Dialog kann neben den aufgefhrten Farben auch ein eigener [http://de.selfhtml.org/html/allgemein/farben.htm#hexadezimal Hexadezimaler Farbcode] eingegeben werden. [http://de.selfhtml.org/html/allgemein/farben.htm#farbnamen Farbnamen] sind nicht erlaubt.+Der Farbwahl-Dialog bietet dem Benutzer die Möglichkeit, einen Farbcode auszuwählen. Je nach Button wird entweder ein [[#a_forecol|<nowiki>[forecol]</nowiki>]]-Tag oder ein [[#a_backcol|<nowiki>[backcol]</nowiki>]]-Tag eingefügt. Im Farbwahl-Dialog kann neben den aufgeführten Farben auch ein eigener [http://de.selfhtml.org/html/allgemein/farben.htm#hexadezimal Hexadezimaler Farbcode] eingegeben werden. [http://de.selfhtml.org/html/allgemein/farben.htm#farbnamen Farbnamen] sind nicht erlaubt.
==Bild-Dialog== ==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.+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: 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. Zustzlich kann der ''{mediapath}''-Platzhalter verwendet werden, um manuell (ohne Datei-ID) auf Dateien im media-Verzeichnis des Projektes zuzugreifen. Wird im Dateibaum eine Datei ausgewhlt, wird die Quelle automatisch auf dessen Datei-ID gesetzt.+*'''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. Whlt man im Dateibaum eine Datei ein 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.+*'''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.
-*'''Hhe''' & '''Breite''': Diese beiden Attribute geben Grenangaben fr die Grafik an. Genaueres knnen Sie unter [http://de.selfhtml.org/html/grafiken/einbinden.htm#breite_hoehe Breite und Hhe von Grafiken] nachlesen.+*'''Höhe''' & '''Breite''': Diese beiden Attribute geben Größenangaben für die Grafik an. Genaueres können Sie unter [http://de.selfhtml.org/html/grafiken/einbinden.htm#breite_hoehe 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. Zustzlich werden die angezeigten Ordner durch die Werte der [[#a_imgfolders|imgfolders]]-, [[#a_imgfolderids|imgfolderids]]-, [[#a_imgsubfolders|imgsubfolders]]-Parameter beeinflusst werden. Welche Dateien innerhalb der Ordner angezeigt werden, kann mit dem [[#a_imgfiletypes|imgfiletypes]]- und dem [[#a_imgfiletypeids|imgfiletypeids]]-Parameter bestimmt werden.+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 [[#a_imgfolders|imgfolders]]-, [[#a_imgfolderids|imgfolderids]]-, [[#a_imgsubfolders|imgsubfolders]]-Parameter beeinflusst werden. Welche Dateien innerhalb der Ordner angezeigt werden, kann mit dem [[#a_imgfiletypes|imgfiletypes]]- und dem [[#a_imgfiletypeids|imgfiletypeids]]-Parameter bestimmt werden.
-Der Baum merkt sich bis zum Ende der Sitzung welche Ordner geffnet waren. Dazu muss der Browser Sessioncookies akzeptieren.+Der Baum merkt sich bis zum Ende der Sitzung welche Ordner geöffnet waren. Dazu muss der Browser Sessioncookies akzeptieren.
-==Abkrzungs-Dialog==+==Abkürzungs-Dialog==
-Der Abkrzungs-Dialog fr [[#a_abbr|<nowiki>[abbr]</nowiki>]]- und [[#a_acronym|<nowiki>[acroym]</nowiki>]]-Tags hat zwei Eingabefelder+Der Abkürzungs-Dialog für [[#a_abbr|<nowiki>[abbr]</nowiki>]]- und [[#a_acronym|<nowiki>[acroym]</nowiki>]]-Tags hat zwei Eingabefelder
-*'''Titel''': Hier kann der Title oder die Beschreibung zu der Abkrzung oder dem Akronym eingetragen werden. Dieser Titel wird in dem meisten Browsern als ToolTipText ber der Abkrzung angezeigt.+*'''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 Abkrzung oder das akronym stammt angegeben werden. Erwartet wird ein [http://de.selfhtml.org/diverses/sprachenkuerzel.htm <nowiki>Sprachenkrzel nach RFC 1766</nowiki>].+*'''Sprache''': Hier kann die Sprache, aus der die Abkürzung oder das Akronym stammt, angegeben werden. Erwartet wird ein [http://de.selfhtml.org/diverses/sprachenkuerzel.htm <nowiki>Sprachenkürzel nach RFC 1766</nowiki>].
-Genaueres ber den Sinn und auch den Unterschied zwischen Abkrzungen und Akronymen, knnen den entsprechenden Wikipedia-Artikeln entnommen werden: [http://de.wikipedia.org/wiki/Akronym Akronym] und [http://de.wikipedia.org/wiki/Abk%C3%BCrzung Abkrzung].+Genaueres über den Sinn und auch den Unterschied zwischen Abkürzungen und Akronymen, können den entsprechenden Wikipedia-Artikeln [http://de.wikipedia.org/wiki/Akronym Akronym] und [http://de.wikipedia.org/wiki/Abk%C3%BCrzung Abkürzung] entnommen werden.
==Link-Dialog== ==Link-Dialog==
-Der Link-Dialog besteht wie der [[#a_Bild-Dialog|Bild-Dialog]] aus zwei Teilen: den Eingabefeldern und einem Auswahlbaum. Der Baum zeigt hier aber nicht die Dateistruktur, sondern die fr den angemeldeten Benutzer sichtbaren Seiten an. Folgende Eingabefelder sind verfgbar:+Der Link-Dialog besteht wie der [[#a_Bild-Dialog|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 gewhlt, wird das Ziel automatisch auf deren Seitennummer gesetzt.+*'''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 ausgewhlt werden, in dem der Link geffnet wird. Nheres ber die Bedeutung der einzelnen Werte knnen Sie unter "[http://de.selfhtml.org/html/verweise/definieren.htm#zielfenster Zielfenster fr Verweise bestimmen]" nachlesen.+*'''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 "[http://de.selfhtml.org/html/verweise/definieren.htm#zielfenster Zielfenster für Verweise bestimmen]" nachlesen.
-*'''Anker''': Anker sind markierte Stellen innerhalb von Seiten, die es dem Browser ermglichen, 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 knnen Sie Ankerpunkte mit dem [[#a_anchor|<nowiki>[anchor]</nowiki>]]-Tag erstellen ''(anchor = Anker)''.+*'''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 [[#a_anchor|<nowiki>[anchor]</nowiki>]]-Tag erstellen ''(anchor = Anker)''.
-*'''kein Linktext''': Diese CheckBox gehrt zu der "[[#a_kein_Linktext|kein Linktext]]"-Funktion und wird im zugehrigen Abschnitt nher erlutert. Sie wird nur angezeigt, wenn der [[#a_notext|notext]]-Parameter gesetzt ist.+*'''kein Linktext''': Diese CheckBox gehört zu der "[[#a_kein_Linktext|kein Linktext]]"-Funktion und wird im zugehörigen Abschnitt näher erläutert. Sie wird nur angezeigt, wenn der [[#a_notext|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 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 geffnet waren. Dazu muss der Browser Session-Cookies akzeptieren.+Der Baum merkt sich bis zum Ende der Sitzung welche Ordner geöffnet waren. Dazu muss der Browser Session-Cookies akzeptieren.
==E-Mail-Dialog== ==E-Mail-Dialog==
-Der E-Mail-Dialog hilft beim Einfgen von [[#a_email|<nowiki>[email]</nowiki>]]-Tags. Es werden folgende Eingabefelder angezeigt:+Der E-Mail-Dialog hilft beim Einfügen von [[#a_email|<nowiki>[email]</nowiki>]]-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. *'''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. *'''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. *'''Betreff''': Es kann auch ein Betreff vorgegeben werden, der dann in den meisten Mailprogrammen als Vorbelegung genommen wird.
-*'''kein Linktext''': Diese CheckBox gehrt zu der "[[#a_kein_Linktext|kein Linktext]]"-Funktion und wird im zugehrigen Abschnitt nher erlutert. Sie wird nur angezeigt, wenn der [[#a_notext|notext]]-Parameter gesetzt ist.+*'''kein Linktext''': Diese CheckBox gehört zu der "[[#a_kein_Linktext|kein Linktext]]"-Funktion und wird im zugehörigen Abschnitt näher erläutert. Sie wird nur angezeigt, wenn der [[#a_notext|notext]]-Parameter gesetzt ist.
==Ankerdialog== ==Ankerdialog==
-Mit dem Ankerdialog kann ein Anker in einer Seite definiert werden, den man dann mit einem Ankerlink anspringen kann. Der Dialog fgt einen [[#a_anchor|<nowiki>[achor]</nowiki>]]-Tag in den Text ein. Es gibt folgende Eingabefelder:+Mit dem Ankerdialog kann ein Anker in einer Seite definiert werden, den man dann mit einem Ankerlink anspringen kann. Der Dialog fügt einen [[#a_anchor|<nowiki>[achor]</nowiki>]]-Tag in den Text ein. Es gibt folgende Eingabefelder:
*'''AnkerID''': Hier wird der eindeutige Name (ID) des Ankers eingegeben, auf den mit dem [[#a_link|<nowiki>[link]</nowiki>]]-Tag verwiesen wird. *'''AnkerID''': Hier wird der eindeutige Name (ID) des Ankers eingegeben, auf den mit dem [[#a_link|<nowiki>[link]</nowiki>]]-Tag verwiesen wird.
-*'''kein Linktext''': Diese ckeckbox gehrt zu der "[[#a_kein_Linktext|kein Linktext]]"-Funktion und wird im zugehrigen Abschnitt nher erlutert. Sie wird nur angezeigt, wenn der [[#a_notext|notext]]-Parameter gesetzt ist.+*'''kein Linktext''': Diese Checkbox gehört zu der "[[#a_kein_Linktext|kein Linktext]]"-Funktion und wird im zugehörigen Abschnitt näher erläutert. Sie wird nur angezeigt, wenn der [[#a_notext|notext]]-Parameter gesetzt ist.
==Dateilink-Dialog== ==Dateilink-Dialog==
-Um bequem [[#a_filelink|<nowiki>[filelink]</nowiki>]]-Tags einzufgen, gibt es den Dateilink-Dialog. Das Dialogfenster besteht fast ausschlielich aus einem Dateibaum, der hnlich dem Dateibaum im [[#a_Bild-Dialog|Bild-Dialog]] die Dateien aus dem Dateimanager anzeigt, die der angemeldete Benutzer sehen darf.+Um bequem [[#a_filelink|<nowiki>[filelink]</nowiki>]]-Tags einzufügen, gibt es den Dateilink-Dialog. Das Dialogfenster besteht fast ausschlieölich aus einem Dateibaum, der ähnlich dem Dateibaum im [[#a_Bild-Dialog|Bild-Dialog]] die Dateien aus dem Dateimanager anzeigt, die der angemeldete Benutzer sehen darf.
-Welche Ordner angezeigt werden, knnen Sie mit den [[#a_filefolders|filefolders]]-, [[#a_filefolderids|filefolderids]]-, [[#a_filesubfolders|filesubfolders]]-Parametern beeinflussen. Die angezeigten Dateien knnen mit dem [[#a_imgfiletypes|imgfiletypes]]- und dem [[#a_imgfiletypeids|imgfiletypeids]]-Parameter ausgewhlt werden.+Welche Ordner angezeigt werden, können Sie mit den [[#a_filefolders|filefolders]]-, [[#a_filefolderids|filefolderids]]-, [[#a_filesubfolders|filesubfolders]]-Parametern beeinflussen. Die angezeigten Dateien können mit dem [[#a_imgfiletypes|imgfiletypes]]- und dem [[#a_imgfiletypeids|imgfiletypeids]]-Parameter ausgewählt werden.
-Der Baum merkt sich bis zum Ende der Sitzung welche Ordner geffnet waren. Dazu muss der Browser Session-Cookies akzeptieren.+Der Baum merkt sich bis zum Ende der Sitzung welche Ordner geöffnet waren. Dazu muss der Browser Session-Cookies akzeptieren.
-Zustzlich kann noch eine ''kein Linktext''-Ckeckbox angezeigt werden. Diese gehrt zu der "[[#a_kein_Linktext|kein Linktext]]"-Funktion und wird im zugehrigen Abschnitt nher erlutert. Sie wird nur angezeigt, wenn der [[#a_notext|notext]]-Parameter gesetzt ist.+Zusätzlich kann noch eine ''kein Linktext''-Checkbox angezeigt werden. Diese gehört zu der "[[#a_kein_Linktext|kein Linktext]]"-Funktion und wird im zugehörigen Abschnitt näher erläutert. Sie wird nur angezeigt, wenn der [[#a_notext|notext]]-Parameter gesetzt ist.
==Listen-Dialog== ==Listen-Dialog==
-Der Listen-Dialog setzt sich aus einer Liste, einem Eingabefeld und mehreren Funktionsbuttons zusammen. Die Liste dient als Vorschau fr die Anzeige und Sortierung der Listenelemente. ber das Eingabefeld knnen neue Elemente hinzugefgt werden. Dazu geben Sie den Text des Elements in das Feld ein und klicken Sie auf ''Hinzufgen'' oder besttigen Sie mit '''Enter'''. Um ein Element aus der Liste zu lschen, markieren Sie es und klicken auf ''Entfernen''.+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 knnen nun im Textfeld den Wert des Eintrages ndern und mit einem Klick auf ''bernehmen'' in der Liste ndern.+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, knnen markierte Elemente ''Hoch'', ''Runter'', ''Nach Oben'' und ''Nach Unten'' verschoben werden. Sie knnen mit gedrckter '''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.+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 schlielich den [[#a_list|<nowiki>[list]</nowiki>]]-Tag mit seinen [[#a_.2A_.28.3DListitem.29|Listenelementen]] zu erzeugen, klicken Sie auf ''OK''.+Um schließlich den [[#a_list|<nowiki>[list]</nowiki>]]-Tag mit seinen [[#a_.2A_.28.3DListitem.29|Listenelementen]] zu erzeugen, klicken Sie auf ''OK''.
==Tabellen-Dialog== ==Tabellen-Dialog==
-Der Tabellendialog hat zwei Eingabefelder fr die Anzahl der Zeilen und der Spalten. Mit einem Klick auf '''OK''' wird ein [[#a_table|<nowiki>[table]</nowiki>]]-Tag mit vorbereiteten [[#a_row|<nowiki>[row]</nowiki>]]- und [[#a_cell|<nowiki>[cell]</nowiki>]]-Tags erzeugt.+Der Tabellendialog hat zwei Eingabefelder für die Anzahl der Zeilen und der Spalten. Mit einem Klick auf '''OK''' wird ein [[#a_table|<nowiki>[table]</nowiki>]]-Tag mit vorbereiteten [[#a_row.2Ftr|<nowiki>[row]</nowiki>]]- und [[#a_cell.2Ftd|<nowiki>[cell]</nowiki>]]-Tags erzeugt.
=Die Parameter des dedi:mod-Tags= =Die Parameter des dedi:mod-Tags=
 +Der jeweils erste angegebene Wert entspricht dem Standard-Wert.
 +
==features== ==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 [[#a_Stil-Auswahl|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 [[#a_Stil-Auswahl|Stil-Auswahl]] nachgelesen werden.
 +*striptags:
 +*: Aktiviert die [[#a_Strip-Tags|Strip-Tags]]-Funktion. Näheres dazu kann im entsprechenden Abschnitt nachgelesen werden.
 +*charmap:
 +*: Aktiviert die [[#a_Charmap|Charmap]]-Funktion.
 +
==fonts== ==fonts==
 + fonts = "[Font #1], [Font #2], [Font #n], ..."
 +Mit dieser kommaseparierten Liste können Sie die Schriftarten, die der Redakteur in der [[#a_Schriftartenauswahl|Schriftartenauswahl]] auswählen und im [[#a_font|<nowiki>[font]</nowiki>]]-Tag benutzen kann, bestimmen. Die angegeben Schriftartennamen können auch Leerzeichen enthalten. Andere als die hier angezeigten Schriftarten können nicht verwendet werden.
 +
==classes== ==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 [[#a_Stil-Auswahl|Stil-Auswahl]] ausgewählt und im [[#a_class|<nowiki>[class]</nowiki>]]-Tag verwendet werden können. Zusätzlich zu den Klassennamen kann ein Anzeigename angegeben werden, welcher in der Auswahlbox ausgegeben wird.
 +
==classids== ==classids==
-==sizemin==+ classids="[ID #1], [ID #2], [ID #n]"
-==sizemax==+Zusätzlich zu den über den [[#a_classes|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|mip_forms]] wichtig und für die manuelle Konfiguration eher uninteressant.
 + 
 +==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.
 + 
==paragraphs== ==paragraphs==
 + paragraphs = "br|p"
 +Gibt an, auf welche Weise Absätze behandelt werden. Ist ''p'' als Wert angegeben, werden Absätze mit der [[#a_Absatzbehandlung|Absatzbehandlung]] verarbeitet. Bei ''br'' werden Absätze durch &lt;br&gt; bzw. &lt;br /&gt;, abhängig vom [[#a_htmlmode|htmlmode]], dargestellt.
 +
==notarget== ==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.
 +
==notext== ==notext==
 + notext = "false|true"
 +Gibt an, dass in den Formularen zu [[#a_email|<nowiki>[email]</nowiki>]], [[#a_anchor|<nowiki>[anchor]</nowiki>]], [[#a_filelink|<nowiki>[filelink]</nowiki>]] und [[#a_link|<nowiki>[link]</nowiki>]] eine Checkbox 'Kein Text' angezeigt wird, die die bbCode-Erweiterung dazu veranlasst, die bbCode-Tags in der Form
 + <nowiki>[</nowiki>[[#a_link|link]]<nowiki>]http://www.google.de</nowiki>[/link]
 +einzufügen, welche den code sauberer hält, jedoch keinen Linktext ermöglicht. Diese Form ist identisch zu
 + <nowiki>[</nowiki>[[#a_link|link]]="<nowiki>http://www.google.de</nowiki>"][/link]
 +Dieser Schalter hat nur Auswirkung auf die (nicht-)Anzeige der Checkbox, die Tags werden trotzdem immer interpretiert.
 +Eine Besonderheit beim [[#a_link|<nowiki>[link]</nowiki>]]-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.
 +
==linkexternal== ==linkexternal==
 + linkexternal = "true|false"
 +Gibt an, ob [[#a_link|<nowiki>[link]</nowiki>]]-Tags auch auf externe URLs verweisen dürfen. Ansonsten sind nur Seiten-IDs als Ziele zugelassen.
 +
==imgexternal== ==imgexternal==
-==linktpl==+ imgexternal = "true|false"
-==extlinktpl==+Genauso wie [[#a_linkexternal|linkexternal]], nur für [[#a_img|<nowiki>[img]</nowiki>]]-Tags. Wird imgexternal deaktiviert, können Bilder nur noch mittels Dateinummer referenziert werden.
 + 
 +==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 [[#a_Linktemplates|Linktemplates]] nachlesen. Das Standardtemplate ist:
 + [link='{url}']{text}[/link]
 + 
==footnotelinktpl== ==footnotelinktpl==
-==filelinktpl==+Template für die Links des [[#a_footnote|<nowiki>[footnote]</nowiki>]]-Tags. Weitere Informationen über die Verwendung dieses Templates können Sie im Abschnitt über [[#a_Linktemplates|Linktemplates]] nachschlagen. Der Standardwert ist
 + [{id}]
 + 
==singleenter== ==singleenter==
 + singleenter = "false|true"
 +Wird dieser Parameter auf ''true'' gesetzt, wird bei aktivierter [[#a_Absatzbehandlung|Absatzbehandlung]] schon nach einem einzelnen Zeilenumbruch ein neuer Absatz begonnen.
 +
==imgalwaysalt== ==imgalwaysalt==
 + imgalwaysalt = "true|false"
 +Gibt an, ob ein von einem [[#a_img|<nowiki>[img]</nowiki>]]-Tag erzeugter <nowiki><img></nowiki>-Tag immer ein alt-Attribut erhält, auch wenn kein Titel angegeben wurde. Sollte für XHTML-Konformität aktiviert sein.
 +
==htmlmode== ==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.
 +
 +==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 [http://www.php.net/strip_tags strip_tags()] verwendet.
 +
==namedentities== ==namedentities==
-==imgfolders==+ namedentities = "true|false"
-==imgsubfolders==+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 [[#a_Entitätenbehandlung|Entitätenbehandlung]] nachgelesen werden.
-==imgfiletypes==+ 
-==imgfiletypeids==+==classescontainer==
-==imgfolderids==+ classescontainer = "inline|block"
 +Dieser Konfigurationsparameter gibt an, in welcher Umgebung die Klassen des [[#a_class|<nowiki>[class]</nowiki>]]-Tags ausgegeben werden.
 +*'''inline''' bedeutet, dass ein Inline-Element mit der Klasse belegt wird, genauer gesagt wird ein &lt;span&gt;-Element erzeugt.
 +*'''block''' erzeugt ein Blocklevel-Element (&lt;div&gt;) und weist ihm die angegeben Klasse zu.
 + 
==filefolders== ==filefolders==
 + filefolders = "true|[iddirectorys]"
 +Mit diesem Parameter kann gesteuert werden, welche Ordner im [[#a_Dateilink-Dialog|Dateilink-Dialog]]-Dialog auftauchen. Für ''filefolders'' können Sie kommasepariert eine Liste von OrdnerIDs angeben. Diese bekommt man am bequemsten über phpMyAdmin, Tabelle &lt;prefix&gt;_directories, Feld ''iddirectory''. Es werden dann nur Dateien aus diesen Ordnern (und mit [[#a_filesubfolders|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.
 +
 +==filefolderids==
 +Dieser Parameter ist von seiner Bedeutung her identisch mit dem [[#a_filefolders|filefolders]]-Parameter, nur dass dieser für die Verwendung mit [[Mip-forms|mip_forms]] bestimmt ist.
 +
==filesubfolders== ==filesubfolders==
 + filesubfolders = "true|false"
 +Gibt an, ob auch die Unterordner der im [[#a_filefolders|filefolders]]-Parameter aufgelisteten Ordner angezeigt werden sollen.
 +
==filefiletypes== ==filefiletypes==
 + filefiletypes = "true|[filetypes]"
 +Hier kann eine Liste an Dateierweiterungen angegeben werden, welche im [[#a_Dateilink-Dialog|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.
 +
==filefiletypeids== ==filefiletypeids==
-==filefolderids==+ filefiletypeids = "[filetypeids]"
 +Zusätzlich zu den mittels [[#a_filefiletypes|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|mip_forms]] gedacht.
 + 
 +==imgfolders==
 +Wie [[#a_filefolders|filefolders]], nur für den [[#a_Bild-Dialog|Bild-Dialog]]. Ob Unterordner mit einbezogen werden sollen, wird durch den [[#a_imgsubfolders|imgsubfolders]]-Parameter bestimmt.
 + 
 +==imgfolderids==
 +Dieser Parameter ist von seiner Bedeutung her identisch mit dem [[#a_imgfolders|imgfolders]]-Parameter, nur dass dieser für die automatische Konfiguration via [[Mip-forms|mip_forms]] gedacht ist.
 + 
 +==imgsubfolders==
 +Wie [[#a_filesubfolders|filesubfolders]], nur auf den [[#a_imgfolders|imgfolders]]-Parameter und den [[#a_Bild-Dialog|Bild-Dialog]] bezogen.
 + 
 +==imgfiletypes==
 +Wie [[#a_filefiletypes|filefiletypes]], nur auf den [[#a_Bild-Dialog|Bild-Dialog]] bezogen.
 + 
 +==imgfiletypeids==
 +Wie [[#a_imgfiletypeids|imgfiletypeids]], nur auf den [[#a_Bild-Dialog|Bild-Dialog]] bezogen.
=Die bbCode-Tags= =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. [[#a_Notation_der_bbCode-Tags|Notation der bbCode-Tags]]).
 +Die Tags [[#a_email|<nowiki>[email]</nowiki>]], [[#a_anchor|<nowiki>[anchor]</nowiki>]], [[#a_link|<nowiki>[link]</nowiki>]] und [[#a_filelink|<nowiki>[filelink]</nowiki>]] 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.
 +
==b== ==b==
 +Formatiert den enthaltenen Text fett.
 +
==i== ==i==
 +Formatiert den enthaltenen Text kursiv (schräg).
 +
==u== ==u==
 +Formatiert den enthaltenen Text unterstrichen. Sparsam verwenden da die Darstellung u. U. mit der Standarddarstellung von Links kollidieren könnte.
 +
==s== ==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.
 +
==sub== ==sub==
 +Stellt den enthaltenen Text tiefgestellt (sub = unter) dar.
 +
==sup== ==sup==
 +Stellt den enthaltenen Text Hochgestellt (sup = super = über) dar.
 +
==size== ==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.
 +
==font== ==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 [[#a_fonts|fonts]]-Parameter festgelegt.
 +
==class== ==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 [[#a_classes|classes]]-Parameter gesteuert.
 +
==forecol== ==forecol==
 +Parameter:
 +*'''color''' - Gibt eine Farbreferenz im Hex-Format (#RRGGBB) an. Mehr Informationen über dieses Format können Sie hier nachlesen: [http://de.selfhtml.org/html/allgemein/farben.htm#hexadezimal Hexadezimale Angabe von Farben].
 +
 +Stellt den enthaltenen Text mit einer anderen Vordergrundfarbe dar.
 +
==backcol== ==backcol==
 +Parameter:
 +*'''color''' - Wie bei [[#a_forecol|<nowiki>[forecol]</nowiki>]]
 +Stellt den enthaltenen Text mit einer anderen Hintergrundfarbe dar.
 +
==img== ==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 [[#a_Style-Attribut|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 [http://de.selfhtml.org/html/grafiken/einbinden.htm#breite_hoehe Breite und Höhe von Grafiken] nachlesen.
 +Mit dem [[#a_imgexternal|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]<nowiki>http://www.google.com/intl/en/images/logo.gif</nowiki>[/img]
 +Zeigt das Google-Logo.
 + [img title="Google"]<nowiki>http://www.google.com/intl/en/images/logo.gif</nowiki>[/img]
 + [img="Google"]<nowiki>http://www.google.com/intl/en/images/logo.gif</nowiki>[/img]
 +Zeigt das Logo mit Titel
 + [img]{mediapath}/logo.gif[/img]
 +Verlinkt auf das Bild ''logo.gif'' im media-Verzeichnis.
 +
==abbr== ==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 [http://de.selfhtml.org/diverses/sprachenkuerzel.htm <nowiki>Sprachenkürzel nach RFC 1766</nowiki>].
 +*style - über diesen Parameter kann man der Abkürzung einen speziellen Stil geben. Näheres dazu kann im Abschnitt über das [[#a_Style-Attribut|Style-Attribut]] nachgelesen werden.
 +Markiert Text als Abkürzung.
 +
==acronym== ==acronym==
 +Parameter:
 +*'''title''' - Wie bei [[#a_abbr|<nowiki>[abbr]</nowiki>]], nur für Akronyme.
 +*lang - Wie bei [[#a_abbr|<nowiki>[abbr]</nowiki>]], nur für Akronyme.
 +*style - über diesen Parameter kann man dem Akronym einen speziellen Stil geben. Näheres dazu kann im Abschnitt über das [[#a_Style-Attribut|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: [http://de.wikipedia.org/wiki/Akronym Akronym] und [http://de.wikipedia.org/wiki/Abk%C3%BCrzung Abkürzung].
 +
==link== ==link==
-<!-- Achtung: Usecontent nur wenn kein anchor angegeben wurde, da sonst inkonsitenz:+Parameter:
- [link anchor="a"]33[/link]+*'''dest''' - Gibt das Ziel der Verknüpfung an.
-Ist 33 Ziel oder Linktext. Ohne anchor eindeutig da, wenn 33 nur Linktext, kein Dest mehr da wre. -->+*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 [[#a_Style-Attribut|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 [[#a_anchor|<nowiki>[anchor</nowiki>]]-Tag.
 +Es kann auch ein Zielfenster definiert werden. Nähreres zu Zielfensterangaben kann unter [http://de.selfhtml.org/html/verweise/definieren.htm#zielfenster 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 [[#a_linktpl.2C_extlinktpl.2C_maillinktpl_.26_filelinktpl|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.
==hr== ==hr==
 +Parameter:
 +*style - über diesen Parameter kann man der horizontalen Linie einen speziellen Stil geben. Näheres dazu kann im Abschnitt über das [[#a_Style-Attribut|Style-Attribut]] nachgelesen werden.
 +Fügt eine horizontale Linie ein.
 +
==br== ==br==
 +Bei aktivierter [[#a_Absatzbehandlung|Absatzbehandlung]] erzeugt dieser Tag innerhalb eines Absatzes einen Zeilenumbruch, ohne einen kompletten neuen Absatz zu beginnen.
 +
==email== ==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 [[#a_Style-Attribut|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 [[#a_linktpl.2C_extlinktpl.2C_maillinktpl_.26_filelinktpl|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.
 +
==anchor== ==anchor==
 +Parameters:
 +*'''id''' - Gibt die Anker-ID an.
 +Erzeugt einen Anker, der dann über den [[#a_link|<nowiki>[link]</nowiki>]]-Tag angesprungen werden kann.
 +Mehr Informationen über Anker können Sie unter [http://de.selfhtml.org/html/verweise/projektintern.htm#anker 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: [http://www.timrivera.com/tests/hover.html A:hover and named anchors].
 +
==filelink== ==filelink==
 +*'''id''' -
 +*style - über diesen Parameter kann man dem Dateilink einen speziellen Stil geben. Näheres dazu kann im Abschnitt über das [[#a_Style-Attribut|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 [[#a_linktpl.2C_extlinktpl.2C_maillinktpl_.26_filelinktpl|filelinktpl]]-Parameter abhängig ist.
 +
==list== ==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 [[#a_Style-Attribut|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 [[#a_.2A_.28.3DListitem.29|<nowiki>[*] (=Listitem)</nowiki>]] 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.
 +
==* (=Listitem)== ==* (=Listitem)==
 +Parameter:
 +*style - über diesen Parameter kann man dem Listitem einen speziellen Stil geben. Näheres dazu kann im Abschnitt über das [[#a_Style-Attribut|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.
 +
==footnote== ==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 [[#a_footnotelinktpl|footnotelinktpl]]-Parameter mit bestimmt.
 +Mehr Informationen zur Verwendung der Fußnoten, können Sie im Abschnitt über die [[#a_Fu.DFnoten|Fußnoten]] nachlesen.
 +
==code== ==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 [http://php.net/highlight_string PHP-Funktion "highlight_string"] durch.
 +
==source== ==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.
 +
==table== ==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 [[#a_Style-Attribut|Style-Attribut]] nachgelesen werden.
 +Erzeugt das Grundgerüst für eine Tabelle. Diese Tabelle kann dann mit [[#a_row.2Ftr|Zeilen]], [[#a_head.2Fth|Tabellenköpfen]] und [[#a_cell.2Ftd|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 [http://de.selfhtml.org/html/tabellen/umgebung.htm#beschriftung Tabellenüberschrift / Tabellenunterschrift definieren] nachlesen.
 +
==row/tr== ==row/tr==
-==cell/td==+Parameter:
 +*style - über diesen Parameter kann man der Tabellenzeile einen speziellen Stil geben. Näheres dazu kann im Abschnitt über das [[#a_Style-Attribut|Style-Attribut]] nachgelesen werden.
 +Erzeugt eine Tabellenzeile. Diese Zeile kann dann mit [[#a_head.2Fth|Tabellenköpfen]] oder [[#a_cell.2Ftd|Zellen]] befüllt werden.
 +Beinhaltet die Zeile nicht mindestens eine gültige Zelle oder einen Tabellenkopf, wird sie ignoriert.
 + 
==head/th== ==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 [[#a_Style-Attribut|Style-Attribut]] nachgelesen werden.
 +
 +==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 [[#a_Style-Attribut|Style-Attribut]] nachgelesen werden.
 +Näheres über das Zusammenspiel von Tabellenzeilen, -zellen und -köpfen, kann unter [http://de.selfhtml.org/html/tabellen/aufbau.htm#definieren Tabellen definieren] nachgelesen werden.
 +
 +=Danksagung=
 +Besonders Danke möchte ich
 +*[http://forum.der-dirigent.de/index.php?s=&act=Profile&CODE=03&MID=120 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.
 +*[http://forum.der-dirigent.de/index.php?s=&act=Profile&CODE=03&MID=333 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.
-=Browserkompatibilitt=+=Quellen=
-=Weitere Informationen=+*Zugrundeliegende bbCode-Klasse: [http://christian-seiler.de/projekte/php/bbcode/ BBCode-Parserklasse für PHP].
 +*Zugrundeliegender JavaScript-Code zum Einfügen der bbCodes in die Textarea: [http://aktuell.de.selfhtml.org/tippstricks/javascript/bbcode/ Text an Cursorposition einfügen].
 +*Die JavaScript-Cookie-Funktionen zum Speichern der Formgrößen stammt aus [http://www.webreference.com/js/column8/functions.html Crispy JavaScript Cookie Functions].
 +*Der JavaScript-Code zum Anordnen der Listen stammt von [http://www.babailiica.com/js/reorderizator.html babailiicas reorderizator].
[[Category:Moduldokumentationen|B]] [[Category:Moduldokumentationen|B]]

Aktuelle Version

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“
Persönliche Werkzeuge