Підручник з KTuberling

# Підручник з KTuberling

Éric Bischoff `<e.bischoff@noos.fr>`

Paul E. Ahlquist, Jr. `<pea@ahlquist.org>`

Eugene Trounev `<eugene.trounev@gmail.com>`

Рецензент: Lauri Watts
Переклад українською: Юрій Чорноіван
версія KDE Gear 21.08 (4 жовтня 2021 року)

Авторське право © 1999, 2000, 2002, 2006 Éric Bischoff

Авторське право © 2001 Paul E. Ahlquist, Jr.

Правова примітка

«Картопляний хлопець» — це гра, яку призначено для маленьких дітей.

Список таблиць

4.1. Кнопки панелі інструментів

Розділ 1. Вступ
Вступ

# Розділ 1. Вступ

Тип гри: Забавка

Кількість можливих гравців: Один

«Картопляний хлопець» — проста гра-конструктор, яку призначено для дітей та дорослих. Ідею гри засновано на колись популярній грі у одягання ляльки. У цій грі картоплину оздоблювали різноманітними невеличкими елементами, щоб зробити її схожою не мініатюрного чоловічка. У грі «Картопляний хлопець» ви матимете набагато ширший вибір у сенсі змісту, крім того можна мати справу з найрізноманітнішими темами гри.

Розділ 2. Як грати
Як грати

# Розділ 2. Як грати

Гру «Картопляний хлопець» призначено для малих дітей. Звичайно ж, у неї можуть грати і дорослі, в душі яких живе мала дитина.

Ця гра — «редактор картоплини». Це означає, що ви можете перетягувати і скидати очі, рот, вуса та інші частини обличчя та одягу на чоловічка, схожого на картоплину. Крім того, ви зможете робити подібні дії із ігровими майданчиками з іншими темами.

У грі немає переможця. Єдиною метою гри є усмішка на обличчі дитини, яка у неї грає.

Крім того, «Картопляний хлопець» може «розмовляти». Програма вимовляє назву об’єкта, який ви перетягуєте і скидаєте. Вона «вимовляє» слова мовою, яку ви можете обрати. Ви навіть можете скористатися нею для вивчення словника іноземної мови.

Розділ 3. Правила і підказки
Правила і підказки

# Розділ 3. Правила і підказки

## Дії за допомогою миші

У головному вікні програми є дві області:

- Область «Ігрового поля».

- У області «Об’єктів» ви можете обирати об’єкти для розташування на ігровому майданчику.

### Примітка

Вигляд програми може бути різним і залежить від обраного ігрового майданчика.

### Як розташувати об’єкт

Щоб перетягнути об’єкт, пересуньте вказівник миші до області «об’єктів», наведіть його на об’єкт і клацніть лівою кнопкою миші. Після цього, пересуньте об’єкт у область «ігрового майданчика» і знову клацніть лівою кнопкою миші.

### Примітка

Під час перетягування розмір об’єктів може змінюватися. Деякі великі об’єкти зменшено так, щоб вони могли вміститися у області об’єктів.

### Пересування об’єкта

Після скидання об’єкта у «ігровий майданчик» цей об’єкт можна пересувати. Просто наведіть вказівник миші на об’єкт, клацніть лівою кнопкою миші, щоб обрати його, перетягніть об’єкт на нове місце і знову клацніть лівою кнопкою миші, щоб скинути його. Після скидання об’єкт знаходитиметься над іншими об’єктами, які могли частково його приховувати. Цей трюк корисний для правильного розташування окулярів та очей.

### Вилучення об’єкта

Щоб вилучити об’єкт, який було скинуто у «ігровий майданчик», перетягніть його назад з «ігрового майданчика» до області «об’єктів».

Розділ 4. Огляд інтерфейсу
Огляд інтерфейсу

# Розділ 4. Огляд інтерфейсу

## Панель інструментів

