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:
{width="500"}
Add the path, model, and mapping details to publish a topic or its elements as a Content Fragment. You can overwrite an existing 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.

• 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 in the cloud services.

• Mapping: 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.

• You can also select different conditions to publish the content. Select one of the following options:

  • None: Select this option if you don’t want to apply any condition on the published output.
  • Using DITAVAL: Select the DITAVAL file to generate output, which includes specific content. 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.

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

• Select Overwrite existing content if your Content Fragment already exists and you wish to overwrite it. Experience Manager Guides displays an error if you don’t select the checkbox and your Content Fragment already exists.

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.