Skip to content

Latest commit

 

History

History
101 lines (72 loc) · 5.45 KB

TRANSLATION.md

File metadata and controls

101 lines (72 loc) · 5.45 KB
Raw

Перевод

Перевод не обязательно должен быть слово-в-слово.

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

Если вы видите, что исходный текст может быть улучшен – отлично, пришлите, пожалуйста, PR.

Важно!

Сохраняйте переносы строк (пустые строки) и структуру абзацев «как есть»: это упрощает объединение будущих изменений из английской версии в перевод.

Текст в коде

  • Комментарии в коде – переводить.
  • Строки в примерах – можно переводить, но не обязательно.
  • Названия переменных, классы, идентификаторы – не надо переводить.

Например:

// Example
const text = "Hello, world";
document.querySelector('.hello').innerHTML = text;

✅ ХОРОШО (переведён комментарий):

// Пример
const text = 'Hello, world';
document.querySelector('.hello').innerHTML = text;

✅ ТОЖЕ ОК (переведён комментарий и текст):

// Пример
const text = 'Привет, мир';
document.querySelector('.hello').innerHTML = text;

Внешние ссылки

Если есть внешняя ссылка на MDN или Wikipedia, например https://en.wikipedia.org/wiki/JavaScript, но есть версия этой же статьи на русском, поменяйте ссылку.

Например:

[JavaScript](https://en.wikipedia.org/wiki/JavaScript) is a programming language.

✅ ПОСЛЕ ЗАМЕНЫ (en -> ru):

[JavaScript](https://ru.wikipedia.org/wiki/JavaScript) – это язык программирования.

Если статья на MDN переведена частично, это тоже подходит.

В случае, если у ссылки нет эквивалента на русском, оставьте её как есть.

И ещё пара деталей :)

  • Вы и его производные пишите с маленькой буквы
  • Используйте букву ё (этот npm-пакет может проверить текст и вставить её, где нужно)
  • Не знаете, как перевести термин? Словарь «Веб-стандартов» поможет!
  • Названия компаний (Google), библиотек (Jest) и аббревиатуры (DOM) не переводятся.
  • importance: n встречающееся в начале задач - служебное поле, перевод не требуется.

Соглашение по переводу (глоссарий)

Пожалуйста, поддерживайте глоссарий в алфавитном порядке.

Оригинальный термин Перевод
Arrow function Стрелочная функция
Backtick Обратная кавычка
Bitwise operator Побитовый оператор
Breakpoint Точка останова
Character class Символьный класс
Comparison Операция сравнения
Construct Конструкция
Conversion Конвертирование
Functionality Функциональность
Left click/right click Левый/правый клик? Кликните? левой кнопкой мыши
More in / Details in Подробнее в
Nullish coalescing operator Оператор нулевого слияния
Script Скрипт
Statement Инструкция
Summary Итого

Ресурсы по переводу

Чтобы улучшить ваш перевод и, вообще, письмо, полезные статьи: