<?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="pl">

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

    <mal:credit xmlns:mal="http://projectmallard.org/1.0/" type="translator copyright">
      <mal:name>Piotr Drąg</mal:name>
      <mal:email>piotrdrag@gmail.com</mal:email>
      <mal:years>2018-2020</mal:years>
    </mal:credit>
  
    <mal:credit xmlns:mal="http://projectmallard.org/1.0/" type="translator copyright">
      <mal:name>Aviary.pl</mal:name>
      <mal:email>community-poland@mozilla.org</mal:email>
      <mal:years>2018-2020</mal:years>
    </mal:credit>
  </info>

<title>Format książki</title>

<synopsis>
  <p>„Książka” w programie <app>Devhelp</app> to dokumentacja API dla jednego modułu lub pakietu (zwykle biblioteki). Ta strona opisuje format, jakiego książka musi używać, aby <app>Devhelp</app> ją rozpoznał.</p>
</synopsis>

<p>Treść książki mieści się w jednym katalogu (ten katalog zawiera tylko jedną książkę, nie może zawierać kilku). Składa się on z:</p>
<list>
  <item><p>stron HTML plus możliwe pliki CSS, obrazy itp.,</p></item>
  <item><p>pliku indeksu z rozszerzeniem <file>*.devhelp2</file>. <link xref="index-file-format"/> zawiera więcej informacji.</p></item>
</list>
<note>
  <p>Ograniczenie: nazwa katalogu, w którym znajduje się plik <file>*.devhelp2</file> i nazwa pliku <file>*.devhelp2</file> (minus rozszerzenie) muszą się zgadzać. Innymi słowy, jeśli katalog z książką ma nazwę <code>$nazwa_książki</code>, to bezwzględna ścieżka do pliku indeksu musi kończyć się <code>$nazwa_książki/$nazwa_książki.devhelp2</code>. W ten sposób jeśli <app>Devhelp</app> zna nazwę katalogu, to bezpośrednio zna także położenie pliku indeksu.</p>
</note>
</page>
