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/daydream/...->/docs/daydream/...docs/sigbit/ja/daydream/...->/docs/ja/daydream/...
同様に,raytracing や ai 等のサブディレクトリも同じルールで公開されます。