Including Specifically Linked Content

One way to completely exclude content from online output is to place condition tags on the topic files and include or exclude them from the targets (see Conditions). Another method is to use an option in the Target Editor to include only content files that are linked in some way from the target or the associated table of contents (TOC). These options can be especially useful if you are publishing output to Salesforce, ServiceNow or Zendesk. However, you do not need to be publishing to Salesforce, ServiceNow, or Zendesk to use the options.

Permission Required?

Editing content and project files is an activity available to users with the Author status. By default, users with Author status have the following permissions set:

  • If this is deselected, then viewing files in a read-only mode is allowed. On the left side of the page, the Files vertical three-dot menu is not available.

  • If this is deselected, the XHTML in the Code view is read-only.

    Editing code is regarded as a capability for an advanced user. If not done properly, the code can become malformed quickly. Administrators can prevent users from editing the code by deselecting the Edit Code permission.

For more information about permissions, see Setting User Permissions or Setting Team Permissions.

How to Include Specifically Linked Content

  1. From the Projects page (Files tab), open a target and in the upper-right click Edit.

  2. On the left, make sure General is selected.

  3. Click the Content to Include field.

  4. Select one of the options.

    • All Content All files will be included in the output, unless they are excluded by conditions or some other means.

    • Content linked directly or indirectly from the target If the target is using particular files such as a table of contents (TOC), template page, and so on, other files linked directly or indirectly from them will be part of the output.

      Example Your target points to a TOC that includes Topic A, Topic B, and Topic C. If you generate an online output and use this option in the Target Editor, all three of those topics will be included in the output. In addition, Topic D will be included in the output. Although Topic D is not found in the TOC, a cross-reference to it is found in Topic B; it is linked to the TOC (and the target) indirectly. Topic E is not included in the output, because it is not found in the TOC and none of the topics to be included in the output contain a link to it.

      Using this option can help prevent bloated output by excluding unused files.

      Example You have 1,000 images in your project, but only 500 of them are used in the HTML5 output you want to generate. By using this feature, only those 500 images are included in the output, thus keeping the output file size down to a minimum.

    • Content linked directly from the TOC Only content files that are linked directly from the TOC are included in the output.

  5. Click Commit. (Or click Cancel, to back out of the process.)

  6. In the Create New Commit dialog, enter a Commit Message.

  7. Click Commit.