devhelp gnome-3-36 - en to uk translation catalogue (47 entries)

note: (itstool) path: page/title (itstool) path: section/title
en: Book format
uk: Формат книги

note: (itstool) path: synopsis/p
en: A “book” in <app>Devhelp</app> is the API documentation for one module, or package (usually a library). This page describes the format that a book needs to follow in order for <app>Devhelp</app> to recognize it.
uk: «Книга» у <app>Devhelp</app> — документація з програмного інтерфейсу для одного модуля або пакунка (зазвичай, бібліотеки). На цій сторінці наведено опис форматування, яке повинна мати книга, щоб <app>Devhelp</app> міг її розпізнати.

note: (itstool) path: page/p
en: The content of a book is placed in one directory (that directory contains only one book, it cannot contain several books). The directory is comprised of:
uk: Вміст книги зберігається в одному каталозі (у каталозі міститься одна книга, у ньому не може бути декількох книг). Каталог містить такі файли:

note: (itstool) path: item/p
en: HTML pages, plus possibly CSS files, images, etc;
uk: Сторінки HTML, плюс, можливо, файли CSS, зображення тощо;

note: (itstool) path: item/p
en: An index file with the <file>*.devhelp2</file> file extension, see <link xref="index-file-format"/> for more information.
uk: Файл покажчика із суфіксом назви <file>*.devhelp2</file>, див. <link xref="index-file-format"/>, щоб дізнатися більше.

note: (itstool) path: note/p
en: Restriction: the name of the directory the <file>*.devhelp2</file> file is in and the name of the <file>*.devhelp2</file> file (minus the extension) must match. In other words, if the book directory is called <code>$book_name</code>, then the absolute path to the index file should end with <code>$book_name/$book_name.devhelp2</code>. That way, when <app>Devhelp</app> knows the directory name, it directly knows the location to the index file.
uk: Обмеження: назва каталогу, у якому зберігається файл <file>*.devhelp2</file>, і назва файла <file>*.devhelp2</file> (без суфікса назви) мають бути однаковими. Іншими словами, якщо книга називається <code>$book_name</code>, абсолютний шлях до файла покажчика має бути таким: <code>$book_name/$book_name.devhelp2</code>. Таким чином, якщо <app>Devhelp</app> знає назву каталогу, програма безпосередньо знає і розташування файла покажчика.

note: (itstool) path: page/title
en: Index file format
uk: Формат файла покажчика

note: (itstool) path: synopsis/p
en: This page describes the purpose and the format of <file>*.devhelp2</file> index files.
uk: На цій сторінці описано призначення та формат файлів покажчика <file>*.devhelp2</file>.

note: (itstool) path: page/p
en: A book (see <link xref="book-format"/>) contains one index file. The index file has the extension <file>.devhelp2</file> and has an XML format.
uk: Книга (див. <link xref="book-format"/>) містить один файл покажчика. Файл покажчика має суфікс назви <file>.devhelp2</file> і форматування XML.

note: (itstool) path: note/p
en: The “2” in the <file>*.devhelp2</file> file extension is because it is the second version of the file format. The first version of the format, with the <file>*.devhelp</file> file extension, is deprecated and its support in <app>Devhelp</app> may be removed in the future. On application startup, when <app>Devhelp</app> scans the filesystem to find books, it emits a warning message in the terminal for each book that uses a deprecated format.
uk: «2» у суфіксі назви <file>*.devhelp2</file> означає, що це друга версія цього формату файлів. Перша версія формату з суфіксом назви <file>*.devhelp</file> є застарілою, і її підтримку у наступних версіях <app>Devhelp</app> може бути вилучено. При запуску програм, коли <app>Devhelp</app> шукає книги у файловій системі, програма виводить попередження до термінала для кожної книги, у якій використано застарілий формат.

note: (itstool) path: page/p
en: The index file mainly contains:
uk: В основному файл покажчика містить такі дані:

note: (itstool) path: item/p
en: The book structure (like a table of contents).
uk: Структуру книги (зокрема таблицю змісту).

note: (itstool) path: item/p
en: A list of symbols (functions, types, macros, signals, properties, …).
uk: Список символів (функції, типи, макроси, сигнали, властивості, …).

note: (itstool) path: page/p
en: These contain links to the HTML files to reach the corresponding pages and symbols.
uk: Тут містяться посилання на файли HTML для переходу до відповідних сторінок і символів.

