reactjs / zh-hans.reactjs.org Goto Github PK

View Code? Open in Web Editor NEW

859.0 39.0 1.1K 153.61 MB

React documentation website in Simplified Chinese

Home Page: https://zh-hans.react.dev

License: Creative Commons Attribution 4.0 International

JavaScript 32.88% CSS 7.33% HTML 0.27% Shell 0.01% TypeScript 59.50%

zh-hans.reactjs.org's Introduction

React 中文文档

此仓库包含 React 中文文档的文档及源码，并由官方实时同步。

参与贡献

目前，大部分的翻译工作都已经完成。现在主要工作是同步和完善已有翻译。

参与贡献前，请仔细阅读 React 中文文档译文规范。

react.dev

This repo contains the source code and documentation powering react.dev.

Getting started

Prerequisites

Git
Node: any 12.x version starting with v12.0.0 or greater
Yarn: See Yarn website for installation instructions
A fork of the repo (for any contributions)
A clone of the react.dev repo on your local machine

Installation

cd react.dev to go into the project root
yarn to install the website's npm dependencies

Running locally

yarn dev to start the development server (powered by Next.js)
open http://localhost:3000 to open the site in your favorite browser

Contributing

Guidelines

The documentation is divided into several sections with a different tone and purpose. If you plan to write more than a few sentences, you might find it helpful to get familiar with the contributing guidelines for the appropriate sections.

Create a branch

git checkout main from any folder in your local react.dev repository
git pull origin main to ensure you have the latest main code
git checkout -b the-name-of-my-branch (replacing the-name-of-my-branch with a suitable name) to create a branch

Make the change

Follow the "Running locally" instructions
Save the files and check in the browser
Changes to React components in src will hot-reload
Changes to markdown files in content will hot-reload
If working with plugins, you may need to remove the .cache directory and restart the server

Test the change

If possible, test any visual changes in all latest versions of common browsers, on both desktop and mobile.
Run yarn check-all. (This will run Prettier, ESLint and validate types.)

Push it

git add -A && git commit -m "My message" (replacing My message with a commit message, such as Fix header logo on Android) to stage and commit your changes
git push my-fork-name the-name-of-my-branch
Go to the react.dev repo and you should see recently pushed branches.
Follow GitHub's instructions.
If possible, include screenshots of visual changes. A preview build is triggered after your changes are pushed to GitHub.

Translation

If you are interested in translating react.dev, please see the current translation efforts here.

License

Content submitted to react.dev is CC-BY-4.0 licensed, as found in the LICENSE-DOCS.md file.

zh-hans.reactjs.org's People

Contributors

Stargazers

Watchers

Forkers

jaychsu tc9011 yuqingc betamee caiyongmin pppluto haimengzhang sanmaopep stonexer zhaozhiming ryanhui zhangxd6 cnahliu huangjihua baxtergu perry2008084 lixiaoyang1992 zbc chloeliang musclejack bailnl meleslilijing yesmeck pampang crazydogs yuiham thewashingtonhua fonkie zombiej yhsunshining lcina shine977 sang4lv summccc bychoo smallbaby nanasun hateonion vincenteof infinnie calvinvt buffaybu runbo94 thjttk coolrice zcfan jiacheng9 hhy5277 shenqidecaonima liujuntao123 couidmine blade-demon next-one soolx selmalee mactanxin hstarorg jiaxiaoweist maicworkgithub itxuye jhjocelyn lambgirl godot007 ethanp-cn maicss lvdingjin afc163 ghycy15 laobeijing0806 qianlanse pebblerwon donchengcheng skycong happystory johnlin0207 loungcingzeon manglobe xjhan2016 stevenyuysy sunzhuoyi zzuu666 flysme hqzh stoneqq11 southproject lgyytm mocoer tramplpf lshaohua5 lllbahol zhwtf dbwcooper jinglingting redbonestone sylviaz89 noxczj talent-rain zanllp zhangchao828 fuckupc

zh-hans.reactjs.org's Issues

[Merge]: Update 2019-02-04-react-v16.8.0.md

Update to original repo
Original:reactjs/react.dev@0d89570

[Doc]: typo

Update to original repo
Original:reactjs/react.dev@26b0eb2

[Merge]: Updated 16.8 CHANGELOG wording to also mention ReactTestRenderer.act()

Update to original repo
Original:reactjs/react.dev@cea45bb

[READ ONLY] The Glossary Sheet

React 翻译参考

相关问题讨论请移步至 #611. 本 issue 现在为只读状态。

本术语表只适用于该术语作为整体概念时的翻译参考，当其作为概念的一部分时，视具体情况翻译。

React 中英文对照表

