Merge branch 'main' into docs/add-hostinger-deployment

Author: brc-dd

docs/.vitepress/config.ts

@@ -26,10 +26,13 @@ export default defineConfig({
   markdown: {
     math: true,
     codeTransformers: [
-      // We use `[!!code` in demo to prevent transformation, here we revert it back.
+      // We use `[!!code` and `@@include` in demo to prevent transformation,
+      // here we revert it back.
       {
         postprocess(code) {
-          return code.replace(/\[\!\!code/g, '[!code')
+          return code
+            .replace(/\[\!\!code/g, '[!code')
+            .replace('@@include', '@include')
         }
       }
     ],

docs/en/guide/markdown.md

@@ -793,7 +793,7 @@ For example, you can include a relative markdown file using this:
 
 ## Basics
 
-<!--@include: ./parts/basics.md-->
+<!--@@include: ./parts/basics.md-->
 ```
 
 **Part file** (`parts/basics.md`)
@@ -829,7 +829,7 @@ It also supports selecting a line range:
 
 ## Basics
 
-<!--@include: ./parts/basics.md{3,}-->
+<!--@@include: ./parts/basics.md{3,}-->
 ```
 
 **Part file** (`parts/basics.md`)
@@ -865,8 +865,8 @@ You can also use a [VS Code region](https://code.visualstudio.com/docs/editor/co
 
 ## Basics
 
-<!--@include: ./parts/basics.md#basic-usage{,2}-->
-<!--@include: ./parts/basics.md#basic-usage{5,}-->
+<!--@@include: ./parts/basics.md#basic-usage{,2}-->
+<!--@@include: ./parts/basics.md#basic-usage{5,}-->
 ```
 
 **Part file** (`parts/basics.md`)
@@ -917,7 +917,7 @@ You can include the `My Base Section` section like this:
 
 ```md
 ## My Extended Section
-<!--@include: ./parts/basics.md#my-base-section-->
+<!--@@include: ./parts/basics.md#my-base-section-->
 ```
 
 **Equivalent code**
@@ -941,7 +941,7 @@ Here, `my-base-section` is the generated id of the heading element. In case it's
 and include it like this:
 
 ```md
-<!--@include: ./parts/basics.md#custom-id-->
+<!--@@include: ./parts/basics.md#custom-id-->
 ```
 
 ## Math Equations

docs/en/reference/runtime-api.md

@@ -49,7 +49,7 @@ interface PageData {
   titleTemplate?: string | boolean
   description: string
   relativePath: string
-  filePath: string,
+  filePath: string
   headers: Header[]
   frontmatter: Record<string, any>
   params?: Record<string, any>

docs/es/guide/markdown.md

@@ -773,7 +773,7 @@ Por ejemplo, puede incluir un archivo markdown relativo usando esto:
 
 ## Conceptos Básicos
 
-<!--@include: ./parts/basics.md-->
+<!--@@include: ./parts/basics.md-->
 ```
 
 **Archivo de Parte** (`parts/basics.md`)
@@ -809,7 +809,7 @@ También soporta la selección de un intervalo de lineas:
 
 ## Conceptos Básicos
 
-<!--@include: ./parts/basics.md{3,}-->
+<!--@@include: ./parts/basics.md{3,}-->
 ```
 
 **Archivo de Parte** (`parts/basics.md`)

docs/es/reference/runtime-api.md

@@ -45,7 +45,7 @@ interface PageData {
   titleTemplate?: string | boolean
   description: string
   relativePath: string
-  filePath: string,
+  filePath: string
   headers: Header[]
   frontmatter: Record<string, any>
   params?: Record<string, any>

docs/fa/guide/markdown.md

@@ -724,7 +724,7 @@ export default config
 
 ## مبانی
 
-<!--@include: ./parts/basics.md-->
+<!--@@include: ./parts/basics.md-->
 ```
 
 **قسمت فایل** (`parts/basics.md`)
@@ -760,7 +760,7 @@ export default config
 
 ## مبانی
 
-<!--@include: ./parts/basics.md{3,}-->
+<!--@@include: ./parts/basics.md{3,}-->
 ```
 
 **قسمت فایل** (`parts/basics.md`)
@@ -796,8 +796,8 @@ export default config
 
 ## مبانی
 
-<!--@include: ./parts/basics.md#basic-usage{,2}-->
-<!--@include: ./parts/basics.md#basic-usage{5,}-->
+<!--@@include: ./parts/basics.md#basic-usage{,2}-->
+<!--@@include: ./parts/basics.md#basic-usage{5,}-->
 ```
 
 **قسمت فایل** (`parts/basics.md`)

docs/fa/reference/runtime-api.md

@@ -49,7 +49,7 @@ interface PageData {
   titleTemplate?: string | boolean
   description: string
   relativePath: string
-  filePath: string,
+  filePath: string
   headers: Header[]
   frontmatter: Record<string, any>
   params?: Record<string, any>

docs/ja/guide/cms.md

@@ -12,44 +12,44 @@ CMS ごとに動作が異なるため、ここでは各自の環境に合わせ
 
 1. CMS が認証を必要とする場合は、API トークンを格納するための `.env` を作成し、次のように読み込みます。
 
-    ```js
-    // posts/[id].paths.js
-    import { loadEnv } from 'vitepress'
+   ```js
+   // posts/[id].paths.js
+   import { loadEnv } from 'vitepress'
 
-    const env = loadEnv('', process.cwd())
-    ```
+   const env = loadEnv('', process.cwd())
+   ```
 
 2. CMS から必要なデータを取得し、適切なパスデータの形式に整形します。
 
-    ```js
-    export default {
-      async paths() {
-        // 必要に応じて各 CMS のクライアントライブラリを使用
-        const data = await (await fetch('https://my-cms-api', {
-          headers: {
-            // 必要ならトークン
-          }
-        })).json()
-
-        return data.map(entry => {
-          return {
-            params: { id: entry.id, /* title, authors, date など */ },
-            content: entry.content
-          }
-        })
-      }
-    }
-    ```
+   ```js
+   export default {
+     async paths() {
+       // 必要に応じて各 CMS のクライアントライブラリを使用
+       const data = await (await fetch('https://my-cms-api', {
+         headers: {
+           // 必要ならトークン
+         }
+       })).json()
+
+       return data.map((entry) => {
+         return {
+           params: { id: entry.id, /* title, authors, date など */ },
+           content: entry.content
+         }
+       })
+     }
+   }
+   ```
 
 3. ページ内でコンテンツをレンダリングします。
 
-    ```md
-    # {{ $params.title }}
+   ```md
+   # {{ $params.title }}
 
-    - {{ $params.date }} に {{ $params.author }} が作成
+   - {{ $params.date }} に {{ $params.author }} が作成
 
-    <!-- @content -->
-    ```
+   <!-- @content -->
+   ```
 
 ## 連携ガイドの募集 {#integration-guides}
 

docs/ja/guide/custom-theme.md

@@ -23,43 +23,42 @@ VitePress のカスタムテーマは次のインターフェースを持つオ
 
 ```ts
 interface Theme {
-/**
-  * すべてのページに適用されるルートレイアウトコンポーネント
-  * @required
-  */
-Layout: Component
-/**
-  * Vue アプリインスタンスを拡張
-  * @optional
-  */
-enhanceApp?: (ctx: EnhanceAppContext) => Awaitable<void>
-/**
-  * 別のテーマを拡張し、そのテーマの `enhanceApp` を先に実行
-  * @optional
-  */
-extends?: Theme
+  /**
+   * すべてのページに適用されるルートレイアウトコンポーネント
+   * @required
+   */
+  Layout: Component
+  /**
+   * Vue アプリインスタンスを拡張
+   * @optional
+   */
+  enhanceApp?: (ctx: EnhanceAppContext) => Awaitable<void>
+  /**
+   * 別のテーマを拡張し、そのテーマの `enhanceApp` を先に実行
+   * @optional
+   */
+  extends?: Theme
 }
 
 interface EnhanceAppContext {
-app: App // Vue アプリインスタンス
-router: Router // VitePress のルーターインスタンス
-siteData: Ref<SiteData> // サイト全体のメタデータ
+  app: App // Vue アプリインスタンス
+  router: Router // VitePress のルーターインスタンス
+  siteData: Ref<SiteData> // サイト全体のメタデータ
 }
 ```
 
 テーマエントリファイルでは、このテーマをデフォルトエクスポートとして公開します。
 
 ```js [.vitepress/theme/index.js]
-
 // テーマエントリでは Vue ファイルを直接インポートできます
 // VitePress は @vitejs/plugin-vue をあらかじめ設定済みです
 import Layout from './Layout.vue'
 
 export default {
-Layout,
-enhanceApp({ app, router, siteData }) {
-  // ...
-}
+  Layout,
+  enhanceApp({ app, router, siteData }) {
+    // ...
+  }
 }
 ```
 
@@ -73,10 +72,10 @@ enhanceApp({ app, router, siteData }) {
 
 ```vue [.vitepress/theme/Layout.vue]
 <template>
-<h1>Custom Layout!</h1>
+  <h1>Custom Layout!</h1>
 
-<!-- この部分に markdown コンテンツが描画されます -->
-<Content />
+  <!-- この部分に markdown コンテンツが描画されます -->
+  <Content />
 </template>
 ```
 
@@ -100,11 +99,11 @@ const { page } = useData()
 
 [`useData()`](../reference/runtime-api#usedata) ヘルパーを使うと、条件によってレイアウトを切り替えるために必要なすべてのランタイムデータを取得できます。アクセスできるデータのひとつにフロントマターがあります。これを利用すると、ページごとにレイアウトを制御できます。例えば、ユーザーが特別なホームページレイアウトを使いたい場合は以下のように記述します。
 
- ```md
+```md
 ---
 layout: home
 ---
- ```
+```
 
 テーマ側を次のように調整します。
 
@@ -164,7 +163,6 @@ npm パッケージとして配布する場合は、次の手順を踏みます
 
 ## カスタムテーマの利用 {#consuming-a-custom-theme}
 
-
 外部テーマを利用するには、カスタムテーマエントリからインポートして再エクスポートします。
 
 ```js [.vitepress/theme/index.js]
@@ -179,10 +177,10 @@ export default Theme
 import Theme from 'awesome-vitepress-theme'
 
 export default {
-extends: Theme,
-enhanceApp(ctx) {
-  // ...
-}
+  extends: Theme,
+  enhanceApp(ctx) {
+    // ...
+  }
 }
 ```
 
@@ -192,8 +190,8 @@ enhanceApp(ctx) {
 import baseConfig from 'awesome-vitepress-theme/config'
 
 export default {
-// 必要に応じてテーマの基本設定を拡張
-extends: baseConfig
+  // 必要に応じてテーマの基本設定を拡張
+  extends: baseConfig
 }
 ```
 
@@ -205,9 +203,9 @@ import { defineConfigWithTheme } from 'vitepress'
 import type { ThemeConfig } from 'awesome-vitepress-theme'
 
 export default defineConfigWithTheme<ThemeConfig>({
-extends: baseConfig,
-themeConfig: {
-  // 型は `ThemeConfig`
-}
+  extends: baseConfig,
+  themeConfig: {
+    // 型は `ThemeConfig`
+  }
 })
 ```

docs/ja/guide/data-loading.md

@@ -10,12 +10,12 @@ VitePress には **データローダー (data loaders)** という機能があ
 
 ```js [example.data.js]
 export default {
-load() {
-  return {
-    hello: 'world'
+  load() {
+    return {
+      hello: 'world'
+    }
   }
 }
-}
 ```
 
 ローダーモジュールは Node.js 上でのみ評価されるため、Node API や npm 依存関係を自由に利用できます。
@@ -179,7 +179,6 @@ interface ContentOptions<T = ContentData[]> {
 
 ## 型付きデータローダー {#typed-data-loaders}
 
-
 TypeScript を使用する場合は、ローダーと `data` エクスポートを型付けできます。
 
 ```ts
@@ -202,7 +201,6 @@ export default defineLoader({
 
 ## 設定情報の取得 {#configuration}
 
-
 ローダー内で設定情報を取得するには次のようにします。
 
 ```ts