Microsoft KB Archive/183377

= Official MS HTML Help Authoring Kit Comments and Corrections =

Article ID: 183377

Article Last Modified on 12/17/2002

-

APPLIES TO


 * MSPRESS Official Microsoft HTML Help Authoring Kit ISBN 1-57231-603-9

-



This article was previously published under Q183377



SUMMARY
This article contains information on known errors, corrections, and comments relating to the Microsoft Press book "Official Microsoft HTML Help Authoring Kit," ISBN 1-57231-603-9.

Contents:
 * Readme.txt: Support Text is Localized for US Only
 * Page 8: Text Incorrect
 * Page 31: Text Incorrect
 * Page 61: Text Incorrect
 * Page 62: Screenshot Incorrect
 * Page 63: Screenshot Incorrect
 * Page 64: Default Help Topic Does Not Match Book
 * Page 65: Step 7 "Inconsistencies" should be "Definition"
 * Page 71: Step 3 - Click Save (not OK)
 * Page 73: Create the keyword Basics not Basic Concepts
 * Page 79: Step 3 Text Incorrect
 * Page 80: Extra Steps Needed
 * Page 121: Technical Correction
 * Page 121: Text Incorrect
 * Page 138: Text Incorrect
 * Page 154: Popup Source Parameters Incorrectly Defined
 * Page 167: Step 1 Open Backup.hhp, Not Backup.chm
 * Page 174: Chapter 6 FAQ Includes Questions from Chapter 5



Readme.txt: Support Text is Localized for US Only
Under "HTML Help Support," the support clause describes options for customers in the United States only. Outside the United States, please contact your local Microsoft subsidiary for further support information. A list of all Microsoft subsidiaries worldwide is available from the following Web site:

http://www.microsoft.com/

Page 8: Text Incorrect
Page 8, under the subheading What Needs To Be Installed:

Change: "Follow the instructions with included with the CD"

To: Follow the instructions included with the CD

Page 31: Text Incorrect
Page 31, third paragraph, last sentence:

Change: "the user most scroll"

To: the user must scroll

Page 61: Text Incorrect
Page 61, second Step 2:

Change: "Choose Project and click Next."

To: Choose Project and click OK.

Page 62: Screenshot Incorrect
Page 62, screenshot:

Just under the [OPTIONS] header, the following line should appear:

Compatibility = 1.1

Page 63: Screenshot Incorrect
Page 63, screenshot:

In the file listing on the screen shot, main.htm is listed twice.

This will not occur on your screen.

Page 64: Default Help Topic Does Not Match Book
The ICECREAM.CHM default page displayed after completing step 4 on page 64 might not match the "Guide to Using YUM" page shown in the book.

The order of the files in the [FILES] list is determined by how you added the files. If the first HTM file is selected and then the last file is Shift selected to accomplish step 3 on page 63, then WORKING.HTM will be the top file instead of MAIN.HTM. Specifying a default page overrides the file order.

Add the following text to page 63 after screen capture:

Specify a Default Topic File
 * 1) Click the Change Project Options button (located directly below the Project tab).
 * 2) Click the General tab and then the Default File box.
 * 3) Type MAIN.HTM and then click OK.

MAIN.HTM will now be the default file that is displayed first whenever the compiled HTML Help file is opened.

Page 65: Step 7 "Inconsistencies" should be "Definition"
Page 65, Step 7:

Change: "The Resolve Window Inconsistencies wizard will appear."

To: The Resolve Window Definition wizard will appear.

Page 71: Step 3 - Click Save (not OK)
Page 71: Step 3

Change: "click OK."

To: click Save.

Page 73: create the keyword Basics not Basic Concepts
Page 73, Practice Exercise:

The instructions indicate that you should create a keyword "Basic Concepts". The illustration that follows on page 75 shows the keyword created as "Basics".

Change:

"On your own, create a keyword 'Basic Concepts' that..."

To:

On your own, create the keyword 'Basics' that...

Page 79: Step 3 Text Incorrect
Page 79, step 3:

Change: "Change the title to Guide to Using YUM and the default window to Main, as shown below."

To: Change the title to Guide to using YUM, the default file to main.htm, and the default window to Main.

Page 80: Extra Steps Needed
On page 80, insert the following steps before step 1 in the "Recompiling and Viewing the Results" section:
 * If you have not already done so, close the already-compiled HTML Help window.
 * Click Add/Modify Window Definitions.
 * On the Files tab, make sure that the TOC is Icecream.hhc and the Index is Index.hhk.

Page 121: Technical Correction
Page 121, answer #2:

Change answer from "With HTML Help 1.1 you can only define one Category...." to read as follows:

Yes. You can define as many Categories as you want using HTML Help 1.1.

Page 121: Text Incorrect
Page 121, paragraph 9:

Change: "They also allow you write for"

To: They also allow you to write for

Page 138: Text Incorrect
Page 138, Step 4:

Change: "accrec.chm::/accrec.hhc"

To: accrec.chm::\accrec.hhc

Page 154: Popup Source Parameters Incorrectly Defined
Page 154: "Understanding the Popup Source Code"

Parameters for this line of code: back up set Read:

...and the margins for the popup, (left margin of 10 pixels, right margin of 10 pixels, top margin of 10 pixels, bottom margin of 10 pixels).

Correction:

The last two parameters control foreground and background colors.

Change code to: back up set Change parameter definition to:

...and the margins for the popup, (left margin of 10 pixels, right margin of 10 pixels, -1 for default foreground color, -1 for default background color).

Page 167: Step 1 Open Backup.hhp, Not Backup.chm
Page 167: "To Apply a Custom Icon to a Content Entry"

Change:

1. With BACKUP.CHM open, click the Contents tab.

To:

1. With BACKUP.HHP open, click the Contents tab.

Page 174: Chapter 6 FAQ Includes Questions from Chapter 5
The Frequently Asked Questions section of chapter 6, on page 174, includes two questions that are identical to those in the chapter 5 Frequently Asked Questions section.

Here is the Frequently Asked Questions section that should have been included on page 174:

Question: I think it's great that I can have text popups in HTML Help, but there are cases where I need to have more complex topics, specifically popups that contain graphics. Is there any way I can do this?

Answer: Eventually, you will be able to create HTML Help popups that contain rich text and graphics. In the meantime, if you must have rich popups (and if you know your system will be run under Windows), you can create jumps that display WinHelp popups.

Question: When creating WinHelp files, I used the EP macro to allow the user to run other applications by clicking a hotspot. I understand that I can do something similar with HTML Help's shortcut feature, but I don't know what this Message, Wparam, Lparam stuff is all about. Can I produce the equivalent of the EP macro?

Answer: Yes. The Shortcut command gives you the ability to launch another program, plus send messages to that program. If you don't know what these messages are or how to use them, don't worry: no one is going to force you to use them. Microsoft Press is committed to providing informative and accurate books. All comments and corrections listed above are ready for inclusion in future printings of this book. If you have a later printing of the book, it may already contain the above corrections.

Additional query words: press ms_press htmlhelp

Keywords: kbinfo kbdocerr kbhtmlhelp KB183377

-

[mailto:TECHNET@MICROSOFT.COM Send feedback to Microsoft]

© Microsoft Corporation. All rights reserved.