К основному содержанию
скилл CX Codex

onepage-pdf — скилл для Claude Code: что делает и как установить

Скилл onepage-pdf рендерит HTML-документ в один непрерывный высокий PDF-лист без разрывов страниц через headless Chrome и обрезает пустоту с помощью PyMuPDF.

MIT 214 установок ★ 17 обновлён 2026-10-25

Установить в Claude Code · Через Skills CLI (Vercel) Все способы и платформы ↓
npx skills add AceDataCloud/Skills --skill onepage-pdf -a claude-code
Открыть на GitHub

Что делает onepage-pdf

Скилл преобразует локальные HTML-страницы, отчёты и коммерческие предложения в один длинный сплошной PDF без разбивки на страницы. При экспорте сохраняются фоны, десктопная вёрстка и выделяемый текст. Высота не угадывается заранее: headless Chrome отрисовывает страницу на увеличенном холсте, а PyMuPDF замеряет фактический контент и подрезает MediaBox и CropBox.

Для работы нужны Python 3.10+ с библиотекой pymupdf и установленный Chrome или Edge. Подключение к сети или API-токены не требуются, скрипт работает строго локально.

Запуск выполняется скриптом scripts/onepage_pdf.py. Он принимает ширину --width (значение лучше округлять до 8 пикселей во избежание фантомных страниц), файл стилей --extra-css для переопределения медиа-запросов и анимаций, а также флаги скрытия данных --replace и --forbid. Файлы высотой более 14400pt ломают просмотрщик Acrobat, хотя браузеры открывают их штатно.

Какие задачи решает

  • сохранить длинный HTML-отчёт в единый PDF без разрыва страниц
  • обрезать пустые поля снизу точно по границе контента
  • замаскировать конфиденциальные строки с проверкой текстового слоя
  • зафиксировать десктопную вёрстку при выводе на печать

Примеры запросов агенту

  • Сконвертируй report.html в один длинный PDF без разбивки на страницы с шириной 1280px
  • Экспортируй proposal.html в непрерывный PDF и примени стили из fixes.css
  • Сделай одностраничный PDF из index.html и скрой персональные данные через replace.json

Как установить onepage-pdf

1Через Skills CLI (Vercel)

npx skills add AceDataCloud/Skills --skill onepage-pdf -a claude-code

2Вручную: положить файлы

~/.claude/skills/onepage-pdf/SKILL.md

Папка скилла целиком; для одного проекта — .claude/skills/onepage-pdf/

По шагам, с командами для каждой платформы: Как установить скилл в Claude Code: пять способов

Вопросы об onepage-pdf

Как установить onepage-pdf в Claude Code?

Выполните команду npx skills add AceDataCloud/Skills --skill onepage-pdf -a claude-code в терминале.

Что делает скилл onepage-pdf?

Он переводит вёрстку HTML в один непрерывный PDF-документ без постраничных разрезов с сохранением фонов и текстового слоя.

Что требуется для работы скрипта?

Необходим Python 3.10 или новее с пакетом pymupdf, а также установленный локально браузер Google Chrome или Microsoft Edge.

Исходный текст

SKILL.md · MIT
---
name: onepage-pdf
description: Convert an HTML page into a single continuous-page PDF (one tall page, no pagination breaks), preserving desktop layout, backgrounds and selectable text. Use when the user asks to turn an HTML file/report/proposal into a "single-page PDF", "long PDF", "不分页 PDF", "单页 PDF", "长图式 PDF", or complains that an HTML-to-PDF export breaks into pages or cuts content. Supports optional string redaction with leak verification.
license: MIT
metadata:
  author: xntj-ai
  version: "1.0"
  source: https://github.com/xntj-ai/onepage-pdf
compatibility: No API token required. Requires Python 3.10+ with `pymupdf` (`pip install pymupdf`) and a local Chrome or Edge browser. Runs fully offline against local HTML — does not call api.acedata.cloud.
---

# onepage-pdf

