<?xml version="1.0" encoding="utf-8"?>
<!--
SPDX-FileCopyrightText: 2019 Sébastien Wilmet <swilmet@gnome.org>
SPDX-License-Identifier: CC-BY-SA-4.0
-->
<page xmlns="http://projectmallard.org/1.0/" xmlns:its="http://www.w3.org/2005/11/its" type="topic" id="book-format" xml:lang="uk">

<info>
  <link type="guide" xref="index"/>

    <mal:credit xmlns:mal="http://projectmallard.org/1.0/" type="translator copyright">
      <mal:name>Юрій Чорноіван</mal:name>
      <mal:email>yurchor@ukr.net</mal:email>
      <mal:years>2020</mal:years>
    </mal:credit>
  </info>

<title>Формат книги</title>

<synopsis>
  <p>«Книга» у <app>Devhelp</app> — документація з програмного інтерфейсу для одного модуля або пакунка (зазвичай, бібліотеки). На цій сторінці наведено опис форматування, яке повинна мати книга, щоб <app>Devhelp</app> міг її розпізнати.</p>
</synopsis>

<p>Вміст книги зберігається в одному каталозі (у каталозі міститься одна книга, у ньому не може бути декількох книг). Каталог містить такі файли:</p>
<list>
  <item><p>Сторінки HTML, плюс, можливо, файли CSS, зображення тощо;</p></item>
  <item><p>Файл покажчика із суфіксом назви <file>*.devhelp2</file>, див. <link xref="index-file-format"/>, щоб дізнатися більше.</p></item>
</list>
<note>
  <p>Обмеження: назва каталогу, у якому зберігається файл <file>*.devhelp2</file>, і назва файла <file>*.devhelp2</file> (без суфікса назви) мають бути однаковими. Іншими словами, якщо книга називається <code>$book_name</code>, абсолютний шлях до файла покажчика має бути таким: <code>$book_name/$book_name.devhelp2</code>. Таким чином, якщо <app>Devhelp</app> знає назву каталогу, програма безпосередньо знає і розташування файла покажчика.</p>
</note>
</page>
