Dépannage

Premier réflexe

DWA : diagnostiquer l’activation sur ce document affiche la cause précise lorsque l’assistance ne s’active pas :

• le document n’est pas en mode Markdown ;
• dwa.enabled vaut false ;
• le frontmatter contient marp: false ;
• le YAML est invalide ou non fermé ;
• aucune déclaration Marp ni thème n’est présente.

DWA : préparer ce document pour DWA passe le document en Markdown et ajoute marp: true, sans imposer ni remplacer le thème. Le contenu et les autres clés YAML sont conservés. Cette commande ne modifie pas dwa.enabled.

Problèmes fréquents

Les commandes DWA n’apparaissent pas

Vérifiez que l’extension est installée et activée dans la fenêtre, le profil et l’environnement utilisés (WSL et SSH ont leurs propres extensions).

Les suggestions apparaissent, mais pas le rendu attendu

Le CSS est choisi en comparant son @theme au nom déclaré dans le document. Un dwa.themePath prévu pour un autre thème est ignoré ; sont alors recherchés les thèmes enregistrés dans markdown.marp.themes, puis <nom-du-thème>.css et theme.css à proximité. Relancez DWA : choisir le thème CSS pour DWA et Marp.

Un CSS ou un navigateur manquant affecte le rendu, pas les suggestions du langage.

« Navigateur indisponible » dans la barre d’état

Installez Chrome, Chromium ou Edge dans l’environnement qui exécute l’extension (sous WSL : un navigateur Linux), ou renseignez dwa.overflow.browserPath.

« Mesure partielle »

Une image est distante ou introuvable, ou le document n’est pas enregistré. Enregistrez le fichier et utilisez des images locales.

Le callout ne change pas de taille

Il faut : un fichier enregistré, un dossier approuvé, un navigateur local et un thème qui fournit les classes callout-size-50 à callout-size-180. Sinon, un message demande la mise à jour du thème. Un CSS non enregistré suspend la mesure.

Les suggestions Property de Marp ont disparu

C’est voulu : voir Des suggestions sans bruit.

Deux avertissements de débordement identiques

Le diagnostic expérimental de Marp markdown.marp.diagnostics.slideContentOverflow est aussi actif : désactivez l’un des deux contrôles.

Où lire les détails

Sortie → DWA Slides : mesures, export PPTX, installation et vérification des thèmes.