Giter Site home page Giter Site logo

reactjs / ru.reactjs.org Goto Github PK

View Code? Open in Web Editor NEW
670.0 19.0 378.0 152.33 MB

React documentation website in Russian / Официальная русская версия сайта React

Home Page: https://ru.react.dev

License: Creative Commons Attribution 4.0 International

JavaScript 32.40% CSS 7.39% HTML 0.28% Shell 0.01% TypeScript 59.92%
react javascript website documentation translation russian-translation russian docs gatsby

ru.reactjs.org's Introduction

ru.react.dev

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

Getting started

Prerequisites

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

Installation

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

Running locally

  1. yarn dev to start the development server (powered by Next.js)
  2. 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

  1. git checkout main from any folder in your local react.dev repository
  2. git pull origin main to ensure you have the latest main code
  3. 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

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

Test the change

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

Push it

  1. 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
  2. git push my-fork-name the-name-of-my-branch
  3. Go to the react.dev repo and you should see recently pushed branches.
  4. Follow GitHub's instructions.
  5. 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.

ru.reactjs.org's People

Contributors

acdlite avatar alexkrolick avatar allevykin avatar angryermine avatar another-guy avatar bvaughn avatar chenglou avatar danilowoz avatar gaearon avatar gcor avatar heegiiny avatar jimfb avatar koba04 avatar kohei-takata avatar lex111 avatar marocchino avatar ntishkevich avatar petehunt avatar rainyera avatar react-translations-bot avatar reactjs-translation-bot avatar rickhanlonii avatar shdq avatar sophiebits avatar tesseralis avatar titovmx avatar vjeux avatar vvscode avatar zpao avatar zqran 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

ru.reactjs.org's Issues

Reviewer availability

Хотел просто сказать, что на этой неделе буду занят и не смогу ревьюить — так что доверяю @lex111 и @another-guy трясти переводы на тему упрощения. Поменьше существительных и деревянных оборотов, побольше живого языка! Думаю, в ревью имеет смысл ссылаться на прошлые переводы и процесс, который они прошли: #17, #42, #39.

Можно в этот тред писать, когда кто-то временно не может ревьюить. Чтобы другие были в курсе и можно было перехватить работу.

Russian Progress [restored]

For reasons unknown so far, the initial issue from @tesseralis has been removed.

The situation is discussed here: https://github.com/orgs/reactjs/teams/reactjs-org-localization/discussions/10


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. Take only one page at a time.
  3. Submit a PR and add it to your comment!

Before contributing, be sure to read the translation guide!

Feel free use partial translation as a starting point — https://github.com/js-ru/react-ru

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:

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.

Basics

  • Hello World (@ModPhoenix)
  • Introducing JSX (@another-guy)
  • Rendering Elements
  • Components and Props
  • State and Lifecycle
  • Handling Events
  • Conditional Rendering
  • Lists and Keys
  • Forms
  • Lifting State Up
  • Composition vs Inheritance
  • Thinking in React

API Reference

  • React
  • React.Component
  • ReactDOM
  • ReactDOMServer
  • DOM Elements
  • SyntheticEvent
  • Test Utilities
  • Shallow Renderer
  • Test Renderer
  • JS Environment Requirements
  • Glossary

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
  • docs/nav.yml

Next Steps

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

Installation

  • Getting Started
  • Add React to a Website
  • Create a New React App
  • CDN Links

Hooks

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

  • Introducing Hooks
  • Hooks at a Glance
  • Using the State Hook
  • Using the Effect Hook
  • Rules of Hooks
  • Building Your Own Hooks
  • Hooks API Reference
  • Hooks FAQ

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
  • invalid-aria-prop
  • invalid-hook-call-warning
  • legacy-properties
  • refs-must-have-owner
  • special-props
  • unknown-prop

Advanced Guides

  • Accessibility
  • Code-Splitting
  • Context
  • Error Boundaries
  • Forwarding Refs
  • Fragments
  • Higher-Order Components
  • Integrating with Other Libraries
  • JSX In Depth
  • Optimizing Performance
  • Portals
  • React Without ES6
  • React Without JSX
  • Reconciliation
  • Refs and the DOM
  • Render Props
  • Static Type Checking
  • Strict Mode
  • Typechecking With PropTypes
  • Uncontrolled Components
  • Web Components

FAQ

  • APIs and AJAX
  • Babel, JSX, and Build Steps
  • Passing Functions to Components
  • Component State
  • Styling and CSS
  • File Structure
  • 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
  • CodeExample
  • ErrorDecoder
  • LayoutFooter
  • LayoutHeader
  • MarkdownPage

