Translate eloquent-resources.md (v5.5) #384

Nationalcat · 2017-11-15T06:30:43Z

Translate `eloquent-resources.md` (v5.5)

大部分的 resources 都沒翻，但有點想翻
關於 meta- 的翻譯則是參照 google 找到的用法，像是 meta data，會是資料的資料。
原文有很多句子都捨不得用標點符號分開，然後各種連接詞和介系詞，所以容易翻錯....

neighborhood999 · 2017-12-11T01:29:07Z

eloquent-resources.md

-    - [Conditional Relationships](#conditional-relationships)
-    - [Adding Meta Data](#adding-meta-data)
- [Resource Responses](#resource-responses)
+# Eloquent: API 資源


Eloquent：API 資源

neighborhood999 · 2017-12-11T01:29:18Z

eloquent-resources.md

+# Eloquent: API 資源
+
+- [介紹](#introduction)
+- [產生 Resouce](#generating-resources)


產生資源

neighborhood999 · 2017-12-11T01:29:33Z

eloquent-resources.md

+    - [有條件的屬性](#conditional-attributes)
+    - [有條件的關聯](#conditional-relationships)
+    - [新增資料的資料](#adding-meta-data)
+- [Resouce 回應](#resource-responses)


資源回應

neighborhood999 · 2017-12-11T01:33:57Z

eloquent-resources.md


-When building an API, you may need a transformation layer that sits between your Eloquent models and the JSON responses that are actually returned to your application's users. Laravel's resource classes allow you to expressively and easily transform your models and model collections into JSON.
+當你在建構 API 時，可能會需要一個位於 Eloquent 模型和實際回傳給使用者的 JSON 回應之間的轉換層。Laravel 的 Resouce 類別可以讓你更直觀且容易的將你的模型和模型集合轉換成 JSON。


當你在建立一個 API 時，可能會需要一個位於 Eloquent 模型和實際回傳給使用者的 JSON 回應之間的轉換層。Laravel 的資源類別可以讓你更直觀且容易的將你的模型和模型集合轉換成 JSON。

neighborhood999 · 2017-12-11T01:40:46Z

eloquent-resources.md


-To generate a resource class, you may use the `make:resource` Artisan command. By default, resources will be placed in the `app/Http/Resources` directory of your application. Resources extend the `Illuminate\Http\Resources\Json\Resource` class:
+你可以使用 Artisan 的 `make:resource` 指令來產生一個 Resouce 類別。預設的 Resouce 會放置於 `app/Http/Resources` 你的應用程式目錄中。Resources 會繼承 `Illuminate\Http\Resources\Json\Resource` 類別：


「Resource」都翻譯成「資源」

預設的 Resouce 會放置於你的 app/Http/Resources 應用程式目錄中。

neighborhood999 · 2017-12-11T09:49:11Z

eloquent-resources.md

@@ -569,19 +569,19 @@ Sometimes you may wish to only include certain meta data with a resource respons
        }
    }

-#### Adding Meta Data When Constructing Resources
+#### 在建構資源時新增資料的資料


在建構資源時新增 Meta Data 的資料

neighborhood999 · 2017-12-11T09:49:43Z

eloquent-resources.md


-You may also add top-level data when constructing resource instances in your route or controller. The `additional` method, which is available on all resources, accepts an array of data that should be added to the resource response:
+在你的路由或控制器建構 Resource 實例時，你也可以新增最上層的資料。`additional` 方法在所有的 Resource 都可以用，並接受應該被新增到 Resource 回應的資料陣列：


「Resource」都翻譯成「資源」

neighborhood999 · 2017-12-11T09:50:02Z

eloquent-resources.md


-As you have already read, resources may be returned directly from routes and controllers:
+正如你已讀過的，Resource 可以從路由或控制器中回傳：


「Resource」都翻譯成「資源」

neighborhood999 · 2017-12-11T09:50:18Z

eloquent-resources.md

@@ -601,7 +601,7 @@ However, sometimes you may need to customize the outgoing HTTP response before i
                    ->header('X-Value', 'True');
    });

-Alternatively, you may define a `withResponse` method within the resource itself. This method will be called when the resource is returned as the outer-most resource in a response:
+或者是你可以在 Resource 中定義 `withResponse` 方法。這個方法會在 Resource 作為回應中的最外層時被呼叫：


「Resource」都翻譯成「資源」

neighborhood999 · 2017-12-11T09:50:57Z

eloquent-resources.md

+    - [分頁](#pagination)
+    - [有條件的屬性](#conditional-attributes)
+    - [有條件的關聯](#conditional-relationships)
+    - [新增資料的資料](#adding-meta-data)


新增 Meta Data

Nationalcat mentioned this pull request Nov 15, 2017

Laravel 5.5 文件翻譯 #340

Open

73 tasks

Nationalcat force-pushed the 5.5-eloquent-resources branch from b05da71 to abba173 Compare November 15, 2017 10:36

Translate eloquent-resources (v5.5)

25d5706

Nationalcat force-pushed the 5.5-eloquent-resources branch from abba173 to 25d5706 Compare November 15, 2017 12:07

neighborhood999 reviewed Dec 11, 2017

View reviewed changes

12/12 修正部分翻譯問題

bae0b8c

neighborhood999 merged commit 428219a into laravel-taiwan:5.5 Dec 13, 2017

Provide feedback

Saved searches

Use saved searches to filter your results more quickly

Translate eloquent-resources.md (v5.5) #384

Translate eloquent-resources.md (v5.5) #384

Nationalcat commented Nov 15, 2017

neighborhood999 Dec 11, 2017

neighborhood999 Dec 11, 2017

neighborhood999 Dec 11, 2017

neighborhood999 Dec 11, 2017

neighborhood999 Dec 11, 2017

neighborhood999 Dec 11, 2017

neighborhood999 Dec 11, 2017

neighborhood999 Dec 11, 2017

neighborhood999 Dec 11, 2017

neighborhood999 Dec 11, 2017


		When building an API, you may need a transformation layer that sits between your Eloquent models and the JSON responses that are actually returned to your application's users. Laravel's resource classes allow you to expressively and easily transform your models and model collections into JSON.
		當你在建構 API 時，可能會需要一個位於 Eloquent 模型和實際回傳給使用者的 JSON 回應之間的轉換層。Laravel 的 Resouce 類別可以讓你更直觀且容易的將你的模型和模型集合轉換成 JSON。


		To generate a resource class, you may use the `make:resource` Artisan command. By default, resources will be placed in the `app/Http/Resources` directory of your application. Resources extend the `Illuminate\Http\Resources\Json\Resource` class:
		你可以使用 Artisan 的 `make:resource` 指令來產生一個 Resouce 類別。預設的 Resouce 會放置於 `app/Http/Resources` 你的應用程式目錄中。Resources 會繼承 `Illuminate\Http\Resources\Json\Resource` 類別：


		You may also add top-level data when constructing resource instances in your route or controller. The `additional` method, which is available on all resources, accepts an array of data that should be added to the resource response:
		在你的路由或控制器建構 Resource 實例時，你也可以新增最上層的資料。`additional` 方法在所有的 Resource 都可以用，並接受應該被新增到 Resource 回應的資料陣列：


		As you have already read, resources may be returned directly from routes and controllers:
		正如你已讀過的，Resource 可以從路由或控制器中回傳：

Translate eloquent-resources.md (v5.5) #384

Translate eloquent-resources.md (v5.5) #384

Conversation

Nationalcat commented Nov 15, 2017

Translate eloquent-resources.md (v5.5)

Choose a reason for hiding this comment

Choose a reason for hiding this comment

Choose a reason for hiding this comment

Choose a reason for hiding this comment

Choose a reason for hiding this comment

Choose a reason for hiding this comment

Choose a reason for hiding this comment

Choose a reason for hiding this comment

Choose a reason for hiding this comment

Choose a reason for hiding this comment

Translate `eloquent-resources.md` (v5.5)