Document! X 2017
Authoring Content / Topic Fundamentals
In This Topic
    Topic Fundamentals
    In This Topic

    Create and Manage Topics and Topic Categories 

    Create a New Topic

    Press the New Topic HotKey (Ctrl+T);

      or

    Click the  New Topic button on the Project Ribbon Tab;

      or

    Click the  New Topic and Table of Contents Node button on the Table of Contents editor Toolbar to create a Topic and a related Table of Contents node in one operation;

      or

    Select an existing Topic on the Project Explorer and click  Clone on the Right click Context Menu to create a new Topic that is a copy of that existing Topic;

      or

    Right click on a specific Topic Category and click  New Topic from the Context Menu to add a Topic to that Category;

    New Topics created using the HotKey or Ribbon button are added to the currently selected Topic Category. If no Topic Category is selected, the new Topic will be added to the (Un-categorized) category.

     

    Change Topic Properties (Name, Status, Title, Page Type etc.)

    1. Select the Topic or Topics in the Project Explorer;
    2. In the Properties Window, edit the desired properties. The changes will take effect immediately.

     

    Create a new Topic Category

    1. If you want to add a new Topic Category beneath an existing Topic Category, first select it in the Project Explorer;
    2. Click the  New Topic Category button on the Project Ribbon Tab;
    3. The New Topic Category will be created, selected on the Project Explorer. The new Project Explorer entry will be put in edit mode, allowing you to immediately type the name of the new Topic Category.

     

    Rename a Topic Category

    1. Select the Topic Category on the Project Explorer;
    2. In the Properties Window, type the new Name for the Topic Category.

     

    Move a Topic or Topic Category

    1. Select the item or items you wish to move;
    2. Drag and drop them to the new desired location on the Project Explorer. A drop indicator highlight will appear as you drag the items around the Project Explorer, indicating where the items will be moved to if dropped.

         - or -

    1. Use the Move Up and Move Down buttons to re-order Topics within a Topic Category, or Topic Categories within the parent Topic Category.

     

    Find a Topic or Topic Category

    1. Click the  Find toolbar button on the Project Explorer;
    2. Type part of the name or Title of the Topic or Topic Category you are looking for and press Enter or click the Find button in the edit box;
    3. The first match will be selected on the Project Explorer. Press Enter or click the Find button in the edit box again to find further matches.
    You can also perform more advanced searches, including searching in the Topic Content, using the Project Find and Replace tool (Tools Ribbon Tab).

     

    Topic Links, Images, See Also Links and Keywords 

    Add a Hyperlink to Topic Content

    1. Move the edit cursor to the point in the Topic content where you would like the hyperlink to appear. Select any existing text that you would like to use as the caption for the new hyperlink;
    2. Right click to show the Context Menu and click the Hyperlink toolbar button
       
        or
       
      Use the Hyperlink HotKey (Ctrl+K);
    3. The Link Designer dialog will be displayed, allowing you to choose the target and caption for the new hyperlink.

     

    Insert an Image in Topic Content

    1. Position the edit cursor at the point in the Topic content that would like to insert the image;
    2. Click the Image... button on the Content Authoring Ribbon Tab;
    3. On the displayed Image dialog, select the Image you would like to insert.

    If the image you select is a thumbnail (e.g. the filename without the extension ends with _thumb), the image will be inserted as a Dynamic Image Widget so that users of your content can enlarge the image in place.

    You can easily create a thumbnail for an existing full size image by right clicking the image in the Project Explorer and selecting Create Thumbnail.

     

    Add a See Also link

    Select See Also Links on the Topic Editor View bar and click the  New toolbar button;

      or

    Click the New button next to the See Also section at the end of the Topic Content in the Topic Editor.

    The Link Designer dialog will be displayed, allowing you to choose the target and caption for the new See Also link.

     

    Add an Index Keyword

    Select Index Keywords on the Topic Editor View bar and click the  New toolbar button;

    You can easily create keywords directly from content in the Topic Editor by highlighting some text and selecting Add as Keyword from the right click context menu.

    Creating hierarchical Keywords

    Keywords will be default appear at the top level of the generated Index. You can create hierarchical keywords by using the | character. As an example, the following keyword:

    Customer|Editing|Editing Customer Details

    Would appear in the generated Help System index as:

    Customer

    Editing

    Editing Customer Details

    You can include the same prefixes in multiple keywords. For example, the following 2 keywords, which could be defined in different Topics:

    Customer|Editing|Editing Customer Details

    Customer|Editing|Recording a Call

    Would appear in the generated Help System as:

    Customer

    Editing

    Editing Customer Details

    Recording a Call

    Microsoft Help 2.x Links

    When creating Microsoft Help 2.x systems, you can create 2 additional types of Index keywords in addition to those in the visible Index.

    Associative Keywords allow you to assign keywords to Topics that you can use to create links from other Topics. As an example, you could assign an associative keyword to each Topic related to a specific concept in your Help System. You would then be able to create a Help 2 link using that keyword; at runtime the Help System would show a list of Topics matching the associative keyword when the link is clicked.

    You create associative keywords by prefixing the keyword with the @ character.

    Context (F1) Keywords are used by Visual Studio to find Topics for the Dynamic Help window matching the current Visual Studio context. If you are developing Add-Ins, Designers or Components for the Visual Studio IDE you can contribute help context keywords. By defining matching Context Keywords in your Help System you can provide your users with F1 or Dynamic Help content based on context.

    You create context keywords by prefixing the keyword with the ! character.

     

    To enable or disable automatically generated Index Keywords for a Topic

    By default, Document! X will generate an index keyword for each Topic using the Topic Title.

    Disabling the automatic index keyword for all Topics

    You can disable this behavior throughout the whole project on the Topic Settings page in the Build Profile Editor.

    Disabling the automatic index keyword for a specific Topic

    You can also disable the automatic keyword generation for individual Topics as follows:

    1. On the Project Explorer, select the Topic that you want to prevent an index keyword from being automatically generated for;
    2. In the Properties Window, untick the Auto Index property.

    Enabling additional automatically generated categorized keywords

    In addition to the automatic keyword generated from the Topic Title, Document! X can also generate an additional hierarchical keyword based on the Topic Category. When this option is enabled (on the Topic Settings page in the Build Profile Editor), a top level keyword is generated for the Topic Category which contains a child keyword for each Topic in that Category.

    You can enable and disable the automatic additional keyword generation for individual Topic Categories as follows:

    1. On the Project Explorer, select the Topic Category that you want to prevent additional categorized index keywords from being automatically generated for;
    2. In the Properties Window, untick the Auto Index property.

     

    Custom Properties, Table of Contents and Tasks 

    Create a custom Topic Property

    1. Click the Project Settings button on the Project Ribbon Tab;
    2. Click Topic Properties on the Page Menu;
    3. Click the New toolbar button to define a new Topic Property, including the default value.

    Once the new Topic Property is defined, select one or more Topics in the Project Explorer and then define the value of your custom Topic Property in the Properties Window.

    You can use the Topic Property anywhere in the Topic Content by surrounding the Property Name with %% characters - e.g. %%MyCustomProperty%%. When the Topic is output, the %%MyCustomProperty%% placeholder will be replaced with the current value defined against the Topic for that property.

    Add a Topic to the Table of Contents

    Click the Add Sibling Node or Add Child Node toolbar button on the Table of Contents Editor. When the Project Link Designer dialog appears, select the Topic you want the new Table of Contents node to link to;

      or

    Select the Topic or Topics that you want to add to the Table of Contents on the Project Explorer. Drag and Drop the Topics on to the Table of Contents editor in the desired location.

     

    Mark a Topic as new in the Table of Contents

    Highlighting new Topics in the Table of Contents makes it easy for users of your Help System to identify new content when you issue a new version of your Help Systems. Document! X provides a structured way to mark Topics as new in the Table of Contents.

    By establishing (in the Build Profile Editor) a date after which Topics are considered new, Document! X can automatically identify new or changed Topics and mark them as new in the generated Table of Contents.

    To mark Topics as new using the Topic creation date

    1. Open the Build Profile Editor;
    2. Select the New Content Highlighting page;
    3. Tick the Automatically highlight new items tick box;
    4. Select the Date after which items are considered new at which Document! X should consider Topics as new;
    5. Select the Use the Topic Creation Date option to automatically identify Topics changed or created since the date value you specified.

    To mark Topics as new using a custom Topic property

    Configure the Build Profile to use the Custom Topic Property

    1. Open the Build Profile Editor;
    2. Select the New Content Highlighting page;
    3. Tick the Automatically highlight new items tick box;
    4. Select the Date after which items are considered new at which Document! X should consider Topics as new;
    5. Select the Use a custom Topic property option;
    6. Click the New Property button and on the displayed dialog set the Property Name to "Change Date" and a Property Type of "Date";
    7. The modification date to be used in determining new Topics can now be set using the Change Date property that appears in Topic Properties.

    Add a Task to a Topic

    Select Tasks on the Topic Editor View bar and click the  New toolbar button;

    The Task that is created will be associated with the current Topic and will be listed on the Task list in the current Topic.

    You can view a Project wide list of Tasks from the Tasks editor (Tools ribbon tab).