Options Dialog

This dialog lets you choose miscellaneous global settings. To open this dialog you must first have a Doc-To-Help project already open. Then, select File > Doc-To-Help > Common Tasks > Options.

Prompts

Set various confirmation prompts. If these check boxes are selected, in most cases a message box will be displayed when you perform these functions. These messages can also be turned off by selecting the "Don't show me this again" check box when the message box is displayed.

  • Confirm editing properties of multiple topics If you select more than one topic in the Topics window, and then click the Doc-To-Help ribbon > Topic Properties button, you will be reminded that you will be editing the properties for all selected topics.

  • Confirm adding documents outside source document folders If adding a document to your project using drag-and-drop, you will be informed if the document is not stored in the correct folder. You should always copy documents to the correct folder before adding them so that the links don't break and the project is self-contained.

  • Confirm using Windows System colors If you change the System background color for a JavaHelp or NetHelp target, you will be informed that system colors are specific to Windows and explain how this will be handled for the target.

  • Prompt installing Microsoft Help Viewer target after build If you built a Microsoft Help Viewer target, you will be asked if you would like to install the target. If yes, it will open the Help Library Manager so you can add the project to the Microsoft Help Viewer and look at it.

  • Prompt viewing help target after build After every build or rebuild, you will be asked if you would like to view the target.

  • Prompt if Word add-in is disabled on startup If this option is selected, you will be alerted if the Word add-in has been disabled for Doc-To-Help. If the add-in is disabled, you will not be able to use the Doc-To-Help features in Word. You will be able to re-enable the add-in from the prompt (you can also re-enable the add-in manually from the Word Options dialog). You can also navigate to C:\Program Files (x86)\MadCap Software\DocToHelp on your computer, and run D2H.EnableWordAddIn.exe to enable the add-in.

Build
  • Display Progress Panel in all open Word documents during build If this option is selected and 1) you start building a new target while the Doc-To-Help Build panel is closed OR 2) you start building a new target and close the Doc-To-Help Build panel, the Doc-To-Help Progress panel opens automatically in all open Word documents for this project. This panel displays build status messages and build progress percentages. See Doc-To-Help Progress Panel.
  • Display Build Log automatically for each build This will display the build log at the bottom of Word while the build is in progress if this option is enabled.

Default location for Doc-To-Help projects

Change the default location for Doc-To-Help projects.

User-defined themes location

Change the default location for Doc-To-Help custom themes. See Themes.

Highlight new project items

Change the default "new project" colors for your team projects.

Checkout

Set Check Out options. See Team Authoring.

Default when opening shared Word documents

Change the defaults for opening shared Word documents (open local copy, open document on server, or prompt to open document on server).

For more about SharePoint, see Merging Word Documents.

Check out Word documents when editing local copy

When selected, Word documents will be checked out of the SharePoint Library automatically when you open them in Doc-To-Help.

Synchronize Word documents with SharePoint Library

Change the defaults for synchronizing Word documents with the SharePoint library (when document is opened, saved, or closed).

Synchronize all shared documents with Library

Change the defaults for synchronizing all shared documents with the SharePoint library (when target is built).

Check for latest Doc-To-Help version

Select whether or not you want to check for updates when Doc-To-Help is opened. If you want to check for updates automatically, and a new version of Doc-To-Help is available, the Doc-To-Help Update dialog will open. The update number and new feature list will be displayed. Click Download to download the update.

Location of the Eclipse executable

Specify the location of the Eclipse executable file (eclipse.exe) on your machine. Doc-To-Help requires this information to view Eclipse Help.

EPUB reader executable

Specify the location of the EPUB reader executable on your machine. Doc-To-Help requires this information to view EPUBs.

Use the following version of Microsoft Help Viewer

Specify the version of the Microsoft Help Viewer to use when viewing Microsoft Help Viewer targets. Options available depend on your Visual Studio installation.