Tutorial-PassingArguments.md #51

Joursion · 2017-07-29T09:40:00Z

完成翻译，求校对
close #29

ydfzgyj · 2017-08-02T07:24:31Z

site/graphql-js/Tutorial-PassingArguments.md

 var schema = buildSchema(`
  type Query {
    rollDice(numDice: Int!, numSides: Int): [Int]
  }
 `);

-// The root provides a resolver function for each API endpoint
+// root 为每个 端点入口 API 提供一个解析器


中间多了一个空格

ydfzgyj · 2017-08-02T07:26:18Z

site/graphql-js/Tutorial-PassingArguments.md


 ```javascript
 type Query {
  rollThreeDice: [Int]
 }
 ```

-Instead of hardcoding “three”, we might want a more general function that rolls `numDice` dice, each of which have `numSides` sides. We can add arguments to the GraphQL schema language like this:
+我们可能想要一个更通用的函数来实现投掷点数 `numDice` ，而不是硬性地设为 "3"，并且有一个参数 `numSide` 来表示骰子的面数，我们可以这样在 GraphQL schema language 实现：


这里的 numDice 应该不是投掷点数，而是投掷的骰子个数

ydfzgyj · 2017-08-02T07:27:20Z

site/graphql-js/Tutorial-PassingArguments.md

@@ -89,19 +89,19 @@ app.listen(4000);
 console.log('Running a GraphQL API server at localhost:4000/graphql');
 ```

-When you call this API, you have to pass each argument by name. So for the server above, you could issue this GraphQL query to roll three six-sided dice:
+当你调用这个 API 时，你需要按名称传入每个参数，对于上面的服务器代码，你可以通过发起这样的 GraphQL 查询，来投掷一个 6 面的，点数为 3 的骰子。


同上，这里应该是投掷 3 个六面的骰子

ydfzgyj · 2017-08-02T07:31:18Z

site/graphql-js/Tutorial-PassingArguments.md


 ```javascript
 {
  rollDice(numDice: 3, numSides: 6)
 }
 ```

-If you run this code with `node server.js` and browse to http://localhost:4000/graphql you can try out this API.
+如果你使用 `node server.js` 运行这段代码，你可以浏览  http://localhost:4000/graphql 来尝试这个 API。


链接前边多了一个空格

ydfzgyj · 2017-08-02T07:34:06Z

site/graphql-js/Tutorial-PassingArguments.md

@@ -123,6 +123,6 @@ xhr.send(JSON.stringify({
 }));
 ```

-Using `$dice` and `$sides` as variables in GraphQL means we don't have to worry about escaping on the client side.
+使用 `$dice` 和 `$sides` 作为 GraphQL 中的变量，我们可以不用担心在客户端转义。


后半句表意不太清楚，可以改成“我们无需在客户端对它们进行转义”

ydfzgyj · 2017-08-02T07:34:29Z

site/graphql-js/Tutorial-PassingArguments.md


-With basic types and argument passing, you can implement anything you can implement in a REST API. But GraphQL supports even more powerful queries. You can replace multiple API calls with a single API call if you learn how to [define your own object types](/graphql-js/object-types/).
+通过基础类型和参数传递，你可以定义任意你在 REST API 中定义的内容。但 GraphQL 支持更强大的查询。如果你学习了 [定义你自己的对象类型](/graphql-js/object-types/)，你可以用单个 API 调用来代替多个 API 调用。


你可以定义任意你“能够”在 REST API 中定义的内容

jonirrings · 2017-08-04T03:39:36Z

site/graphql-js/Tutorial-PassingArguments.md

@@ -6,25 +6,25 @@ permalink: /graphql-js/passing-arguments/
 next: /graphql-js/object-types/
 ---

-Just like a REST API, it's common to pass arguments to an endpoint in a GraphQL API. By defining the arguments in the schema language, typechecking happens automatically. Each argument must be named and have a type. For example, in the [Basic Types documentation](/graphql-js/basic-types/) we had an endpoint called `rollThreeDice`:
+就像 REST API 一样，在 GraphQL API 中，通常向入口端点传入参数，在 schema language 中定义参数，并自动进行类型检查。每一个参数必须有名字和数据类型。举个例子，在 [基础类型文档](/graphql-js/basic-types/) 中，我们定义了一个名为 `rollThreeDice` 的入口端点：


title，sidebarTitle和category也麻烦翻一下:+1:

jonirrings · 2017-08-06T15:00:48Z

