]>
Commit | Line | Data |
---|---|---|
1 | \section{Help Files Format}\label{helpformat} | |
2 | ||
3 | wxHTML library uses a reduced version of MS HTML Workshop format. | |
4 | Tex2RTF can produce these files when generating HTML, if you set {\bf htmlWorkshopFiles} to {\bf true} in | |
5 | your tex2rtf.ini file. | |
6 | ||
7 | (See \helpref{wxHtmlHelpController}{wxhtmlhelpcontroller} for help controller description.) | |
8 | ||
9 | A {\bf book} consists of three files : header file, contents file and index file. | |
10 | ||
11 | \wxheading{Header file (.hhp)} | |
12 | ||
13 | Header file must contain these lines (and may contain additional lines which are ignored) : | |
14 | ||
15 | \begin{verbatim} | |
16 | Contents file=@filename.hhc@ | |
17 | Index file=@filename.hhk@ | |
18 | Title=@title of your book@ | |
19 | Default topic=@default page to be displayed.htm@ | |
20 | \end{verbatim} | |
21 | ||
22 | All filenames (including the Default topic) are relative to the | |
23 | location of .hhp file. | |
24 | ||
25 | {\bf Localization note:} In addition, .hhp file may contain line | |
26 | ||
27 | \begin{verbatim} | |
28 | Charset=@rfc_charset@ | |
29 | \end{verbatim} | |
30 | ||
31 | which specifies what charset (e.g. "iso8859_1") was used in contents | |
32 | and index files. Please note that this line is incompatible with | |
33 | MS HTML Help Workshop and it would either silently remove it or complain | |
34 | with some error. See also | |
35 | \helpref{Writing non-English applications.}{nonenglishoverview} | |
36 | ||
37 | ||
38 | \wxheading{Contents file (.hhc)} | |
39 | ||
40 | Contents file has HTML syntax and it can be parsed by regular HTML parser. It contains exactly one list | |
41 | (\verb$<ul>$....\verb$</ul>$ statement): | |
42 | ||
43 | \begin{verbatim} | |
44 | <ul> | |
45 | ||
46 | <li> <object> | |
47 | <param name="Name" value="@topic name@"> | |
48 | <param name="ID" value=@numeric_id@> | |
49 | <param name="Local" value="@filename.htm@"> | |
50 | </object> | |
51 | <li> <object> | |
52 | <param name="Name" value="@topic name@"> | |
53 | <param name="ID" value=@numeric_id@> | |
54 | <param name="Local" value="@filename.htm@"> | |
55 | </object> | |
56 | ... | |
57 | ||
58 | </ul> | |
59 | \end{verbatim} | |
60 | ||
61 | You can modify value attributes of param tags. {\it topic name} is name of chapter/topic as is displayed in | |
62 | contents, {\it filename.htm} is HTML page name (relative to .hhp file) and {\it numeric\_id} is optional | |
63 | - it is used only when you use \helpref{wxHtmlHelpController::Display(int)}{wxhtmlhelpcontrollerdisplay} | |
64 | ||
65 | Items in the list may be nested - one \verb$<li>$ statement may contain a \verb$<ul>$ sub-statement: | |
66 | ||
67 | \begin{verbatim} | |
68 | <ul> | |
69 | ||
70 | <li> <object> | |
71 | <param name="Name" value="Top node"> | |
72 | <param name="Local" value="top.htm"> | |
73 | </object> | |
74 | <ul> | |
75 | <li> <object> | |
76 | <param name="Name" value="subnode in topnode"> | |
77 | <param name="Local" value="subnode1.htm"> | |
78 | </object> | |
79 | ... | |
80 | </ul> | |
81 | ||
82 | <li> <object> | |
83 | <param name="Name" value="Another Top"> | |
84 | <param name="Local" value="top2.htm"> | |
85 | </object> | |
86 | ... | |
87 | ||
88 | </ul> | |
89 | \end{verbatim} | |
90 | ||
91 | \wxheading{Index file (.hhk)} | |
92 | ||
93 | Index files have same format as contents file except that ID params are ignored and sublists are {\bf not} | |
94 | allowed. | |
95 |