i18n(ja): Update configuring-astro.md (#2137)

src/pages/ja/guides/configuring-astro.md

@@ -24,14 +24,14 @@ export default defineConfig({
 
 `defineConfig()`を使うと、IDEで自動的にタイプヒントを表示できるのでおすすめですが、これはオプションです。最低限必要で、有効な設定ファイルは次のようなものです。
 
-```js
+```js title="astro.config.mjs"
 // 例: 最低限必要な空の設定ファイル
 export default {}
 ```
 
 ## サポートされている設定ファイルの種類
 
-Astroは、JavaScriptの設定ファイルとして、次のようないくつかのファイル形式をサポートしています。 `astro.config.js`,`astro.config.mjs`,`astro.config.cjs`,`astro.config.ts`
+Astroは、JavaScriptの設定ファイルとして、`astro.config.js`、`astro.config.mjs`、`astro.config.cjs`、`astro.config.ts`という複数のファイル形式をサポートしています。多くの場合は`.mjs`を、設定ファイルをTypeScriptで記述する場合は`.ts`を使用することをおすすめします。
 
 TypeScriptの設定ファイルの読み込みは、[`tsm`](https://github.com/lukeed/tsm)を使って処理され、プロジェクトのtsconfigのオプションを尊重します。
 ## 設定ファイルの指定
@@ -67,45 +67,83 @@ export default defineConfig({
 
 ```js
 // astro.config.mjs
- export default /** @type {import('astro').AstroUserConfig} */ ({
+export default /** @type {import('astro').AstroUserConfig} */ ({
   // オプションをここに書きます...
   // https://docs.astro.build/ja/reference/configuration-reference/
 })
 ```
 
 ## 相対ファイルの参照
 
-`root`または`--root`フラグで相対パスを指定すると、`astro`コマンドを実行した現在の作業ディレクトリに反して、指定した相対パスをルートとして使用します。
+`root`または`--root`フラグで相対パスを指定すると、`astro`コマンドを実行した現在の作業ディレクトリを起点として、指定した相対パスを解決します。
 
 ```js
+// astro.config.mjs
+import { defineConfig } from 'astro/config'
+
 export default defineConfig({
-    // 現在の作業ディレクトリにある "./foo"ディレクトリを指します。
-    root: 'foo'
+  // 現在の作業ディレクトリにある "./foo"ディレクトリを指します。
+  root: 'foo'
 })
 ```
 
 Astroは、他のすべての相対ファイルおよび相対ディレクトリを、プロジェクトルートからの相対パスとして解決します。
 
 ```js
+// astro.config.mjs
+import { defineConfig } from 'astro/config'
+
 export default defineConfig({
-    // 現在の作業ディレクトリにある "./foo"ディレクトリを指します。
-    root: 'foo',
-    // 現在の作業ディレクトリの "./foo/public" ディレクトリを指します。
-    publicDir: 'public',
+  // 現在の作業ディレクトリにある "./foo"ディレクトリを指します。
+  root: 'foo',
+  // 現在の作業ディレクトリの "./foo/public" ディレクトリを指します。
+  publicDir: 'public',
 })
 ```
 
 設定ファイルから相対的にファイルやディレクトリを参照するには、`import.meta.url`を使用します（common.jsの`astro.config.cjs`ファイルを記述する場合を除きます）。
 
-```js
+```js "import.meta.url"
+// astro.config.mjs
+import { defineConfig } from 'astro/config'
+
 export default defineConfig({
-    // この設定ファイルからの相対パスで、"./foo"ディレクトリを指します。
-    root: new URL("./foo", import.meta.url),
-    // この設定ファイルから相対パスで、"./public "ディレクトリを指します。
-    publicDir: new URL("./public", import.meta.url),
+  // この設定ファイルからの相対パスで、"./foo"ディレクトリを指します。
+  root: new URL("./foo", import.meta.url),
+  // この設定ファイルから相対パスで、"./public "ディレクトリを指します。
+  publicDir: new URL("./public", import.meta.url),
 })
 ```
 
+:::note
+`import.meta.env`や`import.meta.glob`など、Vite固有の`import.meta`プロパティは設定ファイルからはアクセスできません。こうしたユースケースについては[dotenv](https://github.com/motdotla/dotenv)や[fast-glob](https://github.com/mrmlnc/fast-glob)などの代替手段をおすすめします。
+:::
+
+## 出力するファイル名のカスタマイズ
+
+インポートしたJavaScriptやCSSファイルなど、Astroが処理するコードについては、`astro.config.*`ファイルの`vite.build.rollupOptions`で[`entryFileNames`](https://rollupjs.org/guide/en/#outputentryfilenames)、[`chunkFileNames`](https://rollupjs.org/guide/en/#outputchunkfilenames)、[`assetFileNames`](https://rollupjs.org/guide/en/#outputassetfilenames)を用いて出力するファイル名をカスタマイズできます。
+
+```js ins={9-11}
+// astro.config.mjs
+import { defineConfig } from 'astro/config'
+
+export default defineConfig({
+  vite: {
+    build: {
+      rollupOptions: {
+        output: {
+          entryFileNames: 'entry.[hash].js',
+          chunkFileNames: 'chunks/chunk.[hash].js',
+          assetFileNames: 'assets/asset.[hash][extname]',
+        },
+      },
+    },
+  },
+})
+```
+
+これは、広告ブロッカーの影響を受ける可能性のある名前のスクリプト（たとえば`ads.js`や`google-tag-manager.js`）がある場合に役に立ちます。
+
 ## 環境変数
 
 Astroは他のファイルをロードする前に設定ファイルを評価します。そのため、`import.meta.env`は使えず、また`.env`ファイルによってセットされた環境変数の取得もできません。