术语	译文
asserts	断言
Application	应用
breaking change	破坏性更改
callback	回调函数
Class Components	类式组件
Composition	组合
conditional rendering	条件渲染
controlled components	受控组件
Cross-Cutting Concerns	横切关注点
data	数据
Declarative	声明式
derived state	派生状态
Elements	元素
Embedding Expressions	嵌入表达式
escape hatches	应急方案
External Plugins	外部插件
Function component	函数组件
Functional Components	函数式组件
function signature	函数签名
HOC	高阶函数（HOC）
higher-order-component	高阶函数
Handling Events	事件处理
Inheritance	继承
Legacy	过时
local state	内部 state
mock	设计稿
operator	运算符
prop drilling	prop 逐级透传
Reconciliation	协调
render	渲染
Reusable	可复用
shallow rendering	浅层渲染
Stateful Component	有状态组件
syntax	语法
Third Plugins	第三方插件
uncontrolled components	非受控组件
Vendor Prefix	浏览器引擎

通用

原文	译文
Code linters	代码检查工具
example	示例
For example	例如
Importing	如何引入
In this chapter	本章节
Note	注意
opt-in	可选
Overview	概览
Reference	参考
section	章节
Tip	提示
Tutorial	教程
Try it on CodePen	在 CodePen 上尝试
What's next	下节预告

有时无需翻译的内容

原文术语大小写一致时和下表一致的优先不翻译，大小写不一致的，视具体情况决定是否翻译，如需翻译，可参考可选翻译一列。
下表只适用于该术语作为整体概念时的参考，当其作为概念的一部分时，视具体情况决定是否翻译，如需翻译，可参考可选翻译一列。
中文文档中，术语的大小写和单复数请跟下表保持一致，例如原文的 props 不需要改为单数。

术语	可选翻译
Attributes
bundle
class
Consumer
context
Create React App
DOM
Effect	副作用
fallback
Fiber
fragments
Good/Bad
Hook
hydrate/hydration
mixins
Mutation
package	包
polyfill
Portal
PropTypes
Provider
props / prop
React
ref
state	状态
Tick
UI	用户界面
Web
Web Components
wrapper

不需翻译的链接：

Wikipedia
MDN

[Doc]: fest: add React Native EU 2019, move React India

Update to original repo
Original:reactjs/react.dev@c89caa0

[Merge]: Use 16.8.1

Update to original repo
Original:reactjs/react.dev@8eaa701

[Doc]: Update meetups.md

Update to original repo
Original:reactjs/react.dev@1434671

[Merge]: Document test renderer act (temporary fix)

Update to original repo
Original:reactjs/react.dev@d20be53

[Merge]: Moved blog post to Feb 6th

Update to original repo
Original:reactjs/react.dev@8fa112e

[Merge]: testing

Update to original repo
Original:reactjs/react.dev@601c016

[Doc]: Merge pull request #1544 from threepointone/master

Update to original repo
Original:reactjs/react.dev@924e76d

[Merge]: Merge pull request #1629 from bvaughn/hooks-stable

Update to original repo
Original:reactjs/react.dev@d468ba1

[Merge]: Fix typo on hooks availability

Update to original repo
Original:reactjs/react.dev@be56e22

[Merge]: Merge pull request #1632 from rafaelcg/patch-1

Update to original repo
Original:reactjs/react.dev@e833dfd

[Doc]: Typo fix

Update to original repo
Original:reactjs/react.dev@17fdc42

[Doc]: Merge pull request #1570 from bvaughn/useDebugValue-formatterFn

Update to original repo
Original:reactjs/react.dev@8b333fd

[Merge]: Docs updates

Update to original repo
Original:reactjs/react.dev@d460a9b

[Merge]: React Native will ship hooks in its 0.59 release.

Update to original repo
Original:reactjs/react.dev@9f4b4a9

[Doc]: Warning page for invalid Hook calls

Update to original repo
Original:reactjs/react.dev@f149987

[Doc]: Added link to Reach Router

Update to original repo
Original:reactjs/react.dev@b38c572

[Doc]: Clarify conflicting advice

Update to original repo
Original:reactjs/react.dev@1a49812

[Merge]: review tweaks

Update to original repo
Original:reactjs/react.dev@37d46dd

[Merge]: Added link to 16.7 docs

Update to original repo
Original:reactjs/react.dev@af11b29

[Doc]: Add ReactBris to meetups

Update to original repo
Original:reactjs/react.dev@dc2deb9

[Merge]: Update 2019-02-04-react-v16.8.0.md

Update to original repo
Original:reactjs/react.dev@2fd487e

[Merge]: tweaks

Update to original repo
Original:reactjs/react.dev@d97cdca

[Merge]: Added ReactTestUtils.act() to CHANGELOG

Update to original repo
Original:reactjs/react.dev@8cae066

[Merge]: Merge branch 'hooks-stable' of https://github.com/gaearon/reactjs.org…

Update to original repo
Original:reactjs/react.dev@7d89762

[Doc]: [Hooks] Add recommendations about useMemo and lazy init

Update to original repo
Original:reactjs/react.dev@d7d5533

[Merge]: Thanks Sophie

Update to original repo
Original:reactjs/react.dev@ed6e711

[Doc]: Added useDebugValue formatter function

Update to original repo
Original:reactjs/react.dev@0ace70f

[Merge]: Replaced inaccurate comments

