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

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

    <mal:credit xmlns:mal="http://projectmallard.org/1.0/" type="translator copyright">
      <mal:name>scootergrisen</mal:name>
      <mal:email/>
      <mal:years>2020</mal:years>
    </mal:credit>
  </info>

<title>Indeks-filformat</title>

<synopsis>
  <p>Siden beskriver formålet og formatet af indeksfilerne <file>*.devhelp2</file>.</p>
</synopsis>

<p>En bog (se <link xref="book-format"/>) indeholder en indeksfil. Indeksfilen har endelsen <file>.devhelp2</file> og har et XML-format.</p>

<note>
  <p>“2” i filendelsen <file>*.devhelp2</file> er fordi det er den anden version af filformatet. Den første version af formatet med filendelsen <file>*.devhelp</file> er udgået og dens understøttelse kan blive fjernet fra <app>Devhelp</app> i fremtiden. Ved programopstart når <app>Devhelp</app> skanner filsystemet for at finde bøger, så udsender den en advarselsmeddelelse i terminalen for hver bog som bruger et format som er udgået.</p>
</note>

<p>Indeksfilen indeholder primært:</p>
<list>
  <item><p>Bogstrukturen (såsom en indholdsfortegnelse).</p></item>
  <item><p>En liste over symboler (funktioner, typer, makroer, signaler, egenskaber …).</p></item>
</list>
<p>De indeholder links til HTML-filerne til at nå de tilhørende sider og symboler.</p>
<p>I <app>Devhelp</app> vises bogens struktur i sidepanelet. Og <link xref="search">søg i sidepanelet</link> viser de resultater som bliver fundet i indeksfilerne.</p>

<section id="devhelp2-index-format">
  <title>Specifikationer til <file>*.devhelp2</file> XML-formatet</title>
  <p>Desværre er XML-filformatet til <file>*.devhelp2</file> ikke dokumenteret godt. Der er stadigvæk håb om at det bliver rettet i nær fremtid. I mellemtiden anbefaler vi dig at kigge på hvad <link xref="installing-api-documentation#gtk-doc">GTK-Doc</link> genererer. For den mest præcise definition af hvad <app>Devhelp</app> understøtter kan du læse fortolkerens kildekode og API-referencen til <app>Devhelp</app>.</p>
</section>
</page>
