Grammaire d’une slide

Le langage DWA Core v1 repose sur des classes Marp. Le Markdown définit le contenu, les classes choisissent sa disposition, et le thème fournit les styles et les fonds graphiques. Aucun préprocesseur n’est nécessaire.

Source de référence

Cette section reprend et illustre le guide du langage du dépôt (docs/language/langage.md), qui reste la référence du vocabulaire. La liste des classes est générée directement depuis le catalogue utilisé par l’extension.

La directive

<!-- _class: layout [composition] [paramètres] [options] -->

Les crochets signalent ce qui est facultatif : ne les écrivez pas. Les classes sont séparées par des espaces, pas par des virgules.

<!-- _class: content image-text-80 with-title with-legend fit color-2 small branded -->

Élément	Famille	Signification
content	Layout	Layout principal de contenu
image-text-80	Composition	Image à gauche, 80 % de la largeur utile
with-title	Option	Emplacement dédié au titre de slide
with-legend	Option	Emplacement dédié à la légende
fit	Ajustement	Image entière, sans recadrage
color-2	Palette	Deuxième palette
small	Taille	Typographie réduite
branded	Option	Signature DWA en haut à droite

Les règles

1. Un seul layout par slide : title, toc, chapter, callout, content ou closing.
2. Au plus une composition (cols-N, image-text, gallery, timeline…). Exception : cols-N sert aussi de paramètre à gallery et timeline.
3. Une seule palette (color-1 à color-9), une seule taille (medium ou small), un seul ajustement (fit ou bg).
4. L’ordre des mots n’a pas d’effet. L’ordre proposé est une convention de lecture : layout, composition, paramètres, options.

_class ou class ?

Le préfixe _ limite la directive à la slide courante : c’est l’usage normal, slide par slide. La directive persistante class (sans _) s’applique aussi aux slides suivantes ; l’extension la comprend pour les diagnostics et les suggestions, mais ne génère la structure automatiquement que sur _class.

Format et dimensions du thème DWA

• Format 16:9, 1280 × 720 pixels.
• Marges de 64 pixels en haut et en bas, 72 pixels sur les côtés.
• Police Montserrat si elle est installée, Arial sinon.
• Les quinze fonds graphiques sont intégrés au CSS : aucun fichier séparé.

Un exemple complet

<!-- _class: content cols-3 cards with-title small color-4 -->

# Trois piliers

> ## Contenu
>
> Écrit en Markdown, relu comme du texte.

<!-- -->

> ## Langage
>
> Quelques classes pour choisir la mise en page.

<!-- -->

> ## Thème
>
> La charte, définie une fois pour toutes.

Plan de cette section

Page	Ce que vous y trouverez
Layouts principaux	title, toc, chapter, callout, content, closing
Colonnes et cartes	cols-2 à cols-6, groupes >, cards
Images et texte	image-text-N, text-image-N, image-fit, image-full, fit, bg
Galeries	gallery, gallery-bento
Timelines et graphique large	timeline, timeline-vertical, chart-wide
Titre, légende, taille, marque	with-title, with-legend, medium, small, branded
Palettes et fonds	color-1 à color-9, fonds automatiques
Combinaisons et limites	Ce qui est prévu, ambigu ou incompatible