Organize Your Topics

THESE PAGES ARE STILL UNDER CONSTRUCTION AND DO NOT NECESSARELY REFLECT THE CURRENT VERSION OF TÓPICO

In this tutorial, you'll organize your topic collection hierarchically. This tree structure will be used to create your publication's main menu during the publishing process.

You can use the tree view on the left of the main form to add, delete, reorder and re-parent topics contained in your collection.

Add a new topic

To add a topic to the collection:

  1. Select the home (or parent) topic;
  2. Right click the selected topic;
    or Click the Edit button above the tree view;
  3. From the popup menu, select Add Topic; (1)
  4. Type the topic identifier and click Ok; (2)
  5. Select the template you want to use for the new topic;
  6. Type the navigation title of the page in the tree view label;
  7. Press Enter to complete editing the tree label and copy the text as the topic title.

(1) When you select the home topic as a parent, the new topic will become a top level menu item in your html publication.

(2) The page identifier is used a the root of the file name. To better promote the idea that a file name should be used as some useful identifier for it's content, this dialog box normalizes the text you enter.

New topics are added under the one that is selected. The navigation title you enter in the tree view is first copied to the topic title. Once the topic title is set, the navigation title and topic title are edited separately.

Add more topics

Add a few more topics to create a tree like structure for your collection:

  • My Collection (your collection's home page)
    • Section 1.0 (replace with you own label)
      • Topic 1.1
      • Topic 1.2
      • Topic 1.3
    • Section 2.0 (replace with you own label)
      • Topic 2.1
      • Topic 2.2
      • Topic 2.3
    • Section 3.0 (replace with you own label)
      • Topic 3.1
      • Topic 3.2
      • Topic 3.3

In the above map, the first level sections (1.0, 2.0 and 3.0) under the home page will become top level menus when the collection is published.

Reorder topics

To reorder or re-parent topics, select the one you want to move and then use the appropriate arrow buttons above the tree view.

Click To
move up Move the topic up in the tree. This will position the topic before it's previous sibling.
move down Move the topic down in the tree. This will position the topic after it's next sibling.
move left Move the topic left (higher) in the tree. This will position the topic after it's current parent.
move right Move the topic right (lower) in the tree. This will position the topic as the last child of it's previous sibling.
Tip

The Tutorial collection contains the above structure and some placeholder content in the topics. You can open it from the menu Help > Open collection > Tutorial.

Learn more in Organizing your topics.

THESE PAGES ARE STILL UNDER CONSTRUCTION AND DO NOT NECESSARELY REFLECT THE CURRENT VERSION OF TÓPICO

23 / 194