====== Box Plugin ======

===== Informazioni generali =====
Questo plugin consente di evidenziare porzioni di testo racchiudendole in un riquadro di cui è possibile specificare
molteplici parametri, tra cui le dimanesioni, l'allineamente, il colore, ecc ...

**Sito:** [[http://wiki.jalakai.co.uk/dokuwiki/doku.php/tutorial/boxes | http://wiki.jalakai.co.uk/dokuwiki/doku.php/tutorial/boxes]]

===== Sintassi =====

A simple box:

  <box> the box contents </box>

<box> the box contents </box>

A more complex box:

  <box 80% round red|a title> the box contents </box>

<box round orange 80%|The full syntax:>

''**%%<box%%** //width// //classes// **|** title text**>** contents text **%%</box|%%** caption text**%%>%%**''

  ; //classes// : any number of classes which use the styles in your template or the plugin's own stylesheet to determine the look of the box. The box plugins comes with the following classes already defined:
    * //round// --- box will have rounded corners
    * //blue// --- blue colour scheme
    * //red// --- red colour scheme
    * //green// --- green colour scheme
    * //orange// --- orange colour scheme
    * //left// --- box is floated left on the page
    * //right// --- box is floated right on the page

  ; //width// : any legal CSS length value.
  ; //title text// : text (including dokuwiki markup) displayed as a title above box contents.
  ; //caption text// : text (without dokuwiki markup) displayed as a caption below box contents.


\\ 
//width// & //classes// can be specified in any order.
</box>
if no classes are specified the default styles will be used, that is square corners in a colour scheme based on the default Dokuwiki colour scheme.

The opening ''%%<box ... >%%'' including the title must all appear on one line.  The box contents can appear over as many lines as are needed.

See the plugin in action [[http://wiki.jalakai.co.uk/dokuwiki/doku.php/test/boxes|here]]. The sample page shows all the styles available with the plugin.

===== Esempi =====
<box 80% round red|a title> the box contents </box>
<box> 30% left[[the most basic box]]</box>

'let us start a quote and not finish it.

<box red|Boxed & //titled// > this isn't
also 
boxed
</box>

<box round #f99 #99f #fc9 #f60|using hex colours>lorem ipsum dolor ...</box>

<box round rgb(0,255,127)|using rgb colours>lorem ipsum dolor ...</box>

<box green > this is
also 
boxed
</box|boxed & captioned>

<box round orange>as is this</box>

<box round 75% | title **with //fo''rma''tt//ing**, a [[link]] and rounded corners :-) >boxes can also contain markup...
  * a list
  * of several 
  * items

<code html>
<div class='box'>
  <b class='xtop'><b class='xb1'></b><b class='xb2'></b><b class='xb3'></b><b class='xb4'></b></b>
  <div class='xbox'>
    <p class='box_title'>Title text would go here</p>
    <div class='box_content'>
      <p>Including this html snippet of a box</p>
      <p>All those &lt;b&gt; tags handle the rounded corners</p>
    </div>
  </div>
  <b class='xbottom'><b class='xb4'></b><b class='xb3'></b><b class='xb2'></b><b class='xb1'></b></b>
</div>
</code>

=== headings aren't allowed in boxes ===

| but | tables | are |

and plugins ... 
  ; definition : list : list : list

and a [[link]] </box|Wow, a lot of stuff>


<box |title>a box to match 
the default dokuwiki colour scheme</box>

<box |Example box>
to test what is possible:
**NICE PLUGIN:**
You can 
  * make Lists
  * other markup
  * set the color of the box
  * ...

looks good?

</box>


<box 70% red round| title>red box, 80% wide, with a title</box>

<box blue left> this is a blue box</box>

<box blue right> this is a blue box</box>

<box 40% blue round| title>blue box with a title</box>

<box 80% green round| title>a wide green box</box>

<box orange>and an orange box
</box>

<box 40% left round blue | title teste> testing </box>  
<box 40% right round green  | title test> testing </box> 
<box 45% left round blue | title teste> testing </box>  
<box 45% right round green  | title test> testing </box>
// 
// 
<box 45% left round black|Is the colour wrong?>
this is
also 
boxed
</box>
// 
// 
<box 45% right round green  | title test> 
testing 123456 gagagaga gaggagagaga gaagagagag agagagag agaga gaagagaga gagagagag agagaggag agagaga gag agag
</box>
// 
// 
<box 80% left round|**Simple box with rounded edges and title**>
I wonder what uses I could find for a box...
  * I will have to check this out
  * tomorrow
  * on my wiki
  <box 70% orange>But can there be a box inside of a box?</box|Yes! there can!>
</box>

 

<box 25% left round>
**Simple box with rounded edges and no title**
But with some "code", not really code, but just code layout
<code>
  * I will have to check this out
  * tomorrow
  * on my wiki
</code>
</box>


<box 25% right round>
**Same thing on the right handside**
But with some "code", not really code, but just code layout
<code>
  * I will have to check this out
  * tomorrow
  * on my wiki
</code>
</box>

<box round #fff |using hex colours>lorem ipsum dolor ...</box>