Publish Content Fragments

Create a Content Fragment model in Adobe Experience Manager Assets.

Create a folder where you want to save the Content Fragments that you create based on the Content Fragment model. For example, “stock-content-fragments”.

Edit the folder’s properties (for example, “stock-content-fragments”) and add the path of the folder, which contains the Content Fragment model in the cloud configuration.
For example, add /conf/we-retail in the cloud configuration. This configuration connects all the Content Fragment models with the folder.
{width="650"}
Add the cloud configuration in the folder properties to connect it with the fragment models.

To generate a Content Fragment, select New Output from the Outputs section in the File Properties of a topic.

Select Content Fragment.
{width="300"}

Add a new Content Fragment from the File Properties of a topic.

In the Generate Content Fragment dialog box, fill in the following details under the General and Mapping tabs.

General tab

Add the path, name, title, and condition filtering to publish a topic or its elements as a Content Fragment.

• Path: Browse and select the path of the folder where you want to publish the Content Fragment. If you select an existing Content Fragment, it overwrites the contents of the mapped fields.

• Title: Type the title of the Content Fragment. By default, the title is populated with the title of the topic. You can edit it. This title is used to generate the name of the Content Fragment.

• Name: Type the name of the Content Fragment. By default, the name is populated with the title of the topic, and the spaces are replaced with ‘_’. For example, sample_content_fragment. You can edit it. This name is used to generate the URL for the Content Fragment.

• You can select different conditions to create content fragment variants. Select one of the following options:

  note note
  NOTE
  Conditions are enabled only if condition attributes are defined in the topic.

  • None: Select this option if you don’t want to apply any condition on the published output.
  • Using DITAVAL: Select the DITAVAL file to include or exclude specific content in the generated output. You can select the DITAVAL file using the browse dialog or by typing the file path.
  • Using attributes: You can define condition attributes in your DITA topics. Then, select the condition attribute to publish the relevant content.

Mapping tab

Select the content fragment model, and add the mapping details to publish a topic or its elements as a Content Fragment.

• Model: Select the Content Fragment model that you want to use to create your Content Fragment. The models are picked from the folder, which you have configured on Experience Manager Guides server.

• Mapping: You can view the topic elements that have an id attribute applied to them. Drag the topic elements to the fields present in the content fragment model.
  The right side is populated with the published Content Fragment contents in case of an existing Content Fragment. These can be overwritten with the topic contents if necessary. You can also select Undo to revert the mapping changes.

  note note
  NOTE
  If you are using 4.4 or earlier versions, select a mapping from the drop-down. It picks the mappings from the contentFragmentMapping.json file. Your administrator can add the mappings in the contentFragmentMapping.json file. Learn more about how to create a mapping between a topic and a Content Fragment in the Installation and Configuration Guide.

Click Generate to publish the Content Fragment.

You can view the Content Fragments for a topic under the Outputs section in the File Properties.

{width="300"}

View the Content Fragments present for a topic and republish them.