note: (itstool) path: page/p
en: In <app>Devhelp</app> the book structure is shown in the side panel. And the <link xref="search">search in the side panel</link> shows results found in the index files.
uk: У <app>Devhelp</app> структуру книг буде показано на бічній панелі. А на <link xref="search">панелі пошуку на бічній панелі</link> буде показано результати, які було знайдено у файлах покажчика.

note: (itstool) path: section/title
en: Specification of the <file>*.devhelp2</file> XML file format
uk: Специфікація формату файлів XML <file>*.devhelp2</file>

note: (itstool) path: section/p
en: Unfortunately the <file>*.devhelp2</file> XML file format is not well documented. There is still some hope that it will be fixed in the near future. In the meantime, we recommend to look at what <link xref="installing-api-documentation#gtk-doc">GTK-Doc</link> generates. For the most precise definition of what <app>Devhelp</app> supports, read the parser source code and the <app>Devhelp</app> API reference.
uk: На жаль, формат файлів XML <file>*.devhelp2</file> документовано не дуже добре. Маємо надію, що цю ситуацію буде невдовзі виправлено. Тим часом, ми рекомендуємо ознайомитися із даними, які виводить <link xref="installing-api-documentation#gtk-doc">GTK-Doc</link>. Найточніше визначення того, підтримку чого реалізовано у <app>Devhelp</app>, ознайомтеся із початковим кодом обробника та довідником із програмного інтерфейсу <app>Devhelp</app>.

[ctx: link:trail]
note: (itstool) path: info/title
en: Devhelp User Documentation
uk: Документація користувача Devhelp

[ctx: text]
note: (itstool) path: info/title
en: Devhelp User Documentation
uk: Документація користувача Devhelp

[ctx: link]
note: (itstool) path: info/title
en: Devhelp User Documentation
uk: Документація користувача Devhelp

note: (itstool) path: info/desc
en: Devhelp User Documentation
uk: Документація користувача Devhelp

note: (itstool) path: page/title
en: <_:media-1/> Devhelp User Documentation
uk: <_:media-1/> Документація користувача Devhelp

note: (itstool) path: synopsis/p
en: Devhelp is a developer tool for browsing and searching API documentation.
uk: Devhelp — інструмент розробника для навігації і пошуку у документації із програмних інтерфейсів.

note: (itstool) path: page/title
en: Installing API documentation
uk: Встановлення документації з програмного інтерфейсу

note: (itstool) path: synopsis/p
en: How <app>Devhelp</app> finds the API documentation.
uk: Як <app>Devhelp</app> знаходить документацію до програмного інтерфейсу.

note: (itstool) path: section/p
en: See <link xref="book-format"/> for information on the API documentation format that <app>Devhelp</app> recognizes.
uk: Див. <link xref="book-format"/>, щоб дізнатися більше про формат документації до програмного інтерфейсу, який розпізнається <app>Devhelp</app>.

note: (itstool) path: section/title
en: Books locations
uk: Розташування книг

note: (itstool) path: section/p
en: Once a book follows the right format, its directory needs to be installed at a location where <app>Devhelp</app> will find it.
uk: Якщо книгу записано у належному форматі, її каталог має бути встановлено у місці, де <app>Devhelp</app> його знайде.

note: (itstool) path: section/p
en: <app>Devhelp</app> uses the <link href="https://specifications.freedesktop.org/basedir-spec/latest/">XDG Base Directory Specification</link> to find the books. The list of locations searched is:
uk: <app>Devhelp</app> використовує <link href="https://specifications.freedesktop.org/basedir-spec/latest/">специфікацію базового каталогу XDG</link> для пошуку книг. Ось список місць, де відбуватиметься пошук:

note: (itstool) path: section/p
en: Note that the two latter consist of lists of directories to look for. Directory values are separated by <code>:</code> characters. Those environment variables are normally set up by the desktop environment or distribution.
uk: Зауважте, що два останніх складаються зі списків каталогів для пошуку. Записи каталогів має бути відокремлено символами <code>:</code>. Ці змінні середовища, зазвичай, визначаються стільничним середовищем або дистрибутивом.

note: (itstool) path: section/p
en: Examples of locations to index files with <code>$XDG_DATA_HOME</code> on a typical system:
uk: Приклади місць файлів покажчика із <code>$XDG_DATA_HOME</code> у типовій системі:

note: (itstool) path: item/p
en: <file>~/.var/app/org.gnome.Devhelp/data/devhelp/books/glib/glib.devhelp2</file> if <app>Devhelp</app> is launched with <link href="https://flatpak.org/">Flatpak</link>.
uk: <file>~/.var/app/org.gnome.Devhelp/data/devhelp/books/glib/glib.devhelp2</file>, якщо <app>Devhelp</app> запущено з пакунка <link href="https://flatpak.org/">Flatpak</link>.

