Download and install AEM Sites templates (Cloud services)

Clone Git repository:

1. Navigate to Repositories in the left panel of Cloud Manager.

2. Select Access Repo Info and copy the git clone command.

   {width="350"}

3. Clone the repository to your local system using the provided username and password (generate password if required).

Add Package to Maven Bundle:

1. In your locally cloned repository, create a new Maven bundle or add to an existing one.

2. Ensure the structure /jcr_root/apps/fmdita/install exists in the Maven project.

   {width="650"}

3. Place the downloaded guides-components.all-1.x.x.zip file in the install folder.

Update filters.xml:

1. Open the filters.xml file located in the META-INF folder of the parent content directory.

2. Add the following filter: filter root=“https://experienceleague.adobe.com/apps/fmdita?lang=en” mode=“merge”/

   {width="650"}

Configure pom.xml: Update the pom.xml file as per your environment requirements.

Push changes and run Pipeline:

1. Push the changes to the main Git repository.
2. Navigate to Pipelines in Cloud Manager and run the pipeline for the desired environment.

Verify installation: Once the deployment is complete, the components package will be installed on the AEM Cloud environment.

Import Sites Template:

1. Go to the AEM Sites page (servername/sites.html/content).
2. Select Create > Site from Template.
3. Import the sites template aemg-docs-1.x.x.zip using the Import option.

Select Template: Select AEMG Docs 1.x.x and then select Next.

Enter Site Details: Enter the Site Title and Site Name.

{width="350"}

Select Create.

Create a new preset:

1. Open a DITA map in AEM Guides and navigate to the Output panel.

2. Select Create Preset.

3. Select the type as AEM Sites.

4. Enter a name for the preset.

5. Uncheck the Use legacy component mapping setting.

   {width="350"}

6. Select Add to create the preset.

Configure AEM Site Preset: There are two options to configure the out-of-the-box (OOTB) site:

Option 1: Use the Site Dropdown

1. Select Site as the one created above (e.g., AEMG Docs Site).

2. Verify that the Publish path and Topic page template are automatically set to:

   • Publish path: /content/AEMG-Docs-Site/en/docs/product
   • Topic page template: Topic Page

   {width="350"}

Option 2: Use the Site Path

1. Set the Site path manually as /content/AEMG-Docs-Site/en/docs/product.

2. Verify that the Topic page template is automatically set to Topic Page.

   {width="650"}

Save the preset: Save the changes made to the preset.

Generate Site:

1. With the preset configured, generate the AEM Site for the corresponding DITA map.
2. The generated site will be available at the path: /content/AEMG-Docs-Site/en/docs/product.

Change the Default Generation Path (Optional): If you want to change the default path for site generation, perform the following steps:

1. Navigate to AEM Sites.

2. Create a new product page under the OOTB site structure.

3. Navigate to AEMG Docs > English > Docs.

   {width="650"}

4. Select the Home page tile and then select Next.

   {width="650"}

5. Enter the Title and Name for the page.

6. Select Create.