В цьому репозиторію зберігається переклад посібника https://uk.javascript.info з англійської на українську мову.
Завдяки багатьом небайдужим людям було перекладено більше половини всіх статей, що дозволило 20 січня 2022 р. опублікувати українську версію посібника в Інтернеті 🎉 Однак в перекладі можуть траплятися помилки, неточності тощо. Тому потрібні люди, які можуть прочитати переклад "незамиленим оком" і запропонувати покращення.
Відповідно, є два способи допомогти цьому проєкту: виправлення вже існуючого перекладу або переклад нових статей.
Ми хочемо, щоб інші люди також робили свій вклад в цей посібник. Саме тому будь-яка допомога тільки вітається і нагороджується (шляхом додавання користувача у список подяки).
Ось як ви можете допомогти в перекладі статей:
- Перегляньте перше обговорення: Ukrainian Translation Progress.
- Виберіть статтю, яку хочете перекласти. Вибирайте з тих статей, які ще не відмічені і не перекладаються.
- До того самого обговорення додайте коментар з назвою статті, яку збираєтеся перекладати. Коментар повинен містити лише дослівну назву статті англійською мовою і більше нічого (це робиться для того, щоб бот автоматично закріпив переклад за Вами).
- Створіть копію репозиторію (кнопка "Fork"), перекладіть одну статтю і коли завершите, надішліть запит на злиття (Pull request). Назва запиту має збігатися з назвою статті, яку Ви перекладали. Деякі статті містять додаткові файли із завданнями, ілюстраціями тощо. Їх теж потрібно перекладати.
Якщо виникли питання щодо перекладу, можете створити обговорення (Issue) із назвою перекладу, наприклад: "Translation: Code quality > Debugging in Chrome".
Щось не так? Відсутня тема? Поясніть це людям, створіть запит на злиття (Pull request) 👏
Ви можете редагувати текст у будь-якому редакторі. Посібник використовує розширений "markdown" формат, який легко зрозуміти. І якщо ви хочете побачити, як це виглядає на сайті, є сервер для локального запуску посібника: https://github.com/javascript-tutorial/server.
Щоб допомогти у виправленні перекладених статей потрібно:
- Перегляньте це обговорення.
- Виберіть статтю, яку ще не відмічено.
- Уважно прочитайте цю статтю, протестуйте весь код (якщо такий є).
- Якщо є помилки в перекладі, скопіюйте цей репозиторій (кнопка «Fork»), внесіть зміни і створіть запит на злиття.
- Напишіть в обговоренні назву статті, яку Ви перевіряли (або до якої Ви створили запит на злиття).
Папка називається N-url
, де N
- це число, яке використовується для сортування, а URL
- частина URL-адреси з назвою матеріалу.
🎉 Дякуємо!
Обов’язково ознайомтеся з рекомендаціями щодо перекладу!
Коли переклад або виправлення буде опубліковано, Ваше ім’я та Ваш вклад в переклад з’являться в таблиці подяки нижче.
Якщо Ви хочете стати супроводжуючим (maintainer), мати доступ до репозиторію і переглядати переклади інших, напишіть про свій намір в цьому обговоренні.
Ви можете редагувати текст в будь-якому редакторі. Цей посібник використовує формат "markdown", який легко зрозуміти.
P.S. Весь перелік мов і прогрес перекладу можна знайти на сторінці https://javascript.info/translate.
Кожен розділ, стаття або завдання знаходяться у власних папках.
Папка називається в форматі N-code-editors
, де N
– це номер для сортування (статті впорядковані), і code-editors
це частина URL на сайті.
Перегляньте https://javascript.info/translate для подробиць.
Папка має один з цих файлів:
index.md
якщо це розділ,article.md
якщо стаття,task.md
для формулювання завдання (а такожsolution.md
з текстом вирішення завдання).
Файл починається із # Заголовка
; потім йде текст в форматі Markdown, який легко редагується в звичайному текстовому редакторі.
Додаткові ресурси та приклади до статтей або завдань також розміщуються в одній папці.
Ви можете запустити посібник локально, щоб відразу бачити зміни на сайті. Сервер знаходиться тут: https://github.com/javascript-tutorial/server.
Будемо дуже вдячні за ваш переклад, або додавання чогось нового!
Велика подяка цим людям за їхній вклад в розвиток проєкту (позначення):
Цей проєкт використовує специфікацію all-contributors. Будь-яка допомога до цієї специфікації лише вітається!
♥
Ilya Kantor @iliakan