Débordements et callouts

Pourquoi mesurer le rendu ?

Le thème masque ce qui dépasse (overflow: hidden) : un paragraphe de trop peut disparaître sans que l’aperçu ne l’indique clairement. L’analyse du Markdown ne suffit pas à le prévoir, car tout dépend de la police, de la largeur des colonnes et des retours à la ligne.

L’extension rend donc réellement chaque slide, dans un processus séparé, avec Marp Core, le CSS choisi, vos images et vos polices locales, puis mesure :

• la zone utile de chaque slide ;
• les fragments de texte qui dépassent leur colonne, carte ou cellule.

Les résultats apparaissent dans Problèmes, avec la source DWA rendu. L’ampoule propose d’essayer medium ou small. Le recadrage volontaire d’une image image-full bg n’est pas signalé.

Quand la mesure a-t-elle lieu ?

Après une pause dans la frappe (dwa.overflow.delay, 1 400 ms par défaut), ou à la demande avec DWA : vérifier les débordements. La barre d’état indique la mesure en cours, les débordements, une mesure partielle ou un navigateur indisponible. Les détails sont dans Sortie → DWA Slides.

Le navigateur

Chrome, Chromium ou Edge doit être installé dans l’environnement qui exécute l’extension : en WSL ou en SSH, il faut un navigateur dans cet environnement-là. Si la détection échoue, renseignez dwa.overflow.browserPath. Aucun navigateur n’est téléchargé automatiquement.

Limites

• Le document doit être enregistré pour résoudre les chemins d’images.
• Les ressources distantes ne sont pas téléchargées : images distantes ou manquantes ⇒ mesure partielle.
• Les polices installées influencent le résultat (Montserrat absente ⇒ police de remplacement du thème).
• Le HTML libre est désactivé pour la mesure : extensions Marp tierces et CSS/HTML arbitraire ne font pas partie du contrat DWA.
• Les superpositions d’éléments qui restent dans leur cadre ne sont pas toutes détectées ; les règles de structure complètent la mesure géométrique.
• Désactivé dans les dossiers non approuvés.
• Si le diagnostic expérimental de Marp markdown.marp.diagnostics.slideContentOverflow est actif, désactivez l’un des deux pour éviter les doublons. DWA ne modifie pas ce réglage.

Taille automatique des callouts

Un callout porte une seule phrase, aussi grande que possible. Avec dwa.callout.autoFit (activé par défaut), après une pause de frappe, le navigateur local choisit la plus grande taille qui tient, de 50 à 180 px par pas de 5 px, et l’écrit dans le Markdown sous forme de classe lisible :

<!-- _class: callout callout-size-105 -->

# Une idée à retenir

Trois tailles pour trois longueurs de texte. Tailles choisies à la main pour l’illustration.

• Aucune écriture CSS : le thème fournit les 27 classes callout-size-50 à callout-size-180. Aucun identifiant par slide, aucun fichier généré.
• La mesure garde 24 px de marge intérieure. Sans classe de taille : 108 px.
• Aperçu, PDF et PPTX reprennent la taille enregistrée (convertie en points pour PowerPoint, dont les métriques peuvent différer légèrement).
• Copier, déplacer ou renommer une présentation conserve les tailles.
• Si même 50 px ne suffisent pas, le diagnostic de débordement reste là.

Conditions : fichier enregistré, dossier approuvé, navigateur local. Le calcul fonctionne même si les diagnostics de débordement sont désactivés. Une mesure est ignorée si le texte ou le thème a changé entre-temps.

Pour choisir la taille vous-même, désactivez dwa.callout.autoFit : les tailles sont alors proposées dans l’autocomplétion après callout.

Ancienne méthode

Les versions précédentes généraient des identifiants et des styles dans le Markdown. Ils sont migrés vers les classes callout-size-N au prochain calcul réussi ; les styles manuels et les exemples de code sont conservés.