diff --git a/src/content/docs/ja/basics/rendering-modes.mdx b/src/content/docs/ja/basics/rendering-modes.mdx
index 795b95bfb020f..a46e4d5439b33 100644
--- a/src/content/docs/ja/basics/rendering-modes.mdx
+++ b/src/content/docs/ja/basics/rendering-modes.mdx
@@ -39,8 +39,7 @@ Astroの他の2つの出力モードにより、**ページ、ルート、また
これらのルートはアクセスごとに生成されるため、各ユーザーに合わせてカスタマイズできます。たとえば、オンデマンドにレンダリングされたページは、ログインしたユーザーにアカウント情報を表示したり、サイト全体を再ビルドすることなく最新のデータを表示したりできます。リクエスト時のサーバーでのオンデマンドレンダリングは、**サーバーサイドレンダリング（SSR）** とも呼ばれています。
-{/* TODO: server-side-renderingが更新されたら、以下のリンク先を#enable-on-demand-server-renderingに変更する */}
-以下が必要な場合は、Astroプロジェクトで[`server`または`hybrid`モードを有効にすることを検討](/ja/guides/server-side-rendering/)してください。
+以下が必要な場合は、Astroプロジェクトで[`server`または`hybrid`モードを有効にすることを検討](/ja/guides/server-side-rendering/#オンデマンドサーバーレンダリングを有効にする)してください。
- **APIエンドポイント**: 秘匿データをクライアントから隠蔽したまま、データベースアクセス、認証、認可などのタスクのために特定のページをAPIエンドポイントとして機能させます。
diff --git a/src/content/docs/ja/guides/astro-db.mdx b/src/content/docs/ja/guides/astro-db.mdx
index b8abcfd3a125b..f372d54bd9e10 100644
--- a/src/content/docs/ja/guides/astro-db.mdx
+++ b/src/content/docs/ja/guides/astro-db.mdx
@@ -188,8 +188,7 @@ const comments = await db.select().from(Comment);
### Insert
-{/* TODO: server-side-renderingを更新し、「SSRアダプター」へのリンクを英語版の「/en/guides/server-side-rendering/#official-adapters」と一致させる */}
-フォームからのリクエストを処理してリモートにホストされたデータベースにデータを挿入する場合のように、ユーザー入力を受け付けるためには、Astroプロジェクトを[オンデマンドレンダリング](/ja/basics/rendering-modes/#オンデマンドレンダリング)に設定し、デプロイ環境向けの[SSRアダプターを追加](/ja/guides/server-side-rendering/)してください。
+フォームからのリクエストを処理してリモートにホストされたデータベースにデータを挿入する場合のように、ユーザー入力を受け付けるためには、Astroプロジェクトを[オンデマンドレンダリング](/ja/basics/rendering-modes/#オンデマンドレンダリング)に設定し、デプロイ環境向けの[SSRアダプターを追加](/ja/guides/server-side-rendering/#公式アダプター)してください。
この例では、パースされたフォームのPOSTリクエストに基づいて、`Comment`テーブルに行を挿入しています。
diff --git a/src/content/docs/ja/guides/server-side-rendering.mdx b/src/content/docs/ja/guides/server-side-rendering.mdx
index 47e97f87e4765..f82509f818e5f 100644
--- a/src/content/docs/ja/guides/server-side-rendering.mdx
+++ b/src/content/docs/ja/guides/server-side-rendering.mdx
@@ -1,81 +1,56 @@
---
-title: サーバーサイドレンダリング
+title: オンデマンドレンダリングアダプター
i18nReady: true
---
import PackageManagerTabs from '~/components/tabs/PackageManagerTabs.astro'
-import Since from '~/components/Since.astro';
+import RecipeLinks from '~/components/RecipeLinks.astro';
+import IntegrationsNav from '~/components/IntegrationsNav.astro';
-サーバーサイドレンダリング（SSR）は、サーバー上でHTMLページをオンデマンドで生成し、クライアントに送信することを意味します。
+Astroでは、一部あるいはすべてのページとエンドポイントに**オンデマンドレンダリング**を選択できます。これは**サーバーサイドレンダリング（SSR）** とも呼ばれ、リクエスト時にサーバー上でHTMLページを生成し、結果をクライアントに送信します。プロジェクトをサーバー上で実行しリクエストを処理するためには、**アダプター**が使用されます。
-SSRを利用すると、次のようなことが可能です。
+このオンデマンドレンダリングを利用すると、次のようなことが可能になります。
- アプリのログイン状態のためにセッションを実装する。
-- `fetch`を使って動的にAPIを呼び出しデータをレンダリングする。
+- `fetch()`を使って動的にAPIを呼び出しデータをレンダリングする。
- *アダプター*を利用してサイトをホストにデプロイする。
-以下が必要な場合は、Astroプロジェクトでサーバーサイドレンダリングを有効にすることを検討してください。
+以下が必要な場合は、Astroプロジェクトでオンデマンドレンダリングを有効にすることを検討してください。
-- **APIエンドポイント**: SSRにより、クライアントから機密データを隠したまま、データベースへのアクセス、認証、認可などのタスクをおこなうAPIエンドポイントとして機能する特定のページを作成できます。
+- **APIエンドポイント**: クライアントから機密データを隠したまま、データベースへのアクセス、認証、認可などのタスクをおこなうAPIエンドポイントとして機能するページを作成する。
-- **ページの保護**: ユーザーの権限に基づいてページへのアクセスを制限する必要がある場合は、SSRを有効にしてサーバーでユーザーアクセスを制御できます。
+- **ページの保護**: サーバーでユーザーアクセスを制御し、ユーザーの権限に基づいてページへのアクセスを制限する。
-- **頻繁に変更されるコンテンツ**: SSRを有効にすると、サイトを静的に再ビルドすることなく個々のページを生成できます。これはページのコンテンツが頻繁に更新される場合に有効です。
+- **頻繁に変更されるコンテンツ**: サイトを静的に再ビルドすることなく個々のページを生成する。これはページのコンテンツが頻繁に更新される場合に有効。
-## プロジェクトでSSRを有効にする
+## 公式アダプター
-本番環境でSSRを有効にするには、`output`の設定を`'server'`または（**v2.6.0**で導入された）`'hybrid'`に更新します。これらのモードは、どの[ページ](/ja/basics/astro-pages/)または[サーバーエンドポイント](/ja/guides/endpoints/#サーバーエンドポイントapiルーティング)をサーバーでレンダリングするかを制御します。これらの設定オプションはデフォルトの動作が異なり、各ルーティングでデフォルトからオプトアウトすることが可能となっています。
+Astroは、[Node.js](https://nodejs.org/)、[Vercel](https://vercel.com/)、[Netlify](https://www.netlify.com/)、[Cloudflare](https://www.cloudflare.com/)の公式アダプターを提供しています。
-- __`output: 'server'`__: デフォルトでサーバーレンダリングされます。サイトの大部分またはすべてをサーバーレンダリングする場合に使用します。個別のページやエンドポイントで、事前レンダリングに*オプトイン*できます。
-- __`output: 'hybrid'`__: デフォルトでHTMLに事前レンダリングされます。サイトの大部分を静的にする場合に使用します。個別のページやエンドポイントで、事前レンダリングを*オプトアウト*できます。
+（Deno、SST、AWSなどの）[コミュニティ製のアダプター](https://astro.build/integrations/?search=&categories%5B%5D=adapters)を、インテグレーションディレクトリで確認してください。
-```js ins={6,7}
-// astro.config.mjs
-import { defineConfig } from 'astro/config';
-import nodejs from '@astrojs/node';
+
-export default defineConfig({
- output: 'server',
- adapter: nodejs(),
-});
-```
+## オンデマンドサーバーレンダリングを有効にする
-エクスポート文により、ページやルートをデフォルトのレンダリング動作からオプトアウトできます。
+Astroのオンデマンドレンダリングの出力モード（`server`と`hybrid`）はいずれも、可能な限り個々のルートを事前レンダリングすることで、静的サイトのパフォーマンスを活かせるようにします。このことは、完全に動的なアプリケーションであっても、特定のルートのみにオンデマンドレンダリングが必要なほぼ静的なサイトであっても同様です。
-```astro title="src/pages/mypage.astro" {2}
----
-export const prerender = true;
-// ...
----
-
-
-
-```
-その他の[個別のルートの設定](#個別のルートの設定)例も確認してください。
+プロジェクトでどちらを使用するかを決定するには、ページとルートの**多く**がどのようにレンダリングされるかに応じて`output`オプションを選択します。
-### 静的サイトをハイブリッドレンダリングに変換する
+- __`output: 'server'`__: デフォルトでオンデマンドレンダリングされます。サイトやアプリの大部分またはすべてをリクエスト時にサーバーレンダリングする場合に使用します。個別のページやエンドポイントで、事前レンダリングに*オプトイン*できます。
+- __`output: 'hybrid'`__: デフォルトでHTMLに事前レンダリングされます。サイトの大部分が静的である場合に使用します。個別のページやエンドポイントで、事前レンダリングを*オプトアウト*できます。
-既存の静的なAstroサイトをハイブリッドレンダリングに変換するには、`output`を`'hybrid'`に変更し、アダプターを追加します。
-
-```js ins={2,5-8} title="astro.config.mjs"
-import { defineConfig } from 'astro/config';
-import nodejs from '@astrojs/node';
-
-export default defineConfig({
- adapter: nodejs({
- mode: 'middleware' // または'standalone'
- }),
- output: 'hybrid',
-});
-```
+サーバーは少なくともいくつかのページをオンデマンドに生成する必要があるため、どちらのモードを選択しても、サーバー機能を実行するために[アダプターを追加](#アダプターの追加)する必要があります。
### アダプターの追加
-SSRを有効にしたプロジェクトをデプロイするには、アダプターを追加する必要があります。SSRはサーバーサイドのコードを実行する環境であるサーバーランタイムが必要なためです。各アダプターによって、Astroは特定のランタイムでプロジェクトを実行するスクリプトを出力できます。
+プロジェクトを`server`または`hybrid`モードでデプロイするには、アダプターを追加する必要があります。これは、どちらのモードも、リクエスト時にページを生成するためにサーバーでコードを実行する環境である**ランタイム**が必要であるためです。各アダプターによってAstroは、VercelやNetlify、Cloudflareなどの特定のランタイムでプロジェクトを実行するためのスクリプトを出力できるようになります。
-[公式版とコミュニティ版のSSRアダプターを、インテグレーションディレクトリ](https://astro.build/integrations/?search=&categories%5B%5D=adapters)で確認できます。
+[公式版とコミュニティ版のアダプターを、インテグレーションディレクトリ](https://astro.build/integrations/?search=&categories%5B%5D=adapters)で確認できます。自分の[デプロイ環境](/ja/guides/deploy/)に対応するものを選択してください。
#### `astro add`を使ったインストール
-[Astro公式のアダプターインテグレーション](/ja/guides/integrations-guide/)は、`astro add`コマンドを使って追加できます。これにより、アダプターのインストールと、`astro.config.mjs`ファイルへの適切な変更が一度に行われます。例えば、Vercelアダプターをインストールするには次のコマンドを実行します。
+[Astroが管理する公式のアダプター](/ja/guides/integrations-guide/#公式インテグレーション)は、次の`astro add`コマンドを使って追加できます。これにより、アダプターのインストールと、`astro.config.mjs`ファイルへの適切な変更が一度に実行されます。
+
+たとえばVercelアダプターをインストールするには、以下のコマンドを実行します。
@@ -95,54 +70,68 @@ SSRを有効にしたプロジェクトをデプロイするには、アダプ
-#### 手動でインストール
+#### 手動インストール
+
+パッケージのインストールと`astro.config.mjs`の更新を手動でおこない、アダプターを追加することもできます。
-パッケージをインストールし、`astro.config.mjs`を更新して手動でアダプターを追加することもできます。（以下の2つの手順を完了させSSRを有効にするための各アダプター固有の手順については、上記のリンクをご覧ください。）`my-adapter`を何らかのアダプターの例とすると、次のような手順になります。
+たとえば、Vercelアダプターを手動で追加するには以下のようにします。
1. 好みのパッケージマネージャーを利用してプロジェクトの依存関係にアダプターをインストールします。
```shell
- npm install @astrojs/my-adapter
+ npm install @astrojs/vercel
```
```shell
- pnpm add @astrojs/my-adapter
+ pnpm add @astrojs/vercel
```
```shell
- yarn add @astrojs/my-adapter
+ yarn add @astrojs/vercel
```
-2. `astro.config.mjs`ファイルのimportとdefault exportに[アダプターを追加します](/ja/reference/configuration-reference/#adapter)。
+2. `astro.config.mjs`ファイルのimportとdefault exportに[アダプターを追加し](/ja/reference/configuration-reference/#adapter)、必要な`output`モードを設定します。
- ```js ins={3,6-7}
+ ```js ins={3,7} {6}
// astro.config.mjs
import { defineConfig } from 'astro/config';
- import myAdapter from '@astrojs/my-adapter';
+ import vercel from '@astrojs/vercel/serverless';
export default defineConfig({
output: 'server',
- adapter: myAdapter(),
+ adapter: vercel(),
});
```
-## 機能
+ アダプターごとに設定が異なることに注意してください。各アダプターのドキュメントを読み、選択したアダプターに必要な設定オプションを`astro.config.mjs`で適用してください。
+
+### `server`と`hybrid`の設定
-Astroがデフォルトで静的サイトジェネレーターであることは変わりません。しかし、サーバーサイドレンダリングを有効にしてアダプターを追加すると、いくつかの機能を新しく利用できるようになります。
+オンデマンドレンダリングを有効化するには、`output`の設定値を2つのサーバーレンダリングモードのいずれかに更新する必要があります。
-### 個別のルートの設定
+たとえば、デフォルトですべてのページがオンデマンドにレンダリングされるような、大部分が動的なアプリケーションを設定するには、Astroの設定ファイルに`output: 'server'`を追加します。
+
+```js ins={5} title="astro.config.mjs"
+import { defineConfig } from 'astro/config';
+import node from "@astrojs/node";
-`server`と`hybrid`モードの両方で、サーバーレンダリングされたページとエンドポイントを使用でき、すべてのページはデフォルトの動作に従ってレンダリングされます。しかし、どちらのモードでも、個別のページをデフォルトの動作からオプトアウトできます。
+export default defineConfig({
+ output: 'server',
+ adapter: node({
+ mode: "standalone"
+ })
+});
+```
-### サーバーレンダリングのオプトアウト
+### `server`モードで事前レンダリングにオプトインする
-`output: server`を設定し大部分がサーバーレンダリングされるアプリでは、ページまたはルートに`export const prerender = true`を追加することで、静的ページまたはエンドポイントを事前レンダリングできます。
+`output: server`を設定したほぼサーバーレンダリングされるアプリについては、`export const prerender = true`をページまたはルートに追加して、静的なページまたはエンドポイントを事前レンダリングできます。
```astro title="src/pages/mypage.astro" {2}
---
@@ -150,84 +139,67 @@ export const prerender = true;
// ...
---
-
+
```
```mdx title="src/pages/mypage.mdx" {5}
---
layout: '../layouts/markdown.astro'
-title: '私のページ'
+title: 'My page'
---
export const prerender = true;
-# これは静的な、事前レンダリングされたページです
+# 事前レンダリングされた静的なページです
```
-エンドポイントの場合は次のようになります。
-
```js title="src/pages/myendpoint.js" {1}
export const prerender = true;
export async function GET() {
- return {
- body: JSON.stringify({ message: `これは静的エンドポイントです` }),
- };
+ return new Response(
+ JSON.stringify({
+ message: `静的なエンドポイントです`,
+ }),
+ );
}
```
-### 事前レンダリングのオプトアウト
+### `hybrid`モードで事前レンダリングをオプトアウトする
-`output: hybrid`を設定した大部分が静的なサイトでは、`export const prerender = false`をサーバーレンダリングさせたいファイルに追加します。
+`output: hybrid`を設定したほぼ静的なサイトについては、オンデマンドにサーバーレンダリングしたいファイルに`export const prerender = false`を追加します。
```js title="src/pages/randomnumber.js" {1}
export const prerender = false;
export async function GET() {
let number = Math.random();
- return {
- body: JSON.stringify({ number, message: `ランダムな数: ${number}` }),
- };
+ return new Response(
+ JSON.stringify({
+ number,
+ message: `ランダムな数: ${number}`,
+ }),
+ );
}
```
-### `Astro.request.headers`
-
-リクエストのヘッダーは、`Astro.request.headers`で取得できます。ブラウザの[`Request.headers`](https://developer.mozilla.org/ja/docs/Web/API/Request/headers)と同様に動作します。これは[Headers](https://developer.mozilla.org/ja/docs/Web/API/Headers)オブジェクトという、Cookieなどのヘッダーを取得できるMapのようなオブジェクトです。
-
-```astro title="src/pages/index.astro" {2}
----
-const cookie = Astro.request.headers.get('cookie');
-// ...
----
-
-
-
-```
+## オンデマンドレンダリングの機能
-### `Astro.request.method`
+### HTMLストリーミング
-リクエストに使用されたHTTPメソッドは、`Astro.request.method`で取得できます。これはブラウザの[`Request.method`](https://developer.mozilla.org/ja/docs/Web/API/Request/method)と同様に動作します。リクエストで使用されたHTTPメソッドを文字列として返します。
+HTMLストリーミングにより、ドキュメントはチャンクへと分割され、ネットワークを経由して順に送信され、その順番でページにレンダリングされます。`server`または`hybrid`モードでは、Astroはコンポーネントをレンダリングする際にブラウザに送信するためにHTMLストリーミングを使用します。これによりユーザーにできるだけ早くHTMLを表示できますが、ネットワークの状況によっては、大きなドキュメントのダウンロードが遅れたり、データの取得を待つことでページのレンダリングがブロックされることがあります。
-```astro title="src/pages/index.astro"
----
-console.log(Astro.request.method) // GET (ブラウザで遷移したとき)
----
-```
+
:::caution
-以下の機能はページレベルでのみ利用できます。（レイアウトコンポーネントを含むコンポーネントの内部では使用できません。）
-
-ブラウザに送信された後に変更することができない[レスポンスヘッダー](https://developer.mozilla.org/ja/docs/Glossary/Response_header)を、以下の機能が変更することが理由です。SSRモードでは、AstroはHTMLストリーミングを使用して、各コンポーネントをレンダリングする際にブラウザに送信します。これによりユーザーにできるだけ早くHTMLを表示できますが、その結果、Astroがコンポーネントのコードを実行する時点で、すでにレスポンスヘッダーが送信されてしまっているのです。
+[レスポンスヘッダー](https://developer.mozilla.org/ja/docs/Glossary/Response_header)を変更する機能は**ページレベル**でのみ利用できます。（レイアウトコンポーネントを含むコンポーネントの内部では使用できません。）Astroがコンポーネントのコードを実行する時点で、すでにレスポンスヘッダーが送信されてしまっており、それを変更できないためです。
:::
-### `Astro.cookies`
-
-単一のCookieを読み取り、変更するためのユーティリティです。Cookieのチェック、設定、取得、削除ができます。
+### クッキー
-[`Astro.cookies`と`AstroCookie`型](/ja/reference/api-reference/#astrocookies)について詳しくは、APIリファレンスを確認してください。
+`server`と`hybrid`モードでは、ページやAPIエンドポイントでクッキーをチェック、設定、取得、削除できます。
-以下の例では、ページビューカウンターのCookieの値を更新しています。
+以下の例では、ページビューカウンターのクッキーの値を更新しています。
```astro title="src/pages/index.astro" {4,5,9}
---
@@ -245,9 +217,13 @@ Astro.cookies.set("counter", counter)