Les Styles Wiki permettent à un auteur de modifier la couleur et d'autres attributs du texte du wiki.
Spécifier des styles
Une spécification de style est écrite comme suit
%étendue style=valeur style=valeur ...%
La partie étendue définit ce qui est modifié par le style:
- Pas d'
étendue: tout depuis la spécification du style jusqu'a la fin du paragraphe, de la prochaine spécification de style, ou d'une balise de style vide, selon ce qui se rencontre en premier. item: L'élément de liste qui contient la spécification de style.list: La liste qui contient la spécification de style.p: Le paragraphe qui contient la spécification de style.block: L'élement bloc (paragraphe, section, liste, élement de liste, texte préformaté, ou en-tête) qui contient la spécification de style.
La partie style définit quel aspect est modifié:
color: quelle couleur utiliser pour le texte (CSS).bgcolor: Quelle couleur de fond utiliser (CSS).text-align: Comment aligner le texte (CSS).text-decoration: Comment décorer le texte (souligné, barré etc.) (CSS).font-size: Quelle taille de police utiliser pour le texte (CSS).font-family: Quelle famille de police utiliser pour le texte (CSS).font-weight: Quelle épaisseur de police utiliser pour le texte (CSS).font-style: Quel style de police utiliser pour le texte (CSS).height: La hauteur des images (balise HTML <img>).width: La largeur des images (balise HTML <img>).vspace: Quel espace vertical réserver pour les images (HTML <img>).hspace: Quel espace horizontal réserver pour les images (HTML <img>).align: Quel alignement utiliser pour les images (HTML <img>).target: A quelle fenêtre de destination un lien doit renvoyer (HTML <img>).rel: Quel type de référence pour le lien (HTML <img>).
La partie valeur définit la valeur. Pour les attributs qui sont notés (CSS), ils sont envoyés comme des styles CSS; for pour ceux qui sont marqués (HTML <balise>), ils sont passés comme toutes les balises HTML <balise>.
Styles enregistrés
Il est possible de donner un nom à une spécification de style. Ceci s'écrit comme
%define=nom style=valeur style=valeur ...%
Ceci fait que le nom remplace les associations style=valeur dans les définitions de style.
Styles prédéfinis
Voir Styles Wiki Personnalisés.
Astuces
C'est souvent une bonne idée de mettre les définitions de styles communes dans les pages GroupHeaders? de manière à ce qu'elles puissent être partagées entre les pages du groupe. Ou alors, l'administrateur du wiki peut créer des styles prédéfinis en tant que Configuration Locale -- voir Styles Wiki Personnalisés.
Exemples
Voir aussi Exemples de Styles Wiki.
Dans la pratique, le texte restant sur cette page devrait partir sur la page Exemples de Styles Wiki.
Ce texte est %color=red% rouge, %color=blue% bleu, %% et normal (noir). |
Ce texte est rouge, bleu, et normal (noir). |
Il existe un grand nombre de propriétés de style, empruntées au HTML et aux feuilles de style (CSS). De plus, un auteur peut définir un 'raccourci de style' en utilisant la propriété define=. Par exemple, pour définir un style de %red%, on peut utiliser:
%color=red define=rouge% Ici on trouve du texte %rouge% rouge créé avec un 'raccourci de style'. |
Ici on trouve du texte rouge créé avec un 'raccourci de style'. |
Les raccourcis peuvent être combinés avec d'autres styles, incluant d'autres raccourcis:
%color=red define=rouge% %bgcolor=yellow define=fdjaune% %rouge% Ce texte est rouge, %rouge bgcolor=#ccc% rouge sur fond gris, et %rouge fdjaune% rouge sur fond jaune. |
Ce texte est rouge, rouge sur fond gris, et rouge sur fond jaune. |
Ceci est similaire à ce qui existait dans PmWiki 1.0. PmWiki 2.0 inclut la possibilité d'appliquer les styles à des blocs. Spécifier apply=block dans un style Wiki fera en sorte que ce style s'applique au bloc entier, au lieu de s'appliquer uniquement au texte qui suit:
Ce bloc entier %apply=block bgcolor=yellow% a un fond jaune, même si le style n'apparait qu'au milieu de la ligne. %bgcolor=pink% D'autre style 'en ligne' (non appliqués à des blocs) peuvent apparaître au milieu de la ligne,%% comme auparavant. |
Ce bloc entier a un fond jaune, même si le style n'apparait qu'au milieu de la ligne. D'autre style 'en ligne' (non appliqués à des blocs) peuvent apparaître au milieu de la ligne, comme auparavant. |
Ceci implique qu'il est désormais possible de faire du texte aligné à droite et centré:
%block text-align=right% Le texte de ce paragraphe est aligné à droite. %block text-align=center% Le texte de ce paragraphe est centré. |
Le texte de ce paragraphe est aligné à droite. Le texte de ce paragraphe est centré. |
En fait, PmWiki prédéfinit les raccourcis de styles %right% et %center% aussi vous pouvez écrire ceci plus simplement:
%right% Ceci est aligné à droite. %center% Ceci est centré. |
Ceci est aligné à droite. Ceci est centré. |
Les auteurs peuvent définir leurs propres styles:
%block bgcolor=#fdf define=Pm% %center bgcolor=#dfd border='3px dotted green' define=snoopy% %Pm% Tout texte qui est écrit sur un fond pourpre est un commentaire de [[~Pm]]. %snoopy% Ici un texte de snoopy. |
Tout texte qui est écrit sur un fond pourpre est un commentaire de Pm?. Ici un texte de snoopy. |
Les styles peuvent s'appliquer à pratiquement tout type de bloc:
* %block bgcolor=yellow% Ceci est un item de liste * Ceci est un autre item de liste * Encore un complément de liste # Une nouvelle liste |
|
En particulier, ceci souligne qu'il est maintenant possible d'utiliser les styles de liste prédéfinis %ROMAN%, %roman%, %ALPHA%, and %alpha%. Ce style doit être spécifié dans le premier item de la liste (et nous devons développer une autre syntaxe pour ce genre de liste ordonnée):
# %ROMAN% Niveau supérieur ## %ALPHA% Deuxième niveau ## Deuxième niveau ## Deuxième niveau ### Troisième niveau ### Troisième niveau ## Deuxième niveau ### Troisième niveau #### %alpha% Quatrième niveau ##### %roman% Cinquième niveau ##### Cinquième niveau #### Quatrième niveau # Niveau supérieur # Niveau supérieur |
|
Les styles Wiki peuvent être combinés avec les feuilles de style CSS pour créer des séquences de balises encore plus performantes:
La liste ci-dessous est une liste "soulignée": # %outline% Niveau supérieur # Niveau supérieur ## Deuxième niveau ### Troisième niveau ## Deuxième niveau ## Deuxième niveau ### Troisième niveau #### Quatrième niveau ##### Cinquième niveau Alors que cette liste est juste une liste ordonnée classique: # niveau supérieur ## deuxième niveau ### troisième niveau |
La liste ci-dessous est une liste "soulignée":
Alors que cette liste est juste une liste ordonnée classique:
|
On peut également spécifier l'ouverture d'un lien dans une autre fenêtre grâce à :
%newwin% Tous les liens de cette ligne, comme http://www.pmichaud.com seront ouverts dans une nouvelle fenêtre. |
Tous les liens de cette ligne, comme http://www.pmichaud.com seront ouverts dans une nouvelle fenêtre. |
Enfin, il est possible de contrôler la largeur et la hauteur d'une image dans une page wiki. Ainsi cette balise.
%height=50% http://www.example.com/some.gif
affichera some.gif redimensionné avec une hauteur de 50 pixels.
Définitions des styles
Les auteurs de pages wiki peuvent créer leurs propres définitions dans un document en utilisant l'attribut define. Par exemple, ceci
%define=hotpink color=#ff69b4%
établira la balise %hotpink% comme un raccourci pour %color=#ff69b4% (comme ça). Plusieurs attributs peuvent être utilisés dans une même définition, comme dans
%define=reverse color=white bgcolor=black%
qui permettra à %reverse% de produire reverse video, et %reverse hotpink% est combinaison des deux raccourcis.
C'est souvent une bonne idée de mettre les définitions de styles communes dans l' entête de groupe (cf GroupHeaders en anglais) pour les partager à travers toutes les pages du groupe. L'administrateur du Wiki peut également prédéfinir des styles (voir configuration locale--Administration des styles Wiki)
Styles prédéfinis
Le style %comment%comment...%% peut être utilisé pour inclure des commentaires non visibles. Pour un commentaire "multi-lignes", écrivez quelque chose comme :
%comment% [=
Ceci est un grand bloc
de texte commenté
par la balise %comment% =]
Couleurs
Voir couleurs styles Wiki pour les exemples de couleurs
<< Règles de formatage des textes | Index documentation | ExemplesDeStylesWiki >>
Traduction de PmWiki:WikiStyles révisée en version 2 - page originale sur PmWiki:PmWikiFr.StylesWiki