CLI

前提: Getting Started、Export profiles。

Install と build

npm install --global @illusions-lab/mdi-cli
mdi build novel.mdi --to epub --config novel.export.json -o dist/novel.epub

mdi build <input.mdi> --to html|pdf|epub|docx|txt|txt-ruby|narou|kakuyomu|aozora|txt-all [--config export.json] [-o <output>]

input は UTF-8 です。--to は必須、-o は output path を上書きし txt-all とは併用不可、--config は export profile JSON です。成功は Written <path> と status 0、argument/input/profile/renderer/output の failure は stderr 一行と status 1 です。

format ごとの設定

--to	default	renderer と profile
html	novel.html	Rust semantic standalone HTML。page profile は使わない。
pdf	novel.pdf	Rust HTML + local Chromium。print profile を使う。
epub	novel.epub	config なしは Rust baseline。config があれば metadata/type/chapter/cover を使う。
docx	novel.docx	config なしは Rust baseline。config があれば metadata/page/type/numbering を使う。
text 5 形式	各 .txt	Rust text。profile は indent を決める。aozora は Shift_JIS。
txt-all	6 files	全 text を書き、-o を reject。

epub.coverPath は profile file からの相対 path として読み、PNG/JPEG でなければ error です。cover bytes は EPUB にのみ入り parser には渡りません。EPUB/DOCX で --config が静かに無視されることはもうありません。

--config なしでは、CLI は front matter から built-in layout を選びます。writing-mode: vertical は japanese-publisher の A4 landscape・右綴じ 40×30 小説原稿 grid、それ以外は word の flowing A4 layout です。明示した --config にだけ layout.system が必須です。

profile 例

{
  "layout": { "system": "japanese-publisher" },
  "metadata": { "title": "雨の東京", "author": "Illusions", "language": "ja" },
  "typesetting": { "writingMode": "vertical", "fontFamily": "Yu Mincho", "fontSize": 10, "textIndentEm": 1 },
  "pagination": { "pageSize": "A4", "landscape": true, "gridMode": "strict", "pageNumbers": { "enabled": true, "position": "bottom-center", "format": "simple" } },
  "epub": { "chapterSplitLevel": "h1", "coverPath": "cover.png" }
}

明示した --config には layout.system が必須で、ない profile は reject されます。"japanese-publisher" は book 用の system です。横書きは Shirokuban・10 pt 明朝体・mirror 付き左綴じ 27×26 strict grid、縦書きは A4 landscape 小説原稿・mirror 付き右綴じ 40×30 strict grid が default です。"word" は別の flowing system で、A4、四辺 25.4 mm、mirror なし、gridMode: "typographic" です。strict grid は使えません。

MDI parsing/diagnostic/span は Rust の責務です。profile は publication policy、PDF geometry と Chromium layout は host policy です。PDF は @illusions-lab/mdi-to-pdf と local Chromium を要し、Chromium は .mdi ではなく完成 HTML を受け取ります。DOCX は page/type/numbering を設定できますが、ruby、tate-chu-yoko、禁則/改行禁止、kern、blank paragraph が browser と pixel-identical である保証はありません。対象 reader で確認してください。