Giter Club home page Giter Club logo

the-road-to-graphql-chinese's Introduction

《GraphQL 学习之道》 The Road to GraphQL (简体中文版)

Slack

这是 The Road to GraphQL 的官方仓库(简体中文版)。如果你愿意的话,请到亚马逊或者 Goodreads 上留下你的评论。

更新、帮助和支持

贡献

您可以通过提交新的Issue和Pull Requests来帮助改进这本书。

您可以提交Pull Request来纠正拼写,或者给某个课程增加更多细节。在写这样一本技术类的书籍时,会很容易进入盲区,会忽略一些有待解释和过多解释的内容。

另外,在遇到问题时,您可以在Github创建新的问题(Issue)。为了让这些问题尽快和更容易解决,请提供更多细节,比如报错信息、截图、出错页码、当前node版本(命令行: node -v)以及你的代码仓库地址。这些细节不全是必需的,但大部分可以为修复问题和改进本书提供很大的帮助。

非常感谢您的帮助,

the-road-to-graphql-chinese's People

Contributors

amyshieh avatar azzgo avatar futantan avatar heyff12 avatar jellylu avatar kevindongzg avatar linchen2chris avatar linksgo2011 avatar listensong1013 avatar lixingsun avatar mandy-tang avatar reeli avatar reggiegui avatar rwieruch avatar sasa33 avatar sbeator avatar scglwsj avatar shanezhang-tw avatar sheltonsuen avatar simontal avatar tangniye avatar trotyl avatar warnerhooh avatar wjgogogo avatar xbini avatar yixi avatar zengyang2014 avatar zpc7 avatar

Stargazers

 avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar

Watchers

 avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar

the-road-to-graphql-chinese's Issues

[翻译] 07-apollo-react

翻译范围

章节 文件 文件行数
07-apollo-react index-cn.md 3709

翻译人员(需要约8人)

负责人: 一山

  1. (line 1 - 562) 页首到 ## Apollo Client Error Handling in React (不含)前
  2. (line 564 - 1237)## Apollo Client Error Handling in React 一节
  3. (line 1239 - 1881) ## Apollo Client Optimistic UI in React 整节 + ## GraphQL Pagination with Apollo Client in React 整小节
    4.(line 1883 - 2571) ## GraphQL Caching of Queries with Apollo Client in React 一节
  4. (line 2573 - 2990) ## Implementing the Issues Feature: Setup 一整节 + ## Implementing the Issues Feature: Client-Side Filter 一整节
  5. (line 2992 - 3333) ## Implementing the Issues Feature: Server-Side Filter + ## Apollo Client Prefetching in React
  6. (line 3335 - 页尾) ## Exercise: Commenting Feature + ## Appendix: CSS Files and Styles

翻译人员:
第一部分 文一山 @azzgo
第二部分 徐雯俊 @AHOhhhh
第三部分 李睿 @reeli
第四部分 董志刚 @kevindongzg
第五部分 刘应皓(一兮)@Yixi
第六部分 郑鹏程 @zpc7
第⑦部分 谢长青 @AmyShieh

校对人员

第一部分: @xingqiwu55555, @AHOhhhh
第二部分: @ReggieGui
第三部分: 董志刚 @kevindongzg
第四部分: 文一山 @azzgo
第五部分:李睿 @reeli
第六部分:@WarnerHooh
第7️⃣部分:@zpc7

全篇校对

由我进行全篇校对,希望得到大家的帮助

需要翻译的各章节文件和行数统计

翻译前必读:讨论流程、规范、技巧等等一切问题

翻译前准备

了解GraphQL,推荐大家都阅读一下Robin自己的多篇关于 GraphQL 的博客

