Site view
Quarto
Site Architecture
Operations
nextと関連する3リポジトリの役割、ソース構成、GitHub Pages公開経路を説明します。
サイト構成と公開経路
サイト群は、個人の活動を案内する入口、現在公開している資産の一覧、構築・運用の記録という3つの役割を分担しています。単一のサイトにすべてを重複させず、それぞれの役割に応じて正本を置く構成です。
3リポジトリの相関
| リポジトリ | 公開先 | 役割 |
|---|---|---|
watanabe3tipapa |
https://watanabe3tipapa.github.io/watanabe3tipapa/ | Bricoleur & Toolsmithとしての活動、制作、連絡先を案内する個人ポータル |
watanabe3tipapa.github.io |
https://watanabe3tipapa.github.io/index/ | 現在公開しているサイト、サービス、記事、プロジェクトの一覧と更新状況の正本 |
next |
https://next.watanabe3ti.com/ | 主サイトの体験設計、構築方法、公開経路、運用判断を記録するサイト |
nextのソース構成
next/
├── _quarto.yml # サイト設定とナビゲーション
├── index.qmd # 構築・運用ノートの入口
├── main.qmd # 主サイトの体験設計
├── siteview.qmd # この構成説明
├── github-note.qmd # GitHub Pagesと公開経路
├── audit.qmd # 照合・検証ノート
├── quarto.qmd # Quartoの利用方法
├── toolsmith.qmd # 2024年時点の履歴資料
├── wiki.qmd # 2024年時点の履歴資料
├── blogs.qmd # 2024年時点の履歴資料
├── log.qmd # 2024年時点の履歴資料
├── custom.scss / styles.css # 表現とテーマ
├── assets/ # 画像・静的アセット
├── DEV-MEMO.md # 非公開の開発メモ
├── ECOSYSTEM.md # 3リポジトリの関係
└── webroot/ # Quartoの生成出力
公開の流れ
- 各
.qmd、設定、スタイル、アセットをリポジトリで編集する。 mainへのpushを契機にGitHub ActionsがQuartoをレンダリングする。- 生成した
webroot/をGitHub Pagesへデプロイする。 - GitHub Pagesに接続された
next.watanabe3ti.comで公開内容を提供する。
Important生成物は直接編集しない
webroot/ はQuartoの出力先です。公開内容を更新する場合は、原則として .qmd、_quarto.yml、テーマ、アセットを編集し、レンダリングで生成物を更新します。
更新時の確認順序
公開先やサービス名を説明する前には、公開サイト・サービス一覧を確認します。個人の活動紹介は watanabe3tipapa、技術的な構築・運用の説明はnextで更新します。過去のCMS・サブドメインに関する資料は、対象時点を明示した履歴資料として扱います。