fast-pptx v1.0.8
This release adds Docker support, making it easy to run fast-pptx without installing dependencies locally. The Docker image includes all required tools and is configured to run as a non-root user with proper file permissions.
Highlights
Docker Support
- Added
Dockerfileto createpstothard/fast-pptxDocker image - Image includes all dependencies: pandoc, Graphviz, ImageMagick, poppler, Python 3, Node.js, Playwright with Chromium, mermaid-cli, csv2md, and svgexport
- Configured to run as non-root user with
-u "$(id -u)":"$(id -g)" - Fixed script permissions with
chmod -R 755for all scripts - Created Python symlink (
python→python3) for Debian compatibility - Set
PLAYWRIGHT_BROWSERS_PATHto fixed location with proper read permissions - Added
--no-sandboxflags for Chrome/Chromium in Docker environment - Users can mount current directory and process files without local installations
Docker Usage Examples Added to README
- Added "Using the fast-pptx Docker image" section to README
- Placed Docker instructions early in README for easy discovery
- Follows Docker best practices with relative paths instead of absolute
/data/paths - Includes examples for running with sample input and custom directories
- Shows how to enable verbose output with
-vflag
Suppress ImageMagick Warnings
- Added
-quietflag to ImageMagickconvertandmagickcommands - Eliminates harmless "invalid profile length" PNG metadata warnings
- Cleaner output when processing images
Configuration Files
- Added
scripts/puppeteer-config.jsonfor mermaid-cli sandbox configuration - Updated
fast-pptx.shto pass puppeteer config tommdccommand - Updated
scripts/capture-site.mjsto launch Chromium with--no-sandboxflags
Repository Updates
- Added
sample_output_dockerto.gitignore - Updated README with Docker quick start section
- Updated deploy README with Docker build, test, and publish instructions
Docker Usage
Pull the image:
docker pull pstothard/fast-pptxRun with your own input directory:
docker run --rm \
-v "$(pwd)":/data \
-u "$(id -u)":"$(id -g)" \
-w /data \
pstothard/fast-pptx -i input -o outputView all options:
docker run --rm pstothard/fast-pptx --helpRequirements
Using Docker (Recommended)
- Docker
Local Installation
- pandoc
- Graphviz
- poppler
- ImageMagick
- Node.js with Playwright (
npm install --prefix scripts && npx --prefix scripts playwright install chromium) - Python 3
csv2md,mermaid-cli, andsvgexport
Documentation
See the project README.md for installation, Docker usage, supported input types, output structure, and complete workflow documentation.