Menu
Markdown小説 → A6縦書きPDF/EPUB変換（Puppeteer+PyMuPDF / Vivliostyle CLI）。しっぽり明朝埋め込み、章ヘッダ/ノンブル/挿絵制御、JLREQ前処理、VFMルビ対応。
Install with Codex or Claude Copy this prompt, paste it into Codex, Claude, or another assistant, and let it review the skill page and install it for you.
Based on SOC occupation classification
| name | novel2epub-jp |
| description | Markdown小説 → A6縦書きPDF/EPUB変換（Puppeteer+PyMuPDF / Vivliostyle CLI）。しっぽり明朝埋め込み、章ヘッダ/ノンブル/挿絵制御、JLREQ前処理、VFMルビ対応。 |
| version | 1.5.0 |
| tags | ["novel","pdf","epub","puppeteer","pymupdf","vivliostyle","japanese"] |
✗ vivliostyle build でPDFを生成（横書き・フォント崩壊の原因）
✗ bunko-custom.css 等で縦書き強制を試みる（効かない）
○ build-pdf.py（Puppeteer + PyMuPDF）でPDF生成（唯一の正解）
理由: Chromiumの @page margin box と position: fixed が writing-mode: vertical-rl と両立しないため、Vivliostyle CLI経由のPDFは必ず横書きになる（2026-05-30実証済）。フォント埋め込みも失敗する。
bunko-custom.css の writing-mode 設定だけでは縦書きは強制できない。HTMLの構造（<html lang="ja"> + direction: rtl + writing-mode: vertical-rl）と @viewport の両方が必要。安易なCSS書き換えはEPUB/PDF両方の組版を壊す。
# WOFF2 ダウンロード（EPUB用・これだけでOK）
python3 scripts/setup.py --project-dir /path/to/project
# WOFF2 + OTF 変換（PDF用）
python3 scripts/setup.py --project-dir /path/to/project --otf
# またはシェルスクリプト版
bash scripts/setup.sh --project-dir /path/to/project
セットアップスクリプトが以下を自動実行:
fonts/ ディレクトリに配置--otf 指定時: fonttools で WOFF2 → OTF 変換（PDFのPyMuPDF埋め込み用）依存ツール:
curl / urllib.request（ダウンロード）fonttools（OTF変換時のみ）: pip install fonttoolsnovel/*.md（VFM記法ルビ {漢字|よみ} 使用）novel/image/*.webp（Markdown内で ）fonts/ShipporiMincho-{Regular,Bold}.woff2（setup.sh で自動配置）python3 scripts/build-pdf.py \
--project-dir . \
--output dist/book.pdf \
[--preset <name>] \
[--image-size small|medium|large] \
[--image-caption on|off] \
[--chapter-header-position left|center|right] \
[--chapter-header-display all|even|odd|none] \
[--page-number-position center|left|right|odd-right-even-left|odd-left-even-right] \
[--page-number-display all|even|odd]
--list-presets で確認できる出力例:
Available presets:
showcase-small image-size=small, caption=on, header=even/left, page-num=all/odd-right-even-left
showcase-medium image-size=medium, caption=on, header=even/left, page-num=all/odd-right-even-left
showcase-large image-size=large, caption=off, header=even/left, page-num=all/odd-right-even-left
clean-small image-size=small, caption=off, header=even/left, page-num=all/odd-right-even-left
clean-medium image-size=medium, caption=off, header=even/left, page-num=all/odd-right-even-left
clean-large image-size=large, caption=off, header=even/left, page-num=all/odd-right-even-left
minimal image-size=small, caption=off, header=none/?, page-num=all/center
Usage: python build-pdf.py --preset <name> --project-dir .
| プリセット名 | 挿絵 | caption | ヘッダ | ページ番号 | 用途 |
|---|---|---|---|---|---|
| showcase-small | 小 | ✓ on | even/left | 交互 | 扱いやすいプレビュー |
| showcase-medium | 中 | ✓ on | even/left | 交互 | バランス重視 |
| showcase-large | 大 | ✗ off | even/left | 交互 | 見開き挿絵（注: large=強制caption off） |
| clean-small | 小 | ✗ off | even/left | 交互 | 本文集中・シンプル |
| clean-medium | 中 | ✗ off | even/left | 交互 | 本文集中・やや大きめ |
| clean-large | 大 | ✗ off | even/left | 交互 | 本文集中・フルページ（注: large=強制caption off） |
| minimal | 小 | ✗ off | なし | 中央 | 最小構成 |
注意:
image-size=largeの場合、ページ全体に画像が表示されるため caption は強制的にオフ になります。プリセット指定や--image-caption onで上書きしても large では無視されます。
個別オプションはプリセットをオーバーライド可能。
重要制約:
image-size=large の場合、captionは常に非表示（上書き不可）# 1. Vivliostyle CLI で EPUB をビルド
cd /path/to/novel-project
npx vivliostyle build
# 2. JLREQ後処理を適用
python3 /path/to/novel2epub-jp/scripts/jlreq_postprocess.py \
dist/book-distribution.epub
jlreq_postprocess.py が行うことVivliostyle CLI出力のEPUBを後処理し、日本語組版ルールを適用:
.vrtl クラス付与 — <html> と <body> に class="vrtl" を追加
.vrtl クラスで縦書きを制御するが、Vivliostyle CLIのEPUB出力では自動付与されないno-indent クラスを付与<span class="tcy"> で縦中横化
<p>, <h1>-<h6>, <li> のすべてに適用jlreq_epub_rules.css を <style> タグ内に直接追記注意: \b (word boundary) は日本語文字と数字の間で機能しないため、(?<!\d)(\d{1,2})(?!\d) のパターンを使用。
module.exports = {
title: '作品タイトル',
author: '著者名',
language: 'ja',
readingProgression: 'rtl', // 縦書き右綴じ
entry: [
'novel/序章.md',
'novel/第1章.md',
],
output: {
path: 'dist/作品タイトル-distribution.epub',
format: 'epub',
},
theme: '@vivliostyle/theme-epub3j',
toc: true,
copyAsset: {
includes: ['novel/image/**'],
},
};
重要: style: 'epub-custom.css' は指定しないこと。Vivliostyle CLIが既存のtheme CSSへのリンクを上書きし、横書き化する原因になる。CSSルールはすべて jlreq_postprocess.py で注入する。
| ファイル | 用途 |
|---|---|
scripts/setup.sh | フォント自動ダウンロード・配置 |
scripts/setup.py | フォント自動ダウンロード・配置（Python版） |
scripts/build-pdf.py | PDF生成（Puppeteer + PyMuPDF） |
scripts/jlreq_postprocess.py | EPUB後処理（JLREQルール注入） |
scripts/jlreq_epub_rules.css | EPUB注入用CSSルール |
scripts/fix-epub-css.py | CSSリンク修正ユーティリティ |
scripts/jlreq_preprocess.py | Markdown変換時のJLREQ前処理 |
scripts/build-epub.py | EPUBビルド自動化スクリプト |
scripts/print-pdf.cjs | Puppeteerラッパー |
templates/ | HTML/CSSテンプレート |
references/ | CSS調整・ワークフロー |