-\membersection{Help Files Format}\label{helpformat}
+\section{Help Files Format}\label{helpformat}
wxHTML library uses a reduced version of MS HTML Workshop format.
Tex2RTF can produce these files when generating HTML, if you set {\bf htmlWorkshopFiles} to {\bf true} in
(See \helpref{wxHtmlHelpController}{wxhtmlhelpcontroller} for help controller description.)
-A {\bf book} consists of three files : header file, contents file and index file.
+A {\bf book} consists of three files: header file, contents file and index file.
+You can make a regular zip archive of these files, plus the HTML and any image files,
+for wxHTML (or helpview) to read; and the .zip file can optionally be renamed to .htb.
\wxheading{Header file (.hhp)}
Default topic=@default page to be displayed.htm@
\end{verbatim}
-All filenames (including the Default topic) are relative to the location of .hhp file.
+All filenames (including the Default topic) are relative to the
+location of .hhp file.
-For larger projects I recommend storing everything but .hhp file into one .zip archive. (The contents file
-would then be referred to as myhelp.zip\#zip:contents.hhc)
+{\bf Localization note:} In addition, .hhp file may contain line
+
+\begin{verbatim}
+Charset=@rfc_charset@
+\end{verbatim}
+
+which specifies what charset (e.g. "iso8859\_1") was used in contents
+and index files. Please note that this line is incompatible with
+MS HTML Help Workshop and it would either silently remove it or complain
+with some error. See also
+\helpref{Writing non-English applications}{nonenglishoverview}.
\wxheading{Contents file (.hhc)}
\end{verbatim}
You can modify value attributes of param tags. {\it topic name} is name of chapter/topic as is displayed in
-contents, {\it filename.htm} is HTML page name (relative to .hhp file) and {\it numeric_id} is optional
+contents, {\it filename.htm} is HTML page name (relative to .hhp file) and {\it numeric\_id} is optional
- it is used only when you use \helpref{wxHtmlHelpController::Display(int)}{wxhtmlhelpcontrollerdisplay}
Items in the list may be nested - one \verb$<li>$ statement may contain a \verb$<ul>$ sub-statement: