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

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

    <mal:credit xmlns:mal="http://projectmallard.org/1.0/" type="translator copyright">
      <mal:name>Daniel Mustieles</mal:name>
      <mal:email>daniel.mustieles@gmail.com</mal:email>
      <mal:years>2018-2021</mal:years>
    </mal:credit>
  </info>

<title>Formato de libro</title>

<synopsis>
  <p>En <app>Devhelp</app> un «libro» es la documentación de la API de un módulo o paquete (normalmente una biblioteca). Esta página describe el formato que necesita tener un libro para que <app>Devhelp</app> lo reconozca.</p>
</synopsis>

<p>El contenido de un libro se coloca en una carpeta (que contiene sólo un libro, no puede contener varios). La carpeta se compone de:</p>
<list>
  <item><p>Páginas HTML además de posibles archivos CSS, imágenes, etc.</p></item>
  <item><p>Un archivo índice cuya extensión es <file>*.devhelp2</file>. Consulte la sección <link xref="index-file-format"/> para obtener más información.</p></item>
</list>
<note>
  <p>Restricción: el nombre de la carpeta donde está el archivo <file>*.devhelp2</file> y el nombre del archivo <file>*.devhelp2</file> (sin la extensión) deben coincidir. En otras palabras, si la carpeta del libro se llama <code>$nombre_libro</code>, la ruta absoluta al archivo índice debe terminar es <code>$nombre_libro/$nombre_libro.devhelp2</code>. De este modo, cuando <app>Devhelp</app> conoce el nombre de la carpeta sabe directamente la ubicación del archivo índice.</p>
</note>
</page>
