Merge branch 'main' into i18n-ja-components-and-i18n

3 files changed, 84 insertions, 6 deletions

diff --git a/docs/src/content/docs/ja/getting-started.mdx b/docs/src/content/docs/ja/getting-started.mdx
index 0a7a6dcf..23fc7d0b 100644
--- a/docs/src/content/docs/ja/getting-started.mdx
+++ b/docs/src/content/docs/ja/getting-started.mdx
@@ -11,7 +11,9 @@ Starlightã�¯ã�¾ã� é–‹ç™ºã�®åˆ�期段階ã�«ã�‚ã‚Šã�¾ã�™ã€‚何ã�‹ä¸�å…·å�ˆã‚’見ã�
 
 ## 新��プロジェクトを作��る
 
-Starlight��オールインワン�フレームワーク��る[Astro](https://astro.build)�上�構築�れ����。次�コマンド�より�Astro + Starlight�新��プロジェクトを作�����。
+Starlight��[Astro](https://astro.build)�上�構築�れ��フル機能�ドキュメント��テーマ��。
+
+以下�コマンド�より�Astro + Starlight�新��プロジェクトを作�����。
 
 <Tabs>
 <TabItem label="npm">
@@ -40,7 +42,7 @@ yarn create astro --template starlight
 </TabItem>
 </Tabs>
 
-�れ�より�サイト�必������ファイル�設定���れ��新��プロジェクトディレクトリ�作��れ��。
+�れ�より�サイト�必������ファイル�設定���れ��新��[プロジェクトディレクトリ](/ja/guides/project-structure/)�作��れ��。
 
 :::tip[試���よ�]
 Starlightをブラウザ�試����[StackBlitz�テンプレートを開���](https://stackblitz.com/github/withastro/starlight/tree/main/examples/basics)。
@@ -48,11 +50,24 @@ Starlightをブラウザ�試����[StackBlitz�テンプレートを開
 
 ## Starlight�コンテンツを作��る
 
-Starlight���Markdown�MDX�コンテンツを作�����。
+以上��Starlight�新��コンテンツを追加��り�既存�ファイルを��込ん�り�る準備�������
+
+### ファイルフォーマット
+
+Starlight���Markdown�MDX�コンテンツを作�����。（Markdoc�サ�ート��実験的�[Astro�Markdocインテグレーション](https://docs.astro.build/ja/guides/integrations-guide/markdoc/)をインストール��追加����。）
+
+### ページ�追加
+
+`src/content/docs/`�`.md`���`.mdx`ファイルを作����サイト�新��ページを自動�追加����。ファイルを整��る���サブフォルダを追加��複数�パスセグメントを作��る��も����。
+
+```js
+`src/content/docs/hello-world.md` -> `your-site/hello-world`
+`src/content/docs/guides/faq.md` -> `your-site/guides/faq`
+```
 
-`src/content/docs/`�`.md`���`.mdx`ファイルを作����新��ページを追加���。�����`src/content/docs/hello-world.md`��サイト�`/hello-world`�らアクセス����。
+### 型安全�フロントマター
 
-Starlight�ページ��ページ�表示方法を制御�る����共通�フロントマタープロパティを�識���。
+Starlight�ページ��ページ�表示方法を制御�る����カスタマイズ�能�[共通�フロントマタープロパティ](/ja/reference/frontmatter/)を�識���。
 
 ```md
 ---
@@ -65,6 +80,6 @@ description: �れ�Starlight�作��れ�サイト�ページ��
 
 ## Starlightサイトをデプロイ�る
 
-Starlightサイト�作��カスタマイズ�完了��ら��好��ウェブサー�ーやホスティングプラットフォーム�デプロイ����。Astro���Netlify�Vercel�GitHub Pages���人気�ホスティングプラットフォーム��サ�ート�組�込�れ��る���簡��コマンドを����実行�る���ウェブサイトをデプロイ����。
+Starlightサイト�作��カスタマイズ�完了��ら�Netlify�Vercel�GitHub Pages���他多���好��ウェブサー�ーやホスティングプラットフォーム�デプロイ����。
 
 [Astroサイト�デプロイ������Astro�ドキュメントを�照������。](https://docs.astro.build/ja/guides/deploy/)
diff --git a/docs/src/content/docs/ja/guides/project-structure.mdx b/docs/src/content/docs/ja/guides/project-structure.mdx
new file mode 100644
index 00000000..78fc6778
--- /dev/null
+++ b/docs/src/content/docs/ja/guides/project-structure.mdx
@@ -0,0 +1,48 @@
+---
+title: ディレクトリ構�
+description: Starlightプロジェクト�ファイルを��よ���置�る�����学���。
+---
+
+��ガイド���Starlightプロジェクト�構���プロジェクト内������ファイル�役割����説明���。
+
+Starlightプロジェクト��基本的�他�Astroプロジェクト���ファイル・ディレクトリ構��従���。詳細������[Astro�ディレクトリ構��ドキュメント](https://docs.astro.build/ja/core-concepts/project-structure/)を�照������。
+
+## ファイル�ディレクトリ
+
+- `astro.config.mjs` — Astro�設定ファイル�����Starlight�インテグレーションや設定を記述���。
+- `src/content/config.ts` — コンテンツコレクション�設定ファイル��Starlight�フロントマタースキーマをプロジェクト�追加���。
+- `src/content/docs/` — コンテンツ�ファイル�置�れ��。Starlight����ディレクトリ内��`.md`�`.mdx`�`.mdoc`ファイルを�サイト�ページ��変����。
+- `src/content/i18n/`（任�） — [国際化](/ja/guides/i18n/)をサ�ート�る���翻訳データ�置�れ��。
+- `src/` — プロジェクト�他�ソースコードやファイル（コン�ー�ント�スタイル�画���）�置�れ��。
+- `public/` — Astro�よ��処��れ���的アセット（フォント�ファビコン�PDF��）�置�れ��。
+
+## プロジェクト�中身�例
+
+Starlightプロジェクト�ディレクトリ��次�よ���り��。
+
+import FileTree from '../../../../components/file-tree.astro';
+
+<FileTree>
+
+- public/
+  - favicon.svg
+- src/
+  - assets/
+    - logo.svg
+    - screenshot.jpg
+  - components/
+    - CustomButton.astro
+    - InteractiveWidget.jsx
+  - content/
+    - docs/
+      - guides/
+        - 01-getting-started.md
+        - 02-advanced.md
+      - index.mdx
+    - config.ts
+  - env.d.ts
+- astro.config.mjs
+- package.json
+- tsconfig.json
+
+</FileTree>
diff --git a/docs/src/content/docs/ja/reference/configuration.md b/docs/src/content/docs/ja/reference/configuration.md
index 65501ed9..20bf64e7 100644
--- a/docs/src/content/docs/ja/reference/configuration.md
+++ b/docs/src/content/docs/ja/reference/configuration.md
@@ -5,6 +5,21 @@ description: Starlightã�Œã‚µãƒ�ートã�™ã‚‹ã�™ã�¹ã�¦ã�®è¨­å®šã‚ªãƒ—ションã�®æ
 
 ## `starlight`インテグレーション�設定
 
+Starlight�[Astro](https://astro.build)ウェブフレームワーク�上�構築�れ�インテグレーション��。Astro�`astro.config.mjs`設定ファイル内�プロジェクト�設定を������。
+
+```js
+// astro.config.mjs
+import { defineConfig } from 'astro/config';
+import starlight from '@astrojs/starlight';
+export default defineConfig({
+  integrations: [
+    starlight({
+      title: "��楽��ドキュメントサイト",
+    }),
+  ],
+});
+```
+
 以下�オプションを`starlight`インテグレーション�設定����。
 
 ### `title`（必須）