Update to original repo
Original:reactjs/react.dev@a0db3e7

[Doc]: Add docs for useDebugValue

Update to original repo
Original:reactjs/react.dev@4c29b69

[Merge]: Udpated changelog

Update to original repo
Original:reactjs/react.dev@ee909e5

[Doc]: Add note about Promise polyfill for React.lazy

Update to original repo
Original:reactjs/react.dev@165ae04

[Merge]: Update version number in header and versions page

Update to original repo
Original:reactjs/react.dev@98c1ebe

[Merge]: Merge branch 'update-version-number' of https://github.com/nikhilem/r…

Update to original repo
Original:reactjs/react.dev@845bd4a

[Doc]: Merge pull request #1557 from bvaughn/useDebugValue

Update to original repo
Original:reactjs/react.dev@df240a4

[Merge]: react-testing-library now supports `act`

Update to original repo
Original:reactjs/react.dev@f846c4d

[Doc]: Tweak useMemo wording

Update to original repo
Original:reactjs/react.dev@9b5638f

[Doc]: Wordsmithing

Update to original repo
Original:reactjs/react.dev@efcbcc5

OLD CLAIMS

翻译前，请仔细阅读 React-中文文档译文排版指南。

For New Translators

To translate a page:

Check that no one else has claimed your page in the checklist and comments below.
Comment below with the name of the page you would like to translate. Take only one page at a time.
Clone this repo, translate your page, and submit a pull request!

Please check the previous fork (https://react.docschina.org/) before starting a translation. Make sure to compare the content with the current React website to makes sure everything is up to date!

For Maintainers

When someone volunteers, edit this issue with the username of the volunteer, and with the PR. Ex:

Home Page (@tesseralis) #1

When PRs are merged, make sure to mark that page as completed!

Core Pages

To do before releasing as an "official" translation. Please translate these pages first.

Navigation

These are the navigation links that appears in the sidebar. Possibly wait until
the corresponding sections are translated to do these.

tutorial/nav.yml (@yuqingc) #12
docs/nav.yml (@QC-L) (direct commit)

Next Steps

These are the next most important translations, ordered by importance:

Installation

Getting Started(@laozhu) #143
Add React to a Website (@seognil) #103
Create a New React App (@seognil) #104
CDN Links (@QC-L) #7

Hooks

Everyone is hooked on hooks! People are really excited for these and it would be great for them to be translated.

Introducing Hooks(@lixiaoyang1992) #131
Hooks at a Glance (@yesmeck) #110
Using the State Hook(@Koopos) #16
Using the Effect Hook (@Crazydogs) #123
Rules of Hooks (@Crazydogs) #135
Building Your Own Hooks (@bailnl) #99
Hooks API Reference (@Yuiham) #173
Hooks FAQ (@tonghuashuo) #121

Warnings

These are the pages that you get when you click the links in the console (e.g. https://reactjs.org/warnings/dont-call-proptypes.html). People tend to search these, so please don't translate the error message itself.

dont-call-proptypes (@seognil) #115
invalid-aria-prop (@seognil) #114
legacy-factories (@seognil) #113
invalid-hook-call-warning (@seognil) #169
refs-must-have-owner (@seognil) #124
special-props (@seognil) #112
unknown-prop (@seognil) #111

Advanced Guides

FAQ

APIs and AJAX (@hateonion) #157
Babel, JSX, and Build Steps (@baxtergu) #167
Passing Functions to Components (@sichenguo) #136
Component State (@bbbbx) #137
Styling and CSS (@infinnie) #134
File Structure (@baxtergu) #148
Versioning Policy (@buffaybu) #139
Virtual DOM and Internals (@ChiuMungZitAlexander) #141

Contributing

Priority: Low

How to Contribute (@jimczj)
Codebase Overview (@nanaSun) #144
Implementation Notes (@nanaSun)
Design Principles (@TangHeJun) #145

Components

Components in src/components that have some text in them.

CodeEditor (@zcfan) #149
CodeExample (@zcfan) #150
ErrorDecoder (@CoolRice) #152
LayoutFooter (@QC-L)(direct commit)
LayoutHeader (@QC-L)(direct commit)
MarkdownPage (@QC-L)(direct commit)

Additional Translations

These are not the primary translation targets.

reactjs / zh-hans.reactjs.org Goto Github PK

zh-hans.reactjs.org's Introduction

参与贡献

react.dev

Getting started

Prerequisites

Installation

Running locally

Contributing

Guidelines

Create a branch

Make the change

Test the change

Push it

Translation

License

zh-hans.reactjs.org's People

Contributors

Stargazers

Watchers

Forkers

zh-hans.reactjs.org's Issues

React 翻译参考

React 中英文对照表

有时无需翻译的内容

不需翻译的链接：

For New Translators

For Maintainers

Core Pages

Navigation

Next Steps

Installation

Hooks

Warnings

Advanced Guides

FAQ

Contributing

Components

Additional Translations

Recommend Projects

Recommend Topics

Recommend Org