## Рекомендації щодо перекладу

- Переклад не обов’яково повинен бути дослівним. Він повинен бути без помилок, правильним і **зрозумілим**.
- Якщо ви бачите, що англійську версію можна вдосконалити — чудово, будь ласка, надішліть PR із правками.

> **Важливо!**
>
> Будь ласка, зберігайте перенесення рядків (пусті рядки) і структуру абзаців "як є": не додавайте нові рядки і не видаляйте існуючі. Це полегшує об’єднання майбутніх змін в англійській версії з цим перекладом.

### Текст в блоках коду

- Перекладайте коментарі до коду.
- Перекладайте повідомлення користувачів і тестові рядки.
- Не перекладайте змінні, класи, ідентифікатори.
- Переконайтеся, що код працює після перекладу :)

Наприклад:

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

✅ Перекладіть коментар і рядок:

```js
// Приклад
const text = 'Привіт, світ';
document.querySelector('.hello').innerHTML = text;
```

❌ Не перекладайте назву класу:

```js
// Приклад
const text = 'Привіт, світ';
// ".hello" це клас
// НЕ ПЕРЕКЛАДАЙТЕ ТАК
document.querySelector('.привіт').innerHTML = text;
```

### Внутрішні посилання

Якщо в перекладі потрібно згадати певний розділ, який є в перекладі, можна використати синтаксис `<info:object>`, де `object` -- це частина URL-адреси цього розділу.
На сайті, цей синтаксис буде замінено на посилання на розділ "Об’єкти".

### Зовнішні посилання

Якщо зовнішнє посилання на Вікіпедію має відповідну українську версію, і ця версія містить досить повну інформацію, в такому випадку варто вказати посилання на українську версію.

Наприклад:

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

✅ Можна замінити на українську версію статті:

```md
[JavaScript](https://uk.wikipedia.org/wiki/JavaScript) це прототипна мова програмування.
```

Якщо посилання на українську версію містить кодовані букви (`https://uk.wikipedia.org/wiki/V8_(%D1%80%D1%83%D1%88%D1%96%D0%B9_JavaScript`), їх слід замінити на українські букви (`https://uk.wikipedia.org/wiki/V8_(рушій_JavaScript)`).

Для статтей на MDN, які частково перекладені на українську мову, також можна вказати посилання на українську версію.

Якщо така стаття немає перекладеної версії, залишайте посилання "як є".

### Метадані

Деякі файли, особливо завдання, мають зверху метадані в форматі YAML, які розділені `---`:

```md
importance: 5

---
...
```

Будь ласка, не перекладайте "importance", "smart header" та інші метадані:

```md
```smart header="More information"
Interested to see which characters belong to a property?

```smart header="Більше інформації"
Хочете дізнатися, які символи належать властивості?
```

### Зображення (в форматі SVG)

Переклад svg зображень здійснюється за допомогою файлу `images.yml`, який розташований в корені репозиторію.

Прочитайте про генерацію перекладу [тут](https://github.com/javascript-tutorial/server#translating-images).

Після генерації перекладу, потрібно відкорегувати розташування перекладеного тексту в svg файлі.
Для цього потрібно змінювати атрибути `x` та `y` для тега `<tspan>` безпосередньо в svg файлі. Значення `x` та `y` повинні бути цілим числом (також можуть бути від’ємними).

Щоб змінювати розмір тексту потрібно редагувати атрибут `font-size="14"` для тега `<text>`.

### Ще декілька дрібниць :)

- Слово "_ви_" і його відмінки пишіть з маленької літери.
- Не знаєте, як перекласти термін? [Словник «Веб-стандартів»](https://github.com/web-standards-ru/dictionary/blob/master/dictionary.md) допоможе (російською мовою)!
- Назви компаній (Google), бібліотек (Jest) і абревіатури (DOM) не перекладаються.
- Апостроф потрібно писати одинарною лапкою `'`, а не знаком `’`.
- Власні назви перекладайте на український лад: `let userName = "John"` => `let userName = "Іван"`, `let userName = "Pete"` => `let userName = "Петро"`.

### Глосарій (словник)

Є деякі слова, які викликають сумніви щодо перекладу. Наприклад, слово "application" — це "програма", "додаток" чи "застосунок"?

Щоб зберегти цілісніть перекладу поміж усіма статтями необхідно використовувати однаковий переклад таких слів.

Тому перед перекладом слід ознайомитися із [глосарієм](https://docs.google.com/spreadsheets/d/16tuvd7XaGES81bKLklDXcR2C--GcfJbbMmGE5MzppfI).
В процесі перекладу вам можуть зустрітися й інші неоднозначні слова. В такому випадку – сміливо додавайте свій варіант в це [обговорення](https://github.com/javascript-tutorial/uk.javascript.info/issues/8).