На панелі інструментів розташовано кнопки для найпоширеніших функцій гри.

Таблиця 4.1. Кнопки панелі інструментів

Кнопка | Назва | Еквівалент у меню | Дія
--- | --- | --- | ---
| Створити | Гра → Створити | Повертає «ігровий майданчик» у початковий стан. Ця дія спорожнює всі частини ігрового майданчика так, щоб можна було створювати нові декорації.
| Завантажити… | Гра → Завантажити… | Відкриває наявний файл гри (`.tuberling`) з диска.
| Зберегти | Гра → Зберегти | Зберігає ваше творіння до вашої домашньої теки або, за вашого бажання, до якоїсь іншої теки на вашому диску. Картина зберігається у вигляді маленького файла `.tuberling`, у якому записано лише розташування об’єктів.
| Надрукувати… | Гра → Друкувати… | Друкує зображення.
| Вернути | Зміни → Вернути | Скасовує останню дію.
| Повторити | Зміни → Повторити | Повторює останню скасовану дію.

Пункти меню
Пункти меню

## Пункти меню

### Меню «Гра»

Гра → Створити (Ctrl+N)

  Спорожнює область «ігрового майданчика».

Гра → Завантажити… (Ctrl+O)

  Відкриває наявний файл гри (`.tuberling`) з вашого диска.

Гра → Зберегти (Ctrl+S)

  Зберігає ваше творіння. Картину буде збережено у вигляді маленького файла, у якому буде зафіксовано лише розташування об’єктів.

Гра → Зберегти як малюнок…

  Створює графічний файл, у якому міститиметься малюнок вашого творіння.

Гра → Друкувати… (Ctrl+P)

  Друкує створене вами зображення.

Гра → Вийти (Ctrl+Q)

  Завершує роботу гри «Картопляний хлопець».

### Меню «Зміни»

Зміни → Вернути (Ctrl+Z)

  Скасовує останнє розміщення «об’єкта».

Зміни → Повторити (Ctrl+Shift+Z)

  Повторює останнє розташування «об’єкта». Цей пункт меню стане активним, лише якщо ви раніше користувалися пунктом меню Вернути.

Зміни → Копіювати (Ctrl+C)

  Копіює «ігровий майданчик» до буфера обміну інформацією.

### Меню «Перегляд»

Параметри → Повноекранний режим (Ctrl+Shift+F)

  Вмикає або вимикає повноекранний режим у графічному інтерфейсі програми.

### Меню «Ігровий майданчик»

Ігровий майданчик → Зберігати співвідношення

  За допомогою цього пункту можна зберігати співвідношення сторін ігрового поля під час зміни розмірів вікна гри «Картопляний хлопець». Якщо співвідношення сторін ігрового поля не збігається зі співвідношенням розмірів вікна, тло буде заповнено відповідно до поточної теми.

Ігровий майданчик → `Назва ігрового майданчика`

  Змінює ігровий майданчик.

Тут містяться ігрові майданчики, які встановлено у вашій системі.

Гра «Картопляний хлопець» запам’ятовує назву останнього ігрового майданчика, де ви грали, і наступного разу відкриває саме цей майданчик.

### Меню «Мовлення»

Мовлення → Без звуку

  Вимикає звукові ефекти гри.

Мовлення → `Назва мови`

  Вмикає звукові ефекти гри обраною мовою.

Гра «Картопляний хлопець» запам’ятовує значення цього параметра і відновлює його під час наступного запуску гри.

### Меню «Параметри» і «Довідка»

Крім того, у грі «Картопляний хлопець» передбачено типові для KDE пункти меню Параметри і Довідка. Щоб дізнатися більше, ознайомтеся з розділами щодо меню «Параметри» та меню «Довідка» підручника з основ роботи у KDE.

Розділ 5. Часті запитання
Часті запитання

# Розділ 5. Часті запитання

