APIReference-Utilities.md #70

jonirrings · 2017-08-07T15:48:43Z

resolve #19 有劳审校

Signed-off-by: Jonir Rings <peterpuyi@live.cn>

ydfzgyj · 2017-08-09T10:31:20Z

site/graphql-js/APIReference-Utilities.md

@@ -40,37 +39,37 @@ var { introspectionQuery } = require('graphql'); // CommonJS
  <li>
    <a href="#buildschema">
      <pre>function buildSchema</pre>
-      Builds a Schema object from GraphQL schema language.
+      基于 GraphQL schema languag 构建一个 Schema 对象。


language 少了一个 e

ydfzgyj · 2017-08-09T10:33:10Z

site/graphql-js/APIReference-Utilities.md

@@ -81,7 +80,7 @@ var { introspectionQuery } = require('graphql'); // CommonJS
  <li>
    <a href="#typeinfo">
      <pre>class TypeInfo</pre>
-      Tracks type and field definitions during a visitor AST traversal..
+      在 visitor 遍历 AST 时追踪类型和字段定义。


visitor 可以翻译的吧？

我翻成了 访问方法，可以讨论统一一下

……这个不译比较好，是一个ast遍历用的类的实例。更多像是访问器吧？其实更像是个遍历用的游标？

ydfzgyj · 2017-08-09T10:34:18Z

site/graphql-js/APIReference-Utilities.md

@@ -92,13 +91,13 @@ var { introspectionQuery } = require('graphql'); // CommonJS
  <li>
    <a href="#isvalidjsvalue">
      <pre>function isValidJSValue</pre>
-      Determins if a JavaScript value is valid for a GraphQL type.
+      判断一个 JavaScript 值是否是有效的 GraphQL 类型。


“值是有效的类型”有歧义，最后改成“……类型的值”如何

ydfzgyj · 2017-08-09T10:36:20Z

site/graphql-js/APIReference-Utilities.md

    </a>
  </li>
  <li>
    <a href="#isvalidliteralvalue">
      <pre>function isValidLiteralValue</pre>
-      Determins if a literal value from an AST is valid for a GraphQL type.
+      判断一个 AST 中的字面量值是否是有效的 GraphQL 类型。


ydfzgyj · 2017-08-09T10:37:32Z

site/graphql-js/APIReference-Utilities.md


 *Introspection*

 <ul class="apiIndex">
  <li>
    <a href="#introspectionquery">
      <pre>var introspectionQuery</pre>
-      A GraphQL introspection query containing enough information to reproduce a type system.
+      GraphQL 内省查询，包含足够的信息以重建类型系统。


“reproduce”翻译成“重现”比较好

ydfzgyj · 2017-08-09T10:43:49Z

site/graphql-js/APIReference-Utilities.md

-tools, but cannot be used to execute a query, as introspection does not
-represent the "resolver", "parse" or "serialize" functions or any other
-server-internal mechanisms.
+假设客户端有运行内省查询的结果，创建并返回了一个 GraphQLSchema 实例，这个实例可以用于所有的 GraphQL.js工具，但不能用于执行查询，因为内省并不代表有“解析器”、“分析”或者“序列化”函数，或者其他服务器内部机制。

 ## Schema Representation


ydfzgyj · 2017-08-09T10:44:30Z

site/graphql-js/APIReference-Utilities.md

