Permalink
Browse files

translate v6.0 documents into Chinese

translate v6.0 documents into Chinese. Includeing User Document and README.md  of project.

translate method ref: http://www.sphinx-doc.org/en/stable/intl.html
  • Loading branch information...
labilezhu authored and bbakerman committed Nov 14, 2017
1 parent 31b16d4 commit 381c4cdba1287cc0436612d6f2db569bee2c2fab
Showing with 4,128 additions and 2 deletions.
  1. +40 −0 README.zh_cn.md
  2. +3 −2 docs/conf.py
  3. BIN docs/locale/es/LC_MESSAGES/batching.mo
  4. +160 −0 docs/locale/es/LC_MESSAGES/batching.po
  5. BIN docs/locale/es/LC_MESSAGES/concerns.mo
  6. +111 −0 docs/locale/es/LC_MESSAGES/concerns.po
  7. BIN docs/locale/es/LC_MESSAGES/contributions.mo
  8. +92 −0 docs/locale/es/LC_MESSAGES/contributions.po
  9. BIN docs/locale/es/LC_MESSAGES/exceptions.mo
  10. +125 −0 docs/locale/es/LC_MESSAGES/exceptions.po
  11. BIN docs/locale/es/LC_MESSAGES/execution.mo
  12. +549 −0 docs/locale/es/LC_MESSAGES/execution.po
  13. BIN docs/locale/es/LC_MESSAGES/getting_started.mo
  14. +83 −0 docs/locale/es/LC_MESSAGES/getting_started.po
  15. BIN docs/locale/es/LC_MESSAGES/index.mo
  16. +91 −0 docs/locale/es/LC_MESSAGES/index.po
  17. BIN docs/locale/es/LC_MESSAGES/instrumentation.mo
  18. +131 −0 docs/locale/es/LC_MESSAGES/instrumentation.po
  19. BIN docs/locale/es/LC_MESSAGES/logging.mo
  20. +31 −0 docs/locale/es/LC_MESSAGES/logging.po
  21. BIN docs/locale/es/LC_MESSAGES/relay.mo
  22. +66 −0 docs/locale/es/LC_MESSAGES/relay.po
  23. BIN docs/locale/es/LC_MESSAGES/schema.mo
  24. +477 −0 docs/locale/es/LC_MESSAGES/schema.po
  25. BIN docs/locale/es/LC_MESSAGES/subscriptions.mo
  26. +134 −0 docs/locale/es/LC_MESSAGES/subscriptions.po
  27. BIN docs/locale/zh_CN/LC_MESSAGES/batching.mo
  28. +158 −0 docs/locale/zh_CN/LC_MESSAGES/batching.po
  29. BIN docs/locale/zh_CN/LC_MESSAGES/concerns.mo
  30. +109 −0 docs/locale/zh_CN/LC_MESSAGES/concerns.po
  31. BIN docs/locale/zh_CN/LC_MESSAGES/contributions.mo
  32. +90 −0 docs/locale/zh_CN/LC_MESSAGES/contributions.po
  33. BIN docs/locale/zh_CN/LC_MESSAGES/exceptions.mo
  34. +123 −0 docs/locale/zh_CN/LC_MESSAGES/exceptions.po
  35. BIN docs/locale/zh_CN/LC_MESSAGES/execution.mo
  36. +547 −0 docs/locale/zh_CN/LC_MESSAGES/execution.po
  37. BIN docs/locale/zh_CN/LC_MESSAGES/getting_started.mo
  38. +81 −0 docs/locale/zh_CN/LC_MESSAGES/getting_started.po
  39. BIN docs/locale/zh_CN/LC_MESSAGES/index.mo
  40. +89 −0 docs/locale/zh_CN/LC_MESSAGES/index.po
  41. BIN docs/locale/zh_CN/LC_MESSAGES/instrumentation.mo
  42. +129 −0 docs/locale/zh_CN/LC_MESSAGES/instrumentation.po
  43. BIN docs/locale/zh_CN/LC_MESSAGES/logging.mo
  44. +29 −0 docs/locale/zh_CN/LC_MESSAGES/logging.po
  45. BIN docs/locale/zh_CN/LC_MESSAGES/relay.mo
  46. +64 −0 docs/locale/zh_CN/LC_MESSAGES/relay.po
  47. BIN docs/locale/zh_CN/LC_MESSAGES/schema.mo
  48. +475 −0 docs/locale/zh_CN/LC_MESSAGES/schema.po
  49. BIN docs/locale/zh_CN/LC_MESSAGES/subscriptions.mo
  50. +132 −0 docs/locale/zh_CN/LC_MESSAGES/subscriptions.po
  51. +9 −0 docs/readme.md
@@ -0,0 +1,40 @@
# graphql-java
[![Join the chat at https://gitter.im/graphql-java/graphql-java](https://badges.gitter.im/graphql-java/graphql-java.svg)](https://gitter.im/graphql-java/graphql-java?utm_source=badge&utm_medium=badge&utm_campaign=pr-badge&utm_content=badge)
![logo](https://avatars1.githubusercontent.com/u/14289921?s=200&v=4)
This is a [GraphQL](https://github.com/facebook/graphql) Java implementation.
[![Build Status](https://travis-ci.org/graphql-java/graphql-java.svg?branch=master)](https://travis-ci.org/graphql-java/graphql-java)
[![Latest Release](https://maven-badges.herokuapp.com/maven-central/com.graphql-java/graphql-java/badge.svg)](https://maven-badges.herokuapp.com/maven-central/com.graphql-java/graphql-java/)
[![Latest Dev Build](https://api.bintray.com/packages/andimarek/graphql-java/graphql-java/images/download.svg)](https://bintray.com/andimarek/graphql-java/graphql-java/_latestVersion)
## 文档
关于 `graphql-java` 的详细使用说明,请阅读: http://graphql-java.readthedocs.io/
这也是个很好的教程 : https://www.howtographql.com/graphql-java/0-introduction/
在 [发行版本列表](https://github.com/graphql-java/graphql-java/releases) 中,你可以看到最新版本和变更日志.
### 编码行为约定
请注意,本项目基于 [Contributor Code of Conduct](CODE_OF_CONDUCT.md) 协议来发行。
贡献代码或其它给本项目, (commenting or opening PR/Issues etc) 即表示同意这个协议。
### 感谢
本框架是基于 [JS 参考实现](https://github.com/graphql/graphql-js),来开发的。
如 StarWarSchema 和测试用例 (和其它很多方面) 是从它适配到 Java 的。
### 许可证
graphql-java 基于 MIT 许可证. 详见 [许可证](LICENSE.md) 。
Copyright (c) 2015, Andreas Marek 与 [贡献者们](https://github.com/graphql-java/graphql-java/graphs/contributors)
[graphql-js 许可证](https://github.com/graphql/graphql-js/blob/master/LICENSE)
@@ -167,5 +167,6 @@
'Miscellaneous'),
]
language = 'es' # language supported
locale_dirs = ['locale/'] # path is example but recommended.
gettext_compact = False # optional.
Binary file not shown.
@@ -0,0 +1,160 @@
# SOME DESCRIPTIVE TITLE.
# Copyright (C) 2017, Brad Baker
# This file is distributed under the same license as the graphql-java
# package.
# FIRST AUTHOR <EMAIL@ADDRESS>, 2017.
#
#, fuzzy
msgid ""
msgstr ""
"Project-Id-Version: graphql-java current\n"
"Report-Msgid-Bugs-To: \n"
"POT-Creation-Date: 2017-11-14 18:16+0800\n"
"PO-Revision-Date: YEAR-MO-DA HO:MI+ZONE\n"
"Last-Translator: FULL NAME <EMAIL@ADDRESS>\n"
"Language-Team: LANGUAGE <LL@li.org>\n"
"MIME-Version: 1.0\n"
"Content-Type: text/plain; charset=utf-8\n"
"Content-Transfer-Encoding: 8bit\n"
"Generated-By: Babel 2.5.1\n"
#: ../../batching.rst:2
msgid "Using Dataloader"
msgstr ""
#: ../../batching.rst:4
msgid ""
"If you are using ``graphql``, you are likely to making queries on a graph"
" of data (surprise surprise). But its easy to implement inefficient code"
" with naive loading of a graph of data."
msgstr ""
#: ../../batching.rst:7
msgid ""
"Using ``java-dataloader`` will help you to make this a more efficient "
"process by both caching and batching requests for that graph of data "
"items. If ``dataloader`` has seen a data item before, it will have "
"cached the value and will return it without having to ask for it again."
msgstr ""
#: ../../batching.rst:10
msgid ""
"Imagine we have the StarWars query outlined below. It asks us to find a "
"hero and their friend's names and their friend's friend's names. It is "
"likely that many of these people will be friends in common."
msgstr ""
#: ../../batching.rst:28
msgid ""
"The result of this query is displayed below. You can see that Han, Leia, "
"Luke and R2-D2 are a tight knit bunch of friends and share many friends "
"in common."
msgstr ""
#: ../../batching.rst:42
msgid ""
"A naive implementation would called a `DataFetcher` to retrieved a person"
" object every time it was invoked."
msgstr ""
#: ../../batching.rst:44
msgid ""
"In this case it would be *15* calls over the network. Even though the "
"group of people have a lot of common friends. With `dataloader` you can "
"make the `graphql` query much more efficient."
msgstr ""
#: ../../batching.rst:47
msgid ""
"As `graphql` descends each level of the query ( eg as it processes `hero`"
" and then `friends` and then for each their `friends`), the data loader "
"is called to \"promise\" to deliver a person object. At each level "
"`dataloader.dispatch()` will be called to fire off the batch requests for"
" that part of the query. With caching turned on (the default) then any "
"previously returned person will be returned as is for no cost."
msgstr ""
#: ../../batching.rst:52
msgid ""
"In the above example there are only *5* unique people mentioned but with "
"caching and batching retrieval in place their will be only *3* calls to "
"the batch loader function. *3* calls over the network or to a database "
"is much better than *15* calls you will agree."
msgstr ""
#: ../../batching.rst:55
msgid ""
"If you use capabilities like "
"`java.util.concurrent.CompletableFuture.supplyAsync()` then you can make "
"it even more efficient by making the the remote calls asynchronous to the"
" rest of the query. This will make it even more timely since multiple "
"calls can happen at once if need be."
msgstr ""
#: ../../batching.rst:59
msgid "Here is how you might put this in place:"
msgstr ""
#: ../../batching.rst:121
msgid "```"
msgstr ""
#: ../../batching.rst:123
msgid ""
"One thing to note is the above only works if you use "
"`DataLoaderDispatcherInstrumentation` which makes sure "
"`dataLoader.dispatch()` is called. If this was not in place, then all "
"the promises to data will never be dispatched ot the batch loader "
"function and hence nothing would ever resolve."
msgstr ""
#: ../../batching.rst:128
msgid "Per Request Data Loaders"
msgstr ""
#: ../../batching.rst:130
msgid ""
"If you are serving web requests then the data can be specific to the user"
" requesting it. If you have user specific data then you will not want to "
"cache data meant for user A to then later give it to user B in a "
"subsequent request."
msgstr ""
#: ../../batching.rst:133
msgid ""
"The scope of your DataLoader instances is important. You might want to "
"create them per web request to ensure data is only cached within that web"
" request and no more."
msgstr ""
#: ../../batching.rst:136
msgid ""
"If your data can be shared across web requests then you might want to "
"scope your data loaders so they survive longer than the web request say."
msgstr ""
#: ../../batching.rst:139
msgid ""
"But if you are doing per request data loaders then creating a new set of "
"``GraphQL`` and ``DataLoader`` objects per request is super cheap. Its "
"the ``GraphQLSchema`` creation that can be expensive, especially if you "
"are using graphql SDL parsing."
msgstr ""
#: ../../batching.rst:142
msgid ""
"Structure your code so that the schema is statically held, perhaps in a "
"static variable or in a singleton IoC component but build out a new "
"``GraphQL`` set of objects on each request."
msgstr ""
#~ msgid ""
#~ "But if you are doing per request"
#~ " data loaders then creating a new "
#~ "set of ``GraphQL`` and ``DataLoader`` "
#~ "objects per request is super cheap. "
#~ "Its the ``GraphQLSchema`` creation that "
#~ "can be expensive, especially if you "
#~ "are using graphql IDL parsing."
#~ msgstr ""
Binary file not shown.
@@ -0,0 +1,111 @@
# SOME DESCRIPTIVE TITLE.
# Copyright (C) 2017, Brad Baker
# This file is distributed under the same license as the graphql-java
# package.
# FIRST AUTHOR <EMAIL@ADDRESS>, 2017.
#
#, fuzzy
msgid ""
msgstr ""
"Project-Id-Version: graphql-java current\n"
"Report-Msgid-Bugs-To: \n"
"POT-Creation-Date: 2017-11-11 19:21+0800\n"
"PO-Revision-Date: YEAR-MO-DA HO:MI+ZONE\n"
"Last-Translator: FULL NAME <EMAIL@ADDRESS>\n"
"Language-Team: LANGUAGE <LL@li.org>\n"
"MIME-Version: 1.0\n"
"Content-Type: text/plain; charset=utf-8\n"
"Content-Transfer-Encoding: 8bit\n"
"Generated-By: Babel 2.5.1\n"
#: ../../concerns.rst:2
msgid "Application concerns"
msgstr ""
#: ../../concerns.rst:4
msgid ""
"The graphql-java library concentrates on providing an engine for the "
"execution of queries according to the specification."
msgstr ""
#: ../../concerns.rst:6
msgid ""
"It does not concern itself about other high level application concerns "
"such as the following :"
msgstr ""
#: ../../concerns.rst:8
msgid "Database access"
msgstr ""
#: ../../concerns.rst:9
msgid "Caching data"
msgstr ""
#: ../../concerns.rst:10
msgid "Data authorisation"
msgstr ""
#: ../../concerns.rst:11
msgid "Data pagination"
msgstr ""
#: ../../concerns.rst:12
msgid "HTTP transfer"
msgstr ""
#: ../../concerns.rst:13
msgid "JSON endoding"
msgstr ""
#: ../../concerns.rst:14
msgid "Code wiring via dependency injection"
msgstr ""
#: ../../concerns.rst:16
msgid "You need to push these concerns into your business logic layers."
msgstr ""
#: ../../concerns.rst:18
msgid "The following are great links to read more about this"
msgstr ""
#: ../../concerns.rst:20
msgid "http://graphql.org/learn/serving-over-http/"
msgstr ""
#: ../../concerns.rst:21
msgid "http://graphql.org/learn/authorization/"
msgstr ""
#: ../../concerns.rst:22
msgid "http://graphql.org/learn/pagination/"
msgstr ""
#: ../../concerns.rst:23
msgid "http://graphql.org/learn/caching/"
msgstr ""
#: ../../concerns.rst:26
msgid "Context Objects"
msgstr ""
#: ../../concerns.rst:28
msgid ""
"You can pass in a context object during query execution that will allow "
"you to better invoke that business logic."
msgstr ""
#: ../../concerns.rst:30
msgid ""
"For example the edge of your application could be performing user "
"detection and you need that information inside the graphql execution to "
"perform authorisation."
msgstr ""
#: ../../concerns.rst:33
msgid ""
"This made up example shows how you can pass yourself information to help "
"execute your queries."
msgstr ""
Binary file not shown.
Oops, something went wrong.

0 comments on commit 381c4cd

Please sign in to comment.