Browse Source

🌐 Update translations for ja (update-outdated)

pull/15895/head
github-actions[bot] 3 weeks ago
parent
commit
179c946ff2
  1. 20
      docs/ja/docs/alternatives.md
  2. 2
      docs/ja/docs/async.md
  3. 2
      docs/ja/docs/editor-support.md
  4. 6
      docs/ja/docs/environment-variables.md
  5. 4
      docs/ja/docs/features.md
  6. 20
      docs/ja/docs/index.md
  7. 2
      docs/ja/docs/project-generation.md
  8. 6
      docs/ja/docs/python-types.md
  9. 10
      docs/ja/docs/virtual-environments.md

20
docs/ja/docs/alternatives.md

@ -88,7 +88,7 @@ Requestsは非常にシンプルかつ直感的なデザインで使いやすく
response = requests.get("http://example.com/some/url")
```
対応するFastAPIのAPIのpath operationはこのようになります:
対応するFastAPI側のAPI *path operation* はこのようになります:
```Python hl_lines="1"
@app.get("/some/url")
@ -96,12 +96,12 @@ def read_url():
return {"message": "Hello World"}
```
`requests.get(...)` と`@app.get(...)` には類似点が見受けられます。
`requests.get(...)` と`@app.get(...)` には類似点が見受けられます。
/// tip | **FastAPI**へ与えたインスピレーション
* シンプルで直感的なAPIを持っている点。
* HTTPメソッド名を直接利用し、単純で直感的である。
* HTTPメソッド名 (operation) を直接利用し、単純で直感的である。
* 適切なデフォルト値を持ちつつ、強力なカスタマイズ性を持っている。
///
@ -223,7 +223,7 @@ Flask、Flask-apispec、Marshmallow、Webargsの組み合わせは、**FastAPI**
* [https://github.com/tiangolo/full-stack-flask-couchbase](https://github.com/tiangolo/full-stack-flask-couchbase)
* [https://github.com/tiangolo/full-stack-flask-couchdb](https://github.com/tiangolo/full-stack-flask-couchdb)
そして、これらのフルスタックジェネレーターは、[**FastAPI** Project Generators](project-generation.md)の元となっていました。
そして、これらのフルスタックジェネレーターは、[**FastAPI** プロジェクトジェネレーター](project-generation.md)の元となっていました。
/// note | 備考
@ -247,7 +247,7 @@ Angular 2にインスピレーションを受けた、統合された依存性
パラメータはTypeScriptの型で記述されるので (Pythonの型ヒントに似ています) 、エディタのサポートはとても良いです。
しかし、TypeScriptのデータはJavaScriptへのコンパイル後には残されないため、バリデーション、シリアライゼーション、ドキュメント化を同時に定義するのに型に頼ることはできません。そのため、バリデーション、シリアライゼーション、スキーマの自動生成を行うためには、多くの場所でデコレータを追加する必要があり、非常に冗長になります。
しかし、TypeScriptのデータはJavaScriptへのコンパイル後には残されないため、バリデーション、シリアライゼーション、ドキュメント化を同時に定義するのに型に頼ることはできません。このことといくつかの設計上の判断により、バリデーション、シリアライゼーション、スキーマの自動生成を行うためには、多くの場所でデコレータを追加する必要があり、非常に冗長になります。
入れ子になったモデルをうまく扱えません。そのため、リクエストのJSONボディが内部フィールドを持つJSONオブジェクトで、それが順番にネストされたJSONオブジェクトになっている場合、適切にドキュメント化やバリデーションをすることができません。
@ -333,15 +333,15 @@ OpenAPIやJSON Schemaのような標準に基づいたものではありませ
同じフレームワークを使ってAPIとCLIを作成できる、面白く珍しい機能を持っています。
以前のPythonの同期型Webフレームワーク標準 (WSGI) をベースにしているため、Websocketなどは扱えませんが、それでも高性能です。
以前のPythonの同期型Webフレームワーク標準 (WSGI) をベースにしているため、WebSocketなどは扱えませんが、それでも高性能です。
/// note | 備考
HugはTimothy Crosleyにより作成されました。彼は[`isort`](https://github.com/timothycrosley/isort)など、Pythonのファイル内のインポートの並び替えを自動的におこうなう素晴らしいツールの開発者です。
HugはTimothy Crosleyにより作成されました。彼は[`isort`](https://github.com/timothycrosley/isort)など、Pythonのファイル内のインポートの並び替えを自動的にう素晴らしいツールの開発者です。
///
/// tip | **FastAPI**へ与えたインスピレーション
/// tip | **FastAPI**にインスピレーションを与えたアイデア
HugはAPIStarに部分的なインスピレーションを与えており、私が発見した中ではAPIStarと同様に最も期待の持てるツールの一つでした。
@ -430,7 +430,7 @@ Starletteは、軽量な<dfn title="非同期Python Webアプリケーション
* インプロセスのバックグラウンドタスク。
* 起動およびシャットダウンイベント。
* HTTPXに基づいて構築されたテストクライアント。
* CORS、GZip、静的ファイル、ストリーミング応答
* CORS、GZip、静的ファイル、ストリーミングレスポンス
* セッションとクッキーのサポート。
* 100%のテストカバレッジ。
* 100%の型注釈付きコードベース。
@ -480,6 +480,6 @@ Starletteや**FastAPI**のサーバーとして推奨されています。
///
## ベンチマーク と スピード { #benchmarks-and-speed }
## ベンチマークと速度 { #benchmarks-and-speed }
Uvicorn、Starlette、FastAPIの違いを理解、比較、確認するには、[ベンチマーク](benchmarks.md)を確認してください。

2
docs/ja/docs/async.md

@ -215,7 +215,7 @@ def results():
この「並列ハンバーガー」のシナリオでは、あなたは 2 つのプロセッサ (あなたと好きな人) を持つコンピュータ/プログラム 🤖 で、どちらも長い間 🕙「カウンターでの待機」に注意 ⏯ を専念しています。
ファストフード店には 8 個のプロセッサ (レジ係/料理人) があります。一方、並行ハンバーガーの店には (レジ係 1人、料理人 1 人の) 2 個しかなかったかもしれません。
ファストフード店には 8 個のプロセッサ (レジ係/料理人) があります。一方、並行ハンバーガーの店には (レジ係 1 人、料理人 1 人の) 2 個しかなかったかもしれません。
それでも、最終的な体験は最良とは言えません。😞

2
docs/ja/docs/editor-support.md

@ -20,4 +20,4 @@
- **FastAPI Cloud へデプロイ** - [FastAPI Cloud](https://fastapicloud.com/) にワンクリックでアプリをデプロイできます。
- **アプリケーションログのストリーミング** - FastAPI Cloud にデプロイしたアプリから、レベルフィルタやテキスト検索付きでリアルタイムにログをストリーミングできます。
拡張機能の機能に慣れるには、コマンドパレット(<kbd>Ctrl</kbd> + <kbd>Shift</kbd> + <kbd>P</kbd>、macOS: <kbd>Cmd</kbd> + <kbd>Shift</kbd> + <kbd>P</kbd>)を開き、"Welcome: Open walkthrough..." を選択してから、"Get started with FastAPI" のウォークスルーを選んでください。
拡張機能の機能に慣れるには、コマンドパレット(<kbd>Ctrl</kbd> + <kbd>Shift</kbd> + <kbd>P</kbd>、macOS: <kbd>Cmd</kbd> + <kbd>Shift</kbd> + <kbd>P</kbd>)を開き、「Welcome: Open walkthrough...」を選択してから、「Get started with FastAPI」のウォークスルーを選んでください。

6
docs/ja/docs/environment-variables.md

@ -163,7 +163,7 @@ Hello World from Python
つまり、環境変数からPythonで読み取る**あらゆる値**は **`str`になり**、他の型への変換やバリデーションはコード内で行う必要があります。
環境変数を使って**アプリケーション設定**を扱う方法については、[高度なユーザーガイド - Settings and Environment Variables](./advanced/settings.md)で詳しく学べます。
環境変数を使って**アプリケーション設定**を扱う方法については、[高度なユーザーガイド - 設定と環境変数](./advanced/settings.md)で詳しく学べます。
## `PATH`環境変数 { #path-environment-variable }
@ -285,7 +285,7 @@ $ C:\opt\custompython\bin\python
////
この情報は、[Virtual Environments](virtual-environments.md)について学ぶ際にも役立ちます。
この情報は、[仮想環境](virtual-environments.md)について学ぶ際にも役立ちます。
## まとめ { #conclusion }
@ -295,4 +295,4 @@ $ C:\opt\custompython\bin\python
多くの場合、環境変数がどのように役立ち、すぐに適用できるのかはあまり明確ではありません。しかし、開発中のさまざまなシナリオで何度も登場するため、知っておくとよいでしょう。
例えば、次のセクションの[Virtual Environments](virtual-environments.md)でこの情報が必要になります。
例えば、次のセクションの[仮想環境](virtual-environments.md)でこの情報が必要になります。

4
docs/ja/docs/features.md

@ -99,7 +99,7 @@ Python 開発者調査では、[最もよく使われる機能の 1 つが「オ
すべてに妥当な **デフォルト** があり、どこでもオプションで構成できます。必要に応じてすべてのパラメータを微調整して、求める API を定義できます。
しかしデフォルトのままでも、すべて **うまく動きます**
しかしデフォルトのままでも、すべて **「うまく動きます」**
### 検証 { #validation }
@ -140,7 +140,7 @@ FastAPI には、非常に使いやすく、かつ非常に強力な <dfn title=
* 依存関係は依存関係を持つこともでき、階層または **依存関係の「グラフ」** を作成できます。
* すべてフレームワークによって**自動的に処理**されます。
* すべての依存関係はリクエストからデータを要求でき、*path operation* の制約と自動ドキュメントを**拡張**できます。
* すべての依存関係はリクエストからデータを要求でき、path operation の制約と自動ドキュメントを**拡張**できます。
* 依存関係で定義された *path operation* のパラメータについても**自動検証**されます。
* 複雑なユーザー認証システム、**データベース接続** などのサポート。
* **データベースやフロントエンド等との妥協は不要**。すべてと簡単に統合できます。

20
docs/ja/docs/index.md

@ -49,15 +49,15 @@ FastAPI は、Python の標準である型ヒントに基づいて Python で AP
* **簡単**: 簡単に利用・習得できるようにデザインされています。ドキュメントを読む時間を削減します。
* **短い**: コードの重複を最小限にします。各パラメータ宣言から複数の機能を得られます。バグも減ります。
* **堅牢性**: 自動対話型ドキュメントにより、本番環境向けのコードが得られます。
* **Standards-based**: API のオープンスタンダードに基づいており(そして完全に互換性があります)、[OpenAPI](https://github.com/OAI/OpenAPI-Specification)(以前は Swagger として知られていました)や [JSON Schema](https://json-schema.org/) をサポートします。
* **標準準拠**: API のオープンスタンダードに基づいており(そして完全に互換性があります)、[OpenAPI](https://github.com/OAI/OpenAPI-Specification)(以前は Swagger として知られていました)や [JSON Schema](https://json-schema.org/) をサポートします。
<small>* 本番アプリケーションを構築している社内開発チームのテストに基づく見積もりです。</small>
## Sponsors { #sponsors }
## スポンサー { #sponsors }
<!-- sponsors -->
### Keystone Sponsor { #keystone-sponsor }
### Keystone スポンサー { #keystone-sponsor }
<div class="fastapi-sponsors fastapi-sponsors--keystone">
{% for sponsor in sponsors.keystone -%}
@ -65,7 +65,7 @@ FastAPI は、Python の標準である型ヒントに基づいて Python で AP
{% endfor -%}
</div>
### Gold Sponsors { #gold-sponsors }
### Gold スポンサー { #gold-sponsors }
<div class="fastapi-sponsors fastapi-sponsors--gold">
{% for sponsor in sponsors.gold -%}
@ -73,7 +73,7 @@ FastAPI は、Python の標準である型ヒントに基づいて Python で AP
{% endfor -%}
</div>
### Silver Sponsors { #silver-sponsors }
### Silver スポンサー { #silver-sponsors }
<div class="fastapi-sponsors fastapi-sponsors--silver">
{% for sponsor in sponsors.silver -%}
@ -125,7 +125,7 @@ FastAPI は、Python の標準である型ヒントに基づいて Python で AP
<div class="only-github" markdown="1">
"_[...] 最近 **FastAPI** を使っています。 [...] 実際に私のチームの全ての **Microsoft の機械学習サービス** で使用する予定です。 そのうちのいくつかのコアな **Windows** 製品と **Office** 製品に統合されつつあります。_"
"_[...] 最近 **FastAPI**たくさん使っています。 [...] 実際に私のチームの全ての **Microsoft の機械学習サービス** で使用する予定です。 そのうちのいくつかのコアな **Windows** 製品と **Office** 製品に統合されつつあります。_"
<div style="text-align: right; margin-right: 10%;">Kabir Khan - <strong>Microsoft</strong> <a href="https://github.com/fastapi/fastapi/pull/26"><small>(ref)</small></a></div>
@ -275,7 +275,7 @@ INFO: Application startup complete.
</div>
<details markdown="1">
<summary><code>fastapi dev</code> コマンドについて</summary>
<summary><code>fastapi dev</code> コマンドについて...</summary>
`fastapi dev` コマンドは `main.py` ファイルを自動的に読み取り、その中の **FastAPI** アプリを検出し、[Uvicorn](https://www.uvicorn.dev) を使用してサーバーを起動します。
@ -471,11 +471,11 @@ item: Item
...に変更し、エディタが属性を自動補完し、その型を知ることを確認してください。
![editor support](https://fastapi.tiangolo.com/img/vscode-completion.png)
![エディタサポート](https://fastapi.tiangolo.com/img/vscode-completion.png)
より多くの機能を含む、より完全な例については、<a href="https://fastapi.tiangolo.com/ja/tutorial/">Tutorial - User Guide</a> を参照してください。
より多くの機能を含む、より完全な例については、<a href="https://fastapi.tiangolo.com/ja/tutorial/">チュートリアル - ユーザーガイド</a> を参照してください。
**ネタバレ注意**: tutorial - user guide には以下が含まれます。
**ネタバレ注意**: チュートリアル - ユーザーガイドには以下が含まれます。
* **ヘッダー**、**Cookie**、**フォームフィールド**、**ファイル**など、他のさまざまな場所からの **パラメータ** 宣言。
* `maximum_length``regex` のような **検証制約** を設定する方法。

2
docs/ja/docs/project-generation.md

@ -2,7 +2,7 @@
テンプレートは通常、特定のセットアップが含まれていますが、柔軟でカスタマイズできるように設計されています。これにより、プロジェクトの要件に合わせて変更・適応でき、優れた出発点になります。🏁
このテンプレートを使って開始できます。初期セットアップ、セキュリティ、データベース、いくつかのAPIエンドポイントがすでに用意されています。
このテンプレートを使って開始できます。初期セットアップの多く、セキュリティ、データベース、いくつかのAPIエンドポイントがすでに用意されています。
GitHubリポジトリ: [Full Stack FastAPI Template](https://github.com/tiangolo/full-stack-fastapi-template)

6
docs/ja/docs/python-types.md

@ -151,7 +151,7 @@ def some_function(data: Any):
一部の型は、角括弧内で「型パラメータ」を受け取り、内部の型を定義できます。例えば「文字列のリスト」は `list[str]` として宣言します。
このように型パラメータを取れる型は **Generic types**(ジェネリクス)と呼ばれます。
このように型パラメータを取れる型は **Generic types** または **Generics**(ジェネリクス)と呼ばれます。
次の組み込み型をジェネリクスとして(角括弧と内部の型で)使えます:
@ -265,7 +265,7 @@ def some_function(data: Any):
これは「`one_person` はクラス `Person`**インスタンス** である」ことを意味します。
「`one_person` は `Person` という名前の **クラ ス** である」という意味ではありません。
「`one_person` は `Person` という名前の **クラス** である」という意味ではありません。
## Pydantic のモデル { #pydantic-models }
@ -343,6 +343,6 @@ Python 自体は、この `Annotated` で何かをするわけではありませ
/// note | 備考
すでにすべてのチュートリアルを終えて、型についての詳細を見るためにこのページに戻ってきた場合は、良いリソースとして [`mypy` の「チートシート`](https://mypy.readthedocs.io/en/latest/cheat_sheet_py3.html) があります。
すでにすべてのチュートリアルを終えて、型についての詳細を見るためにこのページに戻ってきた場合は、良いリソースとして [`mypy` の「チートシート](https://mypy.readthedocs.io/en/latest/cheat_sheet_py3.html) があります。
///

10
docs/ja/docs/virtual-environments.md

@ -35,15 +35,15 @@ Pythonプロジェクトの作業では、**仮想環境**(または類似の
<div class="termy">
```console
// Go to the home directory
// ホームディレクトリに移動
$ cd
// Create a directory for all your code projects
// すべてのコードプロジェクト用のディレクトリを作成
$ mkdir code
// Enter into that code directory
// その code ディレクトリに入る
$ cd code
// Create a directory for this project
// このプロジェクト用のディレクトリを作成
$ mkdir awesome-project
// Enter into that project directory
// そのプロジェクトディレクトリに入る
$ cd awesome-project
```

Loading…
Cancel
Save