Création, édition et analyse de fichiers PPTX
Un fichier .pptx est une archive ZIP contenant des fichiers XML. Choisissez votre approche en fonction de la tâche :
| Tâche | Approche |
|---|---|
| Créer une nouvelle présentation | Écrire un script pptxgenjs — voir les pièges ci-dessous |
| Éditer une présentation existante, ou construire à partir d'un modèle | Décompresser → éditer ppt/slides/slideN.xml → recompresser |
| Lire le contenu | markitdown deck.pptx (un bloc par diapositive sous les marqueurs <!-- Slide number: N -->); grille visuelle : python scripts/thumbnail.py deck.pptx |
Scripts
Les chemins sont relatifs au répertoire de cette compétence. Tout le reste est en Python, Node ou shell.
| Script | Ce qu'il fait |
|---|---|
scripts/thumbnail.py deck.pptx [prefix] | Grille étiquetée de chaque diapositive, pour choisir les mises en page du modèle. .pptx seulement. Passez prefix — par défaut thumbnails, ce qui écrase les grilles de tout autre jeu de diapositives fait dans le même répertoire |
scripts/add_slide.py unpacked/ slide2.xml [--after slideN.xml] | Duplique une diapositive (ou un slideLayoutN.xml) avec toute la gestion du package. Accepte aussi un .pptx directement avec -o out.pptx |
scripts/clean.py unpacked/ | Supprime les diapositives, médias et relations qui ne sont plus référencés. Exécutez après que <p:sldIdLst> est finalisé |
scripts/office/validate.py deck.pptx [--original src.pptx] | Vérifications du schéma, des relations, des types de contenu, des graphiques et des diapositives ; chaque échec nomme son correctif. Passez --original pour toute présentation dérivée d'un modèle — cela établit une base des vérifications de schéma par rapport au modèle, de sorte que ses propres erreurs XSD ne soient pas considérées comme les vôtres |
scripts/office/soffice.py --headless --convert-to pdf deck.pptx | Wrapper pour LibreOffice — soffice seul bloque dans ce sandbox |
Création avec pptxgenjs — pièges
pptxgenjs est préinstallé — n'exécutez pas npm install d'abord ; écrivez le script et faites require('pptxgenjs') directement. Seulement si cette instruction échoue : npm install pptxgenjs. Le modèle connaît l'API ; voici les pièges :
- Définissez
pres.layoutavant d'ajouter des diapositives. Le canevas par défaut estLAYOUT_16x9= 10" × 5,625", pas 13,3" de large. Les coordonnées dépassant le bord sont écrites, pas ajustées — la forme n'est simplement pas sur la diapositive. (LAYOUT_WIDEfait 13,3" × 7,5".) - Couleurs hexadécimales : jamais
#, jamais 8 chiffres.color: "FF0000"."#FF0000"ainsi que l'alpha intégré dans l'hexadécimal ("00000020") corrompent le fichier. Pour la translucidité :transparency: 0-100sur les remplissages et les images,opacity: 0.0-1.0sur les ombres — chacun est ignoré silencieusement sur l'autre. - pptxgenjs modifie les objets d'options sur place (convertit les valeurs en EMU lors de la première utilisation). Ne partagez jamais un objet
shadow/options entre deux appelsadd*— créez un nouvel objet à chaque fois. offsetde l'ombre doit être ≥ 0 — un décalage négatif corrompt le fichier. Pour projeter une ombre vers le haut, utilisezangle: 270avec un décalage positif.letterSpacingest ignoré silencieusement — la bonne option estcharSpacing.- Listes :
bullet: truesur chaque élément, jamais un•littéral (rend des doubles puces). DéfinissezbreakLine: truesur chaque élément du tableau sauf le dernier. Espacez les paragraphes à puces avecparaSpaceAfter, paslineSpacing(gros écarts). - Un
new pptxgen()par fichier de sortie — ne réutilisez jamais une instance. rectRadiusne fonctionne que surROUNDED_RECTANGLE, pas surRECTANGLE.- Les remplissages dégradés ne sont pas pris en charge — utilisez une image dégradée comme arrière-plan à la place.
- Les zones de texte ont un remplissage interne intégré — définissez
margin: 0chaque fois que le texte doit s'aligner avec une forme, une ligne ou une icône à la même position x. - Les notes de l'orateur vont dans
slide.addNotes("...")(texte brut, une fois par diapositive), jamais dans une zone de texte sur la diapositive. - Gardez les graphiques natifs. Utilisez
addChart()pour tout ce que PowerPoint peut graphiquer (passez un tableau de{type, data, options}pour les combinaisons). Pour les fonctionnalités natives de PowerPoint que la bibliothèque n'expose pas (lignes de tendance, barres d'erreur), calculez la série supplémentaire vous-même ou post-traitez le OOXML généré — ne recourez pas à une image rendue. Seuls les types de graphiques pour lesquels PowerPoint n'a pas de forme native (Sankey, réseau, corde) sont insérés en tant qu'images. - Les graphiques par défaut sont nus — pas de titre, pas d'étiquettes de données, palette datée. Définissez
showTitle+title,showValue: true+dataLabelPosition,chartColors: [...]à partir de votre palette, et rendez le cadre silencieux (catAxisLabelColor/valAxisLabelColor,valGridLine: { color, size },catGridLine: { style: "none" },showLegend: falsepour une série unique). - Sur un graphique à barres empilées ou à colonnes empilées,
dataLabelPositiondoit êtrectr,inEndouinBase.outEndcorrompt le fichier. - Une série combinée utilisant
secondaryValAxis/secondaryCatAxisa besoin des deuxvalAxesetcatAxesdans les options du graphique, deux entrées chacun. Sans eux, pptxgenjs écrit des ids d'axe qu'il ne déclare jamais, et PowerPoint rejette ce graphique et signale le fichier comme corrompu. Fournir seulementvalAxesne suffit pas. - Après
writeFile(), exécutezpython scripts/office/validate.py deck.pptx. Il signale les deux défauts de graphique ci-dessus et les défauts de XML de diapositive que PowerPoint refuse, et nomme le correctif pour chacun. Corrigez-les dans votre générateur, pas en éditant manuellement le XML compressé. - Ne réorganisez jamais les enfants de
<p:presentation>. pptxgenjs écrit<p:notesMasterIdLst>juste après<p:sldIdLst>et pointe les deux maîtres vers une seule partie de thème. PowerPoint le lit heureusement — déplacez l'élément et la même présentation devient impossible à ouvrir. - Icônes : rendez
react-iconsen SVG (ReactDOMServer.renderToStaticMarkup), pixellisez avecsharpà ≥256px, et insérez viaaddImage({ data: "image/png;base64," + buf.toString("base64") })— le préfixeimage/png;base64,est obligatoire (react-icons,react,react-dometsharpsont préinstallés —npm install react-icons react react-dom sharpseulement si une instruction require échoue).
Édition de présentations et de modèles existants
Choisissez d'abord les mises en page : python scripts/thumbnail.py template.pptx template-thumbs écrit une grille étiquetée de chaque diapositive et imprime le(s) fichier(s) créé(s) — template-thumbs.jpg, divisé en template-thumbs-N.jpg au-delà de 12 diapositives. Passez toujours ce deuxième argument, nommé d'après la présentation. Par défaut, il s'agit de thumbnails, donc deux présentations miniaturisées dans un même répertoire écrasent silencieusement les grilles l'une de l'autre — les grilles de la première présentation sont tout simplement perdues (analyse du modèle uniquement — le contrôle visuel a besoin des rendus haute résolution de Conversion en images ; n'accepte que .pptx, donc copiez d'abord un .potx sous un nom .pptx). Utilisez-le avec markitdown pour mapper chaque section de contenu sur une diapositive du modèle, et variez les mises en page — ne mettez pas chaque section sur la même diapositive titre-et-puces.
python3 -c "import sys,zipfile; zipfile.ZipFile(sys.argv[1]).extractall('unpacked')" deck.pptx
python scripts/add_slide.py unpacked/ slide2.xml --after slide2.xml # duplique une diapositive (ou slideLayoutN.xml); imprime le chemin de la nouvelle diapositive
# réorganiser / supprimer des diapositives = éditer <p:sldIdLst> dans ppt/presentation.xml
python scripts/clean.py unpacked/ # après les suppressions : supprime les diapositives, médias et relations orphelines
# éditer le contenu de la diapositive dans ppt/slides/slideN.xml
(cd unpacked && rm -f ../out.pptx && zip -Xr ../out.pptx .) # zipper DEPUIS l'intérieur du répertoire ; rm d'abord sinon les parties supprimées survivent
python scripts/office/validate.py out.pptx --original deck.pptx
- Faites tout le travail structurel — ajouter, supprimer, réorganiser — avant d'éditer le contenu d'une diapositive.
add_slide.pycopie un fichier de diapositive textuellement, donc dupliquer après avoir édité clone le contenu édité ; etclean.pysupprime toute diapositive manquante dans<p:sldIdLst>, y compris celle que vous venez d'écrire. - Ne copiez jamais un fichier de diapositive à la main —
add_slide.pyfait tous les enregistrements nécessaires pour une nouvelle diapositive et signale ce qu'il a créé (Created ppt/slides/slide17.xml from slide2.xml). Il fonctionne aussi directement sur un fichier :add_slide.py deck.pptx slide2.xml -o out.pptx— passez-o, sinon il réécrit la présentation d'entrée sur place. Une diapositive dupliquée référence toujours les parties de graphique/SmartArt/objet incorporé de sa source au lieu de les cloner, donc éditer le graphique d'une diapositive modifie celui de l'autre. - Si vous utilisez
python-pptx, trois choses qu'il ne fera pas : dupliquer une diapositive (son seul point d'entrée estadd_slide(layout)), préserver la mise en forme viatext_frame.text = "..."(cela réduit le paragraphe à une seule exécution sans style — utilisezrun.textà la place), ou lire le SVG/EMF de la plupart des éléments artistiques des modèles (add_picturelèveUnidentifiedImageError). - Le format
.ppthérité doit d'abord être converti :python scripts/office/soffice.py --headless --convert-to pptx file.ppt. Les modèles.potxse décompressent et se recompressent à l'identique — conservez l'extension.potxsur la sortie. - Pour réutiliser une icône ou une image de modèle, dupliquez une diapositive ou une mise en page qui la contient déjà.
Lors du remplissage d'un modèle :
- Si vous scriptez une transformation XML, analysez avec
defusedxml.minidom— faire passer OOXML parxml.etree.ElementTreeréécrit les préfixes d'espace de noms et corrompt la présentation. - Les emplacements du modèle ≠ éléments source. Si le modèle montre 4 membres d'équipe et que vous en avez 3, supprimez le groupe entier du 4ème membre (image + zones de texte), pas seulement son texte — puis vérifiez les visuels orphelins lors du contrôle qualité.
- Un
<a:p>par élément de liste — ne concaténez jamais les éléments en un seul paragraphe. Copiez le<a:pPr>frère pour préserver l'espacement, et mettezb="1"sur le<a:rPr>des titres, en-têtes de section et étiquettes en ligne (Status:,Owner:). - Laissez les puces hériter de la mise en page ; n'ajoutez que
<a:buChar>,<a:buAutoNum>(numéroté) ou<a:buNone>pour remplacer — jamais un•littéral dans le texte. - Le texte avec des espaces de début ou de fin a besoin de
xml:space="preserve"sur son<a:t>.
Idées de conception
Ne créez pas de diapositives ennuyeuses. De simples puces sur fond blanc n'impressionneront personne. Considérez les idées de cette liste pour chaque diapositive.
Avant de commencer
- Choisissez une palette de couleurs audacieuse et adaptée au contenu : La palette doit sembler conçue pour CE sujet. Si l'échange de vos couleurs dans une présentation complètement différente "fonctionnait" toujours, vous n'avez pas fait de choix assez spécifiques.
- Domination plutôt qu'égalité : Une couleur doit dominer (60-70% de poids visuel), avec 1-2 tons de soutien et un accent vif. Ne donnez jamais un poids égal à toutes les couleurs.
- Contraste clair/foncé : Arrière-plans sombres pour les diapositives de titre + conclusion, clairs pour le contenu (structure "sandwich"). Ou optez pour le sombre partout pour une sensation premium.
- Adoptez un motif visuel : Choisissez UN élément distinctif et répétez-le — cadres d'image arrondis, icônes dans des cercles colorés. Portez-le sur chaque diapositive. N'utilisez pas de barre de couleur ou de bande d'accentuation comme motif (voir la liste des choses à éviter).
Palettes de couleurs
Choisissez des couleurs qui correspondent à votre sujet — ne vous rabattez pas sur le bleu générique. Utilisez ces palettes comme inspiration :
| Thème | Primaire | Secondaire | Accentuation |
|---|---|---|---|
| Midnight Executive | 1E2761 (marine) | CADCFC (bleu glacial) | FFFFFF (blanc) |
| Forest & Moss | 2C5F2D (forêt) | 97BC62 (mousse) | F5F5F5 (crème) |
| Coral Energy | F96167 (corail) | F9E795 (or) | 2F3C7E (marine) |
| Warm Terracotta | B85042 (terre cuite) | E7E8D1 (sable) | A7BEAE (sauge) |
| Ocean Gradient | 065A82 (bleu profond) | 1C7293 (sarcelle) | 21295C (minuit) |
| Charcoal Minimal | 36454F (charbon) | F2F2F2 (blanc cassé) | 212121 (noir) |
| Teal Trust | 028090 (sarcelle) | 00A896 (écume de mer) | 02C39A (menthe) |
| Berry & Cream | 6D2E46 (baie) | A26769 (rose poussiéreux) | ECE2D0 (crème) |
| Sage Calm | 84B59F (sauge) | 69A297 (eucalyptus) | 50808E (ardoise) |
| Cherry Bold | 990011 (cerise) | FCF6F5 (blanc cassé) | 2F3C7E (marine) |
Pour chaque diapositive
Chaque diapositive a besoin d'un élément visuel — image, graphique, icône ou forme. Les diapositives uniquement textuelles sont oubliables.
Options de mise en page :
- Deux colonnes (texte à gauche, illustration à droite)
- Lignes icône + texte (icône dans un cercle coloré, titre en gras, description en dessous)
- Grille 2x2 ou 2x3 (image d'un côté, grille de blocs de contenu de l'autre)
- Image à moitié débordante (côté gauche ou droit complet) avec superposition de contenu
Affichage des données :
- Chiffres clés en grand (grands nombres 60-72pt avec petites étiquettes en dessous)
- Colonnes de comparaison (avant/après, pour/contre, options côte à côte)
- Chronologie ou processus (étapes numérotées, flèches)
Finition visuelle :
- Icônes dans de petits cercles colorés à côté des en-têtes de section
- Texte d'accentuation en italique pour les statistiques clés ou les slogans
Typographie
Les noms de polices que vous écrivez dans le .pptx sont rendus par PowerPoint de l'utilisateur, pas par cet environnement. Votre contrôle qualité visuel rend via LibreOffice, qui substitue les polices qu'il ne possède pas — et pour certaines polices, le substitut a des largeurs différentes, donc votre aperçu de contrôle qualité peut montrer un débordement de texte (ou un ajustement) que la vraie présentation n'aura pas. Pour garder votre contrôle qualité fiable :
- Polices sûres (rendent à largeur réelle dans le contrôle qualité et sont livrées avec Office) : Arial, Calibri, Cambria, Times New Roman, Courier New, Bookman Old Style, Century Schoolbook. Utilisez-les pour le corps du texte et tout ce qui nécessite un ajustement.
- En-têtes avec personnalité sans risque de contrôle qualité : associez une police serif de la liste sûre pour l'en-tête (Cambria, Bookman Old Style, Century Schoolbook) avec une police sans serif de la liste sûre pour le corps (Calibri ou Arial). Vous obtenez un contraste visuel sans renoncer à des vérifications fiables de débordement.
- Si l'utilisateur demande une police en dehors de la liste sûre (par exemple Georgia ou Trebuchet MS) : utilisez-la là où l'utilisateur l'a demandée, mais dimensionnez ces conteneurs avec un peu de marge (~10%) et ne faites pas confiance à l'ajustement du texte de l'aperçu sur ces éléments — l'aperçu de cette police est approximatif. Si l'utilisateur n'a pas précisé, préférez les polices de la liste sûre pour le corps du texte.
- Polices non fiables pour le contrôle qualité (le substitut a des largeurs différentes — les vérifications de débordement peuvent être erronées) : Georgia, Trebuchet MS, Impact, Arial Black, Garamond, Consolas, Palatino Linotype. La substitution de Calibri Light varie selon l'environnement ; traitez-la comme non fiable pour le contrôle qualité. Acceptable pour les titres/accentuations avec marge ; ne faites pas confiance à l'ajustement du texte de l'aperçu sur ces polices.
- Ne vous rabattez jamais sur Aptos — le défaut d'Office après 2023 n'a pas de substitut compatible métrique ici et est absent des installations Office plus anciennes, donc il n'est fiable des deux côtés.
| Élément | Taille |
|---|---|
| Titre de diapositive | 36-44pt gras |
| En-tête de section | 20-24pt gras |
| Corps du texte | 14-16pt |
| Légendes | 10-12pt atténué |
…
[tronqué pour la traduction]