Additional Translations

These are not the primary translation targets.

  • Blog
  • Community

Discussing glossary and style guide on translation

Обсуждаем здесь любые вопросы, пожелания и предложения, связанные с руководством по переводу, включая перевод терминов и слов.

Терминология: child

child components – дочерние компоненты
child – дочерний компонент
children – дочерние компоненты

child components – чайлд-компоненты
child – чайлд
children – чайлды

Кажется, лучше в любом случае писать длинно.

Написание названий технологий, продуктов и т.д.

В #97 заметил что названия продуктов, технологий и прочего пишется по-русски:

Jest -> Джест
Facebook -> Фейсбук
JavaScript -> Джаваскрипт

Я в целом против этого, в документации это вредно, но хочется узнать мнение других участников, и зафиксировать решение в местном руководстве.

Терминология: Refs forwarding

Есть варианты перевода: перенаправление, проброс, передача. Мне больше нравится перенаправление по аналогии с Port Forwarding.

Терминология: folder

Папка, а может быть директория? Может, это очевидно, но нравится последний вариант, но хотелось услышать другие мнения.

Russian Translation Final Steps!

Congrats! We're almost done translating the React docs to Russian!

A couple more things to do before we can mark this translation as complete:

  • Replace "reactjs.org" to "ru.reactjs.org" in the following places:
    • package.json
    • site-constants.js
    • gatsby-config.js
    • MarkdownPage (the link href in "Edit this page")
  • Change html.js to have the attribute lang="ru"
  • Go over each section in the site to:
    • Make sure there are no formatting errors (dangling markdown/html tags) or untranslated English
    • Make sure the sections and style are consistent.
  • Change the DocSearch API key. One of the maintainers needs to sign up for DocSearch

Терминология и вычитка: бандлер/сборщик

В ряде переводов bundler переведён в двух различных вариантах: бандлер и сборщик.

Надо:

  1. Определиться с одним вариантом;
  2. Enforce этот вариант в незакрытых PR;
  3. Вычитать уже переведённые страницы (full text search в помощь) и исправить, где требуется.

Плагины Gatsby (кавычки-ёлочки и проч.)

У нас включен плагин Gatsby, который автоматически конвертирует "" в “” и - в — где надо. Но он не знает про кириллицу и не в курсе, что надо ставить ёлочки. Надо его научить.

Russian Translation Progress

Текущий список мейнтейнеров

Если у вас есть время и желание, и вы уже участвуете в развитии проекта, то можете создать пулреквест с добавлением своего логина в список мейнтейнеров в этом репозитории.


Как помочь с переводом

Вы можете перевести страницу из документации! Это делается в три шага:

  1. Проверьте, что её никто не застолбил в чеклисте или комментариях под ним (они не сразу отражаются в чеклисте)
  2. Напишите, какую страницу вы ходите перевести. Пожалуйста, не берите больше одной страницы за раз.
  3. Когда страница готова, отредактируйте ваш комментарий, чтобы добавить номер пулреквеста.

Прежде чем переводить, обязательно прочитайте местные правила перевода!

Пожалуйста, не тяните с переводами! Если у вас не получается или нет времени, отпишитесь, чтобы кто-то другой мог подхватить эту страницу.

For maintainers

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

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.

Basics

API Reference

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
  • docs/nav.yml

Next Steps

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

Installation

Hooks

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

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.

Advanced Guides

FAQ

Contributing

Priority: Low

Components

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

  • CodeEditor
  • CodeExample
  • ErrorDecoder
  • LayoutFooter
  • LayoutHeader
  • MarkdownPage

Additional Translations

These are not the primary translation targets.

  • Blog
  • Community

Use squash for merging

Как на счет squash при мерже PR . ? чтобы держать историю чистой

Try it on Codepen

Будем переводить текст этой ссылки?

Терминология: Contibuting

Выражения из Codebase Overview, но встречаются и в других главах из CONTRIBUTING.

Codebase - код (не могу придумать, как вставить сюда base, чтобы не получилось длинное словосочетание);
(to) contribute - участвовать в разработке (внести вклад еще переводят, но мне больше первый вариант нравится, к тому же это в документации, а не в меню).

Терминология: helper

В контексте:

помощник мемоизации
хелпер мемоизации
утилита мемоизации
помощник для мемоизации
хелпер для мемоизации
утилита для мемоизации

