BbCode Erweiterung 2 v1.0

Aus DeDi-Help

(Unterschied zwischen Versionen)
Wechseln zu: Navigation, Suche
Version vom 12:08, 26. Nov. 2005 (bearbeiten)
Mika (Diskussion | Beiträge)
K (→Anpassung vorhandener Module)
← Zum vorherigen Versionsunterschied		 Version vom 18:50, 27. Nov. 2005 (bearbeiten) (Entfernen)
MaZderMind (Diskussion | Beiträge)
(Allgemeines fertig, Referenz fehlt noch)
Zum nächsten Versionsunterschied →
Zeile 2: Zeile 2:
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]]. 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]].
-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 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.
-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*aet*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 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]
=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. 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.
 +
'''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. '''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.
- 
-'''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=
Zeile 22: Zeile 21:
=Beispiele= =Beispiele=
-'''Achtung!!! Noch ungetestet''' 
- 
Typische bbCode-Textarea ohne Absatzbehandlung Typische bbCode-Textarea ohne Absatzbehandlung
<dedi:mod <dedi:mod
Zeile 31: Zeile 28:
title = "Typisch" title = "Typisch"
nl2br = "true" nl2br = "true"
- usecontent = "true" + notext = "true"
- filelinktpl = "Download: [b]{file}[/b] [[i]{size}[/i]]" + filelinktpl = "Download: [b]{text}[/b] [[i]{size}[/i]]"
filefolders = "3, 9" filefolders = "3, 9"
filesubfolders ="true" filesubfolders ="true"
Zeile 54: Zeile 51:
=besondere Funktionen= =besondere Funktionen=
==Absatzbehandlung== ==Absatzbehandlung==
-Die Absatzbehandlung ist eine Methode, saubereren 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 eigenstndiger Absatz erkannt werden, automatisch mit &lt;p&gt;&lt;/p&gt; umschlossen ''(p = Paragraph = Absatz)''.
-Zeilen werden zu einem Absatz zusammengefasst, wenn sie nur einen Zeilenumbruch enthalten. Ist 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. Ist eine Leerzeile zwischen zwei Zeilen, werden diese in getrennte Abtze gepackt.
Dies ist ein Absatz Dies ist ein Absatz
der immer noch weitergeht der immer noch weitergeht
Zeile 63: Zeile 60:
Dies wrde zu folgendem HTML-Code fhren: Dies wrde zu folgendem HTML-Code fhren:
- &lt;p&gt;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 &lt;br /&gt; 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|[br]]]-Tag, dieser ist jedoch auch nur bei aktivierter Absatzbehandlung verfgbar.+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 [[#a_br|<nowiki>[br]</nowiki>]]-Tag, dieser ist jedoch auch nur bei aktivierter Absatzbehandlung verfgbar.
==Style-Attribut== ==Style-Attribut==
Zeile 73: Zeile 70:
<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:
-*[[#a_abbr|abbr]]+*[[#a_abbr|<nowiki>[abbr]</nowiki>]]
-*[[#a_acronym|acronym]]+*[[#a_acronym|<nowiki>[acronym]</nowiki>]]
-*[[#a_link|link]]+*[[#a_link|<nowiki>[link]</nowiki>]]
-*[[#a_hr|hr]]+*[[#a_hr|<nowiki>[hr]</nowiki>]]
-*[[#a_email|email]]+*[[#a_email|<nowiki>[email]</nowiki>]]
-*[[#a_filelink|filelink]]+*[[#a_filelink|<nowiki>[filelink]</nowiki>]]
-*[[#a_list|list]]+*[[#a_list|<nowiki>[list]</nowiki>]]
-*[[#a_.2A_.28.3DListitem.29|<nowiki>*</nowiki> (=Listitem)]]+*[[#a_.2A_.28.3DListitem.29|<nowiki>[*] (=Listitem)</nowiki>]]
-*[[#a_table|table]]+*[[#a_table|<nowiki>[table]</nowiki>]]
-*[[#a_row.2Ftr|row/tr]]+*[[#a_row.2Ftr|<nowiki>[row/[tr]</nowiki>]]
-*[[#a_cell.2Ftd|cell/td]]+*[[#a_cell.2Ftd|<nowiki>[cell/[td]</nowiki>]]
-*[[#a_head.2Fth|head/th]]+*[[#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 einfgen eines style-Tags in einen Tag via GUI knnen Sie sich unter [[#a_Stil-Auswahl| Stil-Auswahl]] informieren.
Zeile 91: Zeile 88:
==Charmap== ==Charmap==
-Die Zeichentabelle soll dem Benutzer ermglichen, bequem Sonderzeichen einzufgen. Die Zeichen werden als benannte Entitten in den Quelltext eingefgt. Verfgbar 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 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].
==Entittenbehandlung== ==Entittenbehandlung==
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 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]].
 +
 +==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:
 + <nowiki>[</nowiki>[[#a_link|link]]='{url}']{text}[/link]
 +Sie knnen aber ihre eigenen Templates mit weiteren Tags und auch eigenen Texten bestcken. Folgende Tags sind innerhalb der Linktemplates erlaubt:
 +*[[#a_b|<nowiki>[b]</nowiki>]]
 +*[[#a_i|<nowiki>[i]</nowiki>]]
 +*[[#a_u|<nowiki>[u]</nowiki>]]
 +*[[#a_s|<nowiki>[s]</nowiki>]]
 +*[[#a_sub|<nowiki>[sub]</nowiki>]]
 +*[[#a_sup|<nowiki>[sup]</nowiki>]]
 +*[[#a_size|<nowiki>[size]</nowiki>]]
 +*[[#a_font|<nowiki>[font]</nowiki>]]
 +*[[#a_class|<nowiki>[class]</nowiki>]]
 +*[[#a_forecol|<nowiki>[forecol]</nowiki>]]
 +*[[#a_backcol|<nowiki>[backcol]</nowiki>]]
 +*[[#a_img|<nowiki>[img]</nowiki>]]
 +*[[#a_abbr|<nowiki>[abbr]</nowiki>]]
 +*[[#a_acronym|<nowiki>[acronym]</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)]].
 +
 +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.
 +
 +Zustzlich zu den oben genannten Variablen, knnen im Dateilink noch folgene Variablen verwendet werden:
 +*''{size}'': Die Dateigre mit Einheit (Bytes, KB, MB, GB, TB)
 +*''{title}'': Der im Dateimanager eingegebene Titel
 +*''{desc}'': Die im Dateimanager angegebene Beschreibung
 +*''{type}'': Die Dateinahmenserweiterung 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 wren z.B. ein Icon vor eMail-, Download- oder externen Links:
 + <nowiki>[</nowiki>[[#a_img|img]]]223[/img]<nowiki>[</nowiki>[[#a_link|link]]='{url}']{text}[/link]
 +eine Grenangabe bei Downloadlinks:
 + <nowiki>[</nowiki>[[#a_link|link]]='{url}']{text}[/link] [i]({size})[/i]
 +oder ein Typenabhngiges Icon bei Downloadlinks:
 + <nowiki>[</nowiki>[[#a_img|img]]]{mediapath}typeicons/{type}.png[/img]<nowiki>[</nowiki>[[#a_link|link]]='{url}']{text}[/link]
 +
 +Eine Aunahme bildet das Templates 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 ''{id}'', welcher durch die fortlaufend numerierte ID der Funote ersetzt wird. Das Standardtemplate ist:
 + [{id}]
 +
 +==kein Linktext==
 +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]
 +auch einfach
 + <nowiki>[</nowiki>[[#a_email|email]]]info@der-dirigent.de[/email]
 +schreiben.
 +Genauergesagt geht das mit folgenden Tags:
 +*[[#a_email|<nowiki>[email]</nowiki>]]
 +*[[#a_anchor|<nowiki>[anchor]</nowiki>]]
 +*[[#a_filelink|<nowiki>[filelink]</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.
 +
 +==Funoten==
 +Die bbCode-Erweiterung untersttzt die automatische Funotengenerierung. Dazu muss das Funotenmodul aus der Erweiterung im Dirigenten importiert werden und unterhalb der bbCode-Textares(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 den 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.
=Notation der bbCode-Tags= =Notation der bbCode-Tags=
Zeile 113: Zeile 169:
=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 lsst 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 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 lsst 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.
-Um den bbCode im ContentFlex zu konfigurieren, suchen sie dazu im Moduloutput nach den entsprechenden &lt;dedi:mod type="textarea" /&gt;-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 fgen sie die gewnschten [[#a_Parameter_des_dedi:mod-Tags|Parameter]] ein.
Es ist geplant das [[#Dokumentation_Textarea|Textarea]] sowie das [[#Dokumentation_ContentFlex|ContentFlex]] so anzupassen, dass 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 [[#Dokumentation_Textarea|Textarea]] sowie das [[#Dokumentation_ContentFlex|ContentFlex]] so anzupassen, dass 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'''.
Die bbCode-Erweiterung untersttzt auch mehrere bbCode-Textareas in einer Typegroup. Die bbCode-Erweiterung untersttzt 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 in 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 dieentsprechenden [[#a_features|Features]] aktiviert wurden.+Zustzlich zu der Mglichkeit, bbCodes im Text zu verarbeiten, bietet die bbCode-Erweiterung auch eine GUI, um diese Tags in 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 ausgeblendete 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 geffnet werden, merken sich ihre Gre bis zum Ende der Sitzung. Dazu muss der Browser Session-Cookies erlauben.
==Schriftgren-Auswahl== ==Schriftgren-Auswahl==
-Die Auswahlboxen fr die Schriftgre bentigt das ''size''-[[#a_features|Feature]]. 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|[size]]]-Tag mit der Ausgewhlen Schriftgre an.+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 Ausgewhlen Schriftgre 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 dabie eine Vorschau der gewhlen Schriftart zu zeigen, allerdings funktioniert das nicht in allen Browsern. Wird eine Schriftart ausgewhlt, wird ein [[#a_font|[font]]]-Tag mit der gewhlten Schriftart eingefgt.+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 dabie eine Vorschau der gewhlen 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.
==Stil-Auswahl== ==Stil-Auswahl==
Zeile 134: Zeile 190:
==Farbwahl-Dialog== ==Farbwahl-Dialog==
-Der Farbwahl-Dialog bietet dem Benutzer die Mglichkeit, einen Farbcode auszuwhlen. Je nach Button wird entweder ein [[#a_forecol|[forecol]]]-Tag (bentigt das ''forecol''-Feature) oder ein [[#a_backcol|[backcol]]]-Tag (bentigt das ''backcol''-Feature) eingefgt. Im Fsrbwahl-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 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 Fsrbwahl-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.
==Bild-Dialog== ==Bild-Dialog==
-Der Bild-Dialog 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. 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.
-*'''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.+*'''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.
*'''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. *'''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.
 +
 +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 Baum merkt sich bis zum Ende der Sitzung welche Ordner geffnet waren. Dazu muss der Browser Sessioncookies akzeptieren.
==Abkrzungs-Dialog== ==Abkrzungs-Dialog==
 +Der Abkrzungs-Dialog fr [[#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.
 +*'''Sprache''': Hier wird 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>].
 +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].
 +
==Link-Dialog== ==Link-Dialog==
 +Der Link-Dialog besteht wie der [[#a_Bild-Dialog|Bild-Dialog]] aus zwei Teilen: den Eingabefeldern und einem Auswahlbaum. Dier Baum zeigt hier aber nicht die Dateistruktur, sondern die fr den angemeldeten Benutzer sichtbaren Seiten an. Folgende Eingabefelder sind verfgbar:
 +*'''Ziel''': Kann eine absolute URL oder eine Seitennummer sein. Wird eine Seite im Seitenbaum gewhlt, 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.
 +*'''Anker''': Anker sind mit 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 Anker 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)''.
 +*'''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.
 +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 Sessioncookies akzeptieren.
 +
==eMail-Dialog== ==eMail-Dialog==
 +Der eMail-Dialog hilft beim Einfgen von [[#a_email|<nowiki>[email]</nowiki>]]-Tags. Es werden folgenden Eingabefelder angezeigt:
 +*'''Mailadresse''': Hier wird die Mailadresse eingegeben, auf die der Link verweisen soll. Er werden ausgeschriebene eMail-Adressen erwartet, Stilisierungen wie ''info AT der-dirigent DOT de'' werden nicht akzeptiert.
 +*'''Name''': In diesem Feld kann ein Name zu der zuvor angegeben eMail-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 dem meisten Mailprogrammen als Vorbelegung genommen wird.
 +*'''kein Linktext''': Diese CjeckBox 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.
 +
==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:
 +*'''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.
 +
==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 an, 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.
 +Der Baum merkt sich bis zum Ende der Sitzung welche Ordner geffnet waren. Dazu muss der Browser Sessioncookies 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.
 +
==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 sie auf ''Entfernen''.
 +
 +Um ein Element zu bearbeiten, markieren sie zu erst es in der Liste. Sie knnen 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 Sie markierte Elemente ''Hoch'', ''Runter'', ''Nach Oben'' und ''Nach Unten'' verschieben. 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.
 +
 +Um schlielich 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.
=Die Parameter des dedi:mod-Tags= =Die Parameter des dedi:mod-Tags=
Zeile 160: Zeile 256:
==paragraphs== ==paragraphs==
==notarget== ==notarget==
 +==notext==
==linkexternal== ==linkexternal==
==imgexternal== ==imgexternal==
Zeile 170: Zeile 267:
==htmlmode== ==htmlmode==
==namedentities== ==namedentities==
 +==imgfolders==
 +==imgsubfolders==
 +==imgfiletypes==
 +==imgfiletypeids==
 +==imgfolderids==
 +==filefolders==
 +==filesubfolders==
 +==filefiletypes==
 +==filefiletypeids==
 +==filefolderids==
=Die bbCode-Tags= =Die bbCode-Tags=
Zeile 187: Zeile 294:
==acronym== ==acronym==
==link== ==link==
 +<!-- Achtung: Usecontent nur wenn kein anchor angegeben wurde, da sonst inkonsitenz:
 + [link anchor="a"]33[/link]
 +Ist 33 Ziel oder Linktext. Ohne anchor eindeutig da, wenn 33 nur Linktext, kein Dest mehr da wre. -->
 +
==hr== ==hr==
==br== ==br==

Version vom 18:50, 27. Nov. 2005

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