zensical-workspace-separation-template

Zensical で静的サイトを構築する際に、執筆者領域（コンテンツ） と 管理者領域（サイト構築設定） を Docker マウントで分離するためのテンプレート。

本リポジトリは でも解説しております。よろしければご参照ください。

ディレクトリの意味

ssg/assets/ 配下の CSS/JS は Docker Compose のオーバーレイマウントで docs/stylesheets/, docs/javascripts/ としてコンテナ内から見える。執筆者は docs/ 配下の Markdown だけを編集し、サイトのスタイルやスクリプトは管理者領域で完結する構成。

使い方

執筆者

VSCode でリポジトリを開き、Cmd+Shift+P → Tasks: Run Task から：

• コンテナビルド（初回のみ）
• コンテナ起動
• プレビュー起動 → ブラウザで ` を開く
• docs/ の Markdown を編集するとホットリロード

管理者（Dev Container 利用）

• コンテナ起動 タスクを実行
• Cmd+Shift+P → Dev Containers: Reopen in Container で ssg サービスに接続
• /ssg がワークスペースとして開かれる
• 詳細は ssg/README.md

詳細

• 管理者領域のセットアップ・デバッグ手順: ssg/README.md
• Zensical 前提・ナビ運用ルール: ssg/CLAUDE.md
• 設計判断・運用メモ: ssg/notes/