翻译步骤

  1. 挑选章节:在相应 Issue 里面回复Mark一下即可(稍后发送权限 invitation
  2. 协调时间/人员:跟你共同翻译的小伙伴协商 tasks 和相应的预估时间
  3. fork 项目:clone 至本地进行编辑,推荐 Markdown 编辑器 Typora
  4. 翻译:修改你翻译对应的 *-cn.md 文件,不要修改不带-cn后缀的原始文件(可能用于以后merge最新的英文修改)
  5. 提 Pull Request:同时艾特 @ 同章节的其他翻译小伙伴和做校对的小伙伴
  6. Review:直接在 PR 内对应 commits 位置进行评论与讨论
  7. 合并:翻译完成

翻译的方式

你可以分段将英文和译文放在一起,例如:

> The chapter gives you an introduction to React. You may ask yourself: Why should I learn React in the first place? 

本章介绍 React。你可能会问自己:为何应当优先学习 React?

这样做的好处:

  1. 方便翻译时进行双语对照。
  2. 引用符号 > 方便翻译完成后一键移除英文(使用正则)
    所以用这种方式我们需要两个PR来完成翻译,第一个PR会在文件中每一段后面加上中文,而第二个PR则是移除掉原来的英文部分。

翻译的工具有哪些?

  • 安利一下好用的 Markdown 编辑器 Typora,功能完备且美观,当然也可以用 Sublime 或者 Intellij 呀,😂
  • 可以适当借助 Google 翻译,回过头来看你可能会说,卧槽 Google Translate 真是牛逼!
  • 使用了类似 Trello 的管理工具 ZenHub,具备 Pipeline、Estimate、Assignees 等功能,可视化翻译进度。

翻译时的风格统一需要最终 review

翻译时的常用词汇约定用词规范

原文 中文
command line 命令行
repository 代码库
functional stateless components 无状态组件
terminal 终端
mount 挂载
you
Appolo Client 【无需翻译】
Appolo Server 【无需翻译】
API endpoint 【无需翻译】
star 【无需翻译】
query 查询(操作)
mutation 变更(操作)
organization 组织
Exercises 练习
named 具名, 例如 named query 具名查询
pagination 分页
interface 接口
cursor 游标
meta information 如果可以很好的意译的话就意译,否则翻译成“元信息(meta information)”
resolver 解析器
resovler function 解析函数
model 模型
following 如下内容
mutation 变更(操作)
organization 组织
identifier 唯一标识

翻译练习的方式

无需翻译的原则

  • 代码中的内容都不翻译(包括在段落中引用代码的内容)
  • 大家在中文普通交流都用英文表达的单词,如bug。
  • 没有合适的中文对应的专业术语

附不用翻译的词汇列表:

  • bug
  • Appolo Client
  • Appolo Server
  • API endpoint
  • token相关的内容,如 token, access token,refresh token, personal token,
  • schema
  • issue (作为github issue就不翻译)

其他

  • 中英文字符之间需要与空格。大家可以用vs code插件 vscode-pangu 帮我们快速添加空格
  • 一些特殊的不好翻译的词汇不用强行直译,而是可以通过意译的方式让语句通顺

Incorrect link in readme file

这是 [The Road to GraphQL](https://roadtoreact.com/) 的官方仓库(简体中文版)

The link https://roadtoreact.com/ is incorrect.

[翻译] 08-apollo-server

翻译范围

章节 文件 文件行数
08-apollo-server index-cn.md 5338

翻译人员 (需要10+人)

负责人:@scglwsj

第一部分 @scglwsj
第二部分 @clattanoia
第三部分 @ListenSong1013
第四部分 @WarnerHooh
第五部分 @sheltonsuen
第六部分 @HazelZ
第七部分 @Mandy-Tang
第八部分 @Heyff12
第九部分 @SimonTal
第十部分 @zhangyouxin

校对人员

第一部分 @liujiefengfeng @SimonTal
第二部分 @scglwsj
第三部分 @sheltonsuen
第四部分 @ListenSong1013
第五部分 @xbini
第六部分 @qiuyunfen
第七部分 @Heyff12
第八部分 @Mandy-Tang
第九部分 @HazelZ @zhangyouxin
第十部分 @futantan

Recommend Projects

  • React photo React

    A declarative, efficient, and flexible JavaScript library for building user interfaces.

  • Vue.js photo Vue.js

    🖖 Vue.js is a progressive, incrementally-adoptable JavaScript framework for building UI on the web.

  • Typescript photo Typescript

    TypeScript is a superset of JavaScript that compiles to clean JavaScript output.

  • TensorFlow photo TensorFlow

    An Open Source Machine Learning Framework for Everyone

  • Django photo Django

    The Web framework for perfectionists with deadlines.

  • D3 photo D3

    Bring data to life with SVG, Canvas and HTML. 📊📈🎉

Recommend Topics

  • javascript

    JavaScript (JS) is a lightweight interpreted programming language with first-class functions.

  • web

    Some thing interesting about web. New door for the world.

  • server

    A server is a program made to process requests and deliver data to clients.

  • Machine learning

    Machine learning is a way of modeling and interpreting data that allows a piece of software to respond intelligently.

  • Game

    Some thing interesting about game, make everyone happy.

Recommend Org

  • Facebook photo Facebook

    We are working to build community through open source technology. NB: members must have two-factor auth.

  • Microsoft photo Microsoft

    Open source projects and samples from Microsoft.

  • Google photo Google

    Google ❤️ Open Source for everyone.

  • D3 photo D3

    Data-Driven Documents codes.