> Vendored from [github.com/xntj-ai/onepage-pdf](https://github.com/xntj-ai/onepage-pdf)
> by 张拼拼 · XNTJ, under the MIT License. See [LICENSE](LICENSE).

Render HTML to one tall PDF page via headless Chrome, then crop the page to the
real content height with PyMuPDF. Height is never predicted (print layout is
not screen layout); it is measured after rendering, which is exact.

**Requires:** Python with `pymupdf`, plus a local Chrome or Edge. No API token.

## Workflow

### 1. Inspect the source HTML first

Read the HTML and check four things; they decide whether `--extra-css` is needed:

1. **Responsive breakpoints.** Print media queries evaluate against the default
   paper width (~741px), NOT the `@page` size. Any `@media (max-width: N)` with
   N ≥ 741 will fire during print and collapse the desktop layout. For each such
   rule, write an override locking the desktop value with `!important`
   (e.g. `.grid{grid-template-columns:repeat(3,1fr)!important}`).
2. **Glassmorphism.** `backdrop-filter` blur is silently dropped in PDF output.
   If glass elements sit on busy backgrounds, add a print fallback:
   `.glass{backdrop-filter:none!important;background:rgba(255,255,255,.88)!important}`.
3. **Scroll-reveal animations.** Common class patterns (`fade*`, `reveal*`,
   `animate*`, `aos`) are forced visible automatically. Anything else that
   starts at `opacity:0` needs an explicit `opacity:1!important` override.
4. **vh/vw sizing.** Viewport units resolve against the page area in print and
   drift ~1%; a `min-height:100vh` hero becomes ~187in tall on the bedrock
   page. Override such rules with fixed px values.

Put all overrides in one CSS file and pass it via `--extra-css`.

### 2. Convert

Paths below are relative to this skill directory.

```bash
python scripts/onepage_pdf.py input.html -o output.pdf --width 1280 \
    [--extra-css fixes.css] [--replace subs.json --forbid words.txt]
```

- `--width`: match the design width of the page (snapped to 8px; non-8px
  page sizes hit MediaBox rounding bugs that spawn phantom pages).
- `--replace`: JSON `[["old","new"], ...]`, applied in order — put longer /
  more specific strings first. Use for redaction before publishing.
- `--forbid`: one word per line; the script aborts if any survives in the
  HTML or in the final PDF text layer. Always pair with `--replace`.
- `--crop pixel`: switch to raster row-scanning if the vector crop misjudges
  (e.g. a decorative element painted taller than the real content).

The script self-handles: oversized-bedrock rendering with auto-retry on
overflow, content cropping (MediaBox + CropBox rewritten identically for
viewer compatibility), CJK-safe output paths, single-page assertion.

A bundled example lives in `examples/` — try it end to end:

```bash
python scripts/onepage_pdf.py examples/demo.html -o /tmp/demo.pdf \
    --width 1280 --extra-css examples/demo-fixes.css
```

### 3. Verify

The script prints `OK 1 page, WxHpt`. Then:

1. Render a thumbnail and eyeball it (layout intact, no collapsed grids,
   backgrounds present, nothing cut at the bottom):
   ```python
   import pymupdf
   doc = pymupdf.open("output.pdf")
   doc[0].get_pixmap(dpi=40).save("check.png")
   ```
2. If redaction was used, the forbid check already ran against the PDF text;
   still spot-check the rendered image for sensitive content in raster form.
3. Heed the script warnings: heights above 14400pt break Acrobat (Chrome,
   Firefox and WeChat preview are fine); "content nearly fills the bedrock"
   means inspect the tail for truncation.

## Troubleshooting and mechanics

Read [references/mechanics.md](references/mechanics.md) when output looks wrong
(collapsed layout, missing backgrounds, blank page, phantom second page, blurry
or missing CJK glyphs) — it documents the Chrome print-rendering rules this
tool is built around, plus the CDP-based alternative route.

© xntj-ai · MIT · AceDataCloud/Skills

Похожие скиллы

Все скиллы по теме «Документы и офис» →
pdf-to-html daymade Скилл pdf-to-html для Claude Code: превращает PDF в один самодостаточный HTML-файл с картинками, таблицами и порядком чтения. Открывается двойным щелчком — без листания страниц. CX Codex +1 529установок convert-pdf-to-md официальный github Скилл convert-pdf-to-md преобразует PDF-документы в Markdown с извлечением таблиц и картинок. Помогает GitHub Copilot анализировать отчёты, договоры и счета без ручного копирования. CX Codex +1 138установок pdf shareAI-lab Извлекает текст из PDF, создаёт PDF из Markdown и склеивает файлы. CX Codex +1 ★ 80 707звёзд репо kimi-pdf thvroyal Скилл kimi-pdf делает PDF из HTML через Paged.js, компилирует LaTeX и разбирает готовые файлы: извлечь текст, склеить, разделить, заполнить формы. CX Codex +1 428установок pdf-creator daymade Скилл pdf-creator конвертирует Markdown в PDF для печати или чтения с телефона, добавляя темы и поддержку китайской типографики. Результат проходит визуальную самопроверку. CX Codex +1 1 100установок pdf-document makushingu Скилл pdf-document для Claude Code генерирует PDF-документы через вёрстку HTML и CSS с печатью во встроенном браузере. Агент активирует скилл по запросу пользователя на создание резюме, коммерческого предложения, отчёта или счёта. CX Codex +1 ★ 285звёзд репо

Из того же набора67

Весь набор →
linkedin Публикует текстовые и ссылочные посты в личной ленте LinkedIn через Posts API. Перед отправкой просит подтвердить текст. CX Codex +1 215установок gitlab Скилл учит агента работать с GitLab через glab: заводить issue, смотреть merge request, гонять пайплайны и искать по коду. CX Codex +1 215установок slack Ищет сообщения в открытых каналах Slack и отправляет ответы бота после подтверждения пользователя. CX Codex +1 215установок notion Скилл подключает Claude Code к Notion через REST API: он ищет, читает и изменяет страницы, а также работает с базами данных. CX Codex +1 215установок devto Публикует статьи на dev.to, обновляет посты и собирает статистику просмотров и реакций через Forem API v1 прямо из терминала. CX Codex +1 213установок reddit Ищет обсуждения на Reddit, читает правила сабреддитов, отвечает и публикует посты. Работает с тредами и профилем через OAuth или cookies. CX Codex +1 212установок cos-upload Скилл cos-upload загружает локальные файлы в CDN AceData Cloud и возвращает публичную ссылку для передачи в другие API. CX Codex +1 211установок substack Скилл ведёт ваш настоящий аккаунт Substack через логин-куки: показывает основную публикацию, выгружает посты со статистикой и публикует новый материал. CX Codex +1 207установок

Спонсоры проекта

Компании, которые помогают держать аналитику открытой