File Structure
Use a seperate folder per BHP project,
containing at least the following files:
.BHP,
0.HTM,
.HHP,
.BOOK and optionally
.CSS.
The original source HTM-files must be numbered sequentially, starting with "0.htm".
You may use a single source HTM-file named "0.htm".
The generated WEB-files will be named WEBprefix+SRC-FileName, e.g. "w-0.htm", "w-1.htm" and placed
in the folder WEBcopyPath.
The generated temporary CHM-files will be named CHMprefix+SRC-FileName, e.g. "c-0.htm", "c-1.htm" and
the compiled CHM-file will be placed in the folder CHMcopyPath.
The generated temporary PDF-files will be named PDFprefix+SRC-FileName, e.g. "p-0.htm", "p-1.htm" and
the compiled PDF-file will be placed in the folder PDFcopyPath.
.BHP file
- Used by the BHcomp utility
section [Files]
| | Title=energyXT WHIICH Guide | >> auto-set by BHcomp,
if "0.htm" contains a <title> tag, otherwise you
must supply a valid title
|
| | Project=eXT-WG | >> BHcomp project filename
|
| | hhp=eXT-WG.hhp | >> .HHP HTMLhelp project filename, only needed if .hhp-name differs from project-name
|
| | chm=eXT-WG.chm | >> .CHM HTMLhelp filename, only needed if .chm-name differs from .hhp-name
|
| | txt=eXT-WG.txt | >> only needed if a BBCode formatted TXT/RTF file
is used as a source instead of "0.htm"
|
| | CHMcss=file:eXT.css | >> .CSS filename, the "file:"-portion
is only needed if you want the ability to select another .CSS for the CHM after HTMLhelp compilation
|
| | WEBcss=eXT.css | >> .CSS filename for WEB-files,
only needed WEBcss differs from CHMcss
|
| | WEBcopyPath=..\ | >> folder where WEB-files will be placed
|
| | CHMcopyPath= | >> folder where CHM-file will be placed
|
| | PDFcopyPath= | >> folder where PDF-file will be placed
|
| | WEBprefix=w- | >> prefix placed in front of generated WEB HTM-files, e.g. "w-0.htm"
|
| | CHMprefix=c- | >> prefix placed in front of generated temporary CHM HTM-files, e.g. "c-0.htm"
|
| | PDFprefix=p- | >> prefix placed in front of generated temporary PDF HTM-files, e.g. "p-0.htm"
|
| | TOClevels=4
| >> number of levels in the "table-of-contents" tab and "index" tab in the CHM HTMLhelp
|
|
| TOCmode=relaxed | >> "relaxed" is used if only 1 HTM-source-file is used, "strict" is needed for
multi-page HTM-source-files
|
| | WEBimgDir=images | >> Images sub-folder used by WEB-files
|
| | CHMimgDir=images | >> Images sub-folder used by CHM-file
|
| | PDFimgDir=pdf images | >> Images sub-folder used by PDF-file
|
| | genHHC=1 | >> auto-generates HHC file, default = 1
|
| | genHHK=1 | >> auto-generates HHK file, default = 1
|
.HHP file
- the .HHP file is the project setting used by the Microsoft
HTMLhelp compiler
- the .HHP filename must correspond with "hhp" setting in .BHP file
section [OPTIONS]
| | Binary TOC=Yes |
|
| | Compatibility=1.1 or later |
|
| | Compiled file=eXT-WG.chm | >> auto-set by BHcomp, must correspond with "chm=" setting in .BHP file
|
| | Contents file=eXT-WG.hhc | >> auto-set by BHcomp, must use the same file name as the CHM, but with a .hhc extension
|
| | Index file=eXT-WG.hhk | >> auto-set by BHcomp, must use the same file name as the CHM, but with a .hhk extension
|
| | Default Window=Main |
|
| | Default topic=c-0.htm | >> usually the first file
|
| | Display compile progress=No |
|
| | Full-text search=Yes |
|
| | Language=0x809 English (United Kingdom) |
|
| | Title=energyXT WHIICH Guide | >> auto-set by BHcomp, CHM title
|
section [WINDOWS]
-
Main=,"eXT-WG.hhc","eXT-WG.hhk","c-0.htm","c-0.htm",,,,,0x63520,230,0x386e,
[0,0,880,615],,,,,,,0
The .HHC and .HHK in this [WINDOWS] section is auto-set by BHcomp, must correspond with "Contents
file" and "Index
file" in
the [OPTIONS] section
The "c-0.htm" twice should correspond with "Default topic"
The value 880 may be changed to the desired default width of the HTMLhelp window
The value 615 may be changed to the desired default height of the HTMLhelp window
section [FILES]
- The CHM HTM-filenames are automatically placed by BHcomp
.BOOK file
- the .BOOK file is the project setting used by the
HTMLdoc compiler
- the .BOOK filename must correspond with "chm=" setting in .BHP file, but with a ".book" extension
-
-t pdf13 -f eXT-WG.pdf --book --toclevels 3 --numbered --toctitle "Table of Contents" --title
--titleimage title.htm --linkstyle underline --size Universal --left 15mm --right 15mm --top 10mm
--bottom 10mm --header c.t --footer /.t --nup 1 --tocheader ..t --tocfooter i.t --portrait --color
--no-pscommands --no-xrxcomments --compression=9 --jpeg=90 --fontsize 11.0 --fontspacing 1.2
--headingfont Helvetica --bodyfont Helvetica --headfootsize 10.0 --headfootfont Helvetica-Oblique
--charset iso-8859-1 --links --no-embedfonts --pagemode outline --pagelayout single --firstpage p1
--pageeffect none --pageduration 10 --effectduration 1.0 --no-encryption --permissions all
--owner-password "" --user-password "" --browserwidth 680
The .PDF file name (e.g. "eXT-WG.pdf") is auto-set by BHcomp, must be the same name as the .BOOK
file, but with a .pdf extension
The --browserwidth value 680 may be changed to the desired default width of the PDF
window
- From the 3rd line down, PDF HTM-filenames are automatically placed by BHcomp
