Default page

Your IP: 216.73.216.91
Server IP: 157.245.101.34
Server: Linux skvinfotech-website 5.4.0-131-generic #147-Ubuntu SMP Fri Oct 14 17:07:22 UTC 2022 x86_64
Server Software: Apache/2.4.41 (Ubuntu)
PHP Version: 7.4.33
Buat File | Buat Folder

Edit File: index-file-format.page

<?xml version="1.0" encoding="utf-8"?>

<page xmlns="http://projectmallard.org/1.0/" xmlns:its="http://www.w3.org/2005/11/its" type="topic" id="index-file-format" xml:lang="cs">

<title>Formát indexového souboru</title>

<synopsis>
 Tato stránka popisuje účel a formát indexových souborů <file>*.devhelp2</file>.
</synopsis>

Kniha (viz <link xref="book-format"/>) obsahuje jeden indexový soubr. Indexový soubor má příponu <file>.devhelp2</file> a formát XML.

<note>
 „2“ v příponě souboru <file>*.devhelp2</file> je proto, že se jedná o druhou verzi tohoto souborového formátu. První verze s příponou <file>*.devhelp</file> je označená za zastaralou a její podpora v aplikaci <app>Devhelp</app> může být v budoucnu odstraněna. Při spuštění aplikace, kdy <app>Devhelp</app> prohledává souborový systém na výskyt knih, vysílá do terminálu varovné zprávy pro každou knihu, která používá zastaralý formát.
</note>

Indexový soubor obsahuje zejména:
<list>
 <item>Strukturu knihy (obdoba obsahu knihy).</item>
 <item>Seznam symbolů (funkce, typy, makra, signály, vlastnosti, …).</item>
</list>
Ty pak obsahují odkazy na jednotlivé soubory HTML, díky čemuž se dá dostat na příslušnou stránku a symbol.
Struktura knihy je v aplikaci <app>Devhelp</app> zobrazená v postranním panelu. A <link xref="search">hledání v postranním panelu</link> zobrazuje výsledky nalezené v indexovém souboru.

<section id="devhelp2-index-format">
 <title>Specifikace souborového formátu XML <file>*.devhelp2</file>.</title>
 Naneštěstí souborový formát XML <file>*.devhelp2</file> není příliš dobře zdokumentován. Je tu ale šance, že se to do budoucna zlepší. Než se tak stane, doporučujeme podívat se, co generuje <link xref="installing-api-documentation#gtk-doc">GTK-Doc</link>. Podrobnější definice, co <app>Devhelp</app> podporuje, pak můžete zjistit čtením jeho zdrojového kódu a referenční příručky k API <app>Devhelp</app>.
</section>
</page>