Custom Layout!
+ + +Custom Layout!
+ +Custom Layout!
+ +Custom Layout!
+ +{{ data }}
+```
+
+出力:
+
+```json
+{
+ "hello": "world"
+}
+```
+
+データローダー自体は `data` を直接エクスポートしていないことに気づくでしょう。これは VitePress が裏側で `load()` を呼び出し、その結果を暗黙的に `data` として公開しているためです。
+
+ローダーが非同期でも動作します。
+
+```js
+export default {
+ async load() {
+ // リモートデータを取得
+ return (await fetch('...')).json()
+ }
+}
+```
+
+## ローカルファイルからのデータ {#data-from-local-files}
+
+ローカルファイルに基づいたデータを生成する必要がある場合は、データローダー内で `watch` オプションを使用し、ファイルの変更をホットリロードに反映させることが推奨されます。
+
+`watch` では [glob パターン](https://github.com/mrmlnc/fast-glob#pattern-syntax) を利用して複数ファイルをマッチさせることができ、パターンはローダーファイルからの相対パスで指定できます。`load()` 関数にはマッチしたファイルの絶対パスが渡されます。
+
+以下は CSV ファイルを読み込み [csv-parse](https://github.com/adaltas/node-csv/tree/master/packages/csv-parse/) を使って JSON に変換する例です。このコードはビルド時にのみ実行されるため、CSV パーサーがクライアントに送られることはありません。
+
+```js
+import fs from 'node:fs'
+import { parse } from 'csv-parse/sync'
+
+export default {
+ watch: ['./data/*.csv'],
+ load(watchedFiles) {
+ return watchedFiles.map((file) => {
+ return parse(fs.readFileSync(file, 'utf-8'), {
+ columns: true,
+ skip_empty_lines: true
+ })
+ })
+ }
+}
+```
+
+## `createContentLoader`
+
+コンテンツ中心のサイトを構築する場合、ブログ記事や API ページなどを一覧表示する「アーカイブ」や「インデックス」ページが必要になることがよくあります。これはデータローダー API を使って直接実装できますが、あまりにも一般的なケースなので VitePress では `createContentLoader` というヘルパーが用意されています。
+
+```js [posts.data.js]
+import { createContentLoader } from 'vitepress'
+
+export default createContentLoader('posts/*.md', /* options */)
+```
+
+このヘルパーは [ソースディレクトリ](./routing#source-directory) からの相対 glob パターンを受け取り、`{ watch, load }` を返すデータローダーオブジェクトを生成します。これをデータローダーファイルのデフォルトエクスポートにできます。開発時のパフォーマンスを向上させるために、ファイルの更新時刻に基づくキャッシュも行われます。
+
+このローダーは Markdown ファイルにのみ対応し、それ以外のファイルは無視されます。
+
+読み込まれるデータは `ContentData[]` 型の配列です。
+
+```ts
+interface ContentData {
+ url: string // ページのマッピング URL（例: /posts/hello.html）
+ frontmatter: RecordAll Blog Posts
+-
+
- + {{ post.frontmatter.title }} + by {{ post.frontmatter.author }} + +
デモ
+ + + +-
+
- + {{ todo.text }} + +
-
+
- + {{ todo.text }} + +
` 〜 `` を表示）
+ *
+ * @default 2
+ */
+ level?: number | [number, number] | 'deep'
+
+ /**
+ * アウトラインに表示するタイトル
+ *
+ * @default 'On this page'
+ */
+ label?: string
+ }
+ ```
+
+## socialLinks
+
+- 型: `SocialLink[]`
+
+ナビゲーションにアイコン付きのソーシャルリンクを表示します。
+
+ ```ts
+ export default {
+ themeConfig: {
+ socialLinks: [
+ // simple-icons (https://simpleicons.org/) の任意のアイコンを指定可能
+ { icon: 'github', link: 'https://github.com/vuejs/vitepress' },
+ { icon: 'twitter', link: '...' },
+ // SVG 文字列を渡してカスタムアイコンも可
+ {
+ icon: {
+ svg: ''
+ },
+ link: '...',
+ // アクセシビリティ向けにカスタムラベルも指定可（推奨）
+ ariaLabel: 'cool link'
+ }
+ ]
+ }
+ }
+ ```
+
+ ```ts
+ interface SocialLink {
+ icon: string | { svg: string }
+ link: string
+ ariaLabel?: string
+ }
+ ```
+
+## footer
+
+- 型: `Footer`
+- ページごとに [frontmatter](./frontmatter-config#footer) で上書き可能
+
+フッター設定。メッセージや著作権表示を追加できますが、ページにサイドバーがある場合はデザイン上表示されません。
+
+ ```ts
+ export default {
+ themeConfig: {
+ footer: {
+ message: 'Released under the MIT License.',
+ copyright: 'Copyright © 2019-present Evan You'
+ }
+ }
+ }
+ ```
+
+ ```ts
+ export interface Footer {
+ message?: string
+ copyright?: string
+ }
+ ```
+
+## editLink
+
+- 型: `EditLink`
+- ページごとに [frontmatter](./frontmatter-config#editlink) で上書き可能
+
+「このページを編集」リンクを表示します（GitHub/GitLab など）。詳細は [デフォルトテーマ: 編集リンク](./default-theme-edit-link) を参照。
+
+ ```ts
+ export default {
+ themeConfig: {
+ editLink: {
+ pattern: 'https://github.com/vuejs/vitepress/edit/main/docs/:path',
+ text: 'Edit this page on GitHub'
+ }
+ }
+ }
+ ```
+
+ ```ts
+ export interface EditLink {
+ pattern: string
+ text?: string
+ }
+ ```
+
+## lastUpdated
+
+- 型: `LastUpdatedOptions`
+
+最終更新の文言と日付フォーマットをカスタマイズします。
+
+ ```ts
+ export default {
+ themeConfig: {
+ lastUpdated: {
+ text: 'Updated at',
+ formatOptions: {
+ dateStyle: 'full',
+ timeStyle: 'medium'
+ }
+ }
+ }
+ }
+ ```
+
+ ```ts
+ export interface LastUpdatedOptions {
+ /**
+ * @default 'Last updated'
+ */
+ text?: string
+
+ /**
+ * @default
+ * { dateStyle: 'short', timeStyle: 'short' }
+ */
+ formatOptions?: Intl.DateTimeFormatOptions & { forceLocale?: boolean }
+ }
+ ```
+
+## algolia
+
+- 型: `AlgoliaSearch`
+
+[Algolia DocSearch](https://docsearch.algolia.com/docs/what-is-docsearch) によるサイト内検索の設定。[デフォルトテーマ: 検索](./default-theme-search) を参照。
+
+ ```ts
+ export interface AlgoliaSearchOptions extends DocSearchProps {
+ locales?: Record>
+ }
+ ```
+
+完全なオプションは[こちら](https://github.com/vuejs/vitepress/blob/main/types/docsearch.d.ts)。
+
+## carbonAds {#carbon-ads}
+
+- 型: `CarbonAdsOptions`
+
+[Carbon Ads](https://www.carbonads.net/) を表示します。
+
+ ```ts
+ export default {
+ themeConfig: {
+ carbonAds: {
+ code: 'your-carbon-code',
+ placement: 'your-carbon-placement'
+ }
+ }
+ }
+ ```
+
+ ```ts
+ export interface CarbonAdsOptions {
+ code: string
+ placement: string
+ }
+ ```
+
+詳細は [デフォルトテーマ: Carbon Ads](./default-theme-carbon-ads) を参照。
+
+## docFooter
+
+- 型: `DocFooter`
+
+前／次リンクの上に表示される文言をカスタマイズします。英語以外のドキュメントで便利。前／次リンク自体をグローバルに無効化することも可能。ページごとに切り替えたい場合は [frontmatter](./default-theme-prev-next-links) を使用します。
+
+ ```ts
+ export default {
+ themeConfig: {
+ docFooter: {
+ prev: 'Pagina prior',
+ next: 'Proxima pagina'
+ }
+ }
+ }
+ ```
+
+ ```ts
+ export interface DocFooter {
+ prev?: string | false
+ next?: string | false
+ }
+ ```
+
+## darkModeSwitchLabel
+
+- 型: `string`
+- 既定値: `Appearance`
+
+ダークモード切替スイッチのラベル（モバイル表示のみ）をカスタマイズします。
+
+## lightModeSwitchTitle
+
+- 型: `string`
+- 既定値: `Switch to light theme`
+
+ホバー時に表示されるライトモード切替のタイトルをカスタマイズします。
+
+## darkModeSwitchTitle
+
+- 型: `string`
+- 既定値: `Switch to dark theme`
+
+ホバー時に表示されるダークモード切替のタイトルをカスタマイズします。
+
+## sidebarMenuLabel
+
+- 型: `string`
+- 既定値: `Menu`
+
+サイドバーメニューのラベル（モバイル表示のみ）をカスタマイズします。
+
+## returnToTopLabel
+
+- 型: `string`
+- 既定値: `Return to top`
+
+トップに戻るボタンのラベル（モバイル表示のみ）をカスタマイズします。
+
+## langMenuLabel
+
+- 型: `string`
+- 既定値: `Change language`
+
+ナビバーの言語切替ボタンの aria-label をカスタマイズします。[i18n](../guide/i18n) を使う場合に有効です。
+
+## skipToContentLabel
+
+- 型: `string`
+- 既定値: `Skip to content`
+
+コンテンツへスキップリンクのラベルをカスタマイズします。キーボード操作時に表示されます。
+
+## externalLinkIcon
+
+- 型: `boolean`
+- 既定値: `false`
+
+Markdown 内の外部リンクの横に外部リンクアイコンを表示するかどうか。
+
+## `useLayout`
+
+ sidebar: Readonly>
+ sidebarGroups: ComputedRef
+ hasSidebar: ComputedRef
+ isSidebarEnabled: ComputedRef
+
+ hasAside: ComputedRef
+ leftAside: ComputedRef
+
+ headers: Readonly>
+ hasLocalNav: ComputedRef
+ }
+ ```
+
+**例:**
+
+ ```vue
+
+
+
+ サイドバーがあるときだけ表示
+
+ ```
diff --git a/docs/ja/reference/default-theme-edit-link.md b/docs/ja/reference/default-theme-edit-link.md
new file mode 100644
index 00000000..03573944
--- /dev/null
+++ b/docs/ja/reference/default-theme-edit-link.md
@@ -0,0 +1,60 @@
+# 編集リンク {#edit-link}
+
+## サイトレベルの設定 {#site-level-config}
+
+編集リンクは、GitHub や GitLab などの Git 管理サービスでそのページを編集できるリンクを表示します。有効化するには、設定に `themeConfig.editLink` オプションを追加します。
+
+ ```js
+ export default {
+ themeConfig: {
+ editLink: {
+ pattern: 'https://github.com/vuejs/vitepress/edit/main/docs/:path'
+ }
+ }
+ }
+ ```
+
+`pattern` オプションはリンクの URL 構造を定義します。`:path` はページパスに置き換えられます。
+
+また、引数に [`PageData`](./runtime-api#usedata) を受け取り、URL 文字列を返す純粋関数を指定することもできます。
+
+ ```js
+ export default {
+ themeConfig: {
+ editLink: {
+ pattern: ({ filePath }) => {
+ if (filePath.startsWith('packages/')) {
+ return `https://github.com/acme/monorepo/edit/main/${filePath}`
+ } else {
+ return `https://github.com/acme/monorepo/edit/main/docs/${filePath}`
+ }
+ }
+ }
+ }
+ }
+ ```
+
+この関数はブラウザでシリアライズされ実行されるため、副作用を持たず、スコープ外のものへアクセスしないでください。
+
+既定では、ドキュメント下部に「Edit this page」というリンクテキストが表示されます。`text` オプションでこの文言をカスタマイズできます。
+
+ ```js
+ export default {
+ themeConfig: {
+ editLink: {
+ pattern: 'https://github.com/vuejs/vitepress/edit/main/docs/:path',
+ text: 'GitHub でこのページを編集'
+ }
+ }
+ }
+ ```
+
+## フロントマターでの設定 {#frontmatter-config}
+
+ページごとに無効化するには、フロントマターで `editLink` オプションを使用します。
+
+ ```yaml
+ ---
+ editLink: false
+ ---
+ ```
diff --git a/docs/ja/reference/default-theme-footer.md b/docs/ja/reference/default-theme-footer.md
new file mode 100644
index 00000000..f8226c89
--- /dev/null
+++ b/docs/ja/reference/default-theme-footer.md
@@ -0,0 +1,55 @@
+# フッター {#footer}
+
+`themeConfig.footer` を設定すると、ページ下部にグローバルフッターが表示されます。
+
+```ts
+export default {
+ themeConfig: {
+ footer: {
+ message: 'Released under the MIT License.',
+ copyright: 'Copyright © 2019-present Evan You'
+ }
+ }
+}
+```
+
+```ts
+export interface Footer {
+ // 著作権表示の直前に表示されるメッセージ
+ message?: string
+
+ // 実際の著作権表記
+ copyright?: string
+}
+```
+
+上記の設定は HTML 文字列にも対応しています。たとえば、フッター内のテキストにリンクを含めたい場合は、次のように設定できます。
+
+```ts
+export default {
+ themeConfig: {
+ footer: {
+ message: 'Released under the MIT License.',
+ copyright: 'Copyright © 2019-present Evan You'
+ }
+ }
+}
+```
+
+::: warning
+`message` と `copyright` は `` 要素内にレンダリングされるため、
+使用できるのはインライン要素のみです。ブロック要素を追加したい場合は、
+[`layout-bottom`](../guide/extending-default-theme#layout-slots) スロットの利用を検討してください。
+:::
+
+なお、[SideBar](./default-theme-sidebar) が表示されている場合はフッターは表示されません。
+
+## フロントマターでの設定 {#frontmatter-config}
+
+ページ単位で無効化するには、フロントマターの `footer` オプションを使用します。
+
+```yaml
+---
+footer: false
+---
+```
diff --git a/docs/ja/reference/default-theme-home-page.md b/docs/ja/reference/default-theme-home-page.md
new file mode 100644
index 00000000..e472a478
--- /dev/null
+++ b/docs/ja/reference/default-theme-home-page.md
@@ -0,0 +1,188 @@
+# ホームページ {#home-page}
+
+VitePress のデフォルトテーマにはホームページ用レイアウトが用意されています（[このサイトのトップページ](../) でも使われています）。[フロントマター](./frontmatter-config) に `layout: home` を指定すれば、任意のページで利用できます。
+
+```yaml
+---
+layout: home
+---
+```
+
+ただし、この指定だけでは多くのことは起きません。`hero` や `features` などの追加オプションを設定して、ホームページにあらかじめ用意された複数の「セクション」を配置できます。
+
+## ヒーローセクション {#hero-section}
+
+ヒーローセクションはホームページの最上部に表示されます。設定例は次のとおりです。
+
+```yaml
+---
+layout: home
+
+hero:
+ name: VitePress
+ text: Vite & Vue powered static site generator.
+ tagline: 概要テキスト...
+ image:
+ src: /logo.png
+ alt: VitePress
+ actions:
+ - theme: brand
+ text: はじめる
+ link: /guide/what-is-vitepress
+ - theme: alt
+ text: GitHub で見る
+ link: https://github.com/vuejs/vitepress
+---
+```
+
+```ts
+interface Hero {
+ // `text` の上に表示される短い文字列。ブランドカラーで表示。
+ // 製品名のような短い文言を想定。
+ name?: string
+
+ // ヒーローセクションのメインテキスト。`h1` として出力。
+ text: string
+
+ // `text` の下に表示されるタグライン。
+ tagline?: string
+
+ // テキストとタグラインの横に表示する画像。
+ image?: ThemeableImage
+
+ // ヒーローに表示するアクションボタン。
+ actions?: HeroAction[]
+}
+
+type ThemeableImage =
+ | string
+ | { src: string; alt?: string }
+ | { light: string; dark: string; alt?: string }
+
+interface HeroAction {
+ // ボタンのカラーテーマ。既定は `brand`。
+ theme?: 'brand' | 'alt'
+
+ // ボタンのラベル。
+ text: string
+
+ // ボタンのリンク先。
+ link: string
+
+ // a 要素の target 属性。
+ target?: string
+
+ // a 要素の rel 属性。
+ rel?: string
+}
+```
+
+### name の色をカスタマイズする {#customizing-the-name-color}
+
+`name` にはブランドカラー（`--vp-c-brand-1`）が使われますが、`--vp-home-hero-name-color` 変数を上書きして色を変更できます。
+
+```css
+:root {
+ --vp-home-hero-name-color: blue;
+}
+```
+
+さらに、`--vp-home-hero-name-background` を組み合わせると、`name` にグラデーションを適用できます。
+
+```css
+:root {
+ --vp-home-hero-name-color: transparent;
+ --vp-home-hero-name-background: -webkit-linear-gradient(120deg, #bd34fe, #41d1ff);
+}
+```
+
+## フィーチャーセクション {#features-section}
+
+フィーチャーセクションでは、ヒーロー直下に任意の数の機能説明を並べられます。フロントマターに `features` オプションを指定して設定します。
+
+各フィーチャーにはアイコン（絵文字または画像）を指定できます。アイコンが画像（svg, png, jpeg など）の場合は、**適切な幅・高さ** を指定してください。必要に応じて説明テキストや実サイズ、ライト／ダーク用の差し替えも指定できます。
+
+```yaml
+---
+layout: home
+
+features:
+ - icon: 🛠️
+ title: いつでもシンプル＆ミニマル
+ details: 概要テキスト...
+ - icon:
+ src: /cool-feature-icon.svg
+ title: もうひとつの便利機能
+ details: 概要テキスト...
+ - icon:
+ dark: /dark-feature-icon.svg
+ light: /light-feature-icon.svg
+ title: さらに別の機能
+ details: 概要テキスト...
+---
+```
+
+```ts
+interface Feature {
+ // 各フィーチャーボックスに表示するアイコン。
+ icon?: FeatureIcon
+
+ // フィーチャーのタイトル。
+ title: string
+
+ // フィーチャーの詳細説明。
+ details: string
+
+ // フィーチャーをクリックしたときのリンク（内部・外部どちらも可）。
+ //
+ // 例: `guide/reference/default-theme-home-page` や `https://example.com`
+ link?: string
+
+ // フィーチャー内に表示するリンクテキスト。
+ // `link` と併用するのが最適。
+ //
+ // 例: `Learn more`, `Visit page` など
+ linkText?: string
+
+ // `link` 用の rel 属性。
+ //
+ // 例: `external`
+ rel?: string
+
+ // `link` 用の target 属性。
+ target?: string
+}
+
+type FeatureIcon =
+ | string
+ | { src: string; alt?: string; width?: string; height: string }
+ | {
+ light: string
+ dark: string
+ alt?: string
+ width?: string
+ height: string
+ }
+```
+
+## Markdown コンテンツ {#markdown-content}
+
+`---` で区切るフロントマターの下に Markdown を書くだけで、ホームページに追加コンテンツを表示できます。
+
+````md
+---
+layout: home
+
+hero:
+ name: VitePress
+ text: Vite & Vue powered static site generator.
+---
+
+## はじめに
+
+`npx` を使えば、すぐに VitePress を始められます！
+
+```sh
+npm init
+npx vitepress init
+```
diff --git a/docs/ja/reference/default-theme-last-updated.md b/docs/ja/reference/default-theme-last-updated.md
new file mode 100644
index 00000000..2c85f2a8
--- /dev/null
+++ b/docs/ja/reference/default-theme-last-updated.md
@@ -0,0 +1,46 @@
+# 最終更新日時 {#last-updated}
+
+ページ右下に、コンテンツの最終更新時刻を表示できます。有効化するには、設定に `lastUpdated` オプションを追加します。
+
+::: info
+VitePress は各ファイルの **直近の Git コミットのタイムスタンプ** を用いて「最終更新」を表示します。これを有効にするには、対象の Markdown ファイルが Git にコミットされている必要があります。
+
+内部的には、各ファイルに対して `git log -1 --pretty="%ai"` を実行してタイムスタンプを取得します。すべてのページで同じ更新時刻が表示される場合、（CI 環境でよくある）**浅いクローン（shallow clone）** により Git の履歴が取得できていない可能性があります。
+
+**GitHub Actions** での修正例は次のとおりです。
+
+```yaml{4}
+- name: Checkout
+ uses: actions/checkout@v4
+ with:
+ fetch-depth: 0
+```
+
+他の CI/CD プラットフォームでも同様の設定が用意されています。
+
+もしそのようなオプションが使えない場合は、`package.json` のビルドスクリプトで手動フェッチを前置してください。
+
+```json
+"docs:build": "git fetch --unshallow && vitepress build docs"
+```
+:::
+
+## サイトレベルの設定 {#site-level-config}
+
+```js
+export default {
+ lastUpdated: true
+}
+```
+
+## フロントマターでの設定 {#frontmatter-config}
+
+ページ単位で無効化するには、フロントマターで `lastUpdated` を指定します。
+
+```yaml
+---
+lastUpdated: false
+---
+```
+
+より詳しくは [デフォルトテーマ: 最終更新](./default-theme-config#lastupdated) を参照してください。テーマレベルで truthy な値を設定すると、サイトまたはページで明示的に無効化しない限り、この機能は有効になります。
diff --git a/docs/ja/reference/default-theme-layout.md b/docs/ja/reference/default-theme-layout.md
new file mode 100644
index 00000000..e241d03e
--- /dev/null
+++ b/docs/ja/reference/default-theme-layout.md
@@ -0,0 +1,62 @@
+# レイアウト {#layout}
+
+ページの [フロントマター](./frontmatter-config) の `layout` オプションでページのレイアウトを選択できます。利用可能なレイアウトは `doc`、`page`、`home` の 3 種類です。何も指定しない場合は `doc` として扱われます。
+
+```yaml
+---
+layout: doc
+---
+```
+
+## Doc レイアウト {#doc-layout}
+
+`doc` は既定のレイアウトで、Markdown 全体を「ドキュメント」風にスタイリングします。コンテンツ全体を `vp-doc` という CSS クラスでラップし、その配下の要素にスタイルを適用します。
+
+`p` や `h2` などほぼすべての汎用要素に特別なスタイルが当たります。そのため、Markdown 内にカスタム HTML を追加した場合も、これらのスタイルの影響を受ける点に注意してください。
+
+また、以下のようなドキュメント特有の機能も提供します。これらはこのレイアウトでのみ有効になります。
+
+- 編集リンク（Edit Link）
+- 前後リンク（Prev / Next Link）
+- アウトライン（Outline）
+- [Carbon 広告](./default-theme-carbon-ads)
+
+## Page レイアウト {#page-layout}
+
+`page` は「ブランクページ」として扱われます。Markdown はパースされ、[Markdown 拡張](../guide/markdown) も `doc` と同様に機能しますが、既定のスタイルは適用されません。
+
+このレイアウトでは、VitePress テーマにマークアップを干渉させず、すべてを自分でスタイルできます。独自のカスタムページを作成したい場合に便利です。
+
+なお、このレイアウトでも、ページがサイドバー設定に一致する場合はサイドバーが表示されます。
+
+## Home レイアウト {#home-layout}
+
+`home` はテンプレート化された「ホームページ」を生成します。このレイアウトでは、`hero` や `features` などの追加オプションでコンテンツをさらにカスタマイズできます。詳しくは [デフォルトテーマ: ホームページ](./default-theme-home-page) を参照してください。
+
+## レイアウトなし {#no-layout}
+
+レイアウトを一切適用したくない場合は、フロントマターで `layout: false` を指定します。これは（既定でサイドバー／ナビバー／フッターなしの）完全にカスタマイズ可能なランディングページを作りたい場合に役立ちます。
+
+## カスタムレイアウト {#custom-layout}
+
+カスタムレイアウトを使用することもできます。
+
+```md
+---
+layout: foo
+---
+```
+
+これは、コンテキストに登録された `foo` という名前のコンポーネントを探します。たとえば、`.vitepress/theme/index.ts` でグローバル登録できます。
+
+```ts
+import DefaultTheme from 'vitepress/theme'
+import Foo from './Foo.vue'
+
+export default {
+ extends: DefaultTheme,
+ enhanceApp({ app }) {
+ app.component('foo', Foo)
+ }
+}
+```
diff --git a/docs/ja/reference/default-theme-nav.md b/docs/ja/reference/default-theme-nav.md
new file mode 100644
index 00000000..207bf9e9
--- /dev/null
+++ b/docs/ja/reference/default-theme-nav.md
@@ -0,0 +1,215 @@
+# ナビゲーション {#nav}
+
+ナビはページ上部に表示されるナビゲーションバーです。サイトタイトル、グローバルメニューリンクなどを含みます。
+
+## サイトタイトルとロゴ {#site-title-and-logo}
+
+既定では、ナビには [`config.title`](./site-config#title) の値が表示されます。ナビに表示する文字列を変更したい場合は、`themeConfig.siteTitle` にカスタム文字列を指定します。
+
+```js
+export default {
+ themeConfig: {
+ siteTitle: 'My Custom Title'
+ }
+}
+```
+
+サイトのロゴがある場合は、画像へのパスを渡すと表示できます。ロゴは `public` 直下に配置し、絶対パスで指定してください。
+
+```js
+export default {
+ themeConfig: {
+ logo: '/my-logo.svg'
+ }
+}
+```
+
+ロゴを追加すると、サイトタイトルと並んで表示されます。ロゴだけを表示したい場合は、`siteTitle` を `false` に設定してタイトル文字列を非表示にできます。
+
+```js
+export default {
+ themeConfig: {
+ logo: '/my-logo.svg',
+ siteTitle: false
+ }
+}
+```
+
+ダーク／ライトモードでロゴを切り替えたり、`alt` 属性を付けたい場合は、ロゴにオブジェクトを渡すこともできます。詳細は [`themeConfig.logo`](./default-theme-config#logo) を参照してください。
+
+## ナビゲーションリンク {#navigation-links}
+
+`themeConfig.nav` オプションでナビにリンクを追加できます。
+
+```js
+export default {
+ themeConfig: {
+ nav: [
+ { text: 'Guide', link: '/guide' },
+ { text: 'Config', link: '/config' },
+ { text: 'Changelog', link: 'https://github.com/...' }
+ ]
+ }
+}
+```
+
+`text` はナビに表示される文字列、`link` はクリック時に遷移するリンクです。内部リンクは `.md` 拡張子を付けず、必ず `/` で始めるようにしてください。
+
+`link` には、[`PageData`](./runtime-api#usedata) を受け取ってパスを返す関数を指定することもできます。
+
+ナビリンクはドロップダウンメニューにもできます。リンクオプションに `items` を設定してください。
+
+```js
+export default {
+ themeConfig: {
+ nav: [
+ { text: 'Guide', link: '/guide' },
+ {
+ text: 'Dropdown Menu',
+ items: [
+ { text: 'Item A', link: '/item-1' },
+ { text: 'Item B', link: '/item-2' },
+ { text: 'Item C', link: '/item-3' }
+ ]
+ }
+ ]
+ }
+}
+```
+
+なお、ドロップダウンのタイトル（上の例の `Dropdown Menu`）には `link` は設定できません。ドロップダウンを開くボタンになるためです。
+
+さらに、ドロップダウン内を「セクション」に分けることもできます（入れ子の `items` を使います）。
+
+```js
+export default {
+ themeConfig: {
+ nav: [
+ { text: 'Guide', link: '/guide' },
+ {
+ text: 'Dropdown Menu',
+ items: [
+ {
+ // セクションのタイトル
+ text: 'Section A Title',
+ items: [
+ { text: 'Section A Item A', link: '...' },
+ { text: 'Section B Item B', link: '...' }
+ ]
+ }
+ ]
+ },
+ {
+ text: 'Dropdown Menu',
+ items: [
+ {
+ // タイトルは省略することも可能
+ items: [
+ { text: 'Section A Item A', link: '...' },
+ { text: 'Section B Item B', link: '...' }
+ ]
+ }
+ ]
+ }
+ ]
+ }
+}
+```
+
+### リンクの「アクティブ」状態をカスタマイズ {#customize-link-s-active-state}
+
+現在のページが特定のパス配下にあるとき、該当するナビ項目がハイライトされます。一致させるパスをカスタマイズしたい場合は、`activeMatch` に **正規表現文字列** を指定します。
+
+```js
+export default {
+ themeConfig: {
+ nav: [
+ // ユーザーが `/config/` 配下にいるときにアクティブになる
+ {
+ text: 'Guide',
+ link: '/guide',
+ activeMatch: '/config/'
+ }
+ ]
+ }
+}
+```
+
+::: warning
+`activeMatch` は正規表現 **オブジェクト** ではなく、**文字列** で指定してください。ビルド時のシリアライズの都合で `RegExp` は使用できません。
+:::
+
+### リンクの `target` と `rel` をカスタマイズ {#customize-link-s-target-and-rel-attributes}
+
+既定では、リンクが外部かどうかに応じて VitePress が `target` と `rel` を自動設定します。必要であれば明示的に指定することもできます。
+
+```js
+export default {
+ themeConfig: {
+ nav: [
+ {
+ text: 'Merchandise',
+ link: 'https://www.thegithubshop.com/',
+ target: '_self',
+ rel: 'sponsored'
+ }
+ ]
+ }
+}
+```
+
+## ソーシャルリン� {#social-links}
+
+[`socialLinks`](./default-theme-config#sociallinks) を参照してください。
+
+## カスタムコンポーネント {#custom-components}
+
+`component` オプションを使って、ナビゲーションバーにカスタムコンポーネントを配置できます。`component` には Vue コンポーネント名を指定し、[Theme.enhanceApp](../guide/custom-theme#theme-interface) で **グローバル登録** しておく必要があります。
+
+```js [.vitepress/config.js]
+export default {
+ themeConfig: {
+ nav: [
+ {
+ text: 'My Menu',
+ items: [
+ {
+ component: 'MyCustomComponent',
+ // コンポーネントに渡す任意の props
+ props: {
+ title: 'My Custom Component'
+ }
+ }
+ ]
+ },
+ {
+ component: 'AnotherCustomComponent'
+ }
+ ]
+ }
+}
+```
+
+次に、コンポーネントをグローバル登録します。
+
+```js [.vitepress/theme/index.js]
+import DefaultTheme from 'vitepress/theme'
+
+import MyCustomComponent from './components/MyCustomComponent.vue'
+import AnotherCustomComponent from './components/AnotherCustomComponent.vue'
+
+/** @type {import('vitepress').Theme} */
+export default {
+ extends: DefaultTheme,
+ enhanceApp({ app }) {
+ app.component('MyCustomComponent', MyCustomComponent)
+ app.component('AnotherCustomComponent', AnotherCustomComponent)
+ }
+}
+```
+
+コンポーネントはナビゲーションバー内にレンダリングされます。VitePress は次の追加 props をコンポーネントに提供します。
+
+- `screenMenu`: モバイルのナビメニュー内にあるかどうかを示す任意の boolean
+
+e2e テスト内の例は[こちら](https://github.com/vuejs/vitepress/tree/main/__tests__/e2e/.vitepress)を参照してください。
diff --git a/docs/ja/reference/default-theme-prev-next-links.md b/docs/ja/reference/default-theme-prev-next-links.md
new file mode 100644
index 00000000..7b15d699
--- /dev/null
+++ b/docs/ja/reference/default-theme-prev-next-links.md
@@ -0,0 +1,43 @@
+# 前／次リンク {#prev-next-links}
+
+ドキュメントのフッターに表示される「前のページ」「次のページ」のテキストとリンクをカスタマイズできます。サイドバーに表示しているタイトルとは別の文言を使いたい場合や、フッターを無効化したり、サイドバーに含まれていないページへリンクしたい場合に便利です。
+
+## prev
+
+- 型: `string | false | { text?: string; link?: string }`
+
+- 詳細:
+
+ 前のページへのリンクに表示するテキスト／リンクを指定します。フロントマターで設定しない場合は、サイドバー設定から自動推測されます。
+
+- 例:
+
+ - テキストだけをカスタマイズ:
+
+ ```yaml
+ ---
+ prev: 'Get Started | Markdown'
+ ---
+ ```
+
+ - テキストとリンクの両方をカスタマイズ:
+
+ ```yaml
+ ---
+ prev:
+ text: 'Markdown'
+ link: '/guide/markdown'
+ ---
+ ```
+
+ - 前のページを非表示にする:
+
+ ```yaml
+ ---
+ prev: false
+ ---
+ ```
+
+## next
+
+`prev` と同様ですが、次のページ用の設定です。
diff --git a/docs/ja/reference/default-theme-search.md b/docs/ja/reference/default-theme-search.md
new file mode 100644
index 00000000..e15de4ef
--- /dev/null
+++ b/docs/ja/reference/default-theme-search.md
@@ -0,0 +1,451 @@
+---
+outline: deep
+---
+
+# 検索 {#search}
+
+## ローカル検索 {#local-search}
+
+VitePress は、[minisearch](https://github.com/lucaong/minisearch/) によるブラウザ内インデックスを使った曖昧一致の全文検索をサポートします。有効化するには、`.vitepress/config.ts` で `themeConfig.search.provider` を `'local'` に設定します。
+
+```ts
+import { defineConfig } from 'vitepress'
+
+export default defineConfig({
+ themeConfig: {
+ search: {
+ provider: 'local'
+ }
+ }
+})
+```
+
+表示例:
+
+
+
+代わりに [Algolia DocSearch](#algolia-search) や、次のコミュニティ製プラグインを使うこともできます。
+
+-
+-
+-
+
+### i18n {#local-search-i18n}
+
+多言語検索を行う設定例です。
+
+```ts
+import { defineConfig } from 'vitepress'
+
+export default defineConfig({
+ themeConfig: {
+ search: {
+ provider: 'local',
+ options: {
+ locales: {
+ zh: { // 既定ロケールの文言も翻訳したい場合はこれを `root` に
+ translations: {
+ button: {
+ buttonText: '搜索',
+ buttonAriaLabel: '搜索'
+ },
+ modal: {
+ displayDetails: '显示详细列表',
+ resetButtonTitle: '重置搜索',
+ backButtonTitle: '关闭搜索',
+ noResultsText: '没有结果',
+ footer: {
+ selectText: '选择',
+ selectKeyAriaLabel: '输入',
+ navigateText: '导航',
+ navigateUpKeyAriaLabel: '上箭头',
+ navigateDownKeyAriaLabel: '下箭头',
+ closeText: '关闭',
+ closeKeyAriaLabel: 'esc'
+ }
+ }
+ }
+ }
+ }
+ }
+ }
+ }
+})
+```
+
+### miniSearch のオプション {#mini-search-options}
+
+MiniSearch の設定例です。
+
+```ts
+import { defineConfig } from 'vitepress'
+
+export default defineConfig({
+ themeConfig: {
+ search: {
+ provider: 'local',
+ options: {
+ miniSearch: {
+ /**
+ * @type {Pick}
+ */
+ options: {
+ /* ... */
+ },
+ /**
+ * @type {import('minisearch').SearchOptions}
+ * @default
+ * { fuzzy: 0.2, prefix: true, boost: { title: 4, text: 2, titles: 1 } }
+ */
+ searchOptions: {
+ /* ... */
+ }
+ }
+ }
+ }
+ }
+})
+```
+
+詳しくは [MiniSearch のドキュメント](https://lucaong.github.io/minisearch/classes/MiniSearch.MiniSearch.html) を参照してください。
+
+### コンテンツレンダラーのカスタマイズ {#custom-content-renderer}
+
+インデックス前に Markdown コンテンツをレンダリングする関数をカスタマイズできます。
+
+```ts
+import { defineConfig } from 'vitepress'
+
+export default defineConfig({
+ themeConfig: {
+ search: {
+ provider: 'local',
+ options: {
+ /**
+ * @param {string} src
+ * @param {import('vitepress').MarkdownEnv} env
+ * @param {import('markdown-it-async')} md
+ */
+ async _render(src, env, md) {
+ // HTML 文字列を返す
+ }
+ }
+ }
+ }
+})
+```
+
+この関数はクライアント側のサイトデータからは除外されるため、Node.js の API を使用できます。
+
+#### 例: 検索対象からページを除外する {#example-excluding-pages-from-search}
+
+フロントマターに `search: false` を追加すると、そのページを検索対象から除外できます。あるいは次のようにもできます。
+
+```ts
+import { defineConfig } from 'vitepress'
+
+export default defineConfig({
+ themeConfig: {
+ search: {
+ provider: 'local',
+ options: {
+ async _render(src, env, md) {
+ const html = await md.renderAsync(src, env)
+ if (env.frontmatter?.search === false) return ''
+ if (env.relativePath.startsWith('some/path')) return ''
+ return html
+ }
+ }
+ }
+ }
+})
+```
+
+::: warning 注意
+カスタムの `_render` 関数を提供する場合、`search: false` の処理は自分で行う必要があります。また、`env` は `md.renderAsync` の呼び出し前には完全ではないため、`frontmatter` などの任意プロパティのチェックはその後に行ってください。
+:::
+
+#### 例: コンテンツの変換 — 見出しアンカーを追加 {#example-transforming-content-adding-anchors}
+
+```ts
+import { defineConfig } from 'vitepress'
+
+export default defineConfig({
+ themeConfig: {
+ search: {
+ provider: 'local',
+ options: {
+ async _render(src, env, md) {
+ const html = await md.renderAsync(src, env)
+ if (env.frontmatter?.title)
+ return await md.renderAsync(`# ${env.frontmatter.title}`) + html
+ return html
+ }
+ }
+ }
+ }
+})
+```
+
+## Algolia 検索 {#algolia-search}
+
+VitePress は [Algolia DocSearch](https://docsearch.algolia.com/docs/what-is-docsearch) によるサイト検索をサポートします。導入は公式のガイドを参照してください。`.vitepress/config.ts` では最低限次の設定が必要です。
+
+```ts
+import { defineConfig } from 'vitepress'
+
+export default defineConfig({
+ themeConfig: {
+ search: {
+ provider: 'algolia',
+ options: {
+ appId: '...',
+ apiKey: '...',
+ indexName: '...'
+ }
+ }
+ }
+})
+```
+
+### i18n {#algolia-search-i18n}
+
+多言語検索の設定例です。
+
+```ts
+import { defineConfig } from 'vitepress'
+
+export default defineConfig({
+ themeConfig: {
+ search: {
+ provider: 'algolia',
+ options: {
+ appId: '...',
+ apiKey: '...',
+ indexName: '...',
+ locales: {
+ zh: {
+ placeholder: '搜索文档',
+ translations: {
+ button: {
+ buttonText: '搜索文档',
+ buttonAriaLabel: '搜索文档'
+ },
+ modal: {
+ searchBox: {
+ clearButtonTitle: '清除查询条件',
+ clearButtonAriaLabel: '清除查询条件',
+ closeButtonText: '关闭',
+ closeButtonAriaLabel: '关闭',
+ placeholderText: '搜索文档',
+ placeholderTextAskAi: '向 AI 提问：',
+ placeholderTextAskAiStreaming: '回答中...',
+ searchInputLabel: '搜索',
+ backToKeywordSearchButtonText: '返回关键字搜索',
+ backToKeywordSearchButtonAriaLabel: '返回关键字搜索'
+ },
+ startScreen: {
+ recentSearchesTitle: '搜索历史',
+ noRecentSearchesText: '没有搜索历史',
+ saveRecentSearchButtonTitle: '保存至搜索历史',
+ removeRecentSearchButtonTitle: '从搜索历史中移除',
+ favoriteSearchesTitle: '收藏',
+ removeFavoriteSearchButtonTitle: '从收藏中移除',
+ recentConversationsTitle: '最近的对话',
+ removeRecentConversationButtonTitle: '从历史记录中删除对话'
+ },
+ errorScreen: {
+ titleText: '无法获取结果',
+ helpText: '你可能需要检查你的网络连接'
+ },
+ noResultsScreen: {
+ noResultsText: '无法找到相关结果',
+ suggestedQueryText: '你可以尝试查询',
+ reportMissingResultsText: '你认为该查询应该有结果？',
+ reportMissingResultsLinkText: '点击反馈'
+ },
+ resultsScreen: {
+ askAiPlaceholder: '向 AI 提问： '
+ },
+ askAiScreen: {
+ disclaimerText: '答案由 AI 生成，可能不准确，请自行验证。',
+ relatedSourcesText: '相关来源',
+ thinkingText: '思考中...',
+ copyButtonText: '复制',
+ copyButtonCopiedText: '已复制！',
+ copyButtonTitle: '复制',
+ likeButtonTitle: '赞',
+ dislikeButtonTitle: '踩',
+ thanksForFeedbackText: '感谢你的反馈！',
+ preToolCallText: '搜索中...',
+ duringToolCallText: '搜索 ',
+ afterToolCallText: '已搜索'
+ },
+ footer: {
+ selectText: '选择',
+ submitQuestionText: '提交问题',
+ selectKeyAriaLabel: 'Enter 键',
+ navigateText: '切换',
+ navigateUpKeyAriaLabel: '向上箭头',
+ navigateDownKeyAriaLabel: '向下箭头',
+ closeText: '关闭',
+ backToSearchText: '返回搜索',
+ closeKeyAriaLabel: 'Esc 键',
+ poweredByText: '搜索提供者'
+ }
+ }
+ }
+ }
+ }
+ }
+ }
+ }
+})
+```
+
+[これらのオプション](https://github.com/vuejs/vitepress/blob/main/types/docsearch.d.ts) は上書きできます。詳細は Algolia の公式ドキュメントを参照してください。
+
+### Algolia Ask AI のサポート {#ask-ai}
+
+**Ask AI** を有効にするには、`options` 内に `askAi` オプション（またはその一部）を指定します。
+
+```ts
+import { defineConfig } from 'vitepress'
+
+export default defineConfig({
+ themeConfig: {
+ search: {
+ provider: 'algolia',
+ options: {
+ appId: '...',
+ apiKey: '...',
+ indexName: '...',
+ // askAi: "YOUR-ASSISTANT-ID"
+ // または
+ askAi: {
+ // 少なくとも Algolia から受け取った assistantId を指定
+ assistantId: 'XXXYYY',
+ // 任意の上書き — 省略時は上位の appId/apiKey/indexName を再利用
+ // apiKey: '...',
+ // appId: '...',
+ // indexName: '...'
+ }
+ }
+ }
+ }
+})
+```
+
+::: warning 注意
+キーワード検索を既定にして Ask AI を使わない場合は、`askAi` を指定しないでください。
+:::
+
+Ask AI UI の翻訳は `options.translations.modal.askAiScreen` と `options.translations.resultsScreen` にあります。すべてのキーは[型定義](https://github.com/vuejs/vitepress/blob/main/types/docsearch.d.ts)を参照してください。
+
+### クローラー設定 {#crawler-config}
+
+このサイトで使用している設定を元にした例です。
+
+```ts
+new Crawler({
+ appId: '...',
+ apiKey: '...',
+ rateLimit: 8,
+ startUrls: ['https://vitepress.dev/'],
+ renderJavaScript: false,
+ sitemaps: [],
+ exclusionPatterns: [],
+ ignoreCanonicalTo: false,
+ discoveryPatterns: ['https://vitepress.dev/**'],
+ schedule: 'at 05:10 on Saturday',
+ actions: [
+ {
+ indexName: 'vitepress',
+ pathsToMatch: ['https://vitepress.dev/**'],
+ recordExtractor: ({ $, helpers }) => {
+ return helpers.docsearch({
+ recordProps: {
+ lvl1: '.content h1',
+ content: '.content p, .content li',
+ lvl0: {
+ selectors: 'section.has-active div h2',
+ defaultValue: 'Documentation'
+ },
+ lvl2: '.content h2',
+ lvl3: '.content h3',
+ lvl4: '.content h4',
+ lvl5: '.content h5'
+ },
+ indexHeadings: true
+ })
+ }
+ }
+ ],
+ initialIndexSettings: {
+ vitepress: {
+ attributesForFaceting: ['type', 'lang'],
+ attributesToRetrieve: ['hierarchy', 'content', 'anchor', 'url'],
+ attributesToHighlight: ['hierarchy', 'hierarchy_camel', 'content'],
+ attributesToSnippet: ['content:10'],
+ camelCaseAttributes: ['hierarchy', 'hierarchy_radio', 'content'],
+ searchableAttributes: [
+ 'unordered(hierarchy_radio_camel.lvl0)',
+ 'unordered(hierarchy_radio.lvl0)',
+ 'unordered(hierarchy_radio_camel.lvl1)',
+ 'unordered(hierarchy_radio.lvl1)',
+ 'unordered(hierarchy_radio_camel.lvl2)',
+ 'unordered(hierarchy_radio.lvl2)',
+ 'unordered(hierarchy_radio_camel.lvl3)',
+ 'unordered(hierarchy_radio.lvl3)',
+ 'unordered(hierarchy_radio_camel.lvl4)',
+ 'unordered(hierarchy_radio.lvl4)',
+ 'unordered(hierarchy_radio_camel.lvl5)',
+ 'unordered(hierarchy_radio.lvl5)',
+ 'unordered(hierarchy_radio_camel.lvl6)',
+ 'unordered(hierarchy_radio.lvl6)',
+ 'unordered(hierarchy_camel.lvl0)',
+ 'unordered(hierarchy.lvl0)',
+ 'unordered(hierarchy_camel.lvl1)',
+ 'unordered(hierarchy.lvl1)',
+ 'unordered(hierarchy_camel.lvl2)',
+ 'unordered(hierarchy.lvl2)',
+ 'unordered(hierarchy_camel.lvl3)',
+ 'unordered(hierarchy.lvl3)',
+ 'unordered(hierarchy_camel.lvl4)',
+ 'unordered(hierarchy.lvl4)',
+ 'unordered(hierarchy_camel.lvl5)',
+ 'unordered(hierarchy.lvl5)',
+ 'unordered(hierarchy_camel.lvl6)',
+ 'unordered(hierarchy.lvl6)',
+ 'content'
+ ],
+ distinct: true,
+ attributeForDistinct: 'url',
+ customRanking: [
+ 'desc(weight.pageRank)',
+ 'desc(weight.level)',
+ 'asc(weight.position)'
+ ],
+ ranking: [
+ 'words',
+ 'filters',
+ 'typo',
+ 'attribute',
+ 'proximity',
+ 'exact',
+ 'custom'
+ ],
+ highlightPreTag: '',
+ highlightPostTag: '',
+ minWordSizefor1Typo: 3,
+ minWordSizefor2Typos: 7,
+ allowTyposOnNumericTokens: false,
+ minProximity: 1,
+ ignorePlurals: true,
+ advancedSyntax: true,
+ attributeCriteriaComputedByMinProximity: true,
+ removeWordsIfNoResults: 'allOptional'
+ }
+ }
+})
+```
diff --git a/docs/ja/reference/default-theme-sidebar.md b/docs/ja/reference/default-theme-sidebar.md
new file mode 100644
index 00000000..ddd87383
--- /dev/null
+++ b/docs/ja/reference/default-theme-sidebar.md
@@ -0,0 +1,180 @@
+# サイドバー {#sidebar}
+
+サイドバーはドキュメントの主要なナビゲーションブロックです。[`themeConfig.sidebar`](./default-theme-config#sidebar) でメニューを設定できます。
+
+```js
+export default {
+ themeConfig: {
+ sidebar: [
+ {
+ text: 'Guide',
+ items: [
+ { text: 'Introduction', link: '/introduction' },
+ { text: 'Getting Started', link: '/getting-started' },
+ ...
+ ]
+ }
+ ]
+ }
+}
+```
+
+## 基本 {#the-basics}
+
+最もシンプルな構成は、リンクの配列を 1 つ渡す方法です。第 1 階層のアイテムがサイドバーの「セクション」を表します。各セクションは `text`（セクションのタイトル）と、実際のナビゲーションリンクである `items` を持ちます。
+
+```js
+export default {
+ themeConfig: {
+ sidebar: [
+ {
+ text: 'Section Title A',
+ items: [
+ { text: 'Item A', link: '/item-a' },
+ { text: 'Item B', link: '/item-b' },
+ ...
+ ]
+ },
+ {
+ text: 'Section Title B',
+ items: [
+ { text: 'Item C', link: '/item-c' },
+ { text: 'Item D', link: '/item-d' },
+ ...
+ ]
+ }
+ ]
+ }
+}
+```
+
+各 `link` は `/` で始まる実ファイルへのパスを指定します。リンクの末尾を `/` で終わらせると、対応するディレクトリの `index.md` が表示されます。
+
+```js
+export default {
+ themeConfig: {
+ sidebar: [
+ {
+ text: 'Guide',
+ items: [
+ // `/guide/index.md` を表示
+ { text: 'Introduction', link: '/guide/' }
+ ]
+ }
+ ]
+ }
+}
+```
+
+サイドバーのアイテムは、ルートから数えて最大 6 階層まで入れ子にできます。7 階層以上は無視され、表示されません。
+
+```js
+export default {
+ themeConfig: {
+ sidebar: [
+ {
+ text: 'Level 1',
+ items: [
+ {
+ text: 'Level 2',
+ items: [
+ {
+ text: 'Level 3',
+ items: [
+ ...
+ ]
+ }
+ ]
+ }
+ ]
+ }
+ ]
+ }
+}
+```
+
+## 複数のサイドバー {#multiple-sidebars}
+
+ページのパスに応じて異なるサイドバーを表示できます。たとえば、このサイトのように「Guide」セクションと「Config」セクションでナビゲーションを分けたい場合に便利です。
+
+まず、対象のセクションごとにディレクトリを分けてページを配置します。
+
+```
+.
+├─ guide/
+│ ├─ index.md
+│ ├─ one.md
+│ └─ two.md
+└─ config/
+ ├─ index.md
+ ├─ three.md
+ └─ four.md
+```
+
+次に、各セクション用のサイドバーを設定します。この場合、配列ではなくオブジェクトを渡します。
+
+```js
+export default {
+ themeConfig: {
+ sidebar: {
+ // ユーザーが `guide` ディレクトリ配下にいるときに表示
+ '/guide/': [
+ {
+ text: 'Guide',
+ items: [
+ { text: 'Index', link: '/guide/' },
+ { text: 'One', link: '/guide/one' },
+ { text: 'Two', link: '/guide/two' }
+ ]
+ }
+ ],
+
+ // ユーザーが `config` ディレクトリ配下にいるときに表示
+ '/config/': [
+ {
+ text: 'Config',
+ items: [
+ { text: 'Index', link: '/config/' },
+ { text: 'Three', link: '/config/three' },
+ { text: 'Four', link: '/config/four' }
+ ]
+ }
+ ]
+ }
+ }
+}
+```
+
+## 折りたたみ可能なサイドバーグループ {#collapsible-sidebar-groups}
+
+サイドバーグループに `collapsed` オプションを追加すると、各セクションの開閉トグルが表示されます。
+
+```js
+export default {
+ themeConfig: {
+ sidebar: [
+ {
+ text: 'Section Title A',
+ collapsed: false,
+ items: [...]
+ }
+ ]
+ }
+}
+```
+
+既定ではすべてのセクションが「開いた」状態です。初回表示時に「閉じた」状態にしたい場合は、`collapsed` を `true` に設定します。
+
+```js
+export default {
+ themeConfig: {
+ sidebar: [
+ {
+ text: 'Section Title A',
+ collapsed: true,
+ items: [...]
+ }
+ ]
+ }
+}
+```
diff --git a/docs/ja/reference/default-theme-team-page.md b/docs/ja/reference/default-theme-team-page.md
new file mode 100644
index 00000000..5f02d4d0
--- /dev/null
+++ b/docs/ja/reference/default-theme-team-page.md
@@ -0,0 +1,255 @@
+
+
+# チームページ {#team-page}
+
+チームを紹介したい場合は、Team コンポーネント群を使ってチームページを構成できます。使い方は 2 通りあり、ドキュメントページに埋め込む方法と、専用のチームページを作成する方法があります。
+
+## ページ内にメンバー一覧を表示する {#show-team-members-in-a-page}
+
+任意のページでチームメンバーの一覧を表示するには、`vitepress/theme` からエクスポートされている `` コンポーネントを使用します。
+
+```html
+
+
+# 私たちのチーム
+
+私たちの素晴らしいチームを紹介します。
+
+` コンポーネントには `small` と `medium` の 2 種類のサイズがあります。好みによりますが、ドキュメントページ内で使う場合は `small` が馴染みやすいことが多いでしょう。各メンバーに「説明文」や「スポンサー」ボタンなど、追加のプロパティを付けることもできます。詳細は [``](#vpteammembers) を参照してください。
+
+小規模なチームで専用ページまでは不要な場合や、文脈上の参考として一部のメンバーのみを紹介したい場合は、ドキュメントページへ埋め込む方法が適しています。
+
+メンバーが多い場合や、より広いスペースで紹介したい場合は、[専用のチームページを作成する](#専用のチームページを作成する) ことを検討してください。
+
+## 専用のチームページを作成する {#create-a-full-team-page}
+
+ドキュメントページにメンバーを追加する代わりに、カスタムの [ホームページ](./default-theme-home-page) と同様、専用のチームページを作成することもできます。
+
+まず新しい md ファイルを作成します。ファイル名は任意ですが、ここでは `team.md` とします。このファイルでフロントマターに `layout: page` を設定し、その後 `TeamPage` コンポーネント群を使ってページを構成します。
+
+```html
+---
+layout: page
+---
+
+
+
+
+
+ 私たちのチーム
+
+
+ VitePress の開発は国際的なチームによって主導されています。
+ その一部を以下に紹介します。
+
+
+
+```
+
+専用のチームページを作る際は、必ずすべてのチーム関連コンポーネントを `` でラップしてください。レイアウトや余白などが適切に適用されます。
+
+`` はページタイトルのセクションを追加します。タイトルは `` 見出しになります。`#title` と `#lead` スロットでチームについて説明を書きましょう。
+
+`` はドキュメントページで使う場合と同様に、メンバー一覧を表示します。
+
+### セクションを追加してメンバーを分ける {#add-sections-to-divide-team-members}
+
+チームページに「セクション」を追加できます。たとえば、コアメンバーとコミュニティパートナーなど、役割ごとにメンバーを分けて説明しやすくできます。
+
+そのためには、先ほど作成した `team.md` に `` コンポーネントを追加します。
+
+```html
+---
+layout: page
+---
+
+
+
+
+ 私たちのチーム
+ ...
+
+
+ パートナー
+ ...
+
+
+
+```
+
+`` は `VPTeamPageTitle` と同様に `#title` と `#lead` のスロットを持ち、さらにメンバー表示用の `#members` スロットを備えます。
+
+`#members` スロット内に `` を配置するのを忘れないでください。
+
+## ``
+
+`` コンポーネントは、与えられたメンバー配列を表示します。
+
+```html
+`
+
+専用のチームページを作成する際のルートコンポーネントです。単一のスロットのみを受け取り、渡されたチーム関連コンポーネント全体に適切なスタイルを適用します。
+
+## ``
+
+ページの「タイトル」セクションを追加します。`` の直下に置くのが最適です。`#title` と `#lead` のスロットを受け取ります。
+
+```html
+
+
+
+ 私たちのチーム
+
+
+ VitePress の開発は国際的なチームによって主導されています。
+ その一部を以下に紹介します。
+
+
+
+```
+
+## ``
+
+チームページ内に「セクション」を作成します。`#title`、`#lead`、`#members` の各スロットを受け取ります。`` の中に必要な数だけ追加できます。
+
+```html
+
+ ...
+
+ パートナー
+ Lorem ipsum...
+
+
+
+```
diff --git a/docs/ja/reference/frontmatter-config.md b/docs/ja/reference/frontmatter-config.md
new file mode 100644
index 00000000..e6b8b5ca
--- /dev/null
+++ b/docs/ja/reference/frontmatter-config.md
@@ -0,0 +1,240 @@
+---
+outline: deep
+---
+
+# フロントマター設定 {#frontmatter-config}
+
+フロントマターはページ単位の設定を可能にします。各 Markdown ファイルで、サイト全体やテーマレベルの設定を上書きできます。フロントマターでしか定義できない項目もあります。
+
+使用例:
+
+```md
+---
+title: Docs with VitePress
+editLink: true
+---
+```
+
+Vue の式内では、グローバル `$frontmatter` を介してフロントマターデータにアクセスできます。
+
+```md
+{{ $frontmatter.title }}
+```
+
+## title
+
+- 型: `string`
+
+ページのタイトルです。[config.title](./site-config#title) と同じ意味で、サイトレベルの設定を上書きします。
+
+```yaml
+---
+title: VitePress
+---
+```
+
+## titleTemplate
+
+- 型: `string | boolean`
+
+タイトルのサフィックスです。[config.titleTemplate](./site-config#titletemplate) と同じ意味で、サイトレベルの設定を上書きします。
+
+```yaml
+---
+title: VitePress
+titleTemplate: Vite & Vue powered static site generator
+---
+```
+
+## description
+
+- 型: `string`
+
+ページの説明です。[config.description](./site-config#description) と同じ意味で、サイトレベルの設定を上書きします。
+
+```yaml
+---
+description: VitePress
+---
+```
+
+## head
+
+- 型: `HeadConfig[]`
+
+現在のページに追加で挿入する `` タグを指定します。サイトレベル設定で挿入されたタグの後に追加されます。
+
+```yaml
+---
+head:
+ - - meta
+ - name: description
+ content: hello
+ - - meta
+ - name: keywords
+ content: super duper SEO
+---
+```
+
+```ts
+type HeadConfig =
+ | [string, Record]
+ | [string, Record, string]
+```
+
+## デフォルトテーマ専用 {#default-theme-only}
+
+以下のフロントマター項目は、デフォルトテーマ使用時にのみ適用されます。
+
+### layout
+
+- 型: `doc | home | page`
+- 既定値: `doc`
+
+ページのレイアウトを決めます。
+
+- `doc` — Markdown コンテンツにドキュメント向けの既定スタイルを適用します。
+- `home` — 「ホームページ」用の特別なレイアウト。`hero` や `features` を追加指定して、ランディングページを素早く構築できます。
+- `page` — `doc` と似ていますが、コンテンツにスタイルを適用しません。完全にカスタムなページを作りたい場合に便利です。
+
+```yaml
+---
+layout: doc
+---
+```
+
+### hero {{ theme.footer.copyright }}
+
+```
+
+## `useRoute`
+ /**
+ * ルートが変わる前に呼ばれる。`false` を返すと遷移をキャンセル
+ */
+ onBeforeRouteChange?: (to: string) => Awaitable
+ /**
+ * ページコンポーネントが読み込まれる前（履歴が更新された後）に呼ばれる。
+ * `false` を返すと遷移をキャンセル
+ */
+ onBeforePageLoad?: (to: string) => Awaitable
+ /**
+ * ページコンポーネントが読み込まれた後（更新前）に呼ばれる
+ */
+ onAfterPageLoad?: (to: string) => Awaitable
+ /**
+ * ルートが変わった後に呼ばれる
+ */
+ onAfterRouteChange?: (to: string) => Awaitable
+}
+```
+
+## `withBase` Custom Layout!
+
+
+```
+
+- 関連: [SSR 互換性](../guide/ssr-compat)
+
+## `$frontmatter` /.vitepress/config.[ext]` から解決されます。`` は VitePress の[プロジェクトルート](../guide/routing#root-and-source-directory)で、`[ext]` にはサポートされる拡張子が入ります。TypeScript はそのまま使えます。サポートされる拡張子は `.js`、`.ts`、`.mjs`、`.mts` です。
+
+設定ファイルでは ES Modules 構文の使用を推奨します。設定オブジェクトをデフォルトエクスポートしてください。
+
+```ts
+export default {
+ // アプリレベルの設定
+ lang: 'en-US',
+ title: 'VitePress',
+ description: 'Vite & Vue powered static site generator.',
+ ...
+}
+```
+
+::: details 動的（非同期）設定
+
+設定を動的に生成する必要がある場合は、関数をデフォルトエクスポートすることもできます。例:
+
+```ts
+import { defineConfig } from 'vitepress'
+
+export default async () => {
+ const posts = await (await fetch('https://my-cms.com/blog-posts')).json()
+
+ return defineConfig({
+ // アプリレベル設定
+ lang: 'en-US',
+ title: 'VitePress',
+ description: 'Vite & Vue powered static site generator.',
+
+ // テーマレベル設定
+ themeConfig: {
+ sidebar: [
+ ...posts.map((post) => ({
+ text: post.name,
+ link: `/posts/${post.name}`
+ }))
+ ]
+ }
+ })
+}
+```
+
+トップレベル `await` も使用できます。例:
+
+```ts
+import { defineConfig } from 'vitepress'
+
+const posts = await (await fetch('https://my-cms.com/blog-posts')).json()
+
+export default defineConfig({
+ // アプリレベル設定
+ lang: 'en-US',
+ title: 'VitePress',
+ description: 'Vite & Vue powered static site generator.',
+
+ // テーマレベル設定
+ themeConfig: {
+ sidebar: [
+ ...posts.map((post) => ({
+ text: post.name,
+ link: `/posts/${post.name}`
+ }))
+ ]
+ }
+})
+```
+
+:::
+
+### 設定のインテリセンス {#config-intellisense}
+
+`defineConfig` ヘルパーを使うと、TypeScript による補完が効きます。対応 IDE であれば、JavaScript と TypeScript のどちらでも動作します。
+
+```js
+import { defineConfig } from 'vitepress'
+
+export default defineConfig({
+ // ...
+})
+```
+
+### 型付きのテーマ設定 {#typed-theme-config}
+
+デフォルトでは、`defineConfig` はデフォルトテーマのテーマ設定型を想定します。
+
+```ts
+import { defineConfig } from 'vitepress'
+
+export default defineConfig({
+ themeConfig: {
+ // 型は `DefaultTheme.Config`
+ }
+})
+```
+
+カスタムテーマを使用しており、そのテーマ設定に型チェックを効かせたい場合は、代わりに `defineConfigWithTheme` を使い、ジェネリクスでカスタムテーマの設定型を渡してください。
+
+```ts
+import { defineConfigWithTheme } from 'vitepress'
+import type { ThemeConfig } from 'your-theme'
+
+export default defineConfigWithTheme({
+ themeConfig: {
+ // 型は `ThemeConfig`
+ }
+})
+```
+
+### Vite・Vue・Markdown の設定 {#vite-vue-markdown-config}
+
+- **Vite**
+
+ Vite の設定は VitePress 設定の [vite](#vite) オプションで行えます。別途 Vite の設定ファイルを作る必要はありません。
+
+- **Vue**
+
+ VitePress には公式の Vue プラグイン（[@vitejs/plugin-vue](https://github.com/vitejs/vite-plugin-vue)）が同梱されています。オプションは VitePress 設定の [vue](#vue) から指定できます。
+
+- **Markdown**
+
+ 既定の [Markdown-It](https://github.com/markdown-it/markdown-it) インスタンスは、VitePress 設定の [markdown](#markdown) オプションでカスタマイズできます。
+
+## サイトメタデータ {#site-metadata}
+
+### title
+
+- 型: `string`
+- 既定値: `VitePress`
+- ページ単位での上書き: [frontmatter](./frontmatter-config#title)
+
+サイトのタイトル。デフォルトテーマではナビバーに表示されます。
+
+[`titleTemplate`](#titletemplate) を定義していない場合、個々のページタイトルの既定のサフィックスとしても使われます。各ページの最終タイトルは、そのページの最初の `` 見出しのテキストに、グローバルの `title` をサフィックスとして結合したものになります。次の設定とページ内容の例:
+
+```ts
+export default {
+ title: 'My Awesome Site'
+}
+```
+
+```md
+# Hello
+```
+
+このページのタイトルは `Hello | My Awesome Site` になります。
+
+### titleTemplate
+
+- 型: `string | boolean`
+- ページ単位での上書き: [frontmatter](./frontmatter-config#titletemplate)
+
+各ページタイトルのサフィックス、またはタイトル全体のカスタマイズができます。例:
+
+```ts
+export default {
+ title: 'My Awesome Site',
+ titleTemplate: 'Custom Suffix'
+}
+```
+
+```md
+# Hello
+```
+
+このページのタイトルは `Hello | Custom Suffix` になります。
+
+タイトルの描画方法を完全にカスタマイズするには、`titleTemplate` 内で `:title` シンボルを使います。
+
+```ts
+export default {
+ titleTemplate: ':title - Custom Suffix'
+}
+```
+
+ここで `:title` はページ先頭の `` から推論されたテキストに置き換えられます。先ほどの例では `Hello - Custom Suffix` になります。
+
+`false` を設定するとタイトルのサフィックスを無効にできます。
+
+### description
+
+- 型: `string`
+- 既定値: `A VitePress site`
+- ページ単位での上書き: [frontmatter](./frontmatter-config#description)
+
+サイトの説明。ページの HTML に `` タグとして出力されます。
+
+```ts
+export default {
+ description: 'A VitePress site'
+}
+```
+
+### head
+
+- 型: `HeadConfig[]`
+- 既定値: `[]`
+- ページ単位での追加: [frontmatter](./frontmatter-config#head)
+
+ページ HTML の `` に追加で出力する要素。ユーザーが追加したタグは、VitePress のタグの後、`` の直前にレンダリングされます。
+
+```ts
+type HeadConfig =
+ | [string, Record]
+ | [string, Record, string]
+```
+
+#### 例: favicon を追加 {#example-adding-a-favicon}
+
+```ts
+export default {
+ head: [['link', { rel: 'icon', href: '/favicon.ico' }]]
+} // favicon.ico は public に配置。base を設定している場合は /base/favicon.ico を利用
+
+/* 出力結果:
+
+*/
+```
+
+#### 例: Google Fonts を追加 {#example-adding-google-fonts}
+
+```ts
+export default {
+ head: [
+ [
+ 'link',
+ { rel: 'preconnect', href: 'https://fonts.googleapis.com' }
+ ],
+ [
+ 'link',
+ { rel: 'preconnect', href: 'https://fonts.gstatic.com', crossorigin: '' }
+ ],
+ [
+ 'link',
+ { href: 'https://fonts.googleapis.com/css2?family=Roboto&display=swap', rel: 'stylesheet' }
+ ]
+ ]
+}
+
+/* 出力結果:
+
+
+
+*/
+```
+
+#### 例: Service Worker を登録 {#example-registering-a-service-worker}
+
+```ts
+export default {
+ head: [
+ [
+ 'script',
+ { id: 'register-sw' },
+ `;(() => {
+ if ('serviceWorker' in navigator) {
+ navigator.serviceWorker.register('/sw.js')
+ }
+ })()`
+ ]
+ ]
+}
+
+/* 出力結果:
+
+*/
+```
+
+#### 例: Google Analytics を使用 {#example-using-google-analytics}
+
+```ts
+export default {
+ head: [
+ [
+ 'script',
+ { async: '', src: 'https://www.googletagmanager.com/gtag/js?id=TAG_ID' }
+ ],
+ [
+ 'script',
+ {},
+ `window.dataLayer = window.dataLayer || [];
+ function gtag(){dataLayer.push(arguments);}
+ gtag('js', new Date());
+ gtag('config', 'TAG_ID');`
+ ]
+ ]
+}
+
+/* 出力結果:
+
+
+*/
+```
+
+### lang
+
+- 型: `string`
+- 既定値: `en-US`
+
+サイトの言語属性。ページ HTML の `` として出力されます。
+
+```ts
+export default {
+ lang: 'en-US'
+}
+```
+
+### base
+
+- 型: `string`
+- 既定値: `/`
+
+サイトをデプロイするベース URL。GitHub Pages などサブパス配下にデプロイする場合に設定が必要です。たとえば `https://foo.github.io/bar/` にデプロイする場合、`base` は `'/bar/'` にします。先頭と末尾は必ずスラッシュにしてください。
+
+`/` で始まる他のオプション内の URL には、この `base` が自動的に付与されます。1 回設定すれば十分です。
+
+```ts
+export default {
+ base: '/base/'
+}
+```
+
+## ルーティング {#routing}
+
+### cleanUrls
+
+- 型: `boolean`
+- 既定値: `false`
+
+`true` にすると、URL の末尾の `.html` を削除します。あわせて [クリーン URL の生成](../guide/routing#generating-clean-url) も参照してください。
+
+::: warning サーバ設定が必要
+ホスティング環境によっては追加の設定が必要です。`/foo` へのアクセス時に **リダイレクトなしで** `/foo.html` を返せるサーバ設定が必要です。
+:::
+
+### rewrites
+
+- 型: `Record`
+
+ディレクトリと URL のカスタム対応を定義します。詳しくは [ルーティング: ルートのリライト](../guide/routing#route-rewrites) を参照。
+
+```ts
+export default {
+ rewrites: {
+ 'source/:page': 'destination/:page'
+ }
+}
+```
+
+## ビルド {#build}
+
+### srcDir
+
+- 型: `string`
+- 既定値: `.`
+
+Markdown ページを置くディレクトリ（プロジェクトルートからの相対パス）。[ルートとソースディレクトリ](../guide/routing#root-and-source-directory) も参照。
+
+```ts
+export default {
+ srcDir: './src'
+}
+```
+
+### srcExclude
+
+- 型: `string[]`
+- 既定値: `undefined`
+
+ソースとして除外したい Markdown ファイルにマッチする [glob パターン](https://github.com/mrmlnc/fast-glob#pattern-syntax)。
+
+```ts
+export default {
+ srcExclude: ['**/README.md', '**/TODO.md']
+}
+```
+
+### outDir
+
+- 型: `string`
+- 既定値: `./.vitepress/dist`
+
+ビルド出力先（[プロジェクトルート](../guide/routing#root-and-source-directory) からの相対パス）。
+
+```ts
+export default {
+ outDir: '../public'
+}
+```
+
+### assetsDir
+
+- 型: `string`
+- 既定値: `assets`
+
+生成されるアセットを配置するサブディレクトリ名。パスは [`outDir`](#outdir) の内部で、相対解決されます。
+
+```ts
+export default {
+ assetsDir: 'static'
+}
+```
+
+### cacheDir
+
+- 型: `string`
+- 既定値: `./.vitepress/cache`
+
+キャッシュファイル用ディレクトリ（[プロジェクトルート](../guide/routing#root-and-source-directory) からの相対パス）。参考: [cacheDir](https://vitejs.dev/config/shared-options.html#cachedir)
+
+```ts
+export default {
+ cacheDir: './.vitepress/.vite'
+}
+```
+
+### ignoreDeadLinks
+
+- 型: `boolean | 'localhostLinks' | (string | RegExp | ((link: string, source: string) => boolean))[]`
+- 既定値: `false`
+
+`true` にすると、デッドリンクがあってもビルド失敗にしません。
+
+`'localhostLinks'` にすると、`localhost` へのリンクはチェック対象外にしつつ、その他のデッドリンクではビルドを失敗させます。
+
+```ts
+export default {
+ ignoreDeadLinks: true
+}
+```
+
+正確な URL 文字列、正規表現、カスタムフィルタ関数の配列として指定することもできます。
+
+```ts
+export default {
+ ignoreDeadLinks: [
+ // 正確に "/playground" を無視
+ '/playground',
+ // すべての localhost リンクを無視
+ /^https?:\/\/localhost/,
+ // パスに "/repl/" を含むリンクを無視
+ /\/repl\//,
+ // カスタム関数: "ignore" を含むリンクを無視
+ (url) => {
+ return url.toLowerCase().includes('ignore')
+ }
+ ]
+}
+```
+
+### metaChunk `
+
+`buildEnd` はビルド CLI フックです。ビルド（SSG）が完了した後、VitePress CLI プロセスが終了する前に実行されます。
+
+```ts
+export default {
+ async buildEnd(siteConfig) {
+ // ...
+ }
+}
+```
+
+### postRender
+
+- 型: `(context: SSGContext) => Awaitable`
+
+`postRender` は SSG のレンダリング完了時に呼ばれるビルドフックです。SSG 中の teleport コンテンツの処理に利用できます。
+
+```ts
+export default {
+ async postRender(context) {
+ // ...
+ }
+}
+```
+
+```ts
+interface SSGContext {
+ content: string
+ teleports?: Record
+ [key: string]: any
+}
+```
+
+### transformHead
+
+- 型: `(context: TransformContext) => Awaitable`
+
+`transformHead` は、各ページを生成する前に head を変換するためのビルドフックです。設定ファイルでは静的に追加できない head 要素を追加できます。追加分のみ返せば、既存のものと自動でマージされます。
+
+::: warning
+`context` 内の値は変更しないでください。
+:::
+
+```ts
+export default {
+ async transformHead(context) {
+ // ...
+ }
+}
+```
+
+```ts
+interface TransformContext {
+ page: string // 例: index.md（srcDir からの相対）
+ assets: string[] // 解決済みの公開 URL（非 js/css アセット）
+ siteConfig: SiteConfig
+ siteData: SiteData
+ pageData: PageData
+ title: string
+ description: string
+ head: HeadConfig[]
+ content: string
+}
+```
+
+このフックは静的サイト生成時のみ呼ばれ、開発中には呼ばれません。開発中に動的な head 要素を追加したい場合は、代わりに [`transformPageData`](#transformpagedata) を使用できます。
+
+```ts
+export default {
+ transformPageData(pageData) {
+ pageData.frontmatter.head ??= []
+ pageData.frontmatter.head.push([
+ 'meta',
+ {
+ name: 'og:title',
+ content:
+ pageData.frontmatter.layout === 'home'
+ ? `VitePress`
+ : `${pageData.title} | VitePress`
+ }
+ ])
+ }
+}
+```
+
+#### 例: 正規 URL の `` を追加 {#example-adding-a-canonical-url-link}
+
+```ts
+export default {
+ transformPageData(pageData) {
+ const canonicalUrl = `https://example.com/${pageData.relativePath}`
+ .replace(/index\.md$/, '')
+ .replace(/\.md$/, '.html')
+
+ pageData.frontmatter.head ??= []
+ pageData.frontmatter.head.push([
+ 'link',
+ { rel: 'canonical', href: canonicalUrl }
+ ])
+ }
+}
+```
+
+### transformHtml
+
+- 型: `(code: string, id: string, context: TransformContext) => Awaitable`
+
+`transformHtml` は、各ページの内容をディスクへ保存する前に変換するためのビルドフックです。
+
+::: warning
+`context` 内の値は変更しないでください。また、HTML を変更すると実行時のハイドレーション問題を引き起こす可能性があります。
+:::
+
+```ts
+export default {
+ async transformHtml(code, id, context) {
+ // ...
+ }
+}
+```
+
+### transformPageData
+
+- 型: `(pageData: PageData, context: TransformPageContext) => Awaitable | { [key: string]: any } | void>`
+
+`transformPageData` は各ページの `pageData` を変換するためのフックです。`pageData` を直接変更するか、変更値を返してマージさせることができます。
+
+::: warning
+`context` 内の値は変更しないでください。ネットワークリクエストや重い計算（画像生成など）を行うと開発サーバのパフォーマンスに影響します。`process.env.NODE_ENV === 'production'` を用いた条件分岐を検討してください。
+:::
+
+```ts
+export default {
+ async transformPageData(pageData, { siteConfig }) {
+ pageData.contributors = await getPageContributors(pageData.relativePath)
+ }
+
+ // あるいはマージ用の値を返す
+ async transformPageData(pageData, { siteConfig }) {
+ return {
+ contributors: await getPageContributors(pageData.relativePath)
+ }
+ }
+}
+```
+
+```ts
+interface TransformPageContext {
+ siteConfig: SiteConfig
+}
+```
diff --git a/docs/ko/index.md b/docs/ko/index.md
index ae7df4c8..aa8be95b 100644
--- a/docs/ko/index.md
+++ b/docs/ko/index.md
@@ -8,10 +8,10 @@ hero:
actions:
- theme: brand
text: VitePress란 무엇인가?
- link: /ko/guide/what-is-vitepress
+ link: ./guide/what-is-vitepress
- theme: alt
text: 빠른 시작
- link: /ko/guide/getting-started
+ link: ./guide/getting-started
- theme: alt
text: GitHub
link: https://github.com/vuejs/vitepress
diff --git a/docs/lunaria.config.json b/docs/lunaria.config.json
index 4f93f4dc..2de958b9 100644
--- a/docs/lunaria.config.json
+++ b/docs/lunaria.config.json
@@ -44,6 +44,10 @@
{
"label": "فارسی",
"lang": "fa"
+ },
+ {
+ "label": "日本語",
+ "lang": "ja"
}
],
"outDir": ".vitepress/dist/_translations",
diff --git a/docs/pt/guide/using-vue.md b/docs/pt/guide/using-vue.md
index 226d90d2..a034108d 100644
--- a/docs/pt/guide/using-vue.md
+++ b/docs/pt/guide/using-vue.md
@@ -128,7 +128,7 @@ Se um componente for usado na maioria das páginas, eles podem ser registrados g
Certifique-se de que o nome de um componente personalizado contenha um hífen ou esteja em PascalCase. Caso contrário, ele será tratado como um elemento alinhado e envolvido dentro de uma tag ``, o que levará a uma incompatibilidade de hidratação pois `
` não permite que elementos de bloco sejam colocados dentro dele.
:::
-### Usando Componentes Em Cabeçalhos
` 要素内にレンダリングされるため、
+使用できるのはインライン要素のみです。ブロック要素を追加したい場合は、
+[`layout-bottom`](../guide/extending-default-theme#layout-slots) スロットの利用を検討してください。
+:::
+
+なお、[SideBar](./default-theme-sidebar) が表示されている場合はフッターは表示されません。
+
+## フロントマターでの設定 {#frontmatter-config}
+
+ページ単位で無効化するには、フロントマターの `footer` オプションを使用します。
+
+```yaml
+---
+footer: false
+---
+```
diff --git a/docs/ja/reference/default-theme-home-page.md b/docs/ja/reference/default-theme-home-page.md
new file mode 100644
index 00000000..e472a478
--- /dev/null
+++ b/docs/ja/reference/default-theme-home-page.md
@@ -0,0 +1,188 @@
+# ホームページ {#home-page}
+
+VitePress のデフォルトテーマにはホームページ用レイアウトが用意されています（[このサイトのトップページ](../) でも使われています）。[フロントマター](./frontmatter-config) に `layout: home` を指定すれば、任意のページで利用できます。
+
+```yaml
+---
+layout: home
+---
+```
+
+ただし、この指定だけでは多くのことは起きません。`hero` や `features` などの追加オプションを設定して、ホームページにあらかじめ用意された複数の「セクション」を配置できます。
+
+## ヒーローセクション {#hero-section}
+
+ヒーローセクションはホームページの最上部に表示されます。設定例は次のとおりです。
+
+```yaml
+---
+layout: home
+
+hero:
+ name: VitePress
+ text: Vite & Vue powered static site generator.
+ tagline: 概要テキスト...
+ image:
+ src: /logo.png
+ alt: VitePress
+ actions:
+ - theme: brand
+ text: はじめる
+ link: /guide/what-is-vitepress
+ - theme: alt
+ text: GitHub で見る
+ link: https://github.com/vuejs/vitepress
+---
+```
+
+```ts
+interface Hero {
+ // `text` の上に表示される短い文字列。ブランドカラーで表示。
+ // 製品名のような短い文言を想定。
+ name?: string
+
+ // ヒーローセクションのメインテキスト。`h1` として出力。
+ text: string
+
+ // `text` の下に表示されるタグライン。
+ tagline?: string
+
+ // テキストとタグラインの横に表示する画像。
+ image?: ThemeableImage
+
+ // ヒーローに表示するアクションボタン。
+ actions?: HeroAction[]
+}
+
+type ThemeableImage =
+ | string
+ | { src: string; alt?: string }
+ | { light: string; dark: string; alt?: string }
+
+interface HeroAction {
+ // ボタンのカラーテーマ。既定は `brand`。
+ theme?: 'brand' | 'alt'
+
+ // ボタンのラベル。
+ text: string
+
+ // ボタンのリンク先。
+ link: string
+
+ // a 要素の target 属性。
+ target?: string
+
+ // a 要素の rel 属性。
+ rel?: string
+}
+```
+
+### name の色をカスタマイズする {#customizing-the-name-color}
+
+`name` にはブランドカラー（`--vp-c-brand-1`）が使われますが、`--vp-home-hero-name-color` 変数を上書きして色を変更できます。
+
+```css
+:root {
+ --vp-home-hero-name-color: blue;
+}
+```
+
+さらに、`--vp-home-hero-name-background` を組み合わせると、`name` にグラデーションを適用できます。
+
+```css
+:root {
+ --vp-home-hero-name-color: transparent;
+ --vp-home-hero-name-background: -webkit-linear-gradient(120deg, #bd34fe, #41d1ff);
+}
+```
+
+## フィーチャーセクション {#features-section}
+
+フィーチャーセクションでは、ヒーロー直下に任意の数の機能説明を並べられます。フロントマターに `features` オプションを指定して設定します。
+
+各フィーチャーにはアイコン（絵文字または画像）を指定できます。アイコンが画像（svg, png, jpeg など）の場合は、**適切な幅・高さ** を指定してください。必要に応じて説明テキストや実サイズ、ライト／ダーク用の差し替えも指定できます。
+
+```yaml
+---
+layout: home
+
+features:
+ - icon: 🛠️
+ title: いつでもシンプル＆ミニマル
+ details: 概要テキスト...
+ - icon:
+ src: /cool-feature-icon.svg
+ title: もうひとつの便利機能
+ details: 概要テキスト...
+ - icon:
+ dark: /dark-feature-icon.svg
+ light: /light-feature-icon.svg
+ title: さらに別の機能
+ details: 概要テキスト...
+---
+```
+
+```ts
+interface Feature {
+ // 各フィーチャーボックスに表示するアイコン。
+ icon?: FeatureIcon
+
+ // フィーチャーのタイトル。
+ title: string
+
+ // フィーチャーの詳細説明。
+ details: string
+
+ // フィーチャーをクリックしたときのリンク（内部・外部どちらも可）。
+ //
+ // 例: `guide/reference/default-theme-home-page` や `https://example.com`
+ link?: string
+
+ // フィーチャー内に表示するリンクテキスト。
+ // `link` と併用するのが最適。
+ //
+ // 例: `Learn more`, `Visit page` など
+ linkText?: string
+
+ // `link` 用の rel 属性。
+ //
+ // 例: `external`
+ rel?: string
+
+ // `link` 用の target 属性。
+ target?: string
+}
+
+type FeatureIcon =
+ | string
+ | { src: string; alt?: string; width?: string; height: string }
+ | {
+ light: string
+ dark: string
+ alt?: string
+ width?: string
+ height: string
+ }
+```
+
+## Markdown コンテンツ {#markdown-content}
+
+`---` で区切るフロントマターの下に Markdown を書くだけで、ホームページに追加コンテンツを表示できます。
+
+````md
+---
+layout: home
+
+hero:
+ name: VitePress
+ text: Vite & Vue powered static site generator.
+---
+
+## はじめに
+
+`npx` を使えば、すぐに VitePress を始められます！
+
+```sh
+npm init
+npx vitepress init
+```
diff --git a/docs/ja/reference/default-theme-last-updated.md b/docs/ja/reference/default-theme-last-updated.md
new file mode 100644
index 00000000..2c85f2a8
--- /dev/null
+++ b/docs/ja/reference/default-theme-last-updated.md
@@ -0,0 +1,46 @@
+# 最終更新日時 {#last-updated}
+
+ページ右下に、コンテンツの最終更新時刻を表示できます。有効化するには、設定に `lastUpdated` オプションを追加します。
+
+::: info
+VitePress は各ファイルの **直近の Git コミットのタイムスタンプ** を用いて「最終更新」を表示します。これを有効にするには、対象の Markdown ファイルが Git にコミットされている必要があります。
+
+内部的には、各ファイルに対して `git log -1 --pretty="%ai"` を実行してタイムスタンプを取得します。すべてのページで同じ更新時刻が表示される場合、（CI 環境でよくある）**浅いクローン（shallow clone）** により Git の履歴が取得できていない可能性があります。
+
+**GitHub Actions** での修正例は次のとおりです。
+
+```yaml{4}
+- name: Checkout
+ uses: actions/checkout@v4
+ with:
+ fetch-depth: 0
+```
+
+他の CI/CD プラットフォームでも同様の設定が用意されています。
+
+もしそのようなオプションが使えない場合は、`package.json` のビルドスクリプトで手動フェッチを前置してください。
+
+```json
+"docs:build": "git fetch --unshallow && vitepress build docs"
+```
+:::
+
+## サイトレベルの設定 {#site-level-config}
+
+```js
+export default {
+ lastUpdated: true
+}
+```
+
+## フロントマターでの設定 {#frontmatter-config}
+
+ページ単位で無効化するには、フロントマターで `lastUpdated` を指定します。
+
+```yaml
+---
+lastUpdated: false
+---
+```
+
+より詳しくは [デフォルトテーマ: 最終更新](./default-theme-config#lastupdated) を参照してください。テーマレベルで truthy な値を設定すると、サイトまたはページで明示的に無効化しない限り、この機能は有効になります。
diff --git a/docs/ja/reference/default-theme-layout.md b/docs/ja/reference/default-theme-layout.md
new file mode 100644
index 00000000..e241d03e
--- /dev/null
+++ b/docs/ja/reference/default-theme-layout.md
@@ -0,0 +1,62 @@
+# レイアウト {#layout}
+
+ページの [フロントマター](./frontmatter-config) の `layout` オプションでページのレイアウトを選択できます。利用可能なレイアウトは `doc`、`page`、`home` の 3 種類です。何も指定しない場合は `doc` として扱われます。
+
+```yaml
+---
+layout: doc
+---
+```
+
+## Doc レイアウト {#doc-layout}
+
+`doc` は既定のレイアウトで、Markdown 全体を「ドキュメント」風にスタイリングします。コンテンツ全体を `vp-doc` という CSS クラスでラップし、その配下の要素にスタイルを適用します。
+
+`p` や `h2` などほぼすべての汎用要素に特別なスタイルが当たります。そのため、Markdown 内にカスタム HTML を追加した場合も、これらのスタイルの影響を受ける点に注意してください。
+
+また、以下のようなドキュメント特有の機能も提供します。これらはこのレイアウトでのみ有効になります。
+
+- 編集リンク（Edit Link）
+- 前後リンク（Prev / Next Link）
+- アウトライン（Outline）
+- [Carbon 広告](./default-theme-carbon-ads)
+
+## Page レイアウト {#page-layout}
+
+`page` は「ブランクページ」として扱われます。Markdown はパースされ、[Markdown 拡張](../guide/markdown) も `doc` と同様に機能しますが、既定のスタイルは適用されません。
+
+このレイアウトでは、VitePress テーマにマークアップを干渉させず、すべてを自分でスタイルできます。独自のカスタムページを作成したい場合に便利です。
+
+なお、このレイアウトでも、ページがサイドバー設定に一致する場合はサイドバーが表示されます。
+
+## Home レイアウト {#home-layout}
+
+`home` はテンプレート化された「ホームページ」を生成します。このレイアウトでは、`hero` や `features` などの追加オプションでコンテンツをさらにカスタマイズできます。詳しくは [デフォルトテーマ: ホームページ](./default-theme-home-page) を参照してください。
+
+## レイアウトなし {#no-layout}
+
+レイアウトを一切適用したくない場合は、フロントマターで `layout: false` を指定します。これは（既定でサイドバー／ナビバー／フッターなしの）完全にカスタマイズ可能なランディングページを作りたい場合に役立ちます。
+
+## カスタムレイアウト {#custom-layout}
+
+カスタムレイアウトを使用することもできます。
+
+```md
+---
+layout: foo
+---
+```
+
+これは、コンテキストに登録された `foo` という名前のコンポーネントを探します。たとえば、`.vitepress/theme/index.ts` でグローバル登録できます。
+
+```ts
+import DefaultTheme from 'vitepress/theme'
+import Foo from './Foo.vue'
+
+export default {
+ extends: DefaultTheme,
+ enhanceApp({ app }) {
+ app.component('foo', Foo)
+ }
+}
+```
diff --git a/docs/ja/reference/default-theme-nav.md b/docs/ja/reference/default-theme-nav.md
new file mode 100644
index 00000000..207bf9e9
--- /dev/null
+++ b/docs/ja/reference/default-theme-nav.md
@@ -0,0 +1,215 @@
+# ナビゲーション {#nav}
+
+ナビはページ上部に表示されるナビゲーションバーです。サイトタイトル、グローバルメニューリンクなどを含みます。
+
+## サイトタイトルとロゴ {#site-title-and-logo}
+
+既定では、ナビには [`config.title`](./site-config#title) の値が表示されます。ナビに表示する文字列を変更したい場合は、`themeConfig.siteTitle` にカスタム文字列を指定します。
+
+```js
+export default {
+ themeConfig: {
+ siteTitle: 'My Custom Title'
+ }
+}
+```
+
+サイトのロゴがある場合は、画像へのパスを渡すと表示できます。ロゴは `public` 直下に配置し、絶対パスで指定してください。
+
+```js
+export default {
+ themeConfig: {
+ logo: '/my-logo.svg'
+ }
+}
+```
+
+ロゴを追加すると、サイトタイトルと並んで表示されます。ロゴだけを表示したい場合は、`siteTitle` を `false` に設定してタイトル文字列を非表示にできます。
+
+```js
+export default {
+ themeConfig: {
+ logo: '/my-logo.svg',
+ siteTitle: false
+ }
+}
+```
+
+ダーク／ライトモードでロゴを切り替えたり、`alt` 属性を付けたい場合は、ロゴにオブジェクトを渡すこともできます。詳細は [`themeConfig.logo`](./default-theme-config#logo) を参照してください。
+
+## ナビゲーションリンク {#navigation-links}
+
+`themeConfig.nav` オプションでナビにリンクを追加できます。
+
+```js
+export default {
+ themeConfig: {
+ nav: [
+ { text: 'Guide', link: '/guide' },
+ { text: 'Config', link: '/config' },
+ { text: 'Changelog', link: 'https://github.com/...' }
+ ]
+ }
+}
+```
+
+`text` はナビに表示される文字列、`link` はクリック時に遷移するリンクです。内部リンクは `.md` 拡張子を付けず、必ず `/` で始めるようにしてください。
+
+`link` には、[`PageData`](./runtime-api#usedata) を受け取ってパスを返す関数を指定することもできます。
+
+ナビリンクはドロップダウンメニューにもできます。リンクオプションに `items` を設定してください。
+
+```js
+export default {
+ themeConfig: {
+ nav: [
+ { text: 'Guide', link: '/guide' },
+ {
+ text: 'Dropdown Menu',
+ items: [
+ { text: 'Item A', link: '/item-1' },
+ { text: 'Item B', link: '/item-2' },
+ { text: 'Item C', link: '/item-3' }
+ ]
+ }
+ ]
+ }
+}
+```
+
+なお、ドロップダウンのタイトル（上の例の `Dropdown Menu`）には `link` は設定できません。ドロップダウンを開くボタンになるためです。
+
+さらに、ドロップダウン内を「セクション」に分けることもできます（入れ子の `items` を使います）。
+
+```js
+export default {
+ themeConfig: {
+ nav: [
+ { text: 'Guide', link: '/guide' },
+ {
+ text: 'Dropdown Menu',
+ items: [
+ {
+ // セクションのタイトル
+ text: 'Section A Title',
+ items: [
+ { text: 'Section A Item A', link: '...' },
+ { text: 'Section B Item B', link: '...' }
+ ]
+ }
+ ]
+ },
+ {
+ text: 'Dropdown Menu',
+ items: [
+ {
+ // タイトルは省略することも可能
+ items: [
+ { text: 'Section A Item A', link: '...' },
+ { text: 'Section B Item B', link: '...' }
+ ]
+ }
+ ]
+ }
+ ]
+ }
+}
+```
+
+### リンクの「アクティブ」状態をカスタマイズ {#customize-link-s-active-state}
+
+現在のページが特定のパス配下にあるとき、該当するナビ項目がハイライトされます。一致させるパスをカスタマイズしたい場合は、`activeMatch` に **正規表現文字列** を指定します。
+
+```js
+export default {
+ themeConfig: {
+ nav: [
+ // ユーザーが `/config/` 配下にいるときにアクティブになる
+ {
+ text: 'Guide',
+ link: '/guide',
+ activeMatch: '/config/'
+ }
+ ]
+ }
+}
+```
+
+::: warning
+`activeMatch` は正規表現 **オブジェクト** ではなく、**文字列** で指定してください。ビルド時のシリアライズの都合で `RegExp` は使用できません。
+:::
+
+### リンクの `target` と `rel` をカスタマイズ {#customize-link-s-target-and-rel-attributes}
+
+既定では、リンクが外部かどうかに応じて VitePress が `target` と `rel` を自動設定します。必要であれば明示的に指定することもできます。
+
+```js
+export default {
+ themeConfig: {
+ nav: [
+ {
+ text: 'Merchandise',
+ link: 'https://www.thegithubshop.com/',
+ target: '_self',
+ rel: 'sponsored'
+ }
+ ]
+ }
+}
+```
+
+## ソーシャルリン� {#social-links}
+
+[`socialLinks`](./default-theme-config#sociallinks) を参照してください。
+
+## カスタムコンポーネント {#custom-components}
+
+`component` オプションを使って、ナビゲーションバーにカスタムコンポーネントを配置できます。`component` には Vue コンポーネント名を指定し、[Theme.enhanceApp](../guide/custom-theme#theme-interface) で **グローバル登録** しておく必要があります。
+
+```js [.vitepress/config.js]
+export default {
+ themeConfig: {
+ nav: [
+ {
+ text: 'My Menu',
+ items: [
+ {
+ component: 'MyCustomComponent',
+ // コンポーネントに渡す任意の props
+ props: {
+ title: 'My Custom Component'
+ }
+ }
+ ]
+ },
+ {
+ component: 'AnotherCustomComponent'
+ }
+ ]
+ }
+}
+```
+
+次に、コンポーネントをグローバル登録します。
+
+```js [.vitepress/theme/index.js]
+import DefaultTheme from 'vitepress/theme'
+
+import MyCustomComponent from './components/MyCustomComponent.vue'
+import AnotherCustomComponent from './components/AnotherCustomComponent.vue'
+
+/** @type {import('vitepress').Theme} */
+export default {
+ extends: DefaultTheme,
+ enhanceApp({ app }) {
+ app.component('MyCustomComponent', MyCustomComponent)
+ app.component('AnotherCustomComponent', AnotherCustomComponent)
+ }
+}
+```
+
+コンポーネントはナビゲーションバー内にレンダリングされます。VitePress は次の追加 props をコンポーネントに提供します。
+
+- `screenMenu`: モバイルのナビメニュー内にあるかどうかを示す任意の boolean
+
+e2e テスト内の例は[こちら](https://github.com/vuejs/vitepress/tree/main/__tests__/e2e/.vitepress)を参照してください。
diff --git a/docs/ja/reference/default-theme-prev-next-links.md b/docs/ja/reference/default-theme-prev-next-links.md
new file mode 100644
index 00000000..7b15d699
--- /dev/null
+++ b/docs/ja/reference/default-theme-prev-next-links.md
@@ -0,0 +1,43 @@
+# 前／次リンク {#prev-next-links}
+
+ドキュメントのフッターに表示される「前のページ」「次のページ」のテキストとリンクをカスタマイズできます。サイドバーに表示しているタイトルとは別の文言を使いたい場合や、フッターを無効化したり、サイドバーに含まれていないページへリンクしたい場合に便利です。
+
+## prev
+
+- 型: `string | false | { text?: string; link?: string }`
+
+- 詳細:
+
+ 前のページへのリンクに表示するテキスト／リンクを指定します。フロントマターで設定しない場合は、サイドバー設定から自動推測されます。
+
+- 例:
+
+ - テキストだけをカスタマイズ:
+
+ ```yaml
+ ---
+ prev: 'Get Started | Markdown'
+ ---
+ ```
+
+ - テキストとリンクの両方をカスタマイズ:
+
+ ```yaml
+ ---
+ prev:
+ text: 'Markdown'
+ link: '/guide/markdown'
+ ---
+ ```
+
+ - 前のページを非表示にする:
+
+ ```yaml
+ ---
+ prev: false
+ ---
+ ```
+
+## next
+
+`prev` と同様ですが、次のページ用の設定です。
diff --git a/docs/ja/reference/default-theme-search.md b/docs/ja/reference/default-theme-search.md
new file mode 100644
index 00000000..e15de4ef
--- /dev/null
+++ b/docs/ja/reference/default-theme-search.md
@@ -0,0 +1,451 @@
+---
+outline: deep
+---
+
+# 検索 {#search}
+
+## ローカル検索 {#local-search}
+
+VitePress は、[minisearch](https://github.com/lucaong/minisearch/) によるブラウザ内インデックスを使った曖昧一致の全文検索をサポートします。有効化するには、`.vitepress/config.ts` で `themeConfig.search.provider` を `'local'` に設定します。
+
+```ts
+import { defineConfig } from 'vitepress'
+
+export default defineConfig({
+ themeConfig: {
+ search: {
+ provider: 'local'
+ }
+ }
+})
+```
+
+表示例:
+
+
+
+代わりに [Algolia DocSearch](#algolia-search) や、次のコミュニティ製プラグインを使うこともできます。
+
+- `, o que levará a uma incompatibilidade de hidratação pois ` ` não permite que elementos de bloco sejam colocados dentro dele.
:::
-### Usando Componentes Em Cabeçalhos ` 見出しになります。`#title` と `#lead` スロットでチームについて説明を書きましょう。
+
+`
{{ theme.footer.copyright }}
+
+```
+
+## `useRoute` Custom Layout!
+ ` 見出しのテキストに、グローバルの `title` をサフィックスとして結合したものになります。次の設定とページ内容の例:
+
+```ts
+export default {
+ title: 'My Awesome Site'
+}
+```
+
+```md
+# Hello
+```
+
+このページのタイトルは `Hello | My Awesome Site` になります。
+
+### titleTemplate
+
+- 型: `string | boolean`
+- ページ単位での上書き: [frontmatter](./frontmatter-config#titletemplate)
+
+各ページタイトルのサフィックス、またはタイトル全体のカスタマイズができます。例:
+
+```ts
+export default {
+ title: 'My Awesome Site',
+ titleTemplate: 'Custom Suffix'
+}
+```
+
+```md
+# Hello
+```
+
+このページのタイトルは `Hello | Custom Suffix` になります。
+
+タイトルの描画方法を完全にカスタマイズするには、`titleTemplate` 内で `:title` シンボルを使います。
+
+```ts
+export default {
+ titleTemplate: ':title - Custom Suffix'
+}
+```
+
+ここで `:title` はページ先頭の `
` から推論されたテキストに置き換えられます。先ほどの例では `Hello - Custom Suffix` になります。
+
+`false` を設定するとタイトルのサフィックスを無効にできます。
+
+### description
+
+- 型: `string`
+- 既定値: `A VitePress site`
+- ページ単位での上書き: [frontmatter](./frontmatter-config#description)
+
+サイトの説明。ページの HTML に `` タグとして出力されます。
+
+```ts
+export default {
+ description: 'A VitePress site'
+}
+```
+
+### head
+
+- 型: `HeadConfig[]`
+- 既定値: `[]`
+- ページ単位での追加: [frontmatter](./frontmatter-config#head)
+
+ページ HTML の `` に追加で出力する要素。ユーザーが追加したタグは、VitePress のタグの後、`` の直前にレンダリングされます。
+
+```ts
+type HeadConfig =
+ | [string, Record