i18n(ja): Update environment-variables.md and part of configuring-astro.md#2134
Merged
sarah11918 merged 5 commits intoDec 5, 2022
Merged
Conversation
✅ Deploy Preview for astro-docs-2 ready!Built without sensitive environment variables
To edit notification comments on pull requests, go to your Netlify site settings. |
github-actions
Bot
added
the
i18n
morinokami
commented
Dec 3, 2022
morinokami
commented
Dec 3, 2022
| ベストプラクティスについては、公式の[環境変数の例](https://github.com/withastro/astro/tree/main/examples/env-vars)をご覧ください。 | ||
|
|
||
| ```ini | ||
| ```ini title=".env" |
morinokami
commented
Dec 3, 2022
Comment on lines
-39
to
+44
| ```bash | ||
| # .env | ||
| ```ini title=".env" |
morinokami
commented
Dec 3, 2022
Comment on lines
-84
to
+105
| ```ts | ||
| ```ts title="src/env.d.ts" |
morinokami
commented
Dec 3, 2022
Comment on lines
+20
to
+32
| :::caution | ||
| `import.meta.env`と`.env`ファイルは[設定ファイル](/ja/guides/configuring-astro/#environment-variables)の中では利用できません | ||
| ::: | ||
|
|
||
| ## デフォルト環境変数 | ||
|
|
||
| Astroでは、いくつかの環境変数をすぐに利用できます。 | ||
|
|
||
| - `import.meta.env.MODE` (`development` | `production`): サイトが動作しているモードです。これは`astro dev`を実行している場合は`development`で、`astro build`を実行している場合は`production`になります。 | ||
| - `import.meta.env.BASE_URL` (`string`): あなたのサイトの配信元のベースURLです。これは、[`base`オプション](/ja/reference/configuration-reference/#base)によって決まります。 | ||
| - `import.meta.env.PROD` (`boolean`): あなたのサイトが本番環境で動作しているかどうかです。 | ||
| - `import.meta.env.DEV` (`boolean`): 開発中のサイトかどうかです（常に`import.meta.env.PROD`の反対）。 | ||
| - `import.meta.env.SITE` (`string`): プロジェクトの`astro.config`で指定された[`site`オプション](/ja/reference/configuration-reference/#site). | ||
| - `import.meta.env.MODE`: サイトが動作しているモードです。これは`astro dev`を実行している場合は`development`で、`astro build`を実行している場合は`production`になります。 | ||
| - `import.meta.env.PROD`: あなたのサイトが本番環境で動作している場合は`true`となり、その他の場合は`false`となります。 | ||
| - `import.meta.env.DEV`: あなたのサイトが開発環境で動作している場合は`true`となり、その他の場合は`false`となります。常に`import.meta.env.PROD`の反対となります。 | ||
| - `import.meta.env.BASE_URL`: あなたのサイトの配信元のベースURLです。これは、[`base`オプション](/ja/reference/configuration-reference/#base)によって決まります。 | ||
| - `import.meta.env.SITE`: プロジェクトの`astro.config`で指定された[`site`オプション](/ja/reference/configuration-reference/#site)がセットされます。 |
morinokami
commented
Dec 3, 2022
Comment on lines
-47
to
+77
| ```ini | ||
| .env # すべてのケースで読み込まれます。 | ||
| .env.local # すべてのケースで読み込まれ、gitにはignoreされます。 | ||
| .env.[mode] # 指定したモードのみで読み込まれます。 | ||
| .env.[mode].local # 指定したモードのみで読み込まれ、gitにはignoreされます。 | ||
| ``` | ||
| `.env`ファイルについてさらに知りたい場合は、[Viteのドキュメントを参照してください](https://vitejs.dev/guide/env-and-mode.html#env-files)。 | ||
|
|
||
| ### CLIの利用 | ||
|
|
||
| プロジェクトの実行時に環境変数を追加することも可能です。 | ||
|
|
||
| <PackageManagerTabs> | ||
| <Fragment slot="yarn"> | ||
| ```shell | ||
| POKEAPI=https://pokeapi.co/api/v2 yarn run dev | ||
| ``` | ||
| </Fragment> | ||
| <Fragment slot="npm"> | ||
| ```shell | ||
| POKEAPI=https://pokeapi.co/api/v2 npm run dev | ||
| ``` | ||
| </Fragment> | ||
| <Fragment slot="pnpm"> | ||
| ```shell | ||
| POKEAPI=https://pokeapi.co/api/v2 pnpm run dev | ||
| ``` | ||
| </Fragment> | ||
| </PackageManagerTabs> | ||
|
|
||
| :::caution | ||
| このようにセットされた変数は、クライアントサイドも含め、プロジェクトの任意の箇所から利用可能となります。 | ||
| ::: |
morinokami
commented
Dec 3, 2022
Comment on lines
+36
to
+37
| ### `.env`ファイル | ||
|
|
morinokami
commented
Dec 3, 2022
Comment on lines
-64
to
+85
| ```js | ||
| ```js /(?<!//.*)import.meta.env.[A-Z_]+/ |
morinokami
commented
Dec 3, 2022
Comment on lines
-8
to
+9
| Astroは環境変数にViteを使用しています。[Viteのいずれかの方法](https://vitejs.dev/guide/env-and-mode.html)で環境変数の取得や設定ができます。 | ||
| Astroは環境変数に関するViteの組み込みのサポートを利用しています。環境変数を扱うために[Viteが備える任意の方式](https://vitejs.dev/guide/env-and-mode.html)を使用できます。 |
morinokami
commented
Dec 3, 2022
|
|
||
| サーバ側のコードでは _すべて_ の環境変数が使えますが、クライアント側のコードではセキュリティのために`PUBLIC_`というプレフィックスを持つ環境変数のみが使えることに注意してください。 | ||
|
|
||
| ベストプラクティスについては、公式の[環境変数の例](https://github.com/withastro/astro/tree/main/examples/env-vars)をご覧ください。 |
morinokami
commented
Dec 3, 2022
morinokami
commented
Dec 3, 2022
Comment on lines
+109
to
+114
| ## 環境変数 | ||
|
|
||
| Astroは他のファイルをロードする前に設定ファイルを評価します。そのため、`import.meta.env`を使うことはできず、また`.env`ファイルによってセットされた環境変数を取得することもできません。 | ||
|
|
||
| 設定ファイルの中で`process.env`を使用して、[CLIによりセットされた](/ja/guides/environment-variables/#cliの利用)ものなど、その他の環境変数を取得することは可能です。 | ||
|
|
Member
Author
There was a problem hiding this comment.
に対応する日本語版のリンク先が存在せず、しかし
/en で始まるもとのリンク先のままとすると CI のエラーとなってしまうため、急遽こちらの訳のみ追加しました。configuring-astro.md 全体としては英語版と比較して未訳箇所が残っているようです。
Contributor
There was a problem hiding this comment.
configuring-astro.md も早めに更新が必要そうですね。今回は関連する場所だけで大丈夫だと思います。
morinokami
changed the title
kyosuke
approved these changes
Dec 4, 2022
Contributor
kyosuke
left a comment
kyosuke
left a comment
There was a problem hiding this comment.
@morinokami レビューしました！最新の変更が丁寧に反映されていて、またコメントで変更元もいただいていたのでレビューしやすかったです。
configuring-astro.md のほうだけ、こうした方が読みやすいかなという小さなコメントを入れていますが、このままでも問題ないと思います。
Comment on lines
+109
to
+114
| ## 環境変数 | ||
|
|
||
| Astroは他のファイルをロードする前に設定ファイルを評価します。そのため、`import.meta.env`を使うことはできず、また`.env`ファイルによってセットされた環境変数を取得することもできません。 | ||
|
|
||
| 設定ファイルの中で`process.env`を使用して、[CLIによりセットされた](/ja/guides/environment-variables/#cliの利用)ものなど、その他の環境変数を取得することは可能です。 | ||
|
|
Contributor
There was a problem hiding this comment.
configuring-astro.md も早めに更新が必要そうですね。今回は関連する場所だけで大丈夫だと思います。
|
|
||
| ## 環境変数 | ||
|
|
||
| Astroは他のファイルをロードする前に設定ファイルを評価します。そのため、`import.meta.env`を使うことはできず、また`.env`ファイルによってセットされた環境変数を取得することもできません。 |
Contributor
There was a problem hiding this comment.
Suggested change
| Astroは他のファイルをロードする前に設定ファイルを評価します。そのため、`import.meta.env`を使うことはできず、また`.env`ファイルによってセットされた環境変数を取得することもできません。 | |
| Astroは他のファイルをロードする前に設定ファイルを評価します。そのため、`import.meta.env`は使えず、また`.env`ファイルによってセットされた環境変数を取得もできません。 |
Member
Author
There was a problem hiding this comment.
環境変数を取得もできません については 環境変数の取得もできません としておきました🙏
|
|
||
| Astroは他のファイルをロードする前に設定ファイルを評価します。そのため、`import.meta.env`を使うことはできず、また`.env`ファイルによってセットされた環境変数を取得することもできません。 | ||
|
|
||
| 設定ファイルの中で`process.env`を使用して、[CLIによりセットされた](/ja/guides/environment-variables/#cliの利用)ものなど、その他の環境変数を取得することは可能です。 |
Contributor
There was a problem hiding this comment.
Suggested change
| 設定ファイルの中で`process.env`を使用して、[CLIによりセットされた](/ja/guides/environment-variables/#cliの利用)ものなど、その他の環境変数を取得することは可能です。 | |
| 設定ファイルの中で`process.env`を使用して、[CLIによりセットされた](/ja/guides/environment-variables/#cliの利用)ものなど、その他の環境変数の取得は可能です。 |
Member
Author
|
@kyosuke レビューいただきありがとうございました！コメントを反映しました🙏 |
Contributor
|
@morinokami 修正対応ありがとうございます！確認しました。LGTM！ |
Member
|
I saw the magic phrase, so I'm merging! 🥳 |
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Sign up for free
to join this conversation on GitHub.
Already have an account?
Sign in to comment
3 participants
Add this suggestion to a batch that can be applied as a single commit.This suggestion is invalid because no changes were made to the code.Suggestions cannot be applied while the pull request is closed.Suggestions cannot be applied while viewing a subset of changes.Only one suggestion per line can be applied in a batch.Add this suggestion to a batch that can be applied as a single commit.Applying suggestions on deleted lines is not supported.You must change the existing code in this line in order to create a valid suggestion.Outdated suggestions cannot be applied.This suggestion has been applied or marked resolved.Suggestions cannot be applied from pending reviews.Suggestions cannot be applied on multi-line comments.Suggestions cannot be applied while the pull request is queued to merge.Suggestion cannot be applied right now. Please check back later.
What kind of changes does this PR include?
Description