====== Box PlugIn ======

Das [[http://wiki.splitbrain.org/plugin:boxes|Box PlugIn]] bindet Boxen (wer hätte das gedacht) in die Wiki-Seiten ein. Damit können Texte oder Bilder (oder anderer Content) hervorgehoben werden und auch als Float-Elemente rechts oder links vom Haupttext angezeigt werden.

Es gibt dafür diverse Farbschemen, wenn kein Farbschema angegeben wurde, wird das Default-Farbschema der Wiki-Seiten verwendet (in der Regel wohl die sinnvollste Anwendung).

===== Syntax =====

<box  35% right blue|**Little Boxes**>Little boxes on the hillside, \\
Little boxes made of ticky-tacky, \\
Little boxes, little boxes, \\
Little boxes, all the same. \\
There's a green one and a pink one \\
And a blue one and a yellow one \\
And they're all made out of ticky-tacky \\
And they all look just the same.</box|Malvina Reynolds>

''%%<box width classes|title text> Box Inhalt </box|caption>%%''

Dabei ist

  * //width// --  jeder legale CSS-Wert für eine Breitenangabe
  * //classes // -- jede CSS-Klasse, die im DokuWiki oder in den Styles des aktuellen Templates verwendet wird. Das PlugIn bringt folgende eigene Klassen mit:
    * //round// -- Eine Box mit abgerundeten Ecken
    * //blue// -- (Hell-) blaues Farbschema
    * //red// -- Rosa Farbschema
    * //green// -- Grünes Farbschema
    * //orange// -- Oranges Farbschema
    * //left// -- Der Haupttext fließt um die links auf der Wikiseite angeordnete Box herum
    * //right// -- Der Haupttext fließt um die rechts auf der Wikiseite angeordnete Box herum
  * //title text// -- Der Titel der Box (optional, Wiki-Markup erlaubt)
  * //caption text// -- Text, der unterhalb der Box angezeigt wird (nützlich für Bildunterschriften etc.), kein Wiki-Markup erlaubt (optional).

Der Box-Inhalt kann ebenfalls Wiki-Markups enthalten. Das schließt auch ein, das Boxen wiederum Boxen enthalten können.

===== Beispiele =====

Eine Seite mit vielen exemplarischen Beispielen gibt es [[http://wiki.jalakai.co.uk/dokuwiki/doku.php/test/boxes|hier]].

===== Caveats =====

Das PlugIn scheint einige Probleme mit seinen Stylesheets zu haben (zumindest zusammen mit [[http://tatewake.com/wiki/projects:monobook_for_dokuwiki|Monobook]]). Erst einmal zieht es die ''style.css'' nicht rein, ich habe das gesamte Stylesheet in die ''main.css'' kopiert. Aber selbst dann ist oftmals noch ein Reload der Seite notwendig, damit die Box korrekt angezeigt wird (das letzte Verhalten scheint aber nur den Safari zu betreffen, der Firefox zeigt die Boxen sofort korrekt an).

Es sieht so aus, als ob das letzte Verhalten ein Cache-Problem war. Nun zeigt auch der Safari die Boxen immer sofort korrekt an. Muß ich weiter beobachten.

FIXME