Skip to content

Commit b48ece3

Browse files
committed
docs: add contents
1 parent ab01eda commit b48ece3

File tree

2 files changed

+14
-9
lines changed

2 files changed

+14
-9
lines changed

docs/.vitepress/config/ja.ts

+1-1
Original file line numberDiff line numberDiff line change
@@ -51,7 +51,7 @@ export const jaConfig = defineConfig({
5151
text: 'コマンドラインインターフェース',
5252
link: '/ja/concepts/command-line-interface',
5353
},
54-
// { text: '開発サーバー', link: '/ja/concepts/dev-server' },
54+
{ text: '開発サーバー', link: '/ja/concepts/dev-server' },
5555
// { text: 'プレビューサーバー', link: '/ja/concepts/preview-server' },
5656
// { text: 'プラグインコンテナー', link: '/ja/concepts/plugin-container' },
5757
// { text: 'モジュールグラフ', link: '/ja/concepts/module-graph' },

docs/content/ja/concepts/dev-server.md

+13-8
Original file line numberDiff line numberDiff line change
@@ -2,18 +2,23 @@
22

33
Viteの開発サーバーは、一般的なWebサーバーと同様に、特定のURLに対するリクエストを受け取り、特定のリソースを返します。
44

5-
どんなURLへのリクエストに対してどんなリソースを返すかは、Webサーバーの実装次第です。たとえば、 `/index.html` というURLに対するリクエストに、Webサーバーのファイルシステムにおける `/index.html` を返す必要はありません。かわりに `/www/index.html` ファイルを返すことが可能です。
5+
どんなURLへのリクエストに対してどんなリソースを返すかは、Webサーバーの実装次第です。たとえば、 `/index.html` というURLに対するリクエストに、Webサーバーのファイルシステムにおける `/index.html` を返す必要はありません。かわりに `/www/index.html` ファイルを返すことが可能です。また、 `/src/index.ts` というURLに対するリクエストに、URLの見た目から推測されるとおりにTypeScriptのコードを返す必要もありません。
66

7-
なお、リクエストに対応する処理を決定するのはURLだけでなく、リクエストのその他の点(例:HTTPヘッダー)も考慮して決定される場合もあります。
7+
::: tip
8+
URL (Uniform Resource Locator) とは、インターネット上の固有のリソースのアドレスであって、そのアドレスに実際に何があるかをあらわしたものではないことに留意してください。
9+
:::
810

9-
これらの条件にもとづいて、Viteの開発サーバーは、さまざまなリクエストに対してさまざまな処理をおこないます。
11+
なお、リクエストに対応する処理を決定するのはURLだけでなく、リクエストのその他の属性(例:HTTPヘッダー)も考慮して決定される場合もあります。
12+
13+
リクエストにまつわる諸条件にもとづき、Viteの開発サーバーは、さまざまなリクエストに対してさまざまな処理をおこないます。
1014

1115
## ルーティングとミドルウェア
1216

1317
リクエストに対する特定の処理(関数)を「ミドルウェア」といい、特定のURLへのリクエストに対してどのミドルウェアを実行するかを「ルーティング」といいます。Viteでは、[connect](https://www.npmjs.com/package/connect)を利用してルーティングをおこない、たとえば以下のようなリクエストと処理の関係が定義されています。
1418

15-
| リソース | URL例 | ミドルウェア |
16-
| :----------------- | :---------------- | :-------------------- |
17-
| HTMLリソース | `/index.html` | `indexHtmlMiddleware` |
18-
| JavaScriptリソース | `/src/index.ts` | `transformMiddleware` |
19-
| CSSリソース | `/src/styles.css` | `transformMiddleware` |
19+
| リソース | URL例 | ミドルウェア | ファイルシステム上の対応するファイル |
20+
| :-------------------------------------- | :---------------- | :---------------------- | :----------------------------------- |
21+
| エントリーポイントとしての `index.html` | `/index.html` | `indexHtmlMiddleware` | `<PROJECT_ROOT>/index.html` |
22+
| JavaScriptリソース | `/src/index.ts` | `transformMiddleware` | `<PROJECT_ROOT>/src/index.ts` |
23+
| CSSリソース | `/src/styles.css` | `transformMiddleware` | `<PROJECT_ROOT>/src/styles.ts` |
24+
| 公開静的ファイルリソース | `/favicon.ico` | `servePublicMiddleware` | `<PROJECT_ROOT>/public/favicon.ico` |

0 commit comments

Comments
 (0)