暂时没问题了，我先merge了

ydfzgyj

还有一个小问题麻烦再修改一下

ydfzgyj · 2017-08-07T13:19:43Z

site/graphql-js/Tutorial-PassingArguments.md


-With basic types and argument passing, you can implement anything you can implement in a REST API. But GraphQL supports even more powerful queries. You can replace multiple API calls with a single API call if you learn how to [define your own object types](/graphql-js/object-types/).
+通过基础类型和参数传递，你可以定义任意你"能够"在 REST API 中定义的内容。但 GraphQL 支持更强大的查询。如果你学习了 [定义你自己的对象类型](/graphql-js/object-types/)，你可以用单个 API 调用来代替多个 API 调用。


“能够”两边的引号不需要的……我加引号的目的是表示这两个字漏了需要补上……我下次换成用加粗好了……虽然已经合并了，麻烦再修改一下

😂有劳修改了，再PR一下

我是要重新提交一个PR 吗？

嗯，直接新发pr吧，revert会导致一堆PR失效，比较麻烦。或者@sqrthree 看看怎么弄

直接提交新 PR 即可。

This reverts commit 868de27.

完成翻译 Tutorial-PassingArguments

a6ae29d

linhe0x0 added the 校对认领 label Jul 31, 2017

linhe0x0 mentioned this pull request Jul 31, 2017

Tutorial-PassingArguments.md #29

Closed

ydfzgyj requested changes Aug 2, 2017

View reviewed changes

jonirrings added the 正在校对 label Aug 3, 2017

jonirrings reviewed Aug 4, 2017

View reviewed changes

jonirrings changed the title ~~完成翻译 Tutorial-PassingArguments~~ Tutorial-PassingArguments.md Aug 4, 2017

修正校对

d991a6a

jonirrings approved these changes Aug 6, 2017

View reviewed changes

jonirrings merged commit 868de27 into xitu:zh-Hans Aug 6, 2017

linhe0x0 removed 校对认领正在校对 labels Aug 6, 2017

ydfzgyj reviewed Aug 7, 2017

View reviewed changes

jonirrings added a commit that referenced this pull request Aug 8, 2017

Revert "Tutorial-PassingArguments.md (#51)"

94085ff

This reverts commit 868de27.

Provide feedback

Saved searches

Use saved searches to filter your results more quickly

Tutorial-PassingArguments.md #51

Tutorial-PassingArguments.md #51

Joursion commented Jul 29, 2017 •

edited

Loading

ydfzgyj Aug 2, 2017

ydfzgyj Aug 2, 2017

ydfzgyj Aug 2, 2017

ydfzgyj Aug 2, 2017

ydfzgyj Aug 2, 2017

ydfzgyj Aug 2, 2017

jonirrings Aug 4, 2017 •

edited

Loading

jonirrings commented Aug 6, 2017

ydfzgyj left a comment

ydfzgyj Aug 7, 2017

jonirrings Aug 7, 2017

Joursion Aug 8, 2017

jonirrings Aug 8, 2017

linhe0x0 Aug 8, 2017


		With basic types and argument passing, you can implement anything you can implement in a REST API. But GraphQL supports even more powerful queries. You can replace multiple API calls with a single API call if you learn how to [define your own object types](/graphql-js/object-types/).
		通过基础类型和参数传递，你可以定义任意你在 REST API 中定义的内容。但 GraphQL 支持更强大的查询。如果你学习了 [定义你自己的对象类型](/graphql-js/object-types/)，你可以用单个 API 调用来代替多个 API 调用。


		With basic types and argument passing, you can implement anything you can implement in a REST API. But GraphQL supports even more powerful queries. You can replace multiple API calls with a single API call if you learn how to [define your own object types](/graphql-js/object-types/).
		通过基础类型和参数传递，你可以定义任意你"能够"在 REST API 中定义的内容。但 GraphQL 支持更强大的查询。如果你学习了 [定义你自己的对象类型](/graphql-js/object-types/)，你可以用单个 API 调用来代替多个 API 调用。

Tutorial-PassingArguments.md #51

Tutorial-PassingArguments.md #51

Conversation

Joursion commented Jul 29, 2017 • edited Loading

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

jonirrings Aug 4, 2017 • edited Loading

Choose a reason for hiding this comment

jonirrings commented Aug 6, 2017

ydfzgyj left a 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

Joursion commented Jul 29, 2017 •

edited

Loading

jonirrings Aug 4, 2017 •

edited

Loading