Adding a non-DITA file to a map

Last Updated : Nov 17, 2021 |
You can reference a non-DITA files, such as PDF and Excel in a map.
Prolog information
You must include the PDF or Excel file that you want to reference in a map regardless of whether you want it to appear in the table of content (TOC) or if you just want to insert an xref to it. Insert references to objects like PDF or an Excel file only in a publication that is published as HTML.
Important:
A PDF output with references to Excel or PDF fails.
Before you begin
  • Import the file into Tridion Docs.
  • A user who views the HTML must have appropriate application installed to view the type of file you want to include. Therefore, include common file types, such as PDF or Excel.
  1. Open the publication in Publication Manager.
  2. Expand the map where you want to add the reference to the non-DITA file:
    • To add an object before an existing object, right-click the existing object, and then click Insert before
    • To add an object as a child of an existing topic, right-click the parent topic, and then click Add within.
  3. Click Topic Ref.
    STEP RESULT:
    The map is automatically checked out and the Insert Values dialog box displays.
  4. In the Href field, click Browse and browse to the folder where the object is located.
    STEP RESULT:
    The objects are displayed in the right pane.
  5. Select the object that you want to add, and then click Insert.
    ADDITIONAL INFORMATION:
    Tip:
    Alternatively, you can drag the object and drop the file to where you want it inserted in the map. If you drag and drop the file into the map, make sure that you edit the XML attributes correctly.
  6. Set the attributes for the reference to the non-DITA file:
    1. In Navigation Title, type the name in the output for this file.
      ADDITIONAL INFORMATION:
      Provide complete navigation titles, such as Change history and Optimization and scalability. Titles such as Change history_SM_Dep and Optm & Scal are incorrect and cannot be translated.
    2. Click OK.
  7. If you are including the non-DITA file to add an xref to it and you do not want the file to appear in the TOC:
    1. Right-click the topicref, select XML Attributes.
    2. In the Toc field, click no.
    3. Click OK.
  8. Check in the map when you finish editing it.
  9. Edit the map in Oxygen XML Author to set the locktitle attribute so that the navtitle displays in the TOC or link text rather than the GUID:
    1. Right-click the map in the repository and click Check Out With and select Oxygen XML Author.
    2. When the map opens in Oxygen XML Author, place the cursor in the topicref that references the non-DITA file.
    3. In the Attributes window, in the Locktitle field click yes.
    4. Check in the map.