{{tag>Logiciel}}

====== extlist : syntaxe étendue pour les listes ======

Étend le style des listes dans DokuWiki ; items multilignes, nombre arbitraire d'items numérotés, etc.
===== Pré-requis =====

===== Installation =====

Recherchez et installez le plug-in à l'aide du gestionnaire d'extensions.
===== Configuration =====

Vous pouvez spécifier une classe CSS par défaut supplémentaire pour les listes dl/ol/ul.

^ Clé de configuration  ^ Description                                                                    ^
| dl_class              | nom de classe CSS pour le bloc de liste de description (par défaut : aucun)    |
| ol_class              | nom de classe CSS pour le bloc de liste numérotée (par défaut : hiérarchique)  |
| ul_class              | nom de classe CSS pour le bloc de liste non ordonnée (par défaut : carré)      |
===== Utilisation =====

Ce plugin étend la syntaxe des listes de DokuWiki pour permettre :
  - les listes de description html5, ainsi que les listes ordonnées/non ordonnées
  - commencer une liste ordonnée à n'importe quel nnuméro et donner n'importe quels numéros aux items
  - diviser un élément long en plusieurs lignes indentées d'au moins deux espaces
  - définir un attribut de classe CSS pour chaque bloc de liste de la page

==== Syntaxe ====

**Liste numérotée** (Syntaxe standard de DokuWiki) :
<WRAP center round box 60%>
<code - >
  - item 1
</code>
  - item 1
</WRAP>

**Liste à puce** (Syntaxe standard de DokuWiki) :
<WRAP center round box 60%>
<code - >
  * item
</code>
  * item
</WRAP>

**Liste de description** (largeur de colonne compactée/réduite) :
<WRAP center round box 60%>
<code - >
  ; item à décrire
  : description
</code>
  ; item à décrire
  : description
</WRAP>

**Liste de description** (largeur de colonne NON réduite) :
<WRAP center round box 60%>
<code - >
  ;; item à décrire
  : description
</code>
  ;; item à décrire
  : description
</WRAP>

Les listes peuvent être imbriquées en les indentant davantage, tout comme dans la syntaxe standard de DokuWiki

==== Exemples/Utilisation ====

??? items de liste sous forme de lignes de texte consécutives indentées
!!! Les lignes indentées juste après un élément de liste sont concaténées avec l'élément de liste précédent.
<code - >
  * Lorem ipsum dolor sit amet, consectetur 
    adipiscing elit, sed do eiusmod tempor 
    incididunt ut labore et dolore magna aliqua.</code>

  * Lorem ipsum dolor sit amet, consectetur
    adipiscing elit, sed do eiusmod tempor 
    incididunt ut labore et dolore magna aliqua.

??? Faire en sorte que la liste numérotée commence par un numéro différent de 1
!!! Faire commencer la liste numérotée par le nombre réel suivi d'un point et d'un espace (". ") :
<code - >
  100. commencer à 100
  105. sauter 101 à 104
  - continuer les numéros</code>

  100. commencer à 100
  105. sauter 101 à 104
  - continuer les numéros

??? classe CSS supplémentaire pour chaque bloc de liste
!!! Vous pouvez modifier/écraser la classe CSS à appliquer pour les blocs de liste définis dans les paramètres de configuration du plugin.
<code - >
  ~~ul:squre~~
  * Square marker
    ~~ul:circle~~
    * Circle marker
      ~~ul:dash~~
      * Dash marker 
        ~~ul:disc~~
        * Disc marker 
 
  ~~ol:hierarchical~~
  - marked 1. 
    - marked 1.1
      - marked 1.1.1
</code>

??? Liste de descriptions
!!! Les listes peuvent être imbriquées dans des listes, comme dans la syntaxe standard de DokuWiki.

^ balisage  ^ utilisation                                                                   ^ html                         ^
| ;         | terme de liste de description, largeur de colonne compactée                   | <dt class="compact">..</dt>  |
| ;;        | terme de la liste de description, la largeur de la colonne n'est PAS réduite  | <dt>..</dt>                  |
| :         | description liste description                                                 | <dd>..</dd>                  |

<code - >
  ~~dl:generic~~
  ;; Term 1 phrase wich is too long to compacted column
  : Description 1 of term 1
  : Description 2 of term 1
    * list item1
    * list item2 
  ; Term 2-1
  ; Term 2-2
  ; Term 2-3
  : Description of term 2 series
  : Tips: put **''%%<WRAP clear/>%%''** to expand column height. <WRAP clear/>
  ; Term 3
  : Description of term 3
</code>

Remarque : <WRAP clear/> est une syntaxe abrégée du plug-in Wrap.
===== Désinstallation =====

===== Problèmes connus =====

===== Voir aussi =====

  * **(en)** [[https://www.dokuwiki.org/plugin:extlist]]

----
//Basé sur << [[https://www.dokuwiki.org/plugin:extlist|Extended List Syntax Plugin]] >> par Satoshi Sahara.//