Skip to content

A visual, example-driven guide to Claude Code — from basic concepts to advanced agents, with copy-paste templates that bring immediate value.

4.9 KB
Raw Blame
Claude How To

Скрипт збірки EPUB

Збірка EPUB-книги з markdown-файлів Claude How-To.

Функції

  • Організує розділи за структурою каталогів (01-slash-commands, 02-memory тощо)
  • Рендерить Mermaid-діаграми як SVG-зображення через Pele — закріплений бандл, який запускає Node.js; CSS-змінні замінюються звичайними кольорами на білому тлі, тож діаграми видно в будь-якій EPUB-читалці
  • Кешує однакові діаграми — кожна унікальна діаграма рендериться лише раз
  • Генерує обкладинку з логотипу проєкту
  • Конвертує внутрішні markdown-посилання у посилання на розділи EPUB
  • Суворий режим помилок — падає, якщо діаграма не може бути відрендерена

Вимоги

  • Python 3.10+
  • uv
  • Node.js >= 20 у PATH для рендерингу Mermaid-діаграм. Закріплений бандл Pele завантажується під час першого запуску (мережа потрібна лише раз), перевіряється за sha256 і кешується в scripts/.vendor-cache/pele/

Швидкий старт

# Simplest way - uv handles everything
uv run scripts/build_epub.py

Налаштування розробки

# Create virtual environment
uv venv

# Activate and install dependencies
source .venv/bin/activate
uv pip install -r requirements-dev.txt

# Run tests
pytest scripts/tests/ -v

# Run the script
python scripts/build_epub.py

Параметри командного рядка

usage: build_epub.py [-h] [--root ROOT] [--output OUTPUT] [--verbose]
                     [--lang {en,vi,zh,ja}]

options:
  -h, --help            show this help message and exit
  --root, -r ROOT       Root directory (default: repo root)
  --output, -o OUTPUT   Output path (default: claude-howto-guide.epub)
  --verbose, -v         Enable verbose logging
  --lang {en,vi,zh,ja}  Language to build (default: en)

Приклади

# Build with verbose output
uv run scripts/build_epub.py --verbose

# Custom output location
uv run scripts/build_epub.py --output ~/Desktop/claude-guide.epub

# Build a translated edition
uv run scripts/build_epub.py --lang vi

Вивід

Створює claude-howto-guide.epub у кореневому каталозі репозиторію.

EPUB включає:

  • Обкладинку з логотипом проєкту
  • Зміст з вкладеними секціями
  • Весь markdown-контент, конвертований у EPUB-сумісний HTML
  • Mermaid-діаграми, відрендерені як SVG-зображення

Запуск тестів

# With virtual environment
source .venv/bin/activate
pytest scripts/tests/ -v

# Or with uv directly
uv run --with pytest --with pytest-asyncio \
    --with ebooklib --with markdown --with beautifulsoup4 \
    --with pillow \
    pytest scripts/tests/ -v

Залежності

Керуються через PEP 723 inline script metadata:

Пакет Призначення
ebooklib Генерація EPUB
markdown Конвертація Markdown → HTML
beautifulsoup4 Парсинг HTML
pillow Генерація обкладинки

Усунення проблем

Збірка падає з Pele is unavailable: Встановіть Node.js >= 20 і переконайтеся, що node є у PATH (node --version).

Помилка завантаження або контрольної суми бандла Pele: Перша збірка завантажує закріплений бандл Pele з cdn.jsdelivr.net і перевіряє sha256 кожного файлу. Офлайн або за проксі виконайте одну збірку з доступом до мережі; наступні збірки використовують кеш у scripts/.vendor-cache/pele/<version>/. Невідповідність контрольної суми означає, що завантаження змінене або обірване: видаліть цю папку й зберіть знову.

Відсутній логотип: Скрипт генерує текстову обкладинку, якщо claude-howto-logo.png не знайдено.