publish-to-pages

Convert the PPTX to HTML using the convert-pptx.py script, which preserves text formatting, images, tables, and slide backgrounds. Then run publish.sh with the output file and a repo name to create the repository, push the content, and enable GitHub Pages automatically.

Use the convert-pdf.py script, which renders each PDF page as a PNG via pdftoppm and embeds the images into an HTML file with keyboard, click, and touch slide navigation. Install poppler-utils first with apt or brew.

Yes. Extract the presentation ID from the Google Slides URL, download it as PPTX using the export endpoint with curl, then convert it with the PPTX conversion script. The presentation must be publicly accessible for the download to succeed.

Files over 20MB or with more than 50 images automatically switch to external assets mode, saving images as separate files in an assets directory. This keeps individual files under GitHub's 100MB limit, and the publish script copies the assets folder alongside the HTML.

GitHub Pages on private repositories requires a Pro, Team, or Enterprise plan. Repos are created public by default; if you pass the private flag without a qualifying plan, Pages enablement will fail though the repo itself is still created.

PPTX conversion requires Python 3 with the python-pptx package installed via pip. PDF conversion requires poppler-utils for the pdftoppm renderer. Publishing requires the GitHub CLI (gh) to be installed and authenticated.