|
8.
|
|
|
Index file format
|
|
|
(itstool) path: page/title
|
|
|
|
(no translation yet)
|
|
|
|
Located in
C/index-file-format.page:14
|
|
9.
|
|
|
This page describes the purpose and the format of <file>*.devhelp2</file> index files.
|
|
|
(itstool) path: synopsis/p
|
|
|
|
(no translation yet)
|
|
|
|
Located in
C/index-file-format.page:17
|
|
10.
|
|
|
A book (see <link xref="book-format"/>) contains one index file. The index file has the extension <file>.devhelp2</file> and has an XML format.
|
|
|
(itstool) path: page/p
|
|
|
|
(no translation yet)
|
|
|
|
Located in
C/index-file-format.page:23
|
|
11.
|
|
|
The “2” in the <file>*.devhelp2</file> file extension is because it is the second version of the file format. The first version of the format, with the <file>*.devhelp</file> file extension, is deprecated and its support in <app>Devhelp</app> may be removed in the future. On application startup, when <app>Devhelp</app> scans the filesystem to find books, it emits a warning message in the terminal for each book that uses a deprecated format.
|
|
|
(itstool) path: note/p
|
|
|
|
(no translation yet)
|
|
|
|
Located in
C/index-file-format.page:29
|
|
12.
|
|
|
The index file mainly contains:
|
|
|
(itstool) path: page/p
|
|
|
|
(no translation yet)
|
|
|
|
Located in
C/index-file-format.page:40
|
|
13.
|
|
|
The book structure (like a table of contents).
|
|
|
(itstool) path: item/p
|
|
|
|
(no translation yet)
|
|
|
|
Located in
C/index-file-format.page:44
|
|
14.
|
|
|
A list of symbols (functions, types, macros, signals, properties, …).
|
|
|
(itstool) path: item/p
|
|
|
|
(no translation yet)
|
|
|
|
Located in
C/index-file-format.page:47
|
|
15.
|
|
|
These contain links to the HTML files to reach the corresponding pages and symbols.
|
|
|
(itstool) path: page/p
|
|
|
|
(no translation yet)
|
|
|
|
Located in
C/index-file-format.page:51
|
|
16.
|
|
|
In <app>Devhelp</app> the book structure is shown in the side panel. And the <link xref="search">search in the side panel</link> shows results found in the index files.
|
|
|
(itstool) path: page/p
|
|
|
|
(no translation yet)
|
|
|
|
Located in
C/index-file-format.page:55
|
|
17.
|
|
|
Specification of the <file>*.devhelp2</file> XML file format
|
|
|
(itstool) path: section/title
|
|
|
|
(no translation yet)
|
|
|
|
Located in
C/index-file-format.page:62
|