Layout

ページのフロントマターにレイアウトオプションを設定することで、ページのレイアウトを選択することができます。レイアウトオプションには、doc、page、homeの3種類があります。何も指定しない場合は、docページとして扱われます。

yaml

---
layout: doc
---

Doc Layout

Option docはデフォルトのレイアウトで、Markdownコンテンツ全体を「ドキュメント」ルックにスタイルします。それはvp-doc cssクラスの中で全体のコンテンツをラップし、その下の要素にスタイルを適用することによって動作します。

p、またはh2のようなほとんどすべての一般的な要素は特別なスタイルを取得します。したがって、あなたがMarkdownコンテンツの中にカスタムHTMLを追加した場合、それらも同様にこれらのスタイルによって影響を受けることに留意してください。

また、以下にリストされたドキュメント特有の機能も提供します。これらの機能はこのレイアウトにおいてのみ有効です。

オプションページは "白紙ページ "として扱われます。Markdownはまだ解析され、すべてのMarkdown拡張機能はdocレイアウトと同じように動作しますが、デフォルトのスタイルは取得されません。

ページレイアウトはVitePressテーマがマークアップに影響を与えることなく、すべてを自分でスタイル設定することができます。これは、独自のカスタムページを作成したい場合に便利です。

このレイアウトでも、ページが一致するサイドバー設定を持っていれば、サイドバーは表示されることに注意してください。

オプションのhomeは、テンプレート化された「ホームページ」を生成します。このレイアウトでは、ヒーローや機能などの追加オプションを設定して、コンテンツをさらにカスタマイズすることができます。詳しくは、テーマ：ホームページをご覧ください。

レイアウトが不要な場合は、frontmatterにlayout: falseを渡すことができます。このオプションは、完全にカスタマイズ可能なランディングページ (デフォルトではサイドバー、ナビバー、フッターなし) を作りたい場合に便利です。