Les permutations en pratique

Les permutations mélangent. Les énumérations choisissent. L’essentiel de la vraie variété d’un template bien écrit vient des permutations — pas de l’empilement de synonymes. Ce guide couvre la syntaxe, les règles de séparateur et le motif que presque tout le monde rate : les listes sérielles dans les titres et les intertitres.

Permutation simple

[a|b|c]

Par défaut :

• tous les éléments sont inclus ;
• l’ordre est mélangé à chaque rendu ;
• le séparateur est une simple espace.

Exemples de sortie : a b c, c a b, b c a.

Raccourci à séparateur unique

Pour définir le séparateur (et lastsep) d’un coup :

[< and >a|b|c]

Sorties possibles : a and b and c, c and a and b. Le raccourci attribue la même chaîne à sep et à lastsep : toutes les jonctions se ressemblent.

Configuration complète

La forme détaillée donne le contrôle total :

[<minsize=2;maxsize=4;sep=", ";lastsep=" and ">a|b|c|d|e]

Règles :

• minsize — nombre minimal d’éléments à produire ;
• maxsize — nombre maximal d’éléments à produire ;
• sep — joint tous les éléments sauf la dernière paire ;
• lastsep — joint les deux derniers éléments (pour un « A, B and C » naturel).

Omettez l’une des tailles et l’autre se complète d’elle-même :

• seul minsize défini → maxsize devient « tous les disponibles » ;
• seul maxsize défini → minsize devient 1 ;
• les deux supérieurs au nombre d’éléments → bornés au total ;
• le moteur ne peut pas choisir zéro élément. Pour « peut-être aucune liste », enveloppez la permutation dans une branche vide (voir plus bas).

Séparateurs par élément

S’il vous faut plus fin qu’un sep/lastsep global, un élément peut porter son propre séparateur :

[<, >Visa|Mastercard < and >|Skrill]

Ici :

• le séparateur global est ", " ;
• l’élément qui suit Mastercard porte son séparateur local " and ".

Les séparateurs par élément sont rares, mais utiles quand un emplacement précis demande un autre connecteur.

Espacement automatique des séparateurs

Les séparateurs formés d’un mot reçoivent automatiquement une espace de chaque côté :

[<and>a|b|c]

se comporte comme :

a and b and c

Les séparateurs de ponctuation, eux, ne sont pas espacés automatiquement :

[<,>a|b|c]

produit :

a,b,c

Si vous voulez une espace après la virgule, écrivez-la explicitement : [<, >a|b|c].

Listes optionnelles

Comme une permutation ne peut pas produire zéro élément, on rend une liste « peut-être absente » en enveloppant toute la permutation dans une branche d’énumération vide :

{|[<minsize=2;maxsize=3;sep=", ";lastsep=" and ">Postgres|Redis|Kafka|MongoDB]}

Sorties possibles : Postgres and Redis, Kafka, Postgres and Redis, ou une chaîne vide. Pensez aux espaces alentour — gardez l’espace à l’intérieur de la branche quand la liste peut disparaître.

Listes sérielles dans les titres, descriptions et intertitres

C’est le motif que presque tout le monde rate. Les titres et les intertitres H2/H3 promettent souvent plusieurs thèmes parallèles :

Benefits, Integrations, and How to Get Started

Ce n’est pas une chaîne figée — c’est une liste de trois blocs d’accroche parallèles. Reconnaissez le motif et écrivez-le en permutation :

[<minsize=3;maxsize=3;sep=", ";lastsep=", and ">Benefits|Integrations|How to Get Started]

Bon, dans un cadre d’intertitre avec un emplacement de marque :

%product_name%: [<minsize=3;maxsize=3;sep=", ";lastsep=", and ">Benefits|Integrations|How to Get Started]

Mauvais :

%product_name%: {Benefits, Integrations, and How to Get Started|A Complete Guide for Teams}

Pourquoi la seconde forme est plus faible :

• elle traite une liste structurée comme une chaîne figée ;
• elle perd le motif de séparateur que le moteur gère déjà ;
• elle pousse le modèle vers l’alternance de chaînes entières plutôt que vers une structure réutilisable ;
• elle produit une poignée de variantes là où une permutation en produirait des dizaines.

Utilisez le motif de liste sérielle pour :

• les titres qui énumèrent trois promesses ou plus ;
• les méta-descriptions qui nomment plusieurs blocs de l’article ;
• les intertitres H1/H2/H3 qui listent des thèmes de section parallèles.

Ne l’utilisez pas quand la séquence est une procédure et doit rester dans l’ordre :

Create an account, verify email, and make a deposit

C’est une suite d’étapes, pas une liste d’accroche librement permutable.

La casse des intertitres est manuelle

La règle habituelle du corps de texte veut que les éléments d’une permutation commencent en minuscule, parce que le post-traitement met les débuts de phrase en majuscule.

Cette règle ne s’applique pas aux intertitres sériels de style titre. Chaque élément doit déjà être écrit dans sa casse d’affichage :

[<minsize=3;maxsize=3;sep=", ";lastsep=", and ">Benefits|Integrations|How to Get Started]

et non :

[<minsize=3;maxsize=3;sep=", ";lastsep=", and ">benefits|integrations|how to get started]

Le post-traitement ne convertira pas pour vous une liste d’accroche séparée par des virgules en casse de titre.

Erreurs fréquentes avec les permutations

Checklist des permutations

• Toute liste de 3+ éléments est une permutation, pas une chaîne figée.
• Les listes sérielles des titres et intertitres utilisent des permutations avec sep/lastsep explicites.
• Les listes optionnelles sont enveloppées dans {|[...]}, et non tentées avec minsize=0.
• Les éléments ne se terminent pas par une ponctuation que le séparateur fournit déjà.
• Les permutations d’intertitre sont écrites dans leur casse d’affichage.
• Les permutations de corps de texte commencent en minuscule quand le post-traitement capitalise.
• Tous les éléments d’une permutation sont grammaticalement parallèles.

La structure en place, il reste un dernier passage : la grammaire, avec la synonymisation sans casser la grammaireEN.

Continuer la série