%color=navy define=bleufoncé% 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.

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:

Les raccourcis peuvent être combinés avec d'autres styles, incluant d'autres raccourcis:

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:

Ceci implique qu'il est désormais possible de faire du texte aligné à droite et centré:

En fait, PmWiki prédéfinit les raccourcis de styles %right% et %center% aussi vous pouvez écrire ceci plus simplement:

Les auteurs peuvent définir leurs propres styles:

Les styles peuvent s'appliquer à pratiquement tout type de bloc:

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

Les styles Wiki peuvent être combinés avec les feuilles de style CSS pour créer des séquences de balises encore plus performantes:

On peut également spécifier l'ouverture d'un lien dans une autre fenêtre grâce à :

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

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

° Page originale sur PmWikiFr.StylesWiki - Backlinks
Dernières modifications:
PmWikiFr.StylesWiki: March 04, 2006, at 01:22 PM