В цьому репозиторії зберігається переклад посібника https://uk.javascript.info з англійської на українську мову.
20 січня 2022 р. було опубліковано першу українську версію посібника, яка містила більше половини перекладених статей. Завдяки багатьом небайдужим людям та кураторам, 18 березня 2024 р. завершено переклад усіх статей та розділів посібника 🎉
JavaScript — популярна мова програмування, яка постійно розвивається. Так само і посібник та його переклад українською регулярно оновлюються та вдосконалюються.
Ми запрошуємо переглянути цей переклад "свіжим оком" і запропонувати покращення, виправити помилки чи неточності. Будь-яка допомога, навіть найменша, вітається і буде відзначена (шляхом додавання користувача до списку подяки).
Як ви можете допомогти:
- Перегляньте обговорення Translation review.
- Виберіть статтю, яку хочете перевірити. Пріоритет надається статтям, які ще не позначені галочкою, але ви можете обрати будь-яку, яка вам до вподоби.
- Додайте коментар до обговорення з назвою статті, яку ви збираєтеся перевірити.
- Відгалужте репозиторій (тут детально описано як це зробити), внесіть корективи до статті і після завершення надішліть запит на злиття (Pull request). Назву запиту можна вказати як "Review: [назва статті]". Переконайтеся, що вона збігається з назвою статті, яку ви перевіряли. Зверніть увагу, що деякі статті містять додаткові файли із завданнями, ілюстраціями тощо. Якщо ви вносили зміни до JavaScript коду, обов'язково протестуйте його.
Якщо у вас виникли питання чи пропозиції щодо перекладу, ви можете створити обговорення (Issue) або залишити коментар у головному обговоренні: Ukrainian Translation Progress.
Ви можете редагувати текст у будь-якому редакторі, або навіть на сайті GitHub (кнопка "Edit this file"). Посібник використовує розмітку Markdown, яку легко зрозуміти. Якщо ви хочете побачити, як ваші зміни виглядатимуть на сайті, скористайтеся сервером для локального запуску посібника.
Обов'язково ознайомтеся з рекомендаціями щодо перекладу!
Коли переклад або виправлення буде опубліковано, ваше ім'я та внесок з'являться в списку подяки нижче.
Якщо ви хочете стати куратором (maintainer), отримати доступ до репозиторію та переглядати правки інших, повідомте про свій намір у цьому обговоренні.
P.S. Весь перелік мов і прогрес перекладу посібника можна знайти на сторінці https://javascript.info/translate.
Кожен розділ, підрозділ, стаття чи завдання має власну папку.
Папки мають формат N-url
, де N
— номер для сортування (папки впорядковані за цим номером), а url
— частина URL-адреси на сайті, що відповідає заголовку матеріалу.
Папка може містити такі файли:
index.md
— для розділів;article.md
— для статей;task.md
— для формулювання завдання (а такожsolution.md
для тексту вирішення завдання).
Кожен файл починається із # Заголовок
, далі йде текст у форматі Markdown, який легко редагувати в звичайному текстовому редакторі.
Додаткові ресурси та приклади до статей або завдань також розміщуються в цій папці.
Ви можете запустити посібник локально на комп'ютері, щоб відразу бачити зміни на сайті. Сервер для локального запуску знаходиться тут: https://github.com/javascript-tutorial/server.
Щира подяка цим людям за їхній внесок у розвиток проєкту 💙💛
Ми будемо вдячні за будь-які ваші внески і будемо раді бачити ваші імена в цьому списку!
Цей список згенеровано за допомогою специфікації All Contributors. Детальніше про позначення в списку описано тут.
♥
Ilya Kantor @iliakan
Stanislav Dolgachov @dolgachio
Taras Korzhak @tarasyyyk