X-Git-Url: https://git.saurik.com/wxWidgets.git/blobdiff_plain/d17f05afeb41c64fab410cd3178a78596da55e38..7946d7deaac081a745dc616a5eb13ae864865fa2:/docs/latex/wx/htmlhlpf.tex?ds=sidebyside diff --git a/docs/latex/wx/htmlhlpf.tex b/docs/latex/wx/htmlhlpf.tex index af4ebdc9b7..1b4e02d225 100644 --- a/docs/latex/wx/htmlhlpf.tex +++ b/docs/latex/wx/htmlhlpf.tex @@ -6,17 +6,19 @@ your tex2rtf.ini file. (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)} Header file must contain these lines (and may contain additional lines which are ignored) : \begin{verbatim} -Contents file=@filename.hhc@ -Index file=@filename.hhk@ -Title=@title of your book@ -Default topic=@default page to be displayed.htm@ +Contents file= +Index file= +Title= +Default topic=<default page to be displayed.htm> \end{verbatim} All filenames (including the Default topic) are relative to the @@ -25,7 +27,7 @@ location of .hhp file. {\bf Localization note:} In addition, .hhp file may contain line \begin{verbatim} -Charset=@rfc_charset@ +Charset=<rfc_charset> \end{verbatim} which specifies what charset (e.g. "iso8859\_1") was used in contents @@ -37,20 +39,20 @@ with some error. See also \wxheading{Contents file (.hhc)} Contents file has HTML syntax and it can be parsed by regular HTML parser. It contains exactly one list -(\verb$<ul>$....\verb$</ul>$ statement): +(\tt{<ul>}....\tt{</ul>} statement): \begin{verbatim} <ul> - <li> <object> + <li> <object type="text/sitemap"> <param name="Name" value="@topic name@"> - <param name="ID" value=@numeric_id@> - <param name="Local" value="@filename.htm@"> + <param name="ID" value=@numeric_id@> + <param name="Local" value="@filename.htm@"> </object> - <li> <object> + <li> <object type="text/sitemap"> <param name="Name" value="@topic name@"> - <param name="ID" value=@numeric_id@> - <param name="Local" value="@filename.htm@"> + <param name="ID" value=@numeric_id@> + <param name="Local" value="@filename.htm@"> </object> ... @@ -61,26 +63,26 @@ You can modify value attributes of param tags. {\it topic name} is name of chapt 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: +Items in the list may be nested - one \tt{<li>} statement may contain a \tt{<ul>} sub-statement: \begin{verbatim} <ul> - <li> <object> + <li> <object type="text/sitemap"> <param name="Name" value="Top node"> - <param name="Local" value="top.htm"> + <param name="Local" value="top.htm"> </object> <ul> - <li> <object> - <param name="Name" value="subnode in topnode"> - <param name="Local" value="subnode1.htm"> + <li> <object type="text/sitemap"> + <param name="Name" value="subnode in topnode"> + <param name="Local" value="subnode1.htm"> </object> - ... + ... </ul> - <li> <object> + <li> <object type="text/sitemap"> <param name="Name" value="Another Top"> - <param name="Local" value="top2.htm"> + <param name="Local" value="top2.htm"> </object> ...