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

<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 pliku indeksu</title>

<synopsis>
 Ta strona opisuje przeznaczenie i format plików indeksów <file>*.devhelp2</file>.
</synopsis>

Książka (patrz: <link xref="book-format"/>) zawiera jeden plik indeksu. Ma on rozszerzenie <file>.devhelp2</file> i jest w formacie XML.

<note>
 „2” jest w rozszerzeniu <file>*.devhelp2</file>, ponieważ to druga wersja tego formatu. Pierwsza wersja, o rozszerzeniu <file>*.devhelp</file>, jest przestarzała i jej obsługa w programie <app>Devhelp</app> może zostać usunięta w przyszłości. Podczas włączania programu, kiedy <app>Devhelp</app> wyszukuje książki w systemie plików, w terminalu emitowany jest komunikat ostrzeżenia dla każdej książki używającej przestarzałego formatu.
</note>

Plik indeksu zawiera głównie:
<list>
 <item>strukturę książki (spis treści i podobne),</item>
 <item>listę symboli (funkcje, typy, makra, sygnały, właściwości…).</item>
</list>
Te zawierają odnośniki do plików HTML, aby móc otwierać odpowiednie strony i symbole.
W programie <app>Devhelp</app> struktura książki jest wyświetlana w panelu bocznym. A <link xref="search">wyszukiwanie w panelu bocznym</link> wyświetla wyniki z plików indeksów.

<section id="devhelp2-index-format">
 <title>Specyfikacja formatu pliku XML <file>*.devhelp2</file></title>
 Niestety format pliku XML <file>*.devhelp2</file> nie ma dobrej dokumentacji. Być może zostanie to naprawione w niedalekiej przyszłości. W międzyczasie zalecamy korzystać z wyników działania <link xref="installing-api-documentation#gtk-doc">GTK-Doc</link>. Kod źródłowy parsera i referencja API programu <app>Devhelp</app> najdokładniej określa, co on obsługuje.
</section>
</page>