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).

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'.

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.  

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.

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é.  

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é.

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.

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

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(approve sites) 
   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 PmWiki/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

<< | Index documentation? | >>

Traduction de PmWiki:WikiStyles révisée en version 2 - page originale sur PmWiki:PmWikiFr.StylesWiki