Documentazione AEM Guides Documentazione di AEM Guides

Scaricare e installare modelli AEM Sites

Last update: Fri Apr 10 2026 00:00:00 GMT+0000 (Coordinated Universal Time)

Argomenti:

Creato per:

Esperto
Amministratore

Questa guida fornisce istruzioni dettagliate per impostare e configurare il modello AEM Guides più recente per la generazione di pagine AEM Sites in un ambiente cloud. Segui questi passaggi per installare i pacchetti richiesti, creare e configurare i predefiniti e generare AEM Sites.

Prerequisiti

Le schede seguenti forniscono i prerequisiti necessari in base alla configurazione di Experience Manager Guides: Cloud Service o On-Premise.

Cloud Service

Adobe Experience Manager (AEM) Cloud: istanza in esecuzione di AEM as a Cloud Service con AEM Guides 2502 o versioni successive.
Autorizzazioni richieste: è necessario disporre delle seguenti autorizzazioni:
- Accedi a Cloud Manager per distribuire i pacchetti.
- Accesso a Archivio Git associato al tuo ambiente.
- Autorizzazioni per creare e modificare i predefiniti in AEM Guides.
Scarica pacchetti: scarica i seguenti pacchetti dal portale di distribuzione software:
- Pacchetto componenti: guides-components.all-1.x.0.zip
- Modello siti: aemg-docs-1.x.0.zip

On-Premise

Adobe Experience Manager (AEM): un'istanza in esecuzione di AEM 6.5 con Service Pack 21, 20 e 19 e AEM Guides 4.6.0 o versioni successive installate.
Autorizzazioni richieste: assicurati di disporre delle seguenti autorizzazioni:
- Accedi a Portale di distribuzione software per scaricare i pacchetti richiesti
- Accedi a Gestione pacchetti CRX per installare i pacchetti in AEM.
- Autorizzazioni per creare e modificare i predefiniti in AEM Guides.
Scarica pacchetti: scarica i seguenti pacchetti da Portale di distribuzione software:
- Pacchetto componenti: on-prem-guides-components.all-1.x.0.zip
- Pacchetto Sites: aemg-docs.all-1.x.0.zip

Installazione del pacchetto

Le seguenti schede forniscono istruzioni per l’installazione del pacchetto in base alla configurazione di Experience Manager Guides: Cloud Service o On-Premise.

Cloud Service

Installa il pacchetto Components (guides-components.all-1.x.x.zip) ed esegui i seguenti passaggi

Clona archivio Git:
1. Passa a Archivi nel pannello a sinistra di Cloud Manager.
2. Seleziona Accedi a dati archivio e copia il comando di clonazione Git.
  
  {width="350"}
3. Clona l’archivio sul sistema locale utilizzando il nome utente e la password forniti (genera la password se richiesta).
Aggiungi pacchetto al bundle Maven:
1. Nell’archivio clonato localmente, crea un nuovo bundle Maven o aggiungilo a uno esistente.
2. Verificare che l'installazione della struttura /jcr_root/apps/fmdita/ esista nel progetto Maven.
  
  {width="650"}
3. Inserisci il file guides-components.all-1.x.x.zip scaricato nella cartella di installazione.
Aggiorna filters.xml:
1. Aprire il file filters.xml che si trova nella cartella META-INF della directory del contenuto padre.
2. Aggiungi il seguente filtro: radice filtro=/apps/fmdita modalità=merge/
  
  {width="650"}
Configura pom.xml: Aggiorna il file pom.xml in base ai requisiti dell'ambiente.
Invia modifiche ed esegui pipeline:
1. Invia le modifiche all’archivio Git principale.
2. Passa a Pipeline in Cloud Manager ed esegui la pipeline per l’ambiente desiderato.
Verifica l'installazione: Una volta completata la distribuzione, il pacchetto dei componenti verrà installato nell'ambiente AEM Cloud.

On-Premise

Installare il pacchetto componenti:
1. Passare a Gestione pacchetti CRX.
2. Carica e installa il pacchetto on-prem-guides-components.all-1.x.0.zip.
Installare il pacchetto Sites: Caricare e installare il pacchetto aemg-docs.all-1.x.0.zip utilizzando Gestione pacchetti di CRX.

Crea sito utilizzando i modelli installati (per Cloud Service)

Importa modello siti:
1. Vai alla pagina AEM Sites (servername/sites.html/content).
2. Seleziona Crea > Sito dal modello.
3. Importa il modello Sites aemg-docs-1.x.x.zip utilizzando l'opzione Importa.
Seleziona modello: Seleziona Documenti AEMG 1.x.x, quindi seleziona Successivo.
Immetti i dettagli del sito: Immetti il Titolo sito e il Nome sito.

{width="350"}
Seleziona Crea.

Crea predefinito per sito AEM

Crea un nuovo predefinito:
1. Apri una mappa DITA in AEM Guides e passa al pannello Output.
2. Selezionare Crea predefinito.
3. Seleziona il tipo come AEM Sites.
4. Immettere un nome per il predefinito.
5. Deseleziona l'impostazione Usa mapping di componenti legacy.
6. Seleziona Aggiungi per creare il predefinito.
  
  {width="350"}
Configura predefinito per sito AEM: Sono disponibili due opzioni per configurare il sito preconfigurato:

Opzione 1: utilizzare il menu a discesa Sito
1. Seleziona Sito come creato in precedenza (ad esempio, Sito documenti AEMG).
2. Verificare che il percorso di pubblicazione 1} e il modello di pagina Argomento siano impostati automaticamente su:
  - Percorso di pubblicazione: Cloud Service: /content/AEMG-Docs-Site/en/docs/product e On-Premise: aemg-docs/en/docs/product1
  - Modello pagina argomento: pagina argomento
  {width="350"}
Opzione 2: utilizzare il percorso del sito
1. Impostare il percorso sito manualmente come /content/AEMG-Docs-Site/en/docs/product per Cloud Service e /content/aemg-docs/en/docs/product1 per On-Premise.
2. Verificare che il modello Pagina argomento sia impostato automaticamente su Pagina argomento.
  
  Per Cloud Service:
  
  {width="650"}
  
  Per On-Premise:
  
  {width="350"}
Salva il predefinito: Salva le modifiche apportate al predefinito.

Generare AEM Sites

Genera sito:
1. Con il predefinito configurato, genera il sito AEM per la mappa DITA corrispondente.
2. Il sito generato sarà disponibile nel percorso /content/AEMG-Docs-Site/en/docs/product per Cloud Service e /content/aemg-docs/en/docs/product1 per On-Premise.
Modificare il percorso di generazione predefinito (facoltativo): Se si desidera modificare il percorso predefinito per la generazione del sito, effettuare le seguenti operazioni:
1. Passa a AEM Sites.
2. Crea una nuova pagina di prodotto nella struttura del sito OOTB.
3. Passa a Documenti AEMG > Inglese > Documenti.
  
  {width="650"}
4. Selezionare il riquadro Home page, quindi selezionare Avanti.
  
  {width="650"}
5. Immetti il Titolo e il Nome per la pagina.
6. Seleziona Crea.

NOTE

Per la configurazione di Cloud Service, assicurati che tutte le configurazioni siano testate in un ambiente non di produzione prima di implementarle in produzione.

Per ulteriori informazioni, consulta la documentazione ufficiale sulla distribuzione ad AEM as a Cloud Service.

recommendation-more-help

11125c99-e1a1-4369-b5d7-fb3098b9b178