サイト全体の構造（nav・home・ブログフィード・featured・redirects）は Cosense 上の .site というタイトルのページで宣言します。フレームワークはそのページ内の code:site.yaml ブロックを読み、YAML として解釈します。
書き方
タイトル .site のページを作り、code:site.yaml ブロックを1つ置きます。前後には自由にメモを書いても構いません。
フィールド
- home.page ホームに本文として表示する Cosense ページ
- nav[] ヘッダーの項目。{label, page} で内部、{label, href} で外部 URL
- posts.tag このタグが付いているページが /posts に出る
- posts.limit ホームの「Recent posts」の件数上限
- featured[] ホームで目立たせるページのタイトル
- redirects 旧 slug → 新 slug の写像
注意
.site自身には#publishを付けない。フレームワークが構造ページとして特別扱いします- 未知のフィールドは zod の passthrough で保持されるので、独自セクションを足しても core の変更なしで使えます
関連
- 個別ページの書き方は Quick start
- 検証は Doctor