My Experience with Dr.Explain

by Victor Wheeler
 
×
Menu
 

Settings Can Be Imported from Other Projects

 
Some settings in Dr.Explain are very detailed and can take a while to set up.  Once you do spend that time, the settings themselves can now have shelf life and be used in other projects.  One example is that you can have a large number of coordinated call-out styles all accessible via a few clicks from within the Annotation Designer.  Another example is that you can have very detailed, coordinated set of Screen Capture Scenario settings that govern how callouts are generated for screenshots being captured from running Windows applications.  Once a set of these groups of detailed settings is set up, it can be very handy to be able to save them externally, and/or pull them into other projects so that all the work done to set them up is preserved and can be applied to other projects.
 
 

Importing Settings from Other Projects:

 
All Dr.Explain project settings grouped into categories.  All such categories can be selectively imported from other projects via the Options > Import Settings... menu option, which opens the Import Project Settings dialog box.  In this dialog box, each such group can be checked or unchecked to be imported from another project into the project currently selected.  Note that the other projects do not need to be already open, because the dialog box permits you to select them from their .gui file.
 
The settings categories that can be thus imported are:
 
Common
Screen Capturing (sub-part Capturing Scenario can be imported/exported to/from .des1 file)
Screenshot Annotating (sub-part Annotation Template for one callout can be imported/exported to/from .dea1 file)
HTML Export
Sitemap
Comments and Sharing
Publishing
CHM Export
Help ID Management
CHM Compiler
RTF Export
PDF Export
Text Settings
Variables
Formatting Styles
 
 
All of these settings groups can be individually imported from an external project from the Project Settings dialog for the applicable settings group via the Actions button or Import Settings button in the upper-right corner of the window.
 
Some of these settings categories can be imported from other parts of Dr.Explain as well.  Among these are:
 
Settings Group
Accessed From
Actions Possible
Formatting Styles
Content Editor > Style > Edit...
Import Settings from .gui1 file
Annotation Designer Settings (a.k.a. Screenshot Annotating)
Annotation Designer2 > Annotation Designer Settings toolbar button
Actions button > Import Settings from .gui1 file
 
 

Exporting / Importing Settings to/from External Template Files:

 
Two subsets of these setting groups can also be exported as "settings templates" in external files thus can be later imported into other projects.  These include:
 
Settings Group
Accessed From
Actions Possible
Screen Capture Scenario Export (rules involved in creating callouts during screen captures)
Project Settings > Screen Capturing > Capturing Scenario > Edit
Export Settings to .des1 file.
Screen Capture Scenario Import (rules involved in creating callouts during screen captures)
Project Settings > Screen Capturing > Capturing Scenario
Select Scenario (.des1 file) from dropdown list.
Annotation Template (the settings representing ONE callout style)
Annotation Designer > Annotation Designer Settings > Edit (under desired Annotation Template icon in 2nd row of icons)
 
or Project Settings > Screenshot Annotating
  • Load Annotation Template,
  • Export Annotation Template to File.
 
(Both of these are small buttons in upper left corner of window and deal with .dea1 files.)
 
Notes:
 
1.  Dr.Explain file types are in the table below.
 
2.  Enter Annotation Designer by double-clicking on the screenshot image in a screenshot layout page, clicking on the Edit the Screenshot Annotation button at its base, or right-clicking the image and selecting the Edit... option.
 
 

File Types:

 
Extension
Description
.gui
Dr.Explain Project (contains all elements to generate output documents)
.dea
Annotation Template (contains all settings for ONE callout style)
.des
Screenshot Scenario Settings
 
 
The online help was created with Dr.Explain