Перевод блога

  • "React v16.13.0"
  • "Building Great User Experiences with Concurrent Mode and Suspense"
  • "Preparing for the Future with React Prereleases"
  • "Introducing the New React DevTools"
  • "React v16.9.0 and the Roadmap Update"
  • "Is React Translated Yet? ¡Sí! Sim! はい!" @lyskos97 #409
  • "React v16.8: The One With Hooks" ✏️ @vvscode
  • "React v16.7: No, This Is Not the One With Hooks"✏️ @arsts
  • "React 16.x Roadmap"
  • "React Conf recap: Hooks, Suspense, and Concurrent Rendering" @lyskos97 #412
  • "React v16.6.0: lazy, memo and contextType" @lyskos97 #418
  • "Create React App 2.0: Babel 7, Sass, and More"
  • "Introducing the React Profiler"
  • "React v16.4.2: Server-side vulnerability fix"
  • "You Probably Don't Need Derived State"
  • "React v16.4.0: Pointer Events"
  • "React v16.3.0: New lifecycles and context API"
  • Update on Async Rendering
  • "Sneak Peek: Beyond React 16"
  • "Behind the Scenes: Improving the Repository Infrastructure"
  • "Introducing the React RFC Process"
  • "React v16.2.0: Improved Support for Fragments"
  • "React v16.0"
  • "React v15.6.2"
  • 'title',
  • "DOM Attributes in React 16"
  • "Error Handling in React 16"
  • "React v15.6.0"
  • "What's New in Create React App"
  • "React v15.5.0"
  • "React v15.4.0"
  • "Our First 50,000 Stars"
  • "Relay: State of the State"
  • "Create Apps with No Configuration"
  • "Mixins Considered Harmful"
  • "Introducing React's Error Code System"
  • "React v15.0.1"
  • "React v15.0"
  • "React v0.14.8"
  • "React v15.0 Release Candidate 2"
  • "React v15.0 Release Candidate"
  • "New Versioning Scheme"
  • "Discontinuing IE 8 Support in React DOM"
  • "(A => B) !=> (B => A)"
  • "React v0.14.4"
  • "React Components, Elements, and Instances"
  • "isMounted is an Antipattern"
  • React.js Conf 2016 Diversity Scholarship
  • "React v0.14.3"
  • "React v0.14.2"
  • "React v0.14.1"
  • "Reactiflux is moving to Discord"
  • "React v0.14"
  • "ReactDOM.render and the Top Level React API"
  • "Community Round-up #27 – Relay Edition"
  • "React v0.14 Release Candidate"
  • "New React Developer Tools"
  • "ReactEurope Round-up"
  • "Relay Technical Preview"
  • "New React Devtools Beta"
  • React v0.14 Beta 1
  • "Deprecating JSTransform and react-tools"
  • "React Native Release Process"
  • "React v0.13.3"
  • "GraphQL Introduction"
  • "React v0.13.2"
  • "React Native v0.4"
  • "Community Round-up #26"
  • "Introducing React Native"
  • "Building The Facebook News Feed With Relay"
  • "React v0.13.1"
  • "React v0.13"
  • "Community Round-up #25"
  • "React v0.13 RC2"
  • "Streamlining React Elements"
  • "React v0.13 RC"
  • "Introducing Relay and GraphQL"
  • React.js Conf Round-up 2015
  • React v0.13.0 Beta 1
  • React.js Conf Diversity Scholarship
  • React v0.12.2
  • "Community Round-up #24"
  • React.js Conf Updates
  • React v0.12
  • React.js Conf
  • "Community Round-up #23"
  • "React v0.12 RC"
  • "Introducing React Elements"
  • "Testing Flux Applications"
  • React v0.11.2
  • "Community Round-up #22"
  • "Introducing the JSX Specification"
  • "Community Round-up #21"
  • "Flux: Actions and the Dispatcher"
  • "Community Round-up #20"
  • React v0.11.1
  • React v0.11
  • React v0.11 RC
  • "Community Round-up #19"
  • "One Year of Open-Source React"
  • "Flux: An Application Architecture for React"
  • "Use React and JSX in ASP.NET MVC"
  • The Road to 1.0
  • React v0.10
  • React v0.10 RC
  • "Community Round-up #18"
  • "Community Round-up #17"
  • React v0.9
  • React v0.9 RC
  • "Community Round-up #16"
  • "Community Round-up #15"
  • "Community Round-up #14"
  • "React Chrome Developer Tools"
  • "Community Round-up #13"
  • "Community Round-up #12"
  • "React v0.8"
  • "React v0.5.2, v0.4.2"
  • "Community Round-up #11"
  • "Community Round-up #10"
  • "React v0.5.1"
  • "React v0.5"
  • "Community Round-up #9"
  • "Community Round-up #8"
  • "Community Round-up #7"
  • "Use React and JSX in Python Applications"
  • "Community Round-up #6"
  • "Use React and JSX in Ruby on Rails"
  • "React v0.4.1"
  • "Community Round-up #5"
  • "React v0.4.0"
  • "New in React v0.4: Prop Validation and Default Values"
  • "Community Round-up #4"
  • "New in React v0.4: Autobind by Default"
  • "Community Round-up #3"
  • "React v0.3.3"
  • "Community Round-up #2"
  • "Community Round-up #1"
  • Why did we build React?
  • JSFiddle Integration

