Giter Club home page Giter Club logo

redux-in-chinese's Introduction

➡️在线文档地址:https://cn.redux.js.org/

Redux 是 JavaScript 状态容器,提供可预测化的状态管理。 (如果你需要一个 WordPress 框架,请查看 Redux Framework。)

可以让你构建一致化的应用,运行于不同的环境(客户端、服务器、原生应用),并且易于测试。不仅于此,它还提供 超爽的开发体验,比如有一个时间旅行调试器可以编辑后实时预览

Redux 除了和 React 一起用外,还支持其它界面库。 它体小精悍(只有 2kB,包括依赖)。

安装

Redux Toolkit 是官方推荐的编写 Redux 逻辑的方法。 它围绕着 Redux core,包含我们认为构建 Redux 应用程序必不可少的包和函数。Redux Toolkit 基于我们建议的最佳实践来开发,简化了大多数 Redux 任务,防止了常见错误,并使编写 Redux 应用程序变得更加容易。

npm install @reduxjs/toolkit react-redux

只安装 Redux core

npm install redux

更多信息,访问 安装文档

文档

借鉴

Redux 改进了 Flux 的**,但通过从 Elm 中汲取灵感来避免其复杂性。即使您没有使用过 Flux 或 Elm,Redux 也只需几分钟即可上手。

Logo

官方 Logo 在 Github 上可以找到

重要里程碑

4.x 里程碑:

2022.10.1 全面完成 4.x 官方文档的翻译和校验,特别感谢以下贡献者的辛勤付出:

贡献者

在线链接:https://github.com/nefe/redux-in-chinese/graphs/contributors

所有贡献者列表

本文档翻译流程符合 ETC 翻译规范,欢迎你来一起完善

License

MIT

redux-in-chinese's People

Contributors

alcat2008 avatar arcthur avatar camsong avatar creamidea avatar dependabot[bot] avatar dorayx avatar erweixin avatar fe-sadhu avatar froyog avatar hashtree avatar hellocathi avatar huifeiya avatar johannlai avatar jovey-zheng avatar leftjs avatar lokyoung avatar namelos avatar omytea avatar pandazki avatar qqqdu avatar rainsho avatar rccoder avatar ssy181 avatar teammiclee avatar viddamao avatar yuweiw823 avatar zazaliu avatar zhe avatar zhu-ting avatar zxb-hub 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  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

redux-in-chinese's Issues

关于章节2.5 Usage with React中的疑问

章节2.5中 Presentational and Container Components 那一段的中文翻译,为什么会加上下面这一句呢?

“明智的做法是只在最顶层组件(如路由操作)里使用 Redux”

同样的,在下方的表格中也提到容器组件的location应该在

“最顶层”

对比了英文版,其实并没有这样的说法。所以很想知道它是否是大神自己的最佳实践?为什么会得到这样的结论?

中英截屏对比
snapshot1
snapshot2

望大神不吝赐教,谢谢

Proofread『技巧』章节

为了译文提高质量,我们需定期对内容与原文做同步更新,本次校对的是『技巧』章节,包括 6 小节内容。

技巧

  • 迁移到 Redux
  • 减少样板代码
  • 服务端渲染
  • 编写测试
  • 计算衍生数据
  • 实现撤销重做

校对过程:

  • 回复认领本 issue
  • 把中文与原文对比阅读,对于有更新的内容做同步
  • 完成后提交 PR 即可

Proofread『介绍』章节

为了译文提高质量,我们需定期对内容与原文做同步更新,本次校对的是『介绍』章节,包括 5 小节内容。

介绍

校对过程:

  • 回复认领本 issue
  • 把中文与原文对比阅读,对于有更新的内容做同步
  • 完成后提交 PR 即可

Proofread『词汇表』和『排错』

为了译文提高质量,我们需定期对内容与原文做同步更新,本次校对的是『词汇表』和『排错』。

校对过程:

  • 回复认领本 issue
  • 把中文与英文对比阅读,同步更新内容
  • 完成后提交 PR

英文单复数问题

原文:

First, let’s define some actions.

如果译成

首先,让我们来定义几个 actions。

比较符合原意,但是汉语里没有单复数概念,看起来读起来都有点奇怪。

如果译成 action 看起来更顺畅,但与原文不一致。

不知道业界对此类问题有没有达到共识,欢迎讨论。

在 http://camsong.github.io/redux-in-chinese 这个网站中发现两处错误

