@mostajs/doc-driver-pandoc

Auteur : Dr Hamid MADANI [email protected] Licence : AGPL-3.0-or-later · Niveau : N2 · Sans build

Driver PPTX (diaporama PowerPoint) pour @mostajs/doc-export via pandoc. pandoc consomme directement le Markdown source (--slide-level=2) — reprise de la voie PPTX de md2View. Implémente le contrat RenderDriver (toPptx(markdown, { out })), sans dépendance @mostajs ; pandoc est une dépendance système.

Un PPTX est un livrable éditable dans PowerPoint/LibreOffice — complémentaire du PDF. Le thème visuel PPTX ne vient pas du CSS (palette) mais d'un gabarit --reference-doc optionnel.

Install

npm i @mostajs/doc-export @mostajs/doc-driver-pandoc
sudo apt install pandoc

Usage

import { createDocExporter } from '@mostajs/doc-export'
import { createPandocPptxDriver } from '@mostajs/doc-driver-pandoc'

const doc = createDocExporter({
  drivers: { pptx: createPandocPptxDriver({ referenceDoc: './charte.pptx' /* optionnel */ }) },
})

// PPTX est rendu par pandoc DEPUIS le Markdown → aucun port `markdown` requis pour ce format.
await doc.render({ source, format: 'pptx', out: 'presentation.pptx' })

API

createPandocPptxDriver({ pandoc?, run?, exists?, slideLevel?, referenceDoc? }) -> { toPptx(markdown, { out? }) -> Uint8Array }

• slideLevel : niveau de titre qui débute une diapo (défaut 2, comme md2View).
• referenceDoc : gabarit PPTX (charte) — sinon PPTX_REF env.
• run : injectable (execFile par défaut) → tests sans pandoc.
• out fourni → PPTX conservé ; sinon fichier temporaire nettoyé.

Notes

• Commande : pandoc <tmp.md> -f markdown+autolink_bare_uris -t pptx --slide-level=2 [--reference-doc …] -o <out>.
• Pour le PDF, préférer les drivers Chromium (-electron / -chrome) ou WeasyPrint : pandoc→PDF demande LaTeX/Typst (voir l'état de l'art de doc-export).

Tests

npm test   # `run` injecté (faux pandoc) — aucun pandoc requis