Skip to content
Copied!
published on 2026-04-05

VitePressプロジェクト構成

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

なぜ docs/sigbit なのか

一般的なVitePressでは docs 直下に記事を置きますが,本プロジェクトは docs/sigbitsrcDir にしています。理由は,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/...

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