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:

La partie style définit quel aspect est modifié:

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 Group Headers 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
  • Ceci est un item de liste
  • Ceci est un autre item de liste
  • Encore un complément de liste
  1. 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
  1. Niveau supérieur
    1. Deuxième niveau
    2. Deuxième niveau
    3. Deuxième niveau
      1. Troisième niveau
      2. Troisième niveau
    4. Deuxième niveau
      1. Troisième niveau
        1. Quatrième niveau
          1. Cinquième niveau
          2. Cinquième niveau
        2. Quatrième niveau
  2. Niveau supérieur
  3. 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”:

  1. Niveau supérieur
  2. Niveau supérieur
    1. Deuxième niveau
      1. Troisième niveau
    2. Deuxième niveau
    3. Deuxième niveau
      1. Troisième niveau
        1. Quatrième niveau
          1. Cinquième niveau

Alors que cette liste est juste une liste ordonnée classique:

  1. niveau supérieur
    1. deuxième niveau
      1. 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 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 pour les partager à travers toutes les pages du groupe. L’administrateur du Wiki peut également prédéfinir des styles (voir Configuration locale)

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 des styles Wiki pour les exemples de couleurs


« Tableaux évolués | Index documentation | Exemples de Styles Wiki »


. Traduction de PmWiki.WikiStyles Page originale sur PmWikiFr.WikiStyles - Référencé par
Dernières modifications:
PmWikiFr.WikiStyles: 13 avril 2006 à 11h13
PmWiki.WikiStyles: 21 septembre 2006 à 07h55

Éditer page - Historique - Imprimable - Changements récents - Aide - RechercheWiki
Page last modified on 13 avril 2006 à 11h13