Терминология: phase

The render phase
(фаза, этап, стадия) рендера

clean up phase
(фаза, этап, стадия) сброса

The commit phase
(фаза, этап, стадия) (фиксирования, применения, правки, коммита)

Плашка в страницах про Хуки

Все 🇺🇸/🇬🇧 страницы про Хуки содержат плашку, которая должна быть переведена одинаково на 🇷🇺.

У нас уже есть две конкурирующие версии в пулл реквестах. Надо определиться и использовать один и тот же вариант.

#84 :

Хуки это новое дополнение в React 16.8. Они позволяют вам использовать состояние и другие возможности React без написания классов.

#86 :

Хуки появились в React 16.8. Они позволяют использовать состояние и другие возможности React без необходимости создавать класс.

Или так:

Хуки появились в React 16.8. Они позволяют использовать состояние и другие возможности React без написания классов.

Терминология: Codebase

Codebase - код (не могу придумать, как вставить сюда base, чтобы не получилось длинное словосочетание);

#154

Код на CodePen

В issue #24 было решено, как перевести текст ссылки, ведущей на CodePen.

У меня возник вопрос, оставляем ли мы сам код на CodePen как есть (с английскими комментариями) или же клонируем код и исправляем комментарии на русский в точном соответствии с кодом в документации (вряд ли овчинка стоит выделки)?

possible translation mistakes

Ребята всем привет. Я перевожу React на армянский. Сегодня во время перевода очередной статьи, я наткнулся на одно "нестандартное" предложение. Хотел узнать как вы его перевели, посмотрел ваш вариант, и он по-моему не очень правильный. Речь об этой (RUS/ENG) статье, и про это предложение:

  • ENG - We will later add the timer code back to the component itself
  • RUS - Позже мы вернём код таймера обратно в компонент

Попробую объяснить: в оригинале имеется ввиду, что был код таймера,

function tick() {
  const element = (
    <div>
      <h1>Привет, мир!</h1>
      <h2>Сейчас {new Date().toLocaleTimeString()}.</h2>
    </div>
  );
  ReactDOM.render(
    element,
    document.getElementById('root')
  );
}

setInterval(tick, 1000); // <-------------- ВОТ ОНО

мы удалили его после кaких-то изменений.

class Clock extends React.Component {
  constructor(props) {
    super(props);
    this.state = {date: new Date()};
  }

  render() {
    return (
      <div>
        <h1>Hello, world!</h1>
        <h2>It is {this.state.date.toLocaleTimeString()}.</h2>
      </div>
    );
  }
}

ReactDOM.render(
  <Clock />,
  document.getElementById('root')
);

// ЕГО БОЛЬШЕ НЕТ :(

Потом мы вернем его обратно, но в этот раз поместим это в компонент.

class Clock extends React.Component {
  constructor(props) {
    super(props);
    this.state = {date: new Date()};
  }

  componentDidMount() {
    this.timerID = setInterval( // <-------------- ВОТ ОНО
      () => this.tick(),
      1000
    );
  }

  ...

Вы написали "Позже мы вернём код таймера обратно в компонент". Так, хочу сказать что не "обратно в компонент", он в компоненте и не был. Касательно "обратного" автор имеет ввиду "вернём обратно", но не "обратно в компонент".

Мой вариант, который я
написал в армянском переводе, на русском будет как-то так: "Позже мы вернём код таймера обратно и положим в компонент" или можно еще так "Позже мы вернём код таймера обратно: на этот раз в сам компонент".

Терминология: populate = заполнить?

populate local state

  • Заполнить внутреннее состояние?
  • Задать внутреннее состояние?
  • Обновить внутреннее состояние?

Просто "Заполнить внутреннее состояние" звучит как то странно.

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.