Hebrew Translation Progress

[tesseralis]

Maintainer List

• @galnir
• @galtalmor
• @itayyehezkel

For New Translators

To translate a page:

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

Before contributing, read the glossary and style guide (once they exist) to understand how to translate various technical and React-specific terms.

Please be prompt with your translations! If you find find that you can't commit any more, let the maintainers know so they can assign the page to someone else.

For Maintainers

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

• Home Page (@tesseralis) Hebrew Translation Progress #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.

• Home Page (@gmadar) Home translation #4
• Tutorial (@galtalmor) Translate React tutorial #10

Basics

• Hello World (@bromy) Translate hello-world.md #8
• Introducing JSX (@galtalmor) Translate Introducing JSX page #42
• Rendering Elements (@dormd) Translate rendering elements page to Hebrew #21
• Components and Props (@galtalmor) Translate Components and Props page #20
• State and Lifecycle (@galtalmor) Translate State and Lifecycle page #25
• Handling Events (@galtalmor) Translate Handling Events page #26
• Conditional Rendering (@galtalmor) Translate Conditional Rendering page #30
• Lists and Keys (@itayyehezkel) Translate lists and keys page #36
• Forms (@galtalmor) Translate Forms page #32
• Lifting State Up (@galtalmor) Translate Lifting State Up page #34
• Composition vs Inheritance (@dormd) Update composition-vs-inheritance.md #40
• Thinking in React (@galnir) translate 'thinking in react' guide #14

API Reference

• React
• React.Component (@itzikya) Translating reference-react-component.md #65
• ReactDOM (@galtalmor) Translate ReactDOM API Reference page #45
• ReactDOMServer (@galtalmor) Translate ReactDOMServer page #43
• DOM Elements (@galnir) translate reference-dom-elements #46
• SyntheticEvent (@galnir) Reference events #51
• Test Utilities (@galnir) translate TestUtilities #52
• Shallow Renderer (@itayyehezkel) Translate Shllow Renderer #39
• Test Renderer (@galtalmor) Translate Test Renderer #93
• JS Environment Requirements (@itayyehezkel) Translate JS Environment Requirements Page #37
• Glossary (@galtalmor) Translate Glossary page #49

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 (@galtalmor) Translate React tutorial #10
• docs/nav.yml (@galtalmor) Translate footer & minor missing pieces in homepage #13

Next Steps

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

Installation

• Getting Started (@galtalmor) Translate Getting Started page #15
• Add React to a Website (@galnir) Reference events #51
• Create a New React App (@galnir) translate create a new react app #55
• CDN Links (@dormd) Translating cdn-links.md #31

Hooks

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

• Introducing Hooks (@itayyehezkel) Translate Introducing Hooks #18 (@galnir) fix many translation errors in hooks intro page #265
• Hooks at a Glance (@galnir ) translate Hooks At a Glance #94
• Using the State Hook (@galnir) translate using-the-state-hook #57
• Using the Effect Hook (@galnir) translate using-the-effect-hook #73
• Rules of Hooks (@galnir) translate hooks rules page #84
• Building Your Own Hooks (@galnir) translate 'building your own hooks' #101
• Hooks API Reference (@galnir) Translate Hooks API Reference #113
• Hooks FAQ (@galnir)

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 (@galnir)
• invalid-aria-prop (@itayyehezkel) add invalid aria prop #112
• invalid-hook-call-warning
• legacy-factories
• refs-must-have-owner
• special-props (@itayyehezkel) add special props #111
• unknown-prop

Advanced Guides

• Accessibility (@rgrnwd) Translate accessibility page #71
• Code-Splitting (@rgrnwd) Translate Advanced - Code-Splitting page #92
• Context (@rgrnwd) Translate Advanced (context, forwarding refs) pages #77
• Error Boundaries (@rgrnwd) Translate error boundaries page #74
• Forwarding Refs (@rgrnwd) Translate Advanced (context, forwarding refs) pages #77
• Fragments (@itayyehezkel) add fragment #109
• Higher-Order Components (@rgrnwd) Translate higher order components page #95
• Integrating with Other Libraries
• JSX In Depth
• Optimizing Performance
• Portals
• React Without ES6
• React Without JSX (@tsehori)
• Reconciliation
• Refs and the DOM
• Render Props
• Static Type Checking
• Strict Mode
• Typechecking With PropTypes
• Uncontrolled Components (@itayyehezkel) add uncontrolled components #110
• Web Components

FAQ

• APIs and AJAX (@itayyehezkel) Translate faq ajax #62
• Babel, JSX, and Build Steps (@itayyehezkel) Translate faq build #63
• Passing Functions to Components (@orrsteinberg) Translate faq functions page #172
• Component State
• Styling and CSS (@itayyehezkel) Translate faq styling #64
• File Structure (@galnir) Translate faq-structure.md #44
• Versioning Policy
• Virtual DOM and Internals

Contributing

Priority: Low

• How to Contribute
• Codebase Overview
• Implementation Notes
• Design Principles

Components

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

• CodeEditor (@itayyehezkel) Translate Code Editor Component #27
• CodeExample (@itayyehezkel) Translate Code Example Component #28
• ErrorDecoder (@galnir) translate errordecoder component #23
• LayoutFooter (@galtalmor) Translate footer & minor missing pieces in homepage #13
• LayoutHeader (@galtalmor) Translated the header #11
• MarkdownPage (@itayyehezkel) Translate Markdown Page #19

Additional Translations

These are not the primary translation targets.

• Blog
• Community

[gmadar]

• Home Page

[bentlusty]

@gmadar Added you to Home page. thank you!

[galtalmor]

• Tutorial

[galnir]

@galtalmor Added you to the tutorial

[galtalmor]

@gmadar Added you to the tutorial

Wrong mention, bug tagging is okay :)

[galnir]

@galtalmor oops sorry

[bromy]

• Hello World

[galnir]

@bromy It's yours 👍

[galnir]

Does anyone have a solution for fixing punctuation when translating into hebrew? There is an example in gmadar's pull request:

It also happens on my end when I translate sentences

[galtalmor]

Does anyone have a solution for fixing punctuation when translating into Hebrew?

I suppose it will just require some CSS tweaking with direction: rtl, but I'm not sure how would that work with the way they build and publish this website. I think it is best to try and contact someone from the team in charge to figure out if it is okay to make changes in the website's CSS since this problem will exist everywhere with this translation.

More specifically, adding the following code in the file algolia.css solved the basic issues for me, but requires more tweaking to make everything look better:

p, h1, h2, h3, ul, details {
  direction: rtl;
}

code {
  direction: ltr;
  display: inline-block;
}

[tesseralis]

@galtalmor It's definitely okay to make changes to the CSS -- Arabic and Persian dealt with the same thing and actually have PRs to do it: reactjs/ar.react.dev#8

You might want to post there to see if they can help you set it up for Hebrew!

[galnir]

@galtalmor A member of the Arabic translation team already helped us with that :) #6

[galtalmor]

@galtalmor A member of the Arabic translation team already helped us with that :) #6

👍

[dormd]

Awesome idea 😍
Rendering Elements