VitePress プロジェクトの構成とルーティング

このページでは，このリポジトリ固有のディレクトリ構成とルーティング方針を整理します。

なぜ docs/sigbit なのか

一般的なVitePressでは docs 直下に記事を置きますが，本プロジェクトは docs/sigbit を srcDir にしています。理由は，docs/sigbit をObsidian Vaultとして同期するためです。

• Obsidian SyncでMac/iOS/iPadOSから同一Vaultを編集できる
• Headless SyncでUbuntu Server側でもVaultを同期できる
• 記事本文と，VitePress設定・静的バイナリを分離できる

ディレクトリ構成

主要な構成は次の通りです。

docs/
├── .vitepress/      # VitePress設定・テーマ・プラグイン
├── public/          # 静的アセット（WASMなど）
└── sigbit/          # Obsidian Vault（srcDir）
    ├── en/          # 英語版ドキュメント
    └── ja/          # 日本語版ドキュメント

config.mts の要点

この構成は，docs/.vitepress/config.mts の次の設定で成立しています。

• srcDir: 'sigbit'
• vite.publicDir: '../public'（sigbit から見た相対パス）
• base: '/docs/'
• rewrites により en/:rest* -> :rest*，ja/:rest* -> ja/:rest*

URL構造（en/ja）

rewrites の設定により，英語ページは言語コードなし，日本語ページは ja 付きで公開されます。

• docs/sigbit/en/guides/... -> /docs/guides/...
• docs/sigbit/ja/guides/... -> /docs/ja/guides/...

同様に，raytracing や daydream 等のサブディレクトリも同じルールで公開されます。