http://camsong.github.io/redux-in-chinese/docs/basics/ExampleTodoList.html
在上面这个页面中。

  1. 在 入口文件 index.js 中
    React.render(
{() => < App / >} , rootElement ) 这里的< App/ > 外面应该没有{()=>} 但是发现在repos中是没问题的,怀疑是不是没有重新生成呀。

2.另一处问题也同上。在
容器组件处 containers/App.js 处,最后一行没有显示出来。
export default connect(select)(App)
在本git中也是正确的。所以怀疑重新生成一下应该就好了吧。

文档有误

basics/ExampleTodoList.md:

containers/App.js 中

import { addTodo, completeTodo, setVisibilityFilter, VisibilityFilters } from '../actions'

应是

import { addTodo, toggleTodo, setVisibilityFilter, VisibilityFilters } from '../actions';

TodoList的 completeTodo 也应是 toggleTodo

初学 redux,这是我自己发现的,应该是笔误,比较简单,就不pr了。

2.2节的疑问

翻译文档 中,是否出现了 COMPLETE_TODOTOGGLE_TODO 混淆的情况? 比如:

最后,COMPLETE_TODO 的实现也很好理解:

case TOGGLE_TODO:
  return Object.assign({}, state, {
    todos: state.todos.map((todo, index) => {
      if (index === action.index) {
        return Object.assign({}, todo, {
          completed: !todo.completed
        })
      }
      return todo
    })
  })

英文文档中, 这一节貌似没有提及 TOGGLE_TODO

Proofread『高级』章节

为了译文提高质量,我们需定期对内容与原文做同步更新,本次校对的是『高级』章节,包括 6 小节内容。

高级

  • 异步 Action
  • 异步数据流
  • Middleware
  • 搭配 React Router
  • 示例:Reddit API
  • 下一步

英文地址:https://github.com/rackt/redux/tree/master/docs/advanced

校对过程:

  • 回复认领本 issue
  • 把中文与英文对比阅读,同步更新内容
  • 完成后提交 PR

建议统一将 constant(s) 翻译成「常量」

发现在不同的章节里,constant(s) 的翻译不一致,如:

  • 第 2 章、第 7 章里翻译成「常量」
  • 第 4.2 章里翻译成「定值」
  • 第 6 章里翻译成「常数」

建议统一翻译为「常量」。

redux到底有没有dispatcher ?

本人新手,因为学习react的缘故,从他们的英文文档里看到了redux。搜索之后发现了中文文档,非常赞,感谢大家的努力工作。
我看到两个地方有相互矛盾的地方,不太理解,冒昧问下:
在文档的先前技术章节:http://cn.redux.js.org/docs/introduction/PriorArt.html
中说到flux 时说“而不同于 Flux ,Redux 并没有 dispatcher 的概念”
在文档基础action章节:http://cn.redux.js.org/docs/basics/Actions.html
中说“一般来说你会通过 store.dispatch() 将 action 传到 store。”

dispatcher的概念和store.dispatch() 有木有联系,还是只是看着相似,望有高手解答。

再次感谢

如何使用redux的容器组件

一个页面需要一个container组件还是多个container组件?

如果是一个containner组件,那么它所有的的子组件都是展示组件,都是从顶部containner组件中接受props参数和action吗,这些展示组件是不是还需要一些自己的ui状态?

todoApp 跑哪里去了

import React from 'react'
import { render } from 'react-dom'
import { createStore } from 'redux'
import { Provider } from 'react-redux'
import App from './containers/App'
import todoApp from './reducers'

let store = createStore(todoApp);

let rootElement = document.getElementById('root')
render(


,
rootElement
)

http://cn.redux.js.org/docs/basics/UsageWithReact.html

关于中文翻译中斜体的处理

  • 粗体内嵌斜体:

    Redux doesn’t care how you store the state—it can be a plain object, an Immutable object, or anything else.
    Redux 并不在意你_如何_存储 state,state 可以是普通对象,可以是不可变对象,或者其它类型。

  • 正常斜体:

    While it is technically possible to write impure reducers that mutate the data
    写不纯的 reducers 来变动数据在技术上是_可行_的

对于“正常斜体”是否应该遵循#翻译约定中的 英文有斜体、中文没有,可用强调取代 **强调** 进行翻译?将 可行 译成 可行

文档同步:【介绍】章节

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.