The Documents Tab

If you created a new project, Doc-To-Help Express automatically creates a new document and a glossary and places them in the document tree. If you are working with an existing project, the help target documents appear in the document tree in the same order they appear in the table of contents.

The document tree is designed to help organize the documents that will appear in the help target. Below the document tree are the Document Organization buttons, a series of arrow buttons that control the hierarchy of the table of contents in the help target. To organize the documents:

      Use the Move Up and Move Down buttons move the position of a document in the help target.

      Use the Move Left and Move Right buttons respectively create or remove document hierarchy.

      You can also move documents up and down in the document tree by dragging and dropping the document in the desired position. 

Note: The hierarchy of the documents in the document tree does not affect the output in the help target. This is determined through the document type.

There are two types of documents in the document tree single and multiple topic documents.  

      Single Topic Documents inherit their hierarchy from the Topic Style property.

      Multiple Topic Documents inherit their hierarchy from topic header formatting.

Word documents are always considered multiple topic documents and their properties cannot be changed. Multiple topic documents can only have no Topic Style, which places them at the first level on the document tree. The Topic Style relates to the level of a single topic document in the document tree. It is helpful to keep both the position of the document in the document tree and the style level the same.

Since Word documents can only be multiple topic documents, Word documents cannot have children documents, nor can they be a child document either to another Word file or to an HTML document. Only single topic HTML documents can have children documents. There must be a single topic file within the document tree before a child document can be added. A child document can also have a child document attached to it.

To quickly move about the Document tab, simply right click on a document. This opens up a menu with the same commands as the buttons on the page, as well as the option to skip straight to the build process by clicking Compile.

The Document Properties button beneath the document tree allows you to modify the properties of HTML documents in the document tree. In the document tree, Single Topic documents inherit the title of the document. Selecting a single topic document requires that the title be specified in the Title box. The Topic Style relates to the document level in the document tree. You can choose a Topic Style that is not currently in the document tree by checking the Show all styles box.

Note: Selecting a style different from a level the document tree will result in a warning that the Style level does not correspond to the level of the document tree. It will ask you if you want to choose a different style level before proceeding. If you choose to continue without making changes, your help target will be built according to the Topic Style settings of each document.

Adding Word Files

1.   Select a file in the document tree that precedes the document that you want to add.

2.   Click the Add button. The Add Documents dialog box opens. Make sure that the Files of Type drop-down is set to Word Documents or Rich Text Documents

3.   Browse to find the file that you want to add and select it. 

4.   Click OK and the file will be added after the file that you had selected in the document tree.

Adding HTML Files

1.   Select a file in the document tree that precedes the documents you want to add. 

2.   Click the Add button. The Add Documents dialog box opens. Make sure that the Files of Type drop-down is set to HTML Format

3.   Browse to the file that you want to add. 

4.   Another dialog box will appear where you can set the following options.

5.   Select the number of topics per document: single topic or multiple topics. HTML documents can contain a single topic or multiple topics. Single topic documents can have children documents, whereas multiple topic documents cannot.

6.   Select how to add the document to the document tree: as children or siblings of the selected document. Selecting children will place the current document as a subtopic of the selected document in the document tree. Selecting sibling will place the current document at the same level as the selected document.

Note: To add a child document to the document tree it must be attached to a single topic HTML file.

7.   Select the Document Style. The document style level corresponds to the level of the document in the document tree. Selecting the Show all styles checkbox will show all available styles, which may not correspond to the current document level in the document tree. 

Note: Selecting a style that does not correspond to the document tree will result in a warning that the Style level does not correspond to the level of the document tree. It will ask you if you want to choose a different style level before proceeding. If you choose to continue without making changes, your help target will be built according to the Topic Style settings of each document.

8.   Check the box to add default style sheet to the document.

9.   Click OK and the file will be added after the file you had selected in the document tree.