wrap : conteneurs

Ce plugin permet d'envelopper le texte wiki dans des conteneurs (divs ou spans) et de leur donner :

une certaine classe (avec beaucoup de classes prédéfinies utiles)une largeurune langue avec sa direction de texte associéeIl remplace entièrement : class, clearfloat, div_span_shorthand, divalign2, divalign, emphasis, hide, important_paragraf, importanttext, lang, ltr, noprint, pagebreak, side_note, tip, wpre

Il remplace en partie : box, button, color, columns, fontcolor, fontfamily, fontsize2, fontsize, highlight, layout, note, styler, tab, tablewidth, typography

Pré-requis

Installation

Recherchez et installez le plugin wrap à l'aide du gestionnaire d'extensions.

Configuration

Utilisation

Syntaxe

Syntaxe de base

<WRAP classes #id width :language>
"big" content
</WRAP>
**ou**
<block classes #id width :language>
"big" content
</block>
**ou**
<div classes #id width :language>
"big" content
</div>

Un <WRAP> majuscule (ou <block> ou <div>) crée un div et doit être utilisé pour les «grands» conteneurs, les paragraphes, listes, tableaux, etc. environnants.

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

ou

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

ou

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

Un <wrap> en minuscule (ou <inline> ou <span>) crée un span et doit être utilisé pour les «petits» conteneurs, les paragraphes intérieurs, les listes, les tableaux, etc.

Il existe également une syntaxe abrégée (pour les wraps sans contenu) :

<WRAP classes #id /> or <block classes #id /> or <div classes #id />

et

<wrap classes #id /> or <inline classes #id /> or <span classes #id />

Exemples

Le plugin est livré avec une page d'exemple.

Colonnes

Semblable à columns, side_note, styler, tip

columnidentique à gauche dans les langues LTR et identique à droite dans les langues RTLleftidentique à la colonne, vous permettra de faire flotter votre conteneur sur la gaucherightlaissera le conteneur flotter à droitecenterpositionnera le conteneur au centre horizontal de la pagecol2..col5affichera le texte dans plusieurs colonnes déterminées par leur montant (2, 3, 4 ou 5)colsmall, colmedium, collargeaffichera également le texte dans plusieurs colonnes mais déterminé par leur largeur (petite, moyenne ou grande)

Largeurs

halfajuste deux colonnes en une ligne, doit être utilisé par pairesthirdajuste trois ou deux colonnes en une ligne, doit être utilisé en triplets ou avec deux tierstwothirdsajuste deux colonnes d'affilée lorsqu'il est utilisé avec le troisième, un 1/3 de large et un autre 2/3 de largequarterajuste quatre colonnes d'affilée, doit être utilisé en quads

Alignements

Semblable à divalign, columns, styler

leftalignaligne le texte à gaucherightalignaligne le texte à droitecenteraligncentre le textejustifyjustifie le texte

Boîtes et notes

Semblable à box, note, tip

boxcrée une boîte autour du conteneur (utilise les couleurs de style.ini)infocrée une boîte bleue avec une icône d'informationimportantcrée une boîte orange avec une icône importantalertcrée une boîte rouge avec une icône d'alertetipcrée une boîte jaune avec une icône astucehelpcrée une boîte violette avec une icône d'aidetodocrée une boîte cyan avec une icône “à faire”downloadcrée une boîte verte avec une icône de téléchargementroundajoute des coins arrondis à n'importe quel conteneur ayant une couleur d'arrière-plan ou une borduredangercrée une note de sécurité danger rougewarningcrée une note de sécurité d'avertissement orangecautioncrée une note de sécurité d'avertissement jaunenoticecrée une note de sécurité bleuesafetycrée une note de sécurité verte

Marques

Semblable à emphasis, important_paragraf, importanttext

himarque le texte en surbrillancelomarque le texte comme moins significatifemmarque le texte comme particulièrement souligné

Divers

clearsimilaire à clearfloat, doit de préférence être utilisé avec des divs, c'est-à-dire <WRAP> majusculestabssi enroulé autour d'une liste de liens, les affichera sous forme d'ongletshidemasque le texte par CSSnoprintaffiche du texte à l'écran, mais pas en version imprimée, semblable à noprintonlyprintaffiche le texte uniquement sur papier, mais pas à l'écranpagebreakforce une nouvelle page dans les impressions (non visibles à l'écran), semblable à pagebreaknopagebreakessaie d'éviter un saut de page dans les impressions (non visible à l'écran)spoilermontre du texte blanc sur fond blanc, qui ne doit être révélé qu'en le surlignant; similaire à hidebuttonlorsqu'il entoure un lien, lui donne le style d'un boutontablewidthdéfinit la largeur des tables à l'intérieur selon la largeur obtenue par l'habillage, remplace en partie tablewidthindentindente le texte, peut être utilisé à la place de taboutdent«outdente» le texte, pourrait en partie être utilisé à la place de outdentprewrapencapsule le texte dans des blocs de code pré-formatés, semblable à wpre

Largeurs

Vous pouvez définir n'importe quelle largeur valide sur n'importe quel conteneur <WRAP> majuscule: %, px, em, rem, ex, ch, vw, vh, pt, pc, cm, mm, in. Réglez simplement la largeur avant, après ou avec les classes, par ex.

<WRAP someclass 50% anotherclass>...

Tous sauf les pourcentages seront réduits pour avoir la largeur maximale disponible sur les petits écrans.

Vous pouvez également utiliser les mots clés de largeur half, third, twothirds and quarter. Pour fonctionner correctement, ils ont besoin d'un autre wrap autour d'eux. Par exemple.

<WRAP group>
<WRAP half column>...</WRAP>
<WRAP half column>...</WRAP>
</WRAP>

se traduira par deux colonnes côte à côte, qui s'enrouleront les unes sur les autres sur des écrans et des appareils mobiles plus petits.

Sélecteur de barre d'outils

Le sélecteur de la barre d'outils d'édition ajoute les syntaxes les plus courantes.

columnscreates a set of half columnssimple centered boxcreates a standard box (60% wide, centered)info, tip, important, alert, help, download, todo boxcreates specifically themed boxes (also 60% wide, centered)clear floatscreates a <WRAP clear/>especially emphasised, highlighted, less significantcreates the respective marks

Désinstallation

Voir aussi

(en) https://www.dokuwiki.org/plugin:wrap

Basé sur << Wrap Plugin >> par Anika Henke.