5.1. Я хочу змінити вигляд цієї гри. Як це зробити?
5.2. Чи можна використовувати для гри клавіатуру?
5.3. Мені вдалося створити чудовий малюнок, і я хочу поділитися ним зі своїми друзями. Чи можна зберегти малюнок у вигляді файла зображення?

5.1. | Я хочу змінити вигляд цієї гри. Як це зробити?
| Зверніться до цього розділу «Огляду інтерфейсу», щоб дізнатися як це зробити.
5.2. | Чи можна використовувати для гри клавіатуру?
| Ні. У цю гру не можна грати за допомогою клавіатури.
5.3. | Мені вдалося створити чудовий малюнок, і я хочу поділитися ним зі своїми друзями. Чи можна зберегти малюнок у вигляді файла зображення?
| Так. Щоб зберегти поточний сеанс у вигляді зображення, зверніться до цього розділу «Огляду інтерфейсу», щоб дізнатися більше.

Розділ 6. Технічні подробиці
Технічні подробиці

# Розділ 6. Технічні подробиці

Éric Bischoff

Переклад українською: Юрій Чорноіван
версія KDE Gear 21.08 (4 жовтня 2021 року)

За допомогою KTuberling ви можете отримати перший цінний досвід у налаштуванні і програмуванні у KDE. Можливості програми легко розширити. Наприклад, без написання жодних програмних кодів за допомогою лише зміни графічних файлів можна додавати нові ігрові майданчики. Якщо додати до цих файлів відповідні звукові файли, перекладачі зможуть перекласти звуки гри новими мовами!

Якщо ви розширюєте або додаєте якісь елементи до гри, будь ласка, не полінуйтеся і надішліть ваші доповнення супровіднику програми, Alex Fiestas, для включення до наступних випусків програми.

## Для художників

Щоб створити нову гру для KTuberling, вам слід:

- Намалювати поле гри у вигляді файла SVG, в якому ви маєте:

  - Назвати місце, куди будуть перетягуватися елементи «background».

  - Назвати кожен з елементів, придатних для перетягування, унікальною назвою.

- Створити файл `.theme` за такою схемою:

      <playground gameboard="ваш_файл_SVG" name="стільничний_файл">
      <object name="назва_елемента" sound="назва_звуку" scale="певне_значення" />
      ...
      ...
      ...
      </playground>

  - `ваш_файл_SVG` — це назва файла SVG, у якому знаходиться малюнок.

  - `стільничний_файл` — назва стільничного (desktop) файла з назвою теми.

  - Кожному об’єкту має відповідати запис `<object>`. `назва_елемента` є унікальною назвою в межах файла SVG, `назва_звуку` — назва звукового файла, який буде відтворено під час перетягування елемента, щоб дізнатися більше, перегляньте інструкцію зі створення звукових тем у файлі `sounds/soundthemes.HOWTO` ієрархії початкового коду програми.

  - Запис `scale` (масштаб) є необов’язковим. `певне_значення` — це масштабний коефіцієнт, який буде використано для малювання цього об’єкта поза межами сховища елементів, якщо не вказано значення 1.

- Створіть файл `.desktop` за такою схемою:

      [KTuberlingTheme]
      Name=назва_теми

  - `назва_теми` — це назва-ідентифікатор теми, яку буде показано у меню «Ігровий майданчик».

- Якщо ви додаєте тему до сховища KTuberling, впишіть файли `.svg`, `.theme` та `.desktop` до розділу `FILES` файла `CMakeLists.txt` у каталозі `pics/`.

- Якщо хочете встановити усе самостійно, розташуйте файли `.svg`, `.theme`, `.desktop` у підкаталозі `ktuberling/pics` каталогу, що визначається командою `qtpaths `--paths GenericDataLocation``

Для перекладачів
Для перекладачів

## Для перекладачів

Окрім звичайного механізму перекладу міток і запитів програм за допомогою файлів `.po`, у цій програмі можна локалізувати і звуки.

