Skip to content

Latest commit

 

History

History
102 lines (72 loc) · 5.84 KB

TRANSLATION.md

File metadata and controls

102 lines (72 loc) · 5.84 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 Точка останова
Comparison Операция сравнения (а не сравнивания)
Construct Конструкция (switch называется то конструкцией, то оператором. Как правильно?)
Conversion Конвертирование (а не конвертация)
Expression Выражение
Function expression Функциональное выражение
JavaScript vs Javascript
Left click/right click Левый/правый щелчок/клик? Пример: кликните/щёлкните? левой кнопкой мыши
More in / Details in Подробнее / Подробности?
Script Скрипт (а не сценарий)
Statement Инструкция (оператор?)
Summary Итого

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

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