サイトのデプロイ

このページは、Timeline DSL 本体やこのドキュメントサイトを保守する開発者向けです。.tdsl ファイルを使って年表を作る利用者向けの手順ではありません。

このドキュメントサイトは Cloudflare Pages の GitHub integration で公開します。GitHub Actions は CI として pnpm build を確認し、公開と Preview URL の作成は Cloudflare Pages に任せます。

前提

Cloudflare Pages project は timeline-dsl、production branch は main とします。

Cloudflare Pages の Build settings は以下にします。

Setting	Value
Root directory	site
Build command	pnpm build
Build output directory	dist
Deploy command	設定項目が出ない

Cloudflare Pages の build image は dependency install を自動実行します。Build command に pnpm install --frozen-lockfile && pnpm build を入れても build はできますが、install が二重になるため pnpm build のみにします。

Deploy command が必須になっている場合や、非本番ブランチのデプロイコマンドが表示されている場合は、Pages ではなく Workers Builds の設定画面です。Workers Builds は build command の後に Wrangler の deploy command を実行する仕組みですが、このサイトは静的な Pages site として運用するため使いません。

実行タイミング

Trigger	用途	Pages branch
pull_request	Preview deployment を作成	PR branch
push to main	本番公開	main
release.published	deploy trigger としては使わない	-
workflow_dispatch	GitHub Actions の CI を手動再実行	-

pull request では GitHub Actions の Site build workflow と Cloudflare Pages の Preview deployment がそれぞれ実行されます。

Preview 確認

Cloudflare Pages の Preview URL は GitHub PR の checks、Deployments、または Cloudflare Pages dashboard から確認します。

1. PR の Cloudflare Pages check または Deployments から Preview URL を開く。
2. Preview URL で / が表示できることを確認する。
3. Preview URL で /docs/ が表示できることを確認する。

エラー対応

Cloudflare build log に Worker Name、Executing user deploy command: npx wrangler deploy、Non-production branch deploy command が出ている場合は、Workers Builds として作成されています。Cloudflare dashboard で新しい Pages project を作成し、Pages の Import an existing Git repository からこの repository を接続してください。

Workers Builds として継続する場合は Wrangler 設定と Workers Static Assets 用の deploy command が必要になりますが、この LP/document サイトでは不要です。Missing file or directory: public/.assetsignore は Wrangler が Workers/Astro 用の追加セットアップを試みた結果で、Pages project として作り直すことで解消します。

参考:

• Cloudflare Pages build configuration
• Cloudflare Workers Builds configuration
• Cloudflare Pages preview deployments

ローカル確認

cd site
pnpm install --frozen-lockfile
pnpm build

WASM bundle の更新

Playground と runnable docs から Timeline DSL WASM を使う場合、LP 側の呼び出し口は src/lib/tdsl-wasm.ts に集約します。Astro / Starlight のコンポーネントから tdsl_wasm.js や wasm-bindgen 生成物を直接 import しないでください。

2026年5月時点では、本体 repo の tdsl-wasm は npm package や release artifact としての配布方式がまだ固定されていません。そのため LP 側では、本体 repo の apps/webui と同じ wasm-pack --target web 生成物を public/wasm/ に vendoring します。将来 npm package または release artifact が整備されたら、差し替え対象は src/lib/tdsl-wasm.ts とこの更新手順に限定します。

本体 repo で WASM を更新します。

cd ../timeline-dsl
wasm-pack build crates/tdsl-wasm --target web --out-dir apps/webui/src/wasm --no-opt

生成物を LP repo に同期します。

cd ../timeline-dsl-lp
cp ../timeline-dsl/apps/webui/src/wasm/tdsl_wasm.js site/public/wasm/tdsl_wasm.js
cp ../timeline-dsl/apps/webui/src/wasm/tdsl_wasm.d.ts site/public/wasm/tdsl_wasm.d.ts
cp ../timeline-dsl/apps/webui/src/wasm/tdsl_wasm_bg.wasm site/public/wasm/tdsl_wasm_bg.wasm
cp ../timeline-dsl/apps/webui/src/wasm/package.json site/public/wasm/package.json

更新後は smoke と build を実行します。

cd site
pnpm smoke:wasm
pnpm build

WASM wrapper が対象にするのは静的な .tdsl の検証、IR 生成、SVG/HTML レンダリングです。Wikidata import の解決やネットワーク取得はブラウザ版 WASM では対応外とし、Playground 側では diagnostic として扱います。