Navigation:  More Advanced Procedures > Working with Modular Help Systems >

Managing modules in the TOC

Print this Topic Previous pageReturn to chapter overviewNext page
Show/Hide Hidden Text

You can manage module entries in the Table of Contents (TOC) in exactly the same way as normal TOC items – they are normal TOC items.

Moving module entries

You can move module entries and change their level in exactly the same way as any other TOC entries.

To move a module entry:

Modules can be moved around in the TOC in the same way as ordinary topics:

Select the main module entry in the TOC with the mouse and drag it, or use the normal copy and paste methods to move by copying and pasting.

Select the entry and use cut and paste.
Use the and buttons in Write > Manage Topics.

To change the level a module entry:

Select the entry and click on the Promote and Demote buttons in Write > Manage Topics.

To delete a module entry:

Select the entry and press DELETE, or select Add Topic > Delete in Write > Manage Topics. (This does not delete the module project, it just removes the module entry from the current TOC.)

Copying modules, second copies of modules

"Copying" modules is not possible because they are really only references to entire help projects. If you want to insert the same module in a second project you must do this directly.

You cannot insert a second copy of a module entry within the same project. Please don't try to do this as it would cause irreconcilable conflicts in your output project because of the duplicate topic IDs and context numbers it would create.

Using include options on your modules

You can use conditional output include options on entire modules in the same way as you can on individual topics. To do this select the main module entry in the TOC and then select Project > Change > Include in Builds to select the include options for the module. You can also access the include options by right-clicking on the main module entry in the TOC. See Modular projects include options for full details.

How to access a child project's files and configuration settings

Even when the TOC of the your child project is visible in the master TOC you cannot see all of the child's topic files directly. Only the topic files with TOC entries are actually displayed in the master TOC. You can access topic files without TOC entries and the child's configuration settings in the Merged Projects section in the Project Explorer:

This section is located right at the bottom of the Configuration section. Note that like the TOC, the files and settings of merged projects are only shown for projects inserted in publish-time merging mode. Runtime-merged projects are just placeholders and are not really part of your project, they must be opened and edited separately.

See also:

Modular Projects (Reference)

 


Page url: http://www.helpandmanual.com/help/index.html?hm_advanced_modular_managingmodstoc.htm