@@ -138,23 +132,23 @@ server-internal mechanisms.
 function buildSchema(source: string | Source): GraphQLSchema {
 ```

-Creates a GraphQLSchema object from GraphQL schema language. The schema will use default resolvers. For more detail on the GraphQL schema language, see the [schema language docs](/learn/schema/) or this [schema language cheat sheet](https://wehavefaces.net/graphql-shorthand-notation-cheatsheet-17cd715861b6#.9oztv0a7n).
+基于 GraphQL schema language 创建一个 GraphQLSchema 对象。schema 将会使用默认解析器。关于 GraphQL schema language 的更多细节，请查看 [schema language 文档](/learn/schema/) 或者  [schema language 速查表](https://wehavefaces.net/graphql-shorthand-notation-cheatsheet-17cd715861b6#.9oztv0a7n)。


或者后边多了一个空格

ydfzgyj · 2017-08-09T10:47:41Z

site/graphql-js/APIReference-Utilities.md

-TypeInfo is a utility class which, given a GraphQL schema, can keep track
-of the current field and type definitions at any point in a GraphQL document
-AST during a recursive descent by calling `enter(node)` and `leave(node)`.
+TypeInfo 是一个工具类，在 GraphQL 文档 AST 的递归分析中的任何位置上，调用 `enter(node)` 和 `leave(node)` 的时候，可以追踪当前字段和类型定义。


given a GraphQL schema 漏了

ydfzgyj · 2017-08-09T10:52:40Z

site/graphql-js/APIReference-Utilities.md

-Given a JavaScript value and a GraphQL type, determine if the value will be
-accepted for that type. This is primarily useful for validating the
-runtime values of query variables.
+给定一个 JavaScript 值和 GraphQL 类型，判断这个值是否能被这个类型接受。这个功能在验证运行时查询参数的时候特别有用。


runtime values 的 values 漏了

ydfzgyj · 2017-08-09T10:53:54Z

site/graphql-js/APIReference-Utilities.md


-Note that this only validates literal values, variables are assumed to
-provide values of the correct type.
+注意，这个功能只验证字面量值，并假设变量值的是正确的类型。


“值的是”=>“指的是”？

“的”多余

Signed-off-by: Jonir Rings <peterpuyi@live.cn>

linhe0x0 · 2017-08-10T05:21:03Z

site/graphql-js/APIReference-Utilities.md

 permalink: /graphql-js/utilities/
 sublinks: astFromValue,buildASTSchema,buildClientSchema,buildSchema,introspectionQuery,isValidJSValue,isValidLiteralValue,printIntrospectionSchema,printSchema,typeFromAST,TypeInfo
 next: /graphql-js/validation/
 ---

-The `graphql/utilities` module contains common useful computations to use with
-the GraphQL language and type objects. You can import either from the `graphql/utilities` module, or from the root `graphql` module. For example:
+`graphql/utilities` 模块包含用于 GraphQL 语言和类型对象的常用计算。你可以从 `graphql/utilities` 模块或是根 `graphql` 模块引入。如下：


『根 graphql 模块』这里翻译成『根模块 graphql』或者『graphql 根模块』是不是更通顺一点捏

后者吧~~

Signed-off-by: Jonir Rings <peterpuyi@live.cn>

linhe0x0 · 2017-08-10T06:31:47Z

@ydfzgyj 如果没什么疑问的话来 approve 一下吧。

ydfzgyj

Visitor 的问题，请 @jonirrings @llp0574 你们两位用到这个词的商议一下怎么统一吧

jonirrings · 2017-08-10T07:11:02Z

@ydfzgyj
@llp0574 我觉得这是PL实现相关的术语，最好不要译，你怎么看？

0x0042 · 2017-08-10T08:04:36Z

@jonirrings 那就统一为不译吧
@sqrthree 我去修改一下重新提个pr

jonirrings · 2017-08-10T08:09:30Z

嗯嗯。@llp0574 。有劳修改

APIReference-Utilities translation done

4179b09

Signed-off-by: Jonir Rings <peterpuyi@live.cn>

jonirrings added the 校对认领 label Aug 7, 2017

ydfzgyj requested changes Aug 9, 2017

View reviewed changes

linhe0x0 added the 正在校对 label Aug 10, 2017

linhe0x0 mentioned this pull request Aug 10, 2017

APIReference-Utilities.md #19

Closed

修正用词，添加几个标题的翻译

b595bc8

Signed-off-by: Jonir Rings <peterpuyi@live.cn>

jonirrings force-pushed the APIReference-Utilities branch from 9003a3a to b595bc8 Compare August 10, 2017 03:32

linhe0x0 reviewed Aug 10, 2017

View reviewed changes

linhe0x0 removed the 校对认领 label Aug 10, 2017

统一“根模块”这个用词

9d038ca

Signed-off-by: Jonir Rings <peterpuyi@live.cn>

linhe0x0 approved these changes Aug 10, 2017

View reviewed changes

ydfzgyj approved these changes Aug 10, 2017

View reviewed changes

jonirrings merged commit e559e6a into xitu:zh-Hans Aug 10, 2017

linhe0x0 removed the 正在校对 label Aug 10, 2017

jonirrings deleted the APIReference-Utilities branch May 23, 2021 11:54

Provide feedback

Saved searches

Use saved searches to filter your results more quickly

APIReference-Utilities.md #70

APIReference-Utilities.md #70

jonirrings commented Aug 7, 2017 •

edited by linhe0x0

ydfzgyj Aug 9, 2017

ydfzgyj Aug 9, 2017

0x0042 Aug 10, 2017

jonirrings Aug 10, 2017 •

edited

ydfzgyj Aug 9, 2017

ydfzgyj Aug 9, 2017

ydfzgyj Aug 9, 2017

jonirrings Aug 10, 2017

ydfzgyj Aug 9, 2017

ydfzgyj Aug 9, 2017

ydfzgyj Aug 9, 2017

ydfzgyj Aug 9, 2017

ydfzgyj Aug 9, 2017

jonirrings Aug 10, 2017

linhe0x0 Aug 10, 2017

jonirrings Aug 10, 2017

linhe0x0 commented Aug 10, 2017

ydfzgyj left a comment

jonirrings commented Aug 10, 2017

0x0042 commented Aug 10, 2017

jonirrings commented Aug 10, 2017

APIReference-Utilities.md #70

APIReference-Utilities.md #70

Conversation

jonirrings commented Aug 7, 2017 • edited by linhe0x0

Choose a reason for hiding this comment

Choose a reason for hiding this comment

Choose a reason for hiding this comment

jonirrings Aug 10, 2017 • edited

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

Choose a reason for hiding this comment

Choose a reason for hiding this comment

Choose a reason for hiding this comment

linhe0x0 commented Aug 10, 2017

ydfzgyj left a comment

Choose a reason for hiding this comment

jonirrings commented Aug 10, 2017

0x0042 commented Aug 10, 2017

jonirrings commented Aug 10, 2017

jonirrings commented Aug 7, 2017 •

edited by linhe0x0

jonirrings Aug 10, 2017 •

edited