BbCode Erweiterung 2 v1.0
Aus DeDi-Help
(Unterschied zwischen Versionen)
| Version vom 09:33, 26. Nov. 2005 (bearbeiten) MaZderMind (Diskussion | Beiträge) K (Bild-Dialog: berflssiges ' entfernt) ← Zum vorherigen Versionsunterschied |
Version vom 12:06, 26. Nov. 2005 (bearbeiten) (Entfernen) Mika (Diskussion | Beiträge) K (→gelesen und gelegentlich korrigiert) Zum nächsten Versionsunterschied → |
||
| Zeile 1: | Zeile 1: | ||
| =Einleitung= | =Einleitung= | ||
| - | bbCode ist eine Methode, Texte auch ohne HTML-Kenntnisse zu formatieren. Dabei wird eine 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 entscheidenbde Nachteile gegenber dem [[Dokumentation_WYSIWYG|WYSIWYG-Editor]]. Vorallem fehlten Formulare zum einfachen einfgen von Links, Bildern und anderen Elementen. Die neue Version versucht diese Nachteiel 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@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*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] |
| =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 erst einfach das komplette Archiv auf ihren Computer. Kopieren Sie dann den Ordner ''backend'' per FTP in den Ordner der DeDi-Installation und den Inhalt des ''projekt01''-Ordners in jedes Frontendverzeichnis. Vorhandenen 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. | '''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. | ||
| Zeile 19: | Zeile 19: | ||
| 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 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]]. |
| =Beispiele= | =Beispiele= | ||
| Zeile 54: | Zeile 54: | ||
| =besondere Funktionen= | =besondere Funktionen= | ||
| ==Absatzbehandlung== | ==Absatzbehandlung== | ||
| - | Die Absatzbehandlung ist eine Methode, saubereren und [http://de.wikipedia.org/wiki/Semantik semantisch] korrekteren Quellcode zu erzeugen. | + | Die Absatzbehandlung ist eine Methode, saubereren 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 <p></p> umschlossen (p = Paragraph = Absatz). | Bei aktivierter Absatzbehandlung werden Textteile, welche als eigenstndiger Absatz erkannt werden, automatisch mit <p></p> umschlossen (p = Paragraph = Absatz). | ||
| - | Zu einem Absatz zusammengefasst werden Zeilen, 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 nur einen 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 67: | Zeile 67: | ||
| <p>Hier beginnt dann ein neuer</p> | <p>Hier beginnt dann ein neuer</p> | ||
| - | Ohne Absatzbehandlung wird jeder Zeilenumbrich 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|[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|[br]]]-Tag, dieser ist jedoch auch nur bei aktivierter Absatzbehandlung verfgbar. |
| ==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 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: | ||
| <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] | ||
| - | Vorraussetzung 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|abbr]] | ||
| *[[#a_acronym|acronym]] | *[[#a_acronym|acronym]] | ||
| Zeile 94: | Zeile 94: | ||
| ==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]]. |
| =Notation der bbCode-Tags= | =Notation der bbCode-Tags= | ||
| Zeile 103: | Zeile 103: | ||
| 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 oberer Notation. Ohne Anfhrungszeichen darf der Wert dieses Paramerers kein Leerzeichen enthalten. | + | Identisch zu oben stehender Notation. Ohne Anfhrungszeichen darf der Wert dieses Paramerers 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 Anfhrungszeichen. Hier sind auch Leerzeichen kein Problem. Anfhrungszeichen mssen mit \" escaped werden. | ||
