Rédiger avec l’assistance

Créer une slide

Tapez --- après une ligne vide. Si la nouvelle slide est vide, une suggestion en texte fantôme propose :

<!-- _class:  -->

• Tab l’insère, place le curseur après _class: et ouvre le choix du layout.
• Échap masque la suggestion.

Le frontmatter YAML, les blocs de code et les slides déjà remplies ne déclenchent pas cette proposition. Elle utilise les suggestions inline de VS Code (editor.inlineSuggest.enabled).

Choisir les classes, étape par étape

Dans <!-- _class: … -->, tapez une classe ou Ctrl+Espace. La complétion est progressive :

1. d’abord un layout : content, title, chapter, callout, cover, toc ou closing (cover insère title) ;
2. après validation, un espace est ajouté et le menu suivant s’ouvre : les compositions pour content ;
3. puis les options adaptées à la composition, les palettes et les tailles : fit/bg seulement pour les compositions avec image, cols-N pour les colonnes, galeries et timelines compatibles.

Les classes déjà présentes et les combinaisons incompatibles sont filtrées. Chaque suggestion est documentée : sa structure attendue et un exemple.

Survol : placez le pointeur sur une classe pour lire son explication.

Une structure préremplie

Si la slide est vide, choisir le layout insère le Markdown de départ : titre/sous-titre/auteur pour title, numéro et titre pour chapter, liste pour toc, trois groupes pour cols-3, etc.

• Le texte déjà présent n’est jamais remplacé.
• content seul attend une composition ou with-title avant de préremplir.
• Les chemins d’images proposés sont des emplacements à compléter.
• Les seuls commentaires insérés sont les directives Marp et les séparateurs <!-- --> nécessaires entre groupes.

Désactivable avec dwa.autoScaffold.

Les diagnostics

Le panneau Problèmes signale, avec la source DWA :

• les classes inconnues ;
• les combinaisons ambiguës ou incompatibles (deux palettes, deux compositions…) ;
• les titres et légendes manquants quand with-title ou with-legend les attend ;
• la mauvaise structure des images, groupes, tableaux ou listes selon la composition.

Les exemples dans les blocs de code et les commentaires ordinaires ne sont pas interprétés comme des directives.

Corrections rapides

Sur un diagnostic, l’ampoule (Ctrl+.) propose :

• appliquer une correction : le contenu n’est restructuré qu’après ce choix ;
• DWA : copier le layout à remplir : copie dans le presse-papiers la directive et le modèle complet de la slide, même quand aucune correction automatique ne suffit.

Depuis la palette de commandes, pour la slide courante :

• DWA : copier le layout à remplir — même sans diagnostic ;
• DWA : insérer le layout à remplir — si la slide est vide. Si elle contient déjà du texte, préférez la copie pour choisir où coller.

Des suggestions sans bruit

Les suggestions Property de Marp (icône clé à molette) se mélangent à celles de DWA, et VS Code ne permet pas à une extension de masquer individuellement les suggestions d’une autre. À l’ouverture d’un document DWA, l’extension configure donc [markdown].editor.suggest.showProperties: false dans les paramètres du dossier, en conservant vos autres réglages.

• Les directives Marp (theme, paginate, header, backgroundColor…) restent proposées par DWA dans le frontmatter.
• Le filtre nécessite d’avoir ouvert un dossier.
• Pour revenir en arrière : désactiver dwa.cleanSuggestions, puis remettre editor.suggest.showProperties à true dans [markdown].

Option expérimentale : transitions de layout

expérimental désactivée par défaut.

"dwa.experimental.layoutTransitions": true

Sur une slide content, retirer with-title met le titre principal de côté dans un commentaire dwa-reserve:title ; le remettre le restaure. Même principe pour with-legend et le dernier paragraphe. Le commentaire reste dans le fichier mais ne s’affiche ni dans Marp ni dans le PPTX.

Le changement s’applique 900 ms après une directive _class valide, si le contenu n’a pas changé entre-temps. Les cas ambigus (plusieurs titres, plusieurs réserves) laissent le contenu intact. Cette option ne convertit pas les compositions et ne modifie jamais une slide à sa simple ouverture.