html2pptx-unicode-path-fix

Copy build inputs to an ASCII-only path to fix html2pptx ENOENT errors.

Updated Mar 4, 2026
One-click install
npx skills add https://github.com/hubeiqiao/skills --skill html2pptx-unicode-path-fix
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: html2pptx-unicode-path-fix
Source: https://github.com/hubeiqiao/skills/tree/main/html2pptx-unicode-path-fix
Command: npx skills add https://github.com/hubeiqiao/skills --skill html2pptx-unicode-path-fix

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

This Skill resolves "ENOENT: no such file or directory" errors that occur when converting HTML to PowerPoint presentations if file paths contain non-ASCII characters.

Core Features & Use Cases

  • Unicode Path Handling: Ensures that PptxGenJS can correctly access image and asset files located in directories with Japanese, Chinese, Korean, or emoji characters.
  • Playwright Compatibility: Addresses issues in Playwright-based HTML-to-PPTX pipelines where browser-encoded paths cause file access failures.
  • Use Case: When your automated presentation generation fails because background images or logos are not found due to a directory name like 日本語資料/, this skill provides the solution.

Quick Start

Apply the html2pptx unicode path fix by copying build inputs to a temporary ASCII-only directory before running the build.

Frequently Asked Questions about html2pptx-unicode-path-fix

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
Why does PptxGenJS throw ENOENT errors when converting HTML to PPTX?

PptxGenJS throws ENOENT errors because it fails to access files when the pipeline processes URL-encoded paths containing non-ASCII characters. The fix involves copying build inputs to a temporary ASCII-only directory before execution.

How do I fix html2pptx failures caused by Unicode directory paths?

To fix html2pptx failures caused by Unicode directory paths, copy your build inputs to a temporary ASCII-only path before running the build. This ensures PptxGenJS can correctly locate and access image and asset files.

Does Playwright work with PptxGenJS for HTML to PPTX conversion?

Playwright works with PptxGenJS for HTML to PPTX conversion, but browser-encoded paths can cause file access failures in directories with non-ASCII characters. This skill addresses those compatibility issues by redirecting inputs to an ASCII-only path.

What is the best way to handle non-ASCII characters in html2pptx pipelines?

The best way to handle non-ASCII characters in html2pptx pipelines is to copy build inputs to a temporary ASCII-only directory before execution. This bypasses URL-encoding failures in PptxGenJS and Playwright.

When do I need a temporary ASCII path for HTML to PPTX conversion?

You need a temporary ASCII path for HTML to PPTX conversion when your automated presentation generation fails to find background images or logos due to directory names containing Japanese, Chinese, Korean, or emoji characters.

Can PptxGenJS access image files in directories with Japanese or emoji characters?

PptxGenJS cannot directly access image files in directories with Japanese or emoji characters due to URL-encoding issues. Applying this unicode path fix ensures correct file access by using a temporary ASCII-only directory.