fastapi/fastapiPublic

NotificationsYou must be signed in to change notification settings
Fork8.7k
Star95.4k

🌐 Add Japanese translation for Alternatives#2043

Merged

tiangolo merged 5 commits intofastapi:masterfrom

Attsun1031:tranlation/add-japanese-doc-alternatives-inspiration-comparisons

Oct 18, 2020

Merged

🌐 Add Japanese translation for Alternatives#2043
tiangolo merged 5 commits intofastapi:masterfrom
Attsun1031:tranlation/add-japanese-doc-alternatives-inspiration-comparisons

Conversation

Copy link

Contributor

Attsun1031 commentedSep 13, 2020

This PR translates the alternatives.md to Japanese.
Please review alternatives.md.

🌐 Add Japanese translation for alternatives.md

3360436

Attsun1031 commented

Sep 13, 2020

View reviewed changes

docs/ja/mkdocs.yml

		- tr: /tr/
		- uk: /uk/
		- zh: /zh/
		- alternatives.md

Copy link

ContributorAuthor

Attsun1031Sep 13, 2020

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others.Learn more.

Only this line is edited manually, others are changed automatically bypython scripts/docs.py build-all.

Copy link

codecovbot commentedSep 13, 2020•
edited
Loading

Codecov Report

Merging#2043 intomaster willnot change coverage.
The diff coverage isn/a.

@@            Coverage Diff            @@##            master     #2043   +/-   ##=========================================  Coverage   100.00%   100.00%           =========================================  Files          239       239             Lines         7079      7079           =========================================  Hits          7079      7079

Continue to review full report at Codecov.

Legend -Click here to learn more
Δ = absolute <relative> (impact),ø = not affected,? = missing data
Powered byCodecov. Last update8a1ebb3...508ff57. Read thecomment docs.

Attsun1031 mentioned this pull request

Sep 13, 2020

Japanese Translation#1572

Closed

Copy link

Contributor

github-actionsbot commentedSep 13, 2020

📝 Docs preview for commit3360436 at:https://5f5de27c495aebdaefc39cdb--fastapi.netlify.app

tokusumi suggested changes

Sep 13, 2020

View reviewed changes

Copy link

Contributor

tokusumi left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others.Learn more.

appreciate for tough work. most of your translation is perfect.
I commented better word choices for unification and small corrections.

docs/ja/docs/alternatives.md Outdated

		@@ -0,0 +1,412 @@
		# 代替となるツールからの影響と比較

Copy link

Contributor

tokusumiSep 13, 2020

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others.Learn more.

代替ツールから受けた影響と比較

docs/ja/docs/alternatives.md Outdated

		@@ -0,0 +1,412 @@
		# 代替となるツールからの影響と比較

		何がFastAPIに影響を与えたのか、他の代替ツールとの比較、そしてそこから何を学んだのかについて。

Copy link

Contributor

tokusumiSep 13, 2020

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others.Learn more.

何がFastAPIに影響を与えたのか、他の代替ツールと比較してどうか、そしてそこから何を学んだのかについて。

docs/ja/docs/alternatives.md Outdated


		私は数年前から新しいフレームワークの作成を避けてきました。まず、FastAPIでカバーされているすべての機能を、さまざまなフレームワーク、プラグイン、ツールを使って解決しようとしました。

		しかし、ある時点で、これらの機能をすべて提供し、以前のツールから優れたアイデアを取り入れ、可能な限り最高の方法でそれらを組み合わせ、それまで利用できなかった言語機能（Python 3.6以降の型ヒント）を利用したものを作る以外に選択肢はありませんでした。

Copy link

Contributor

tokusumiSep 13, 2020

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others.Learn more.

ある時点で、 -> その時点では、

docs/ja/docs/alternatives.md Outdated


		## はじめに

		FastAPIは、以前からある代替となるツールがなければ存在しなかったでしょう。

Copy link

Contributor

tokusumiSep 13, 2020

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others.Learn more.

FastAPIは、代替ツールのこれまでの働きがなければ存在しなかったでしょう。

