Skip to content

Latest commit

 

History

History
70 lines (54 loc) · 4.81 KB

TRANSLATION.md

File metadata and controls

70 lines (54 loc) · 4.81 KB

Перевод на русский язык сайта reactjs.org

Текущий прогресс: reactjs#1

Пожалуйста, используйте этот ишью, если вы хотите что-то перевести и узнать.

Общие правила

  • Вы и его производные пишете с маленькой буквы
  • Всегда используйте букву ё
  • Используйте тире вместо дефиса (оно должно быть намного длиннее, чем дефис). Тире: , дефис: -
  • Переводите комментарии в примерах кода, но не содержимое
  • Используйте терминологию словаря «Веб-стандартов», если нет исходного варианта в таблице ниже
  • Ссылки на ресурсы (MDN, Wikipedia) должны вести на русскую версию, если есть соответствующий перевод.
  • Иностранные имена переводите с указанием оригинального имени в скобках: Дэн Абрамов (Dan Abramov). При этом обязательно проверьте уже существующий перевод имени в словаре имён «Веб-стандартов»

Слово живое и мёртвое

Прежде чем переводить, почитайте пару страниц из «Слова живого и мёртвого» Норы Галь. Хотя бы эти две:

По мере возможности, избегайте отглагольных существительных!

  • Деревянно: для открытия
  • Живо: чтобы открыть

Чтобы избежать кальки, можно брать смысл предложения, а потом перефразировать так, как объясняли бы старшему коллеге. Если предложение звучит нелепо вслух, то его надо переписать. Например:

Оригинал: React has been designed from the start for gradual adoption, and you can use as little or as much React as you need.

Мёртвая калька: React был спроектирован с самого начала для постепенного внедрения, и вы можете использовать столько React, сколько вам нужно.

Нормальный перевод: Чтобы внедрить React, не надо ничего переписывать. Его можно использовать как для маленькой кнопки, так и для целого приложения.

Небольшие вольности в переводе допускаются, но только если они помогают передать смысл. Перевод не должен быть ни деревянным, ни фамильярным. Истина где-то посередине.

Соглашение по переводу

Оригинальный термин Перевод
array массив
arrow function стрелочная функция
bug баг, дефект
bundler бандлер
camelCase camelCase
(un)controlled component (не)контролируемый компонент
debugging отладка
error ошибка
debugging отладка
framework фреймворк
functional component функциональный компонент
hook хук
key ключ
lazy initialization ленивая инициализация
library библиотека
lowercase нижний регистр
mock фиктивный
paint перерисовка
props пропсы
reuse повторное использование, переиспользование
React React
React element React-элемент, элемент React
reconciliation согласование
render(ing) in component sense рендер, рендерить, отрендерить, рендеринг
render(ing) in visual sense отрисовать, вывести на экран
ref реф
state состояние
template literals шаблонные строки