Help editing tips

Navigation

Navigation is the movement to other pages.

Click page in content tree

The most direct form of movement is clicking on a page in the content tree.

Follow Hyperlink

Right-click on a hyperlink and click 'Follow Hyperlink' to move to the linked page.

Shortcut menu on hyperlink  

Back and Forward

Use the Shortcut menu Back and Forward to navigate the same way as with your browser.

Content tree

Content tree entries

There are three types of content tree nodes: 1. entries that are initially created by the generation process,  2. entries that have been added (New, Add) by the help author and 3. entries that are derived from control sections. Operations on nodes of the first and second type (1.,2.)  can be done thru rightclick on the node and selecting Delete, Exclude or Rename.

control sections

Changing content tree entries that are derived from control sections (rename, remove)

You can rename or remove entries that are derived from control sections by editing their section titles in the HTML page. Directly after moving to another page the comntent tree is updated.

Changing position in content tree

Control + arrows(up/down/left/right)

Moving to help topics and sections

When you click in the content tree on a page that page is automatically loaded (and previous loaded page saved!). For each control under a form there appears in the content tree a section 'subtopic'. Clicking on it automatically moves the HTML page focus to the corresponding section. Use TAB to enter directly in the selected section to start editing.

HTML editing

Entering tabs

When you press TAB while editing this does not insert a TAB in the page. Instead you will move to the next object (picture or table) in the page. Instead use Indentation

Indentation

To indent do menu: Format > Increase indent or on the toolbar

Fix HTML trouble

Switch on menu to View > HTML. The HTML is very readable because of our built-in HTML formatting.

Font preferences

Font preferences can be set using cascading style sheets. It is best to set the stylesheet on the Cascading Style Sheets step of the Help Generator Wizard. You can link stylesheets to pages manually in the editor thru menu: Format > Style >...

Links

Adding links

Links can be added in several ways to both the HTML page and the content tree:

In the content tree , select a node and:

In the HTML page (add hyperlink ), select a text and:

Change hyperlink URL

Edit Hyperlink text

Position the cursor in it and delete/insert characters.

Add Bookmark links

Bookmarks make it possible to link to a specific location on a page.

I. add bookmark:

  1. menu: Insert > Bookmark
  2. give a Bookmarkname (e.g. mybookmark)

II. Link to the bookmark

  1. Select the text to link from
  2. menu: Insert > Hyperlink
  3. Select T ype: Other
  4. enter #mybookmark and OK

Edit tables

Special table formatting

The built-in table editing possibilities are limited. For example you can not drag borders to resize columns. What you can do is use another editor like Word to make the table the way you like it and copy / paste it in the Help editor. Note that

Delete a table

Select a table by clicking on it's borders and then press delete. Selecting the table is succesful if you see small squares appear at the corners of the table.

Make headers

Menu: Format > Style > Header ..

Hotspots

To change hotspots positions you need to switch to HTML mode and look for MAP. An alternative is to use a hotspot editor , such as is present in FrontPage.

Editing Hotspots

For coords the subsequent values mean left-x, top-y, right-x, bottom-y.  

Remove a hotspot

Remove the corresponding line.

Add a hotspot

Add the corresponding line.