diff --git a/docs/zh-hant/docs/alternatives.md b/docs/zh-hant/docs/alternatives.md index f167c6304..5a3cd0709 100644 --- a/docs/zh-hant/docs/alternatives.md +++ b/docs/zh-hant/docs/alternatives.md @@ -20,19 +20,19 @@ Django 是最受歡迎的 Python 框架，並且廣受信任。它被用來構 它與關聯式資料庫（如 MySQL 或 PostgreSQL）的耦合度較高，因此將 NoSQL 資料庫（如 Couchbase、MongoDB、Cassandra 等）作為主要儲存引擎並不容易。 -Django 的設計初衷是為了在後端生成 HTML，而不是為了創建供現代前端（如 React、Vue.js 和 Angular）或其他系統 (類似 IoT devices）使用的 API。 +Django 的設計初衷是為了在後端生成 HTML，而不是為了建立供現代前端（如 React、Vue.js 和 Angular）或其他系統 (類似 IoT devices）使用的 API。 ### Django REST Framework -Django REST Framework 是為了在 Django 的基礎上建構 Web API 而創建的靈活工具包，旨在提升其 API 功能。 +Django REST Framework 是為了在 Django 的基礎上建構 Web API 而建立的靈活工具包，旨在提升其 API 功能。 它被許多公司使用，包括 Mozilla、Red Hat 和 Eventbrite。 -它是自動生成 API 文件的早期範例之一，而這正是啟發 「探索」FastAPI 的第一個想法之一。 +它是自動生成 API 文件的早期範例之一，而這正是啟發「探索」FastAPI 的第一個想法之一。 /// note | 筆記 -Django REST Framework 是 Tom Christie 所發明. 他同時研發了 Starlette 和 Uvicorn, 兩者皆是基於 **FastAPI**. +Django REST Framework 是 Tom Christie 所發明，他同時研發了 Starlette 和 Uvicorn，兩者皆是基於 **FastAPI**。 /// @@ -50,7 +50,7 @@ Flask 是一個「微框架」，它並未內建資料庫整合功能，也不 由於其設計極為簡潔，學習起來相對直觀，儘管其文件在某些部分仍需要點技術。 -它也常被用於其他不一定需要資料庫、用戶管理或 Django 中預建的眾多功能之應用程式。儘管這些功能中的許多可以透過插件來添加。 +它也常被用於其他不一定需要資料庫、用戶管理或 Django 中預建的眾多功能之應用程式。儘管這些功能中的許多可以透過擴充套件來添加。 這種模組化的設計，以及作為一個可擴展以滿足特定需求的「微框架」，正是我希望保留的關鍵特性。 @@ -110,7 +110,7 @@ def read_url(): 我從 Django REST Framework 中想要的主要功能是自動生成 API 文件。 -後來我發現有一種標準可以用來記錄 API，使用 JSON（或 YAML，JSON 的擴展）來描述，稱為 Swagger。 +後來我發現有一種標準可以用來記錄 API，使用 JSON（或 YAML，為 JSON 的擴展）來描述，稱為 Swagger。 而且已經有人為 Swagger API 創建了一個網頁用戶界面。因此，能夠為 API 生成 Swagger 文件，就能自動使用這個網頁用戶界面。 @@ -122,12 +122,12 @@ def read_url(): 採用並使用 API 規範的開放標準，而非自定義的架構。 -並整合基於標準的用戶界面工具： +並整合基於標準的用戶介面工具： * Swagger UI * ReDoc -這兩者之所以被選中，是因為它們相當流行且穩定，但若稍加搜尋，你會發現有數十種適用於 OpenAPI 的替代用戶界面（你也可以在 **FastAPI** 中使用這些工具）。 +這兩者之所以被選中，是因為它們相當流行且穩定，但若稍加搜尋，你會發現有數十種適用於 OpenAPI 的替代用戶介面（你也可以在 **FastAPI** 中使用這些工具）。 /// @@ -145,7 +145,7 @@ API 系統所需的主要功能之一是數據 "schema 你必須使用 Marshmallow 提供的特定工具和類別。 +但 Marshmallow 是在 Python 型別提示（type hints）出現之前建立的。因此，要定義每個 schema 你必須使用 Marshmallow 提供的特定工具和類別。 /// check | 啟發了 **FastAPI** @@ -205,7 +205,7 @@ APISpec 是 Marshmallow 相同的開發團隊所創建。 ### Flask-apispec -這是一個 Flask 的插件，將 Webargs、Marshmallow 和 APISpec 整合在一起。 +這是一個 Flask 的擴充套件，將 Webargs、Marshmallow 和 APISpec 整合在一起。 它利用 Webargs 和 Marshmallow 提供的數據驗證與解析功能，透過 APISpec 自動產生 OpenAPI 規範。 @@ -221,7 +221,7 @@ APISpec 是 Marshmallow 相同的開發團隊所創建。 * https://github.com/tiangolo/full-stack-flask-couchbase * https://github.com/tiangolo/full-stack-flask-couchdb -這些全端應用程式生成器也是 [**FastAPI** Project Generators](project-generation.md){.internal-link target=_blank}的基礎。 +這些全端應用程式生成器也是 [**FastAPI** Project Generators](project-generation.md){.internal-link target=_blank} 的基礎。 /// info | 資訊 @@ -243,9 +243,9 @@ Flask-apispec 由與 Marshmallow 相同的開發團隊所創建。 它內建一套依賴注入（Dependency Injection）系統，靈感來自 Angular 2。與其他依賴注入系統一樣，它需要事先註冊「可注入項目（injectables）」，這導致程式碼變得更冗長且重複。 -因為參數是用 TypeScript 類型（類似 Python 型別註記）來描述的，因此編輯器支援相當良好。 +因為參數是用 TypeScript 型別（類似 Python 型別提示）來描述的，因此編輯器支援相當良好。 -但由於 TypeScript 類型在編譯後不會保留於 JavaScript，因此無法同時用來定義驗證、序列化與文件化。 +但由於 TypeScript 型別在編譯後不會保留於 JavaScript，因此無法同時用來定義驗證、序列化與文件化。 由於這一點及其他設計考量，要實現驗證、序列化與自動模式生成，需要在許多地方添加裝飾器，這導致程式碼變得冗長。 @@ -253,7 +253,7 @@ Flask-apispec 由與 Marshmallow 相同的開發團隊所創建。 /// check | 啟發了 **FastAPI** -使用 Python 類型來獲得更強大的編輯器支援。 +使用 Python 型別來獲得更強大的編輯器支援。 設計一個強大的依賴注入系統，並設法減少程式碼重複。 @@ -261,13 +261,13 @@ Flask-apispec 由與 Marshmallow 相同的開發團隊所創建。 ### Sanic -這是一個基於 `asyncio` 極快的python框架，與Flask非常相似。 +這是一個基於 `asyncio` 極快的 Python 框架，與 Flask 非常相似。 /// note | 技術層面細節 -它使用了 `uvloop` 而非python預設的`asyncio` loop。這也是讓它速度之快的原因。 +它使用了 `uvloop` 而非 Python 預設的 `asyncio` loop。這也是讓它速度之快的原因。 -它很明顯的啟發了 Uvicorn 和 Starlette，兩者在效能測試速度皆優於Sanic。 +它很明顯的啟發了 Uvicorn 和 Starlette，兩者在效能測試速度皆優於 Sanic。 /// @@ -291,7 +291,7 @@ Falcon 是另一個高效能的 Python 框架，設計簡潔，並作為 Hug 等 尋找方法以獲得優秀的效能。 -與 Hug 一樣（因為 Hug 是基於 Falcon 的），啟發 FastAPI 讓函式可選擇性地使用 response 參數來設置標頭、cookie 和狀態代碼。 +與 Hug 一樣（因為 Hug 是基於 Falcon 的），啟發 FastAPI 讓函式可選擇性地使用 response 參數來設置標頭、cookie 和狀態碼。 /// @@ -301,7 +301,7 @@ Falcon 是另一個高效能的 Python 框架，設計簡潔，並作為 Hug 等 * 基於 Python 型別註解（type hints）。 * 透過型別自動執行驗證與文件生成。 -* 內建相依性注入（Dependency Injection）系統。 +* 內建依賴注入系統。 然而，Molten 並未採用像 Pydantic 這樣的第三方資料驗證、序列化與文件生成工具，而是內建了一套自己的解決方案。因此，定義的資料型別無法像 Pydantic 那樣輕鬆地被重複使用。 @@ -360,7 +360,7 @@ Hug 的創新理念對 FastAPI 產生了直接影響，特別是使用 Python 不過，APIStar 的請求體（Body）架構定義並不像 Pydantic 那樣直接使用 Python 型別提示，而是更接近 Marshmallow。因此，編輯器的支援性相對較差，但即便如此，當時 APIStar 仍是最好的選擇。 -當時，它的效能測試（Benchmark）表現最佳，只有 Starlette 能超越它。 +當時，它的基準測試（Benchmark）表現最佳，只有 Starlette 能超越它。 最初，它沒有自動生成 API 文件的 Web UI，但我知道可以手動加入 Swagger UI 來補足這項功能。 @@ -378,7 +378,7 @@ APIStar 是由 Tom Christie 創建的。他同時也是以下專案的作者： * Django REST Framework * Starlette (**FastAPI** 的基礎) -* Uvicorn (被Starlette 和 **FastAPI** 使用) +* Uvicorn (被 Starlette 和 **FastAPI** 使用) /// @@ -454,7 +454,7 @@ FastAPI 使用 ASGI 來處理所有核心的 Web 功能，並在其基礎上增 其 `FastAPI` 類別直接繼承自 `Starlette`類別。 -因此，任何可以在 Starlette 上做的事情，都可以直接在 **FastAPI** 上做，因為 FastAPI 本質上就是 增強版的 Starlette。 +因此，任何可以在 Starlette 上做的事情，都可以直接在 **FastAPI** 上做，因為 FastAPI 本質上就是增強版的 Starlette。 /// @@ -462,7 +462,7 @@ FastAPI 使用 ASGI 來處理所有核心的 Web 功能，並在其基礎上增 Uvicorn 是一款極速的 ASGI 伺服器，基於 uvloop 和 httptools 架構而成。 -它並不是一個網頁框架，而是一個伺服器。例如，它不提供路徑導向的路由功能，這部分需要像Starlette 或 **FastAPI** 這類框架來實現。 +它並不是一個網頁框架，而是一個伺服器。例如，它不提供路徑導向的路由功能，這部分需要像 Starlette 或 **FastAPI** 這類框架來實現。 Uvicorn 是 Starlette 和 **FastAPI** 官方推薦的伺服器。 @@ -471,12 +471,12 @@ Uvicorn 是 Starlette 和 **FastAPI** 官方推薦的伺服器。 運行 **FastAPI** 應用程式的主要網頁伺服器。 -此外，你還可以使用 `--workers` 指令選項，啟動非同步的多進程伺服器，以提升效能。 +此外，你還可以使用 `--workers` 指令選項，啟動非同步的多行程伺服器，以提升效能。 -更多詳細資訊請參考 [Deployment](deployment/index.md){.internal-link target=_blank} 章節. +更多詳細資訊請參考[部署](deployment/index.md){.internal-link target=_blank}章節。 /// ## 效能測試與速度 -如需瞭解、比較並觀察 Uvicorn, Starlette 和 FastAPI，請前往 [Benchmarks](benchmarks.md){.internal-link target=_blank}. +如需瞭解、比較並觀察 Uvicorn, Starlette 和 FastAPI，請前往[基準測試](benchmarks.md){.internal-link target=_blank}.