note: (itstool) path: section/p
en: Example of a location to an index file with <code>$XDG_DATA_DIRS</code> on a typical system:
uk: Приклад розташування файла покажчика із <code>$XDG_DATA_DIRS</code> у типовій системі:

note: (itstool) path: section/p
en: <link href="https://gitlab.gnome.org/GNOME/gtk-doc">GTK-Doc</link> is a tool to generate API documentation from comments added to C code. It is used by GLib, GTK and GNOME libraries and applications.
uk: <link href="https://gitlab.gnome.org/GNOME/gtk-doc">GTK-Doc</link> — інструмент для створення документації до програмного інтерфейсу на основі коментарів у коді C. Він використовується GLib, GTK та бібліотеками і програмами GNOME.

note: (itstool) path: section/p
en: GTK-Doc installs the API reference of a module into:
uk: GTK-Doc встановлює довідник із програмного інтерфейсу модуля до такого каталогу:

note: (itstool) path: section/p
en: It follows the book format supported by <app>Devhelp</app>. So by using GTK-Doc, the API reference can be browsed in <app>Devhelp</app> automatically (once installed in the right location, that is).
uk: Використовується формат книги, підтримку якого передбачено у <app>Devhelp</app>. Отже, використання GTK-Doc надає змогу автоматично переглядати довідник з програмного інтерфейсу у <app>Devhelp</app> (достатньо просто встановити дані до належного каталогу).

note: (itstool) path: page/title
en: Search in the side panel
uk: Пошук на бічній панелі

note: (itstool) path: synopsis/p
en: How the search in the side panel works.
uk: Як працюють засоби пошуку на бічній панелі.

note: (itstool) path: section/title
en: Case sensitivity
uk: Врахування регістру

note: (itstool) path: section/p
en: The search is case sensitive when there is an uppercase letter. If the search terms are all in lowercase, the search is case insensitive. It's like the “smartcase” feature present in some text editors.
uk: Пошук відбуватиметься із врахуванням регістру символів, якщо у критерії пошуку будуть великі літери. Якщо усі літери у критерії є малими, пошук відбуватиметься без врахування регістру символів. Це «кмітливий» регістр, який використовується у деяких текстових редакторах.

note: (itstool) path: section/title
en: Glob-style pattern matching
uk: Пошук за взірцями із символами-замінниками

note: (itstool) path: section/p
en: A search term can be a pattern containing ‘*’ and ‘?’ wildcards. ‘*’ matches an arbitrary, possibly empty, string; and ‘?’ matches an arbitrary character.
uk: Критерій пошуку може бути взірцем, що містить символи-замінники «*» і «?». «*» замінює довільний, можливо порожній, рядок; а «?» замінює один довільний символ.

note: (itstool) path: section/title
en: Several search terms
uk: Пошук за декількома ключовими словами

note: (itstool) path: section/p
en: You can search with several search terms (separated by spaces). A symbol will match only if <em>all</em> the search terms individually match (not necessarily in the same order of appearance).
uk: Пошук можна може відбуватися за декількома ключовими словами (відокремленими пробілами). Символ вважається відповідним, лише якщо у ньому буде знайдено <em>усі</em> ключові слова пошуку (не обов'язково у вказаному вами порядку).

note: (itstool) path: section/p
en: Note that it is different than searching with the ‘*’ wildcard: with the ‘*’ wildcard it forces the keywords to be in the same order.
uk: Зауважте, що все змінюється, якщо використано символ-замінник «*»: якщо використано «*» усі ключові слова мають збігатися у вказаному порядку.

note: (itstool) path: section/p
en: For example when searching “<input>gtk window application</input>”, it matches both “<code>gtk_window_get_application()</code>” and “<code>GtkApplicationWindow</code>” (among other symbols).
uk: Наприклад, при пошуку «<input>gtk window application</input>» буде знайдено «<code>gtk_window_get_application()</code>» і «<code>GtkApplicationWindow</code>» (серед інших символів).

note: (itstool) path: section/p
en: On the other hand, searching “<input>gtk*window*application</input>” will match “<code>gtk_window_get_application()</code>” but not “<code>GtkApplicationWindow</code>”.
uk: З іншого боку, пошук за критерієм «<input>gtk*window*application</input>» надасть змогу знайти «<code>gtk_window_get_application()</code>», але не «<code>GtkApplicationWindow</code>».
