Modern JavaScript Tutorial in Ukrainian (JavaScript українською 🇺🇦)
В цьому репозиторію зберігається переклад посібника https://uk.javascript.info з англійської на українську мову.
Завдяки багатьом небайдужим людям було перекладено більше половини всіх статей, що дозволило 20 січня 2022 р. опублікувати українську версію посібника в Інтернеті 🎉 Однак в перекладі можуть траплятися помилки, неточності тощо. Тому потрібні люди, які можуть прочитати переклад "незамиленим оком" і запропонувати покращення.
Відповідно, є два способи допомогти цьому проєкту: виправлення вже існуючого перекладу або переклад нових статей.
Ми хочемо, щоб інші люди також робили свій вклад в цей посібник. Саме тому будь-яка допомога тільки вітається і нагороджується (шляхом додавання користувача у список подяки).
Ось як ви можете допомогти в перекладі статей:
Якщо виникли питання щодо перекладу, можете створити обговорення (Issue) із назвою перекладу, наприклад: "Translation: Code quality > Debugging in Chrome".
Щось не так? Відсутня тема? Поясніть це людям, створіть запит на злиття (Pull request) 👏
Ви можете редагувати текст у будь-якому редакторі. Посібник використовує розширений "markdown" формат, який легко зрозуміти. І якщо ви хочете побачити, як це виглядає на сайті, є сервер для локального запуску посібника: https://github.com/javascript-tutorial/server.
Щоб допомогти у виправленні перекладених статей потрібно:
Папка називається 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