Publish Content with Heretto Deploy

You deliver content from your content library to a Content Portal instance by modifying an existing sitemap or creating a new sitemap.

Note: Your content library may contain multiple sitemaps associated with different portal instances such as production (public) or staging (internal) instances. We recommend keeping the sitemaps associated with production (public) Content Portal instances on distinct branches different than the default “master” branch.

Any configuration, style, behavior, or content changes that you make to the sitemaps associated with your Content Portal instances are instantaneous.

For more information about branching, see Branches.

For more information about the recommended sitemap structure, see Content Portal Layout and Navigation.

For more information on how to create and manage maps, see Create a DITAVal.

  • To update content on an existing Content Portal instance:
    1. Locate the sitemap associated with the Content Portal instance that you want to update.
      For more information, contact your Heretto CCMS administrator.
    2. To filter out specific content from the publication, see Filter Portal Content.
    3. Update the sitemap contents.
      Tip: You can merge content to quickly update a sitemap.
  • To prepare content for a new Content Portal instance:
    1. In the content library, create a sitemap.
    2. To filter out specific content from the publication, see Filter Portal Content.
    3. Associate the sitemap with a new Content Portal instance.
      Reach out to your Customer Success Manager.

Filter Portal Content

You can filter content on your Content Portal by adding a DITAVAL to the associated sitemap.

Tip: You can filter out your internal or in-progress content from your public Content Portal instance for every portal visitor.
  • Ensure that the content that you delivered or want to deliver to the Content Portal is profiled.

    For more information, see Profile Topic Elements and Profile Map Elements.

  • Locate the sitemap associated with your Content Portal.

    For more information, contact your Heretto CCMS administrator.

  1. Create a new DITAVAL or locate the existing DITAVAL that you want to filter the content on your portal with.
    For more information on how to create DITAVAL files, see Create a DITAVal.
  2. Associate the DITAVAL with the sitemap by doing the following:
    1. In the content library double-click on the sitemap that you want to modify to open it in the Content Editor.
    2. Navigate to the DITAVAL file.
    3. While holding the Shift keyboard key, drag and drop the DITAVAL file to the end of the sitemap.
      Inserting a DITAVAL file
    4. From the dialog, select Data and click Insert.
    5. In the left pane, right-click the DITAVAL and select Edit element attributes.
    6. In the Edit Properties window, in the name field, enter content-api-default-audience
    7. If needed, clear the scope field by clicking the corresponding trash icon.
    8. Click Save.

Profile Topic Elements

Use the Content Editor to conditionalize elements in a topic for conditional publishing.

The default conditional processing attributes are: audience, rev, platform, product, props, and otherprops.
  1. In the content library double-click a topic or a map.
  2. Place your cursor in the element you want to set a conditional processing attribute values on.
    Note: It is a best practice to profile grammatically independent elements, not just individual words or phrases. This is especially important when localizing the content, since at least a complete sentence is required to provide sufficient context for accurate translation memory and machine translation matching. This is true even if some text is duplicated across alternative elements for different conditions. When localizing content, it's always best to think of it grammatically first, then structurally.
  3. Click Attributes to open the Attributes tab.
  4. Navigate to the conditional processing attribute that you want to define, for example audience.
  5. Enter the values for each conditional processing attribute that defines the condition in which the element will be shown.
  6. Press the Enter keyboard key to apply attribute values.
Depending on the action defined for a specific value at publish time, content is either flagged, excluded, or included. If no action is specified for a specific value, the default is to include the content (unless your publishing profile sets the default to exclude).

Profile Map Elements

Use the Content Editor to set conditional processing attribute values and profile an entire topic (topicref element) or a submap (mapref element) for conditional publishing.

The default conditional processing attributes are: audience, rev, platform, product, props, and otherprops.
Note: When you apply a conditional processing attribute to a parent topic (topicref element), the same attribute applies to all children of that topic.
  1. In the content library, double-click a map.
  2. In the left pane, hover over the element you want to set the conditional processing attributes for and click the wrench icon.
  3. Enter the values for each conditional processing attribute that defines the condition in which the element will be displayed.
    If the topic is only intended for administrators, in the audience field enter administrator
    Tip: To add multiple values for conditional processing attributes, insert a space between each value.

Create a DITAVal

Create a DITAVAL containing include or exclude rules to filter content at publish or during editing.

  1. In the content library, navigate to a folder and click Create New.
  2. Select DITAVal to open the Create new window.
  3. Enter a name for the file.
  4. Optional: Create the file in a folder different from the current folder by clicking Change and selecting a new location.
  5. Optional: Assign the file to collections by clicking Collections and selecting collections from the list.
  6. Optional: Assign metadata to the file by filling in the Metadata fields.
  7. Click Create & Edit.
  8. Edit or remove the default property, or click Add Prop to add a new action.
You can use this DITAVAL to publish or filter your content as your edit or preview files in your content library. For more information, see Create a DITAVal or Filter Content with a DITAVAL.