Ukrainian translation. Intro and building blocks. (#374)

docs/uk/manuals/building-blocks.md

@@ -0,0 +1,116 @@
+---
+title: Будівельні блоки Defold
+brief: Цей посібник вникає в деталі ігрових обʼєктів, компонентів та колецкцій.
+---
+
+# Будівельні блоки
+
+В центрі архітектури Defold знаходяться кілька дуже важливих концепцій. Цей посібник пояснює з яких блоків складається Defold. Після того як прочитаєте цей посібник, переходьте до [посібника по адресації](/manuals/addressing) та [надсиланню повідомлень](/manuals/message-passing). А в редакторі є набір [уроків](/tutorials/getting-started) для швидкого старту.
+
+![Будівельні блоки](images/building_blocks/building_blocks.png){srcset="images/building_blocks/[email protected] 2x"}
+
+Defold гра складається з блоків трьох головних типів:
+
+Колекція (collection)
+: Колекція - це файл, який використовується для структуризації вашої гри. В колекціях ви складаєте ієрархію з ігрових обʼєктів та інших колекцій. Зазвичай колекції використовують для створення структури ігрових рівнів, груп ворогів або персонажів, які складаються з декількох ігрових обʼєктів.
+
+Ігровий обʼєкт (game object)
+: Ігровий обʼєкт - це контейнер, що має ідентифікатор, позицію, поворот, та масштаб. Він містить в собі компоненти. Зазвичай ігрові обʼєкти використовуються для створення персонажів гравців, куль, систем ігрових правил, завантажувачів або розвантажувачів рівнів, тощо.
+
+Компонент (component)
+: Компоненти - це сутності, які можна додати до ігрових обʼєктів щоб надати їм графіку, звук або логіку в грі. Зазвичай вони використовуються щоб створювати спрайти (sprites) персонажів, файли сценаріїв, додавати звукові ефекти та частинки.
+
+## Колекції (collections)
+
+Колекції - це деревоподібні структури, які містять в собі ігрові обʼєкти та інші колекції. Вони завжди зберігаються у файлах.
+
+Коли Defold двигун стартує, він завантажує єдину _стартову колекцію (bootstrap collection)_, яка вказана в файлі налаштувань проєкту *game.project*. Стартова колекція зазвичай називається "main.collection", але ви можете переіменувати її як завгодно.
+
+Колекція може містити ігрові обʼєкти та інші колекції (через посилання на файл підколекції), скомпоновані як завгодно. Ось наприклад файл "main.collection". Він містить один ігровий обʼєкт (з ідентифікатором "can") та одну підколекію (з ідентифікатором "bean"). В свою чергу, підколекція містить два ігрові обʼєкти: "bean" та "shield".
+
+![Колекція](images/building_blocks/collection.png){srcset="images/building_blocks/[email protected] 2x"}
+
+Зверніть увагу, підколекція "bean" зберігається в своєму окремому файлі під назвою "/main/bean.collection" а "main.collection" на неї лише посилається:
+
+![Колекція Bean](images/building_blocks/bean_collection.png){srcset="images/building_blocks/[email protected] 2x"}
+
+Самі колекції не можна адресувати, тому що під час виконання не існує обʼєктів, відповідних колекціям "main" та "bean". Однак, іноді вам доведеться використовувати ідентифікатор колекції як частину _шляху_ до ігрового обʼєкту (див. [посібник з адресації](/manuals/addressing)):
+
+```lua
+-- file: can.script
+-- get position of the "bean" game object in the "bean" collection
+local pos = go.get_position("bean/bean")
+```
+
+Колекція завжди додається до іншої колекції як посилання на файл:
+
+Клацніть <kbd>правою кнопкою</kbd> на колекцію в вікні *Структура (Outline)* та оберіть <kbd>Add Collection File</kbd>.
+
+## Ігрові обʼєкти (Game Objects)
+
+Ігрові обʼєкти - це прості обʼєкти, кожен із своїм життєвим циклом під час виконання гри. В них є позиція, поворот та масштаб (position, rotation, scale), які можна змінювати та анімувати під час виконання.
+
+```lua
+-- animate X position of "can" game object
+go.animate("can", "position.x", go.PLAYBACK_LOOP_PINGPONG, 100, go.EASING_LINEAR, 1.0)
+```
+
+Ігрові обʼєкти можна використовувати пустими (наприклад як маркери позиції), але зазвичай до них додаються різномаїтні компоненти: спрайти, звуки, сценарії, моделі, фабрики, та інші. Ігрові обʼєкти створюються в редакторі, додаються до колекцій, або генеруються динамічно під час виконання за допомогою компонентів _фабрик (factory)_.
+
+Ігрові обʼєкти додаються до колекції на місці, або як посилання на файл ігрового обʼєкту:
+
+Клацніть <kbd>правою кнопкою</kbd> на колекції в вікні *Структура (Outline)* та оберіть <kbd>Add Game Object</kbd> (додати на місці) або <kbd>Add Game Object File</kbd> (додати як посилання на файл).
+
+
+## Компоненти (Components)
+
+:[компоненти](../shared/components.md)
+
+Див. [огляд компонентів](/manuals/components/) із переліком всіх доступних типів компонентів.
+
+## Додавання обʼєктів на місці (in-place) або за посиланням (by reference)
+
+Коли ви створюєте _файл_ колекції, ігрового обʼєкту або компоненту, ви створюєте так званий прототип (також відомий як "prefab" або "blueprint" в інших двигунах). Такий файл лише додається до структури проєкту, нічого не буде додано до вашої гри під час виконання. Для того щоб створити екземпляр(instance) колекції, ігрового обʼєкту або компоненту, його потрібно додати до файлу колекції.
+
+Ви можете побачити файл, із якого створюється екземпляр, у вікні структури (outline). Файл "main.collection" містить три єкземпляри, що засновані на цих файлах:
+
+1. Підколекція "bean".
+2. Компонент-сценарій "bean", в ігровому обʼєкті "bean", в підколекції "bean".
+3. Компонент-сценарій "can", в ігровому обʼєкті "can" .
+
+![Екземпляр](images/building_blocks/instance.png){srcset="images/building_blocks/[email protected] 2x"}
+
+Користь від створення файлів-прототипів стає очевидною коли ви маєте кілька екземплярів ігрового обʼєкту або колекції та бажаєте міняти їх всіх одразу:
+
+![Екземпляри ІО](images/building_blocks/go_instance.png){srcset="images/building_blocks/[email protected] 2x"}
+
+Після змін в файлі-прототипі, всі екземпляри, що використовують такий файл, будуть одразу ж оновлені.
+
+![Зміна прототипу ІО](images/building_blocks/go_change_blueprint.png){srcset="images/building_blocks/[email protected] 2x"}
+
+Наприклад тут зображення спрайту було змінене в прототипі, і негайно всі екземпляри оновились:
+
+![Оновлені екземпляри ІО](images/building_blocks/go_instance2.png){srcset="images/building_blocks/[email protected] 2x"}
+
+## Дочірні ігрові обʼєкти (childing)
+
+У файлі колекції ви можете будувати ієрархії ігрових обʼєктів таким чином, щоб один або більше ігрових обʼєктів ставали дочірніми в межах одного батьківського обʼєкта. Просто <kbd>перетягніть</kbd> один обʼєкт на інший, і перетягнутий обʼєкт стане дочірнім:
+
+![Дочірні ігрові обʼєкти](images/building_blocks/childing.png){srcset="images/building_blocks/[email protected] 2x"}
+
+Ієрархія дочірніх обʼєктів - це динамічні відносини, вони впливають на те як обʼєкти реагують на трансформації. Будь-яка трансформація обʼєкту (пересування, поворот або масштаб) буде в свою чергу застосована до дочірнії обʼєктів, як у редакторі, так і під час виконання:
+
+![Дочірня трансформація](images/building_blocks/child_transform.png){srcset="images/building_blocks/[email protected] 2x"}
+
+І навпаки, трансформації дочірнії обʼєктів виконуються в локальному просторі батьківського обʼєкта. В редакторі ви можете обирати чи редагувати обʼєкт в батьківскьому просторі, чи в глобальному, обравши <kbd>Edit ▸ World Space</kbd> (за замовчуванням) або <kbd>Edit ▸ Local Space</kbd>.
+
+Також, батька можна змінити під час виконання відправивши повідомлення `set_parent` обʼєкту.
+
+```lua
+local parent = go.get_id("bean")
+msg.post("child_bean", "set_parent", { parent_id = parent })
+```
+
+::: important
+Поширене непорозуміння що місце обʼєкта в колекції змінюється коли він стає частиною батьківських-дочірніх відносин. Однак, це різні речі. Ієрархія дочірніх обʼєктів динамічно змінює граф сцени, що дозволяю обʼєктам візуально приєднуватися одне до одного. Єдине, від чого залежить адрес обʼєкту, це його місце в ієрархії колекцій. Адрес залишиться статичним на весь час існування обʼєкту.
+:::

docs/uk/manuals/introduction.md

@@ -0,0 +1,36 @@
+---
+title: Вступ до Defold
+brief: Короткий вступ до Defold.
+---
+
+# Ласкаво просимо в Defold
+
+Defold це рішення під ключ, яке надасть вам все що треба для дизайну, побудови та випуску ігор. Повний перелік підтримуваних можливостей можна подивитися в нашому [огляді продукта](/product).
+
+Ми витратили багато зусиль та часу, щоб переконатися що всі ключові елементи процесу розробки ігор були якомога плавними та легкими, і ми віримо що це виділяє Defold серед інших. Дізнайтеся [чому ми вважаемо, що вам варто використовувати Defold, тут](/why).
+
+## З чого почати?
+
+Ми заохочуємо вам експериментувати, виконувати інструкції, читати наш посібник та документацію API, приймати участь на форумі щоб навчатися в інших та слідкувати за розвитком Defold. Документації багато, у формі посібника, API довідника, прикладів та інструкцій. Якщо не знаєте де почати, ось кілька рекомендацій:
+
+#### Редактор
+![Огляд редактору](images/introduction/editor.png){.left} [Огляд редактору](/manuals/editor/) познайомить із додатком-редактором, допоможе зорієнтуватися в графічному інтерфейсі, пояснить як використовувати графічні інструменти та писати код. Якщо ви знайомі із 3D редакторами та вмієтете користуватись IDE, то сюрпризів буде небашато. Але завжди знайдуться відмінності від ваших улюбленних додатків.
+
+#### Прості приклади
+![Приклади](images/introduction/examples.jpg){.left} [Наша колекція простих прикладів](/examples/) допоможе розібратися як скласти із дрібних частин щось, що буде працювати. Ви знайдете невеликі приклади рішення різноманітих повсякденних задач у Defold.
+
+#### Мова Lua
+![Огляд Lua](images/introduction/lua.png){.left} [Defold використовує Lua](/manuals/lua/) для виконання всієї логіки. Двигун - швидкий механізм, написаний на C++, але на високому рівні він контролюється Lua сценаріями. Якщо ви раніше використовували Python, Javascript або іншу високорівневу мову, вам не складе труднощів зрозуміти Lua та слідувати інструкціям та урокам. В іншому випадку прочитайте наш our Lua посібник.
+
+#### Уроки
+![Уроки](images/introduction/tutorials.jpg){.left} Ми віримо що люди навчаються найкраще, роблячи. Тому прямо [в редакторі](/manuals/editor/) є набір уроків різної складності. Запускайте додаток та пройдіть один чи два уроки щоб розібратися як будувати проєкти та як працює Defold.
+
+#### Будівельні блоки Defold
+![Будівельні блоки](images/introduction/building_blocks.png){.left} [Defold ігри будуються компонуванням простих блоків](/manuals/building-blocks/), деякі з них здадуться знайомими якщо ви вже користувался іншими двигунами. Через деякі архітектурні рішення, Defold компоненти можуть здаватися незвичайними і вам знадобиться час щоб звикнути до них. Почніть з посібника по будівелним блокам, якщо вважаєте що вам потрібно ретельно розібратися як вони працюють.
+
+#### Форум
+![Форум](images/introduction/forum.jpg){.left} [Навчання в інших](//forum.defold.com/) часто буде найкращим засобом вчитися. Наша спільнота дуже доброзичлива, має багато досвіду у будуванні ігор, зокрема за допомогою Defold. Якщо у вас виникнуть труднощі, не зволікайте та прямуйте на форум за допомогою!
+
+Памʼятайте, що який би шлях вивчання Defold ви б не обрали, ви завжди можете повернутися сюди та отримати ретельне пояснення різних функцій та концепцій Defold. Та не зволікайте вказувати на те, що не розумієте або вважаєте невірним. Ці сторінки для вас, і ми хочемо зробити їх якомога краще.
+
+Сподіваємося що вам сподобається створювати вашу наступну круту ігру разом із Defold!

docs/uk/shared/components.md

@@ -0,0 +1,24 @@
+Компоненти надають виразливості та функціональності ігровим обʼєктам. Вони мають міститися всередині ігрових обʼєктів. Позиція, поворот та масштаб ігрового обʼєкту впливають на його компоненти:
+
+![Компоненти](../shared/images/components.png){srcset="../shared/images/[email protected] 2x"}
+
+Багато компонентів мають властивості, які можна змінювати. Під час виконання можна викликати спеціфічні для компонентів функції:
+
+```lua
+-- disable the can "body" sprite
+msg.post("can#body", "disable")
+
+-- play "hoohoo" sound on "bean" in 1 second
+sound.play("bean#hoohoo", { delay = 1, gain = 0.5 } )
+```
+
+Компоненти додаються до ігрового обʼєкта на місці (in-place), або через посилання на файл:
+
+Клацніть <kbd>правою кнопкою</kbd> на ігровий обʼєкт у вікні *Структура (Outline)* та оберіть <kbd>Add Component</kbd> (додати на місці) або <kbd>Add Component File</kbd> (додати посилання на файл).
+
+Є сенс додавати більшість компонентів прямо на місці, але наступні компоненти мають бути створені в окремих файлах перш ніж бути доданими до ігрового обʼєкту:
+
+* Сценарій (Script)
+* Графічний інтерфейс (GUI)
+* Частинки (Particle FX)
+* Карта тайлів (Tile Map)