Щоб створити нову звукову тему для KTuberling, вам слід:

- Записати звуки до файлів у форматі OGG Vorbis rc3.

- Створити файл ``дволітерний_код_вашої_мови`.soundtheme` за такою схемою:

      <language code="дволітерний_код_вашої_мови">
      <sound name="назва_звуку" file="відносний_шлях" />
      ...
      ...
      ...
      </language>

  - `дволітерний_код_вашої_мови` — це дволітерний код вашої мови, наприклад uk для української.

  - Кожному звуку має відповідати запис `<sound>`. `назва_звуку` має відповідати параметру назва_звуку, вказаному у темі ігрового майданчика (див. інструкцію з тем у файлі `pics/themes.HOWTO` ієрархії початкового коду програми). `відносний_шлях` вказує на відносний шлях, за яким ви маєте намір встановити файл з відповідним звуком, зазвичай, цим шляхом буде ``певний_унікальний_шлях`/`назва_звуку`.`формат`` (`певний_унікальний_шлях` може визначатися, наприклад, дволітерним кодом вашої мови).

- Якщо ви додаєте звукову тему KTuberling до теки вашої мови:

  - Додайте файли зі звуками і файли `.soundtheme` до каталогу `data/kdegames/ktuberling` сховища перекладів вашою мовою.

  - У тому самому каталозі вам слід розмістити і файл `CMakeLists.txt`, у якому вказати спосіб встановлення ваших файлів, зазвичай, це щось на зразок:

        FILE( GLOB oggfiles *.ogg )
        INSTALL( FILES ${oggfiles} DESTINATION ${KDE_INSTALL_DATADIR}/ktuberling/sounds/дволітерний_код_вашої_мови )
        INSTALL( FILES дволітерний_код_вашої_мови.soundtheme DESTINATION ${KDE_INSTALL_DATADIR}/ktuberling/sounds/ )

- Якщо ви бажаєте встановити тему власноруч, зробіть так:

  - Скопіюйте файл ``дволітерний_код_вашої_мови`.soundtheme` до підкаталогу `ktuberling/sounds` каталогу, що визначається командою `qtpaths `--paths GenericDataLocation``

  - Скопіюйте ваші_звукові_файли до підкаталогу `ktuberling/sounds/someUniquePath` у каталозі, що визначається командою `qtpaths `--paths GenericDataLocation``

Відомості про те, як працювати з механізмами перекладу у KDE, можна отримати з Порад щодо перекладу KDE.

Для програмістів
Для програмістів

## Для програмістів

Програмістові буде зовсім нескладно доповнити можливості KTuberling.

### Класи C++

`TopLevel`

  Керування вікном верхнього рівня і базове керування програмою.

`PlayGround`

  Опис одного з рівнів гри.

`ToDraw`

  Опис одного з графічних «об’єктів», які слід намалювати.

`SoundFactory`

  Опис однієї з мов і її звуків.

`Action`

  Одна з дій користувача у послідовності скасування/повторення дій.

Розділ 7. Подяки і ліцензія
Подяки і ліцензія

# Розділ 7. Подяки і ліцензія

KTuberling

- Alex Fiestas `(alex AT eyeos.org)` — поточний супровідник

- John Calhoun — початкова ідея, перші малюнки і звуки англійською

- Éric Bischoff `(e.bischoff AT noos.fr)` — програмування для KDE

- François-Xavier Duranceau `(duranceau AT free.fr)` — тести, поради і допомога

- Peter Silva `(peter.silva AT videotron.ca)` — корекція документації

- Paul E. Ahlquist, Jr. `(pea AT ahlquist.org)` — удосконалення документації

Переклад українською: Юрій Чорноіван `(yurchor AT ukr.net)`

Цей документ поширюється за умов дотримання GNU Free Documentation License.

Ця програма поширюється за умов дотримання GNU General Public License.