CLI · 第2層

出力ターゲット

標準の HTML バンドル以外の特定の成果物を生成します: ページごとの PNG 画像、PDF、およびデプロイメントの成果物。

このドキュメントでは、HTML バンドル以外の出力形式 (PDF、PNG 画像) とデプロイメントの成果物の生成を担当する、OpenPress の第2層 CLI コマンドについて説明します。これらのコマンドは、特定のタスクを実行するために依存関係 (Chromium、アダプタ SDK) をラップしており、基本的な build コマンドからは独立しています。

Command Impl

# `openpress:pdf`

Chromium を介してローカルで PDF 出力を生成します。

npm run openpress:pdf

パラメータ (Flags)

Name	Type	Default	Description
`--output`	`string`		出力パスを上書きします。デフォルトは `config.pdf.filename` で定義されたパスです。
`--no-build`	`flag`		ビルドフェーズをバイパスし、既存の `dist-react/` 出力を再利用します。
`--host`	`string`	`"127.0.0.1"`	Chromium が印刷時に接続する静的サーバーのホスト IP を指定します。
`--port`	`string`	`"5185"`	静的サーバーのポートを指定します。
`--dry-run`	`flag`		実行されるコマンドのシーケンスを出力するだけで、サーバーを起動したり Chromium を呼び出したりしません。

例: PDF を出力する

npm run openpress:pdf

Command Impl

# `openpress:image`

Chromium を介してページごとの PNG 画像出力を生成します。

npm run openpress:image

パラメータ (Flags)

Name	Type	Default	Description
`--output`	`string`		出力ディレクトリのパスを上書きします。デフォルトは `dist-react/images` です。
`--no-build`	`flag`		ビルドフェーズをバイパスし、既存の `dist-react/` 出力を再利用します。
`--host`	`string`	`"127.0.0.1"`	Chromium がキャプチャ時に接続する静的サーバーのホスト IP を指定します。
`--port`	`string`	`"5186"`	静的サーバーのポートを指定します。
`--dry-run`	`flag`		実行されるコマンドのシーケンスを出力するだけで、サーバーを起動したり Chromium を呼び出したりしません。

例: 画像を出力する

npm run openpress:image

Command Impl

# `openpress:deploy`

指定されたアダプタ (Adapter) に基づいてデプロイメントプロセスを実行します。

npm run openpress:deploy

このコマンドは、ビルド、PDF の段階的な成果物の生成、deploy.json へのデプロイメタデータの書き込みを順に実行し、設定されたデプロイメントアダプタを呼び出します。

パラメータ (Flags)

Name	Type	Default	Description
`--confirm`	`flag`		実際のデプロイの公開に必要なパラメータ。インタラクティブなプロンプトをバイパスし、CI 環境に適しています。
`--dry-run`	`flag`		プリフライトチェックを実行し、コマンドシーケンスを出力します。実際の公開とアップロードは行いません。

例: デプロイ操作

# デプロイメントプロセスのプレビュー (Dry run)
npm run openpress:deploy:dry-run

# 実際のデプロイの実行 (確認フラグを含む)
npm run openpress:deploy -- --confirm

デプロイメントアダプタ (Adapters)

アクティブなアダプタは、package.json の "openpress.deploy.adapter" プロパティによって決定されます。

Config Impl

# `"cloudflare-pages"`

npx wrangler pages deploy を呼び出します。必須プロパティ: projectName。オプションのプロパティ: commitDirty。

// package.json
"openpress": {
  "deploy": { "adapter": "cloudflare-pages", "projectName": "...", "source": ".deploy" }
}

Wrangler 環境は、デプロイメントコマンドを実行するマシン上で事前に認証を完了している必要があります。専用のアダプタが提供されていないホスト環境の場合は、標準の静的ビルド出力を直接使用してください。