FOLIO - POWERPOINT PDF PREVIEWS

The browser can preview modern .pptx and .ppsx files directly. For a faithful
static rendering, or for older .ppt files, create PDF copies with this helper.
The helper requires Windows and an installed desktop copy of Microsoft
PowerPoint. It has not been run on Windows in this build environment.

HOW TO USE

1. Close PowerPoint. This avoids sharing the application you are editing in.
2. Double-click Launch-Convert.cmd and choose your presentation folder.
3. Wait for the conversion summary. The first run may take a while.
4. In Folio, choose the original folder again. Include its subfolders so Folio
   can find the new previews in Folio-PDF-Previews.

You can also drag a folder onto Launch-Convert.cmd, or run:

  powershell.exe -NoProfile -STA -File .\Convert-PowerPoint.ps1 -SourceFolder "C:\Teaching"

To choose a different preview location, add:

  -OutputFolder "C:\Teaching-previews"

If your output folder is outside the original folder, add the preview folder
to Folio as well so its PDFs are available.

WHAT IT DOES

- Finds .ppt, .pptx and .ppsx files recursively, without following folder links.
- Creates previews under Folio-PDF-Previews, keeping the original subfolders.
- Lesson.pptx becomes Folio-PDF-Previews\Lesson.pptx.pdf. The .pptx part is kept
  so a pre-existing Lesson.pdf cannot be confused with a generated preview.
- Opens presentations read-only with macros disabled and never saves originals.
- Includes hidden slides, as well as normal slides, in the PDF preview.
- Reuses previews when the source path, size and modification time are unchanged.
- Keeps small .folio.json cache records beside the preview PDFs.
- Reports failures and continues with other presentations.
- Leaves existing PDFs without matching Folio cache metadata untouched.
- Never terminates an existing PowerPoint process. If you open another
  presentation during conversion, the helper leaves PowerPoint running.

NOTES

The launcher respects your existing PowerShell execution policy. On a managed
computer, if scripts are blocked, ask your IT team or use PowerPoint's own PDF
export instead. This helper does not change the execution policy.

Password-protected presentations, Protected View and rights-managed files may
need to be opened or exported manually in PowerPoint. Application security
settings are not bypassed. Font availability can still affect rendering.

A PDF is a static slide preview: animations, transitions and embedded video
playback are not included. Browser .pptx/.ppsx previews are approximate; use
these PDF copies when exact placement matters, and for annotation or merging.
The quick browser preview limits files to 200 MB and applies ZIP resource
limits, so particularly large presentations may also need PDF conversion.

You may delete the Folio-PDF-Previews folder to remove the generated cache.
Run the helper again to rebuild it. Do not delete your source presentations.

REFERENCE

https://learn.microsoft.com/en-us/office/vba/api/powerpoint.presentation.exportasfixedformat
https://learn.microsoft.com/en-us/office/vba/api/powerpoint.application.automationsecurity
