<?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="index-file-format" xml:lang="hu">

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

    <mal:credit xmlns:mal="http://projectmallard.org/1.0/" type="translator copyright">
      <mal:name>Úr Balázs</mal:name>
      <mal:email>ur dot balazs at fsf dot hu</mal:email>
      <mal:years>2018, 2021.</mal:years>
    </mal:credit>
  </info>

<title>Az indexfájl formátuma</title>

<synopsis>
  <p>Ez az oldal a <file>*.devhelp2</file> indexfájlok célját és formátumát mutatja be.</p>
</synopsis>

<p>Egy könyv (lásd: <link xref="book-format"/>) egy indexfájlt tartalmaz. Az indexfájl <file>.devhelp2</file> kiterjesztéssel rendelkezik és XML-formátumú.</p>

<note>
  <p>A „2” a <file>*.devhelp2</file> fájlkiterjesztésben azért van, mert ez a fájlformátum második verziója. A formátum első verziója a <file>*.devhelp</file> fájlkiterjesztéssel elavult, és a jövőben a támogatása eltávolításra kerülhet a <app>Devhelp</app> alkalmazásból. Az alkalmazás indításakor, amikor a <app>Devhelp</app> átvizsgálja a fájlrendszert a könyvek kereséséhez, egy figyelmeztető üzenetet ad ki a terminálban minden olyan könyvnél, amely elavult formátumot használ.</p>
</note>

<p>Az indexfájlban főként a következők találhatók:</p>
<list>
  <item><p>A könyv szerkezete (egy tartalomjegyzékhez hasonlóan).</p></item>
  <item><p>Szimbólumok listája (függvények, típusok, makrók, szignálok, tulajdonságok, …).</p></item>
</list>
<p>Ezek tartalmazzák a HTML-fájlokra mutató hivatkozásokat a megfelelő oldalak és szimbólumok eléréséhez.</p>
<p>A <app>Devhelp</app> alkalmazásban a könyv szerkezete az oldalsó panelen látható. A <link xref="search">keresés az oldalsó panelen</link> pedig az indexfájlokban talált eredményeket jeleníti meg.</p>

<section id="devhelp2-index-format">
  <title>A <file>*.devhelp2</file> XML-fájlformátum specifikációja</title>
  <p>Sajnos a <file>*.devhelp2</file> XML-fájlformátum nem jól dokumentált. Még van némi remény, hogy a közeljövőben javítani fogják. Addig azt javasoljuk, hogy nézze meg, amit a <link xref="installing-api-documentation#gtk-doc">GTK-Doc</link> előállít. A legpontosabb meghatározásához annak, hogy a <app>Devhelp</app> mit támogat, olvassa el a feldolgozó forráskódját és a <app>Devhelp</app> API-hivatkozását.</p>
</section>
</page>
