Creating a common topic for document titles

Last Updated : Aug 08, 2017 |
Prolog information
Metadata
Keywords:
Every project must have a common topic that contains a list of all of the publication titles for your project. Writers for that project or other projects can reuse the titles in the topic. The topics are stored in the same folder to which everyone has access.
Important:
If you have to change or add new titles for a release and you have to create a new version of the topic, you must include the product release for which the doc titles apply in the Changes field. This will help writers who reuse your topic know which version to use.
  1. In the Tridion Docs repository, go to the folder Common DITA Supporting Content/Project document titles/topics.
  2. On the toolbar of the right pane, click New Object icon.
    STEP RESULT:
    The system displays the Select Template dialog box.
  3. Select the Document titles template and click Next.
  4. Complete the fields on each tab as appropriate.
    ADDITIONAL INFORMATION:
    Important:
    Ensure that the Tridion Docs title includes the product name, so that writers are aware of the project for which they need the document titles to be reused. For example, CM Document Titles.
  5. Click OK.
  6. Check out the topic.
  7. Put each document title in a cite element in a list item.
    ADDITIONAL INFORMATION:
    If the title includes a product name, reuse the product name in the cite element. If your document has a document number, you can put the cite element and document number in a ph element. You can then reuse the ph element in other topics so that you get both the document title and number.
  8. Add an element ID to each cite element, as well as any other elements that you might want to reuse.
    ADDITIONAL INFORMATION:
    For example, if you wrapped a cite element and a document number in a ph element, apply an id to the ph element.
  9. If you include any text in the topic, such as descriptions or instructions that are not part of the titles and will not be used in any output, set the translate attribute to no in the attributes for that element
  10. Check in the topic.