====== Plugin : WRAP ======

https://www.dokuwiki.org/plugin:wrap



===== Description =====



Les différents mots clés utilisés : column, centeralign, rightaline, hi, lo, tabs, clear, indent, outdent, prewrap, spoiler, hide, pagebreak, nopagebreak, noprint, onlyprint, 
...
===== Syntaxe =====

==== Syntaxe de base ====

=== WRAP / block / div ===

**''%%<WRAP>%%'' en majuscules** creé un bloc (on peut aussi utiliser ''%%<block>%%'' or ''%%<div>%%'').

Par exemple :

<code>
<WRAP classes #id width :language>
"big" content
</WRAP>

or
<block classes #id width :language>
"big" content
</block>

or
<div classes #id width :language>
"big" content
</div>
</code>

=== wrap / inline / span ===


Si **''%%<wrap>%%'' est écrit en minuscules** cela crée un sous-bloc dans le texte qui reste sur la ligne (on peut aussi utiliser ''%%<inline>%%'' ou ''%%<span>%%'').

Exemple : 

<code>
<wrap classes #id width :language>"small" content</wrap>

or
<inline classes #id width :language>"small" content</inline>

or
<span classes #id width :language>"small" content</span>
</code>

A noter que certains éléments ne fonctionnent pas avec cette fonction : les alignements (alignments), le multi-colonnes (multi-columns) et la largeur (widths).





==== Classes et styles ====

=== Colonnes et flottants ===

Columns :
  * widths (experimental) : ''half'' / ''third'' / ''quarter''


  * column		: same as left in LTR languages and same as right in RTL languages
  * left		: same as column, will let you float your container on the left
  * right		: will let the container float right
  * center		: will position the container in the horizontal center of the page
  * col2..col5		: will show the text in multiple columns (2, 3, 4 or 5), only works in modern browsers (Firefox, Chrome and Safari) 

...

=== Alignements ===

  * ''leftalign''
  * ''rightalign''
  * ''centeralign''
  * ''justify''

Exemple :

<code>
<WRAP centeralign>Texte centré</WRAP>
</code>

<WRAP centeralign>Texte centré</WRAP>

=== Boites et notes ===

  * **round**		: ajoute des coins arrondis aux containers qui ont une couleur de fond ou une bordure
  * **box**		: crée une boite autour du container (en utilisant les couleurs de style.ini)
  * **info**            : crée une boite blueue avec une icone info
  * **important**	: crée une boite orange avec une icone important
  * **alert**           : crée une boite rouge avec une icone alert (c'était "warning" dans les versions précédentes)
  * **tip**		: crée une boite jaune avec une icone tip
  * **help**		: crée une boite violette avec une icone help
  * **todo**		: crée une boite cyan avec une icone todo
  * **download**	: crée une boite verte avec une icone download
  * **danger**		: creates a red danger safety note
  * **warning**		: creates an orange warning safety note
  * **caution**		: creates a yellow caution safety note
  * **notice**		: creates a blue notice safety note
  * safety		: creates a green safety note 


==== Marquage ====

  * **hi**		: met le texe en surbrillance
  * **lo**		: met le texte en peu important
  * **em**		: fait ressortir le texte
==== Onglets ====


==== Divers ====

A classer : 

  * **clear**		: similar to clearfloat, should preferably be used with divs, i.e. uppercase <WRAP>s
  * **tabs**		: if wrapped around a list of links, will show those as tabs
  * **hide**		: hides the text per CSS (the text will still appear in the source code, in non-modern browsers and is searchable)
  * **noprint**		: displays text on the screen, but not in print, similar to noprint
  * **onlyprint**	: displays text only in print, but not on the screen
  * **pagebreak**	: forces a new page in printouts (not visible on the screen), similar to pagebreak
  * **nopagebreak**	: tries to avoid a pagebreak in printouts (not visible on the screen)
  * **spoiler**		: shows white text on a white background, only to be revealed by highlighting it; similar to hide	
  * **indent**		: indents the text, could be used instead of tab	
  * **outdent**		: “outdents” the text, could partly be used instead of outdent	
  * **prewrap**		: wraps text inside pre-formatted code blocks, similar to wpre
==== Langage et direction de texte ====

===== Exemples =====

=== Prewrap ===

<WRAP prewrap 250px>
<code>
Inside this code block the words will wrap to a new line although they are all in one line.
</code>
</WRAP>

  <WRAP prewrap 250px>
  <code>
  Inside this code block the words will wrap to a new line although they are all in one line.
  </code>
  </WRAP>

=== Notes ===

<code><WRAP info 220px left>
**Info**
  <WRAP info></WRAP>
</WRAP></code>

<WRAP info 220px left>
**Info**
  <WRAP info></WRAP>
</WRAP>

<WRAP tip 220px left>
**Tip**
  <WRAP tip></WRAP>
</WRAP>


<WRAP important 220px left>
//**Important**//
  <WRAP important></WRAP>
</WRAP>

<WRAP alert 220px left>
//**Alert**//
  <WRAP alert></WRAP>
</WRAP>


<WRAP round help 220px left>
//**Help**//
  <WRAP round help></WRAP>
</WRAP>


<WRAP download 220px left>
//**Download**//
  <WRAP download></WRAP>
</WRAP>


<WRAP todo 220px left>
//**Todo**//
  <WRAP todo></WRAP>
</WRAP>

<WRAP clear></WRAP>


Peut s'utiliser aussi à l'intérieur du texte :
<wrap info>info</wrap>, <wrap help>help</wrap>, <wrap alert>alert</wrap>, <wrap important>important</wrap>, <wrap tip>tip</wrap>, <wrap download>download</wrap>, <wrap todo>todo</wrap> and <wrap round box>round box</wrap> and <wrap danger>danger</wrap>, <wrap warning>warning</wrap>, <wrap caution>caution</wrap>, <wrap notice>notice</wrap>, <wrap safety>safety</wrap>.
  <wrap info>info</wrap>, <wrap help>help</wrap>, ...

=== Safety Notes ===


<WRAP danger 27% left>
//**Danger**//
  <WRAP danger></WRAP>
</WRAP>

<WRAP warning 27% left>
//**Warning**//
  <WRAP warning></WRAP>
</WRAP>

<WRAP caution 27% left>
//**Caution**//
  <WRAP caution></WRAP>
</WRAP>

<WRAP round notice 27% left>
//**Notice**//
  <WRAP round notice></WRAP>
</WRAP>

<WRAP round safety 27% left>
//**Safety**//
  <WRAP round safety></WRAP>
</WRAP>

<WRAP clear></WRAP>

=== Spoiler ===

Here follows a spoiler: <wrap spoiler>Darth Vader is Luke's father.</wrap>

  Here follows a spoiler: <wrap spoiler>Darth Vader is Luke's father.</wrap>

Sélectionner le texte pour pouvoir le lire.

=== Hide ===

The following text is hidden: <wrap hide>John, please revise that sentence.</wrap>

  The following text is hidden: <wrap hide>John, please revise that sentence.</wrap>

:!: Attention : le texte apparait toujours dans le code source, ne pas cacher des informations risquées avec ça !



====== Liens ======

  * https://www.dokuwiki.org/plugin:wrap
  * https://www.dokuwiki.org/_media/plugin:wrap_plugin_example7.png
  * https://wiki.math.ntnu.no/wiki/wrap/example