Doc-To-Help What's New
Doc-To-Help functionality has now been incorporated into Microsoft Word. Functions that were previously done directly in the Doc-To-Help program are now done in Word. The following information describes how Doc-To-Help is used within Microsoft Word.
A Doc-To-Help project can now be opened directly in Word. When you click the File menu in Word, the Doc-To-Help menu is now available. This is the initial menu for Doc-To-Help that will display when you create a new project or open an existing project.
The Getting Started submenu allows you to do one of the following when you select the Open/Create section:
- Open an existing project
- Create a new project
- Open a sample project
The Help section of the Getting Started submenu gives you access to the following Doc-To-Help features in Word:
- Open the Help system
- Go to the Doc-To-Help website
- Visit MadCap Software's online forums
- Download PDF manuals for Doc-To-Help
- View video tutorials for using Doc-To-Help
- Report Doc-To-Help issues
- View/Download Doc-To-Help updates
- Deactivate Doc-To-Help on your computer
Once you have a Doc-To-Help project open in Word, this menu will expand to include the Project submenu.
This ribbon provides the ability to add and edit topics, insert headings, modify styles, add links, and glossary terms.
In the D2HML Styles section of this ribbon, you can add Links, Inline Text, Keywords, assign a specific topic to a Group, assign Link Tags, and assign Conditional Text. See About Styles.
The Variable function in the Doc-To-Help ribbon allows you to insert a new variable in your content. This dialog also allows you to hide the properties of this variable in the document. See About Variables.
You can also earmark certain sections as collapsible in your content, clear any custom formatting on selected text, and apply any D2HML styles from a drop-down list.
This is a new ribbon in Word. Targets can be added, built, and published within this ribbon.
The Active Target for your Doc-To-Help project can be set to any target that you have already created in your project. The Target Properties button allows you to add, edit or delete any targets. See Editing Target Settings.
The targets can be built ad-hoc or by scheduling a build. You can also Rebuild your target or schedule your target to be rebuilt. The build of the active target can be viewed, or you can cancel an ongoing build. Once the target has been built, you can view the Build Log, or Publish to Sharepoint. See Building Targets.
The default themes of your targets can be modified. You can also add a new theme using the Wizard or Designer. See About Themes.
Your Templates can similarly be managed in this ribbon. Use the Target Template button to change your default template of your project. You can also Add, Edit, or Remove templates. See About Templates and Styles.
This is also a new ribbon in Word used for your Doc-To-Help projects. Project settings can be modified in this ribbon. You can also apply attributes and styles to your Doc-To-Help project.
The Topics Panel is now displayed through the Project ribbon. When you click on the Topics Panel button, it displays each of the topics. See Topics Window Panel (Word).
Templates are now added and managed through the Project ribbon. See About Templates and Styles.
The Team Authoring functions are available once your Doc-To-Help project has been committed to a shared repository such as TFS, a file system repository, or web repository. See About Team Authoring.
This embedded panel now allows you to add and manage elements of your Doc-To-Help project. The Related Topics view has been added to this panel.
This panel allows you to add or edit Documents, Contents, Index and Groups, Variables and Related Topics. You can expand or collapse all of the elements within a specific tab, or you can create a filter within the tab. See Doc-To-Help Project Panel.
The Documents view gives you the functionality to create a new document, add existing documents, rename or remove documents. You can also convert selected documents to an HTML5 format. You can also move selected documents up or down in the hierarchy of your project. Selected documents can also be moved out or in to promote specific documents. See Documents Window View (Word).
In the Contents tab, you can create a book, or rebuild a table of contents. You can also create a target-specific table of contents in this view. See Contents Window View (Word).
Keywords can be created or grouped. You can also add secondary keywords to an existing keyword. See Creating Index Keywords in a Project.
Variables can be created and modified in the Variables view of this panel. You can use specific buttons in this view to create text variables, Version variables or Date/Time variables. You can also create new variable documents for rich content variables, add existing variable documents, convert existing variable documents to HTML5, rename a variable document or delete a variable document. See About Variables.
In the Related Topics view, a secondary pane opens that will show the selected topic that expands to display related topics. You can also Disable Subtopic Relations in this view. See Related Topics Window View (Word).
Note: TFS 2010, 2012, 2013, 2015, 2017, and TFS Online are now supported for Doc-To-Help projects.
Note: For any Doc-To-Help projects that have HTML5 source documents, those projects must still be managed through the Doc-To-Help program directly. To access the program, double-click on the Doc-To-Help.exe file in the following location in Windows Explorer: C:\Program Files (x86)\MadCap Software\DocToHelp.
Note: NetHelp output can now be viewed on your local system in any supported browser without needing to view it through the Doc-To-Help program.