docs/ja/docs/alternatives.md Outdated


		リレーショナルデータベース（MySQLやPostgreSQLなど）と比較的強固に結合されているので、NoSQLデータベース（Couchbase、MongoDB、Cassandraなど）をメインに利用することは簡単ではありません。

		バックエンドでHTMLを生成するために作られたもので、最新のフロントエンド（ReactやVue.js、Angularなど）が使用するAPIや、他のシステム（<abbr title="Internet of Things">IoT</abbr>デバイスなど）が通信するためのAPIを作るために作られたものではありません。

Copy link

Contributor

tokusumiSep 13, 2020

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others.Learn more.

バックエンドでHTMLを生成するために作られたものであり、現代的なフロントエンド（ReactやVue.js、Angularなど）や、他のシステム（IoTデバイスなど）と通信するためのAPIを構築するために作られたものではありません。

docs/ja/docs/alternatives.md Outdated


		Marshmallowに匹敵しますが、ベンチマークではMarshmallowよりも高速です。また、Pythonの型ヒントを元にしているので、エディタの補助が素晴らしいです。

		!!! check "FastAPIへの影響"

Copy link

Contributor

tokusumiSep 13, 2020

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others.Learn more.

!!! check "FastAPIでの使用用途"

docs/ja/docs/alternatives.md Outdated


		しかしながら、いくつかのツールにおいてすでに「標準」として利用されています。このことは互換性を大きく改善するもので、Uvicornから他のASGIサーバー（DaphneやHypercorn）に乗り換えることができたり、あなたが`python-socketio`のようなASGI互換のツールを追加することもできます。

		!!! check "FastAPIへの影響"

Copy link

Contributor

tokusumiSep 13, 2020

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others.Learn more.

!!! check "FastAPIでの使用用途"

docs/ja/docs/alternatives.md

		しかしながら、いくつかのツールにおいてすでに「標準」として利用されています。このことは互換性を大きく改善するもので、Uvicornから他のASGIサーバー（DaphneやHypercorn）に乗り換えることができたり、あなたが`python-socketio`のようなASGI互換のツールを追加することもできます。

		!!! check "FastAPIへの影響"
		`FastAPI`クラスそのものは、`Starlette`クラスを直接継承しています。

Copy link

Contributor

tokusumiSep 13, 2020

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others.Learn more.

webに関するコアな部分を全て扱います。その上に機能を追加します。`FastAPI`クラスは、`Starlette`クラスを直接継承しています。

(1行抜けています。)

docs/ja/docs/alternatives.md Outdated

		!!! check "FastAPIへの影響"
		`FastAPI`クラスそのものは、`Starlette`クラスを直接継承しています。

		基本的にはStarletteの強化版であるため、Starletteで可能なことはFastAPIで直接可能です。

Copy link

Contributor

tokusumiSep 13, 2020

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others.Learn more.

基本的にはStarletteの強化版であるため、Starletteで可能なことは**FastAPI**で直接可能です。

(インデントの追加)

docs/ja/docs/alternatives.md Outdated


		StarletteやFastAPIのサーバーとして推奨されています。

		!!! check "FastAPI への影響"

Copy link

Contributor

tokusumiSep 13, 2020

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others.Learn more.

!!! check "FastAPI が推奨する理由"

Attsun1031 force-pushed thetranlation/add-japanese-doc-alternatives-inspiration-comparisons branch fromaf04f01 to6c63165Compare

September 17, 2020 10:41

fix translation

2fa0261

fix indent

Attsun1031 force-pushed thetranlation/add-japanese-doc-alternatives-inspiration-comparisons branch from6c63165 to2fa0261Compare

September 17, 2020 10:50

Copy link

Contributor

github-actionsbot commentedSep 17, 2020

📝 Docs preview for commit2fa0261 at:https://5f63539fe55d1fcb3b10d4a5--fastapi.netlify.app

Copy link

ContributorAuthor

Attsun1031 commentedSep 17, 2020

@tokusumi Thanks for your review! I fixed everything, so please check changes.

tokusumi suggested changes

Sep 17, 2020

View reviewed changes

Copy link

Contributor

tokusumi left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others.Learn more.

your updates is perfect.

unfortunately, I found some correction to unify "!!!" syntax. please check docs preview what is problem.

docs/ja/docs/alternatives.md Outdated


		これは自動的なAPIドキュメント生成の最初の例であり、これはFastAPIに向けた「調査」を触発した最初のアイデアの一つでした。

		!!! 備考

Copy link

Contributor

tokusumiSep 17, 2020

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others.Learn more.

!!! note "備考"

docs/ja/docs/alternatives.md Outdated


		素晴らしいツールで、私もFastAPIを持つ前はよく使っていました。

		!!! 情報

Copy link

Contributor

tokusumiSep 17, 2020

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others.Learn more.

!!! info "情報"

docs/ja/docs/alternatives.md Outdated


		エディタでは、この問題を解決することはできません。また、パラメータやMarshmallowスキーマを変更したときに、YAMLのdocstringを変更するのを忘れてしまうと、生成されたスキーマが古くなってしまいます。

		!!! 情報

Copy link

Contributor

tokusumiSep 17, 2020

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others.Learn more.

!!! info "情報"

docs/ja/docs/alternatives.md Outdated


		そして、これらのフルスタックジェネレーターは、[FastAPI Project Generators](project-generation.md){.internal-link target=_blank}の元となっていました。

		!!! info

Copy link

Contributor

tokusumiSep 17, 2020

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others.Learn more.

!!! info "情報"

docs/ja/docs/alternatives.md Outdated


		`asyncio`に基づいた、Pythonのフレームワークの中でも非常に高速なものの一つです。Flaskと非常に似た作りになっています。

		!!! 備考 "技術的な詳細"

Copy link

Contributor

tokusumiSep 17, 2020

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others.Learn more.

!!! note "技術詳細"

docs/ja/docs/alternatives.md Outdated


		これは FastAPI が追加する主な機能の一つで、すべての機能は Pythonの型ヒントに基づいています (Pydanticを使用しています) 。これに加えて、依存性注入の仕組み、セキュリティユーティリティ、OpenAPIスキーマ生成などがあります。

		!!! 備考 "技術的な詳細"

Copy link

Contributor

tokusumiSep 17, 2020

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others.Learn more.

!!! note "技術詳細"

docs/ja/docs/alternatives.md Outdated


		今ではAPIStarはOpenAPI仕様を検証するためのツールセットであり、ウェブフレームワークではありません。

		!!! 情報

Copy link

Contributor

tokusumiSep 17, 2020

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others.Learn more.

!!! info "情報"

docs/ja/docs/alternatives.md Outdated


		以前のPythonの同期型Webフレームワーク標準 (WSGI) をベースにしているため、Websocketなどは扱えませんが、それでも高性能です。

		!!! 情報

Copy link

Contributor

tokusumiSep 17, 2020

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others.Learn more.

!!! info "情報"

fix note and info.

e8869eb

fix indent and translation.

Copy link

ContributorAuthor

Attsun1031 commentedSep 18, 2020

@tokusumi Thanks for your careful review ! I fixed all (and some other points) , so please check once again.
e8869eb

Copy link

Contributor

github-actionsbot commentedSep 18, 2020

📝 Docs preview for commite8869eb at:https://5f64dcc1d80b640fc744c023--fastapi.netlify.app

tokusumi approved these changes

Sep 18, 2020

View reviewed changes

Copy link

Contributor

tokusumi left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others.Learn more.

thank you for improvements 👍

komtaki reviewed

Sep 25, 2020

View reviewed changes

Copy link

Contributor

komtaki left a comment•
edited
Loading

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others.Learn more.

Thank you for the tough work. 👍
I commented to make it easier to read as Japanese.

docs/ja/docs/alternatives.md OutdatedShow resolvedHide resolved

Apply suggestions from code review

3eb6171

Co-authored-by: Taki Komiyama <39375566+komtaki@users.noreply.github.com>

Copy link

ContributorAuthor

Attsun1031 commentedSep 26, 2020

@komtaki Thanks for your careful review and suggestions ! I applied all your suggestions.

Copy link

Contributor

github-actionsbot commentedSep 26, 2020

📝 Docs preview for commit3eb6171 at:https://5f6ee9f347cd08fa66921e28--fastapi.netlify.app

komtaki approved these changes

Sep 26, 2020

View reviewed changes

Copy link

Contributor

komtaki left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others.Learn more.

Thank you. 👍

LGTM 👌

Copy link

Contributor

tokusumi commentedSep 26, 2020

Hi,@tiangolo
This PR has been approved by two reviewers (github actions to label approved PR didn't work, though).
Would you like to require something more for this to be merged?