Predefinito AEM Sites nella console Mappa
Puoi creare un predefinito di AEM Sites dalla console Mappa e configurarlo per generare l’output di AEM Sites. Esistono due modi per creare l’output di AEM Sites:
Usa mappatura componenti compositi
La mappatura dei componenti compositi offre una pubblicazione su AEM Sites più rapida e scalabile rispetto alla mappatura dei componenti legacy. Viene fornito con modelli modificabili predefiniti che possono essere personalizzati in base alle tue esigenze utilizzando l’editor di modelli di AEM. I modelli utilizzano una combinazione di componenti di base WCM e di guides-components
specifici per garantire agli utenti finali un'esperienza ottimale sulle pagine AEM Sites. Puoi anche personalizzare i modelli esistenti utilizzando il metodo di mappatura dei componenti compositi.
Experience Manager Guides fornisce modelli predefiniti per la creazione di AEM Sites. Questi modelli consentono di garantire la coerenza nel layout e nella struttura del contenuto.
- Crea le home page in base a questi modelli predefiniti.
- Puoi modificare i modelli di argomento e applicare gli stili in base alle tue esigenze.
- Puoi anche personalizzare i modelli AEM Sites esistenti.
Crea predefinito AEM Sites
Per creare il predefinito AEM Sites utilizzando la mappatura di componenti compositi, effettua le seguenti operazioni:
-
Nel pannello Predefiniti di output, seleziona l'icona + per creare un predefinito di output.
-
Selezionare AEM Sites dal menu a discesa Tipo nella finestra di dialogo Nuovo predefinito di output.
-
Deseleziona l'opzione Usa mapping di componenti legacy.
-
Selezionare l'opzione Aggiungi al profilo cartella corrente per creare un predefinito di output nel profilo cartella corrente. L'icona
Ulteriori informazioni su Gestire i predefiniti di output per profili globali e cartelle.
-
Seleziona Aggiungi.
Viene creato il predefinito per AEM Sites.
Configurazione predefinita di AEM Sites per la mappatura di componenti compositi
- Software on-premise: ulteriori informazioni su come scaricare e installare modelli AEM Sites per software on-premise.
- Cloud Service: ulteriori informazioni su come scaricare e installare modelli AEM Sites per Cloud Service.
Nella console Mappa (Map), le opzioni di configurazione predefinite per la mappatura dei componenti compositi sono organizzate nelle seguenti schede:
- Generale
- Contenuto
- Elenco argomenti
- Riferimenti a mappe incrociate
Generale
La scheda Generale contiene le seguenti opzioni di configurazione:
È inoltre possibile utilizzare le variabili durante l'impostazione del percorso del sito. Per ulteriori dettagli, visualizzare Utilizzare le variabili per impostare le opzioni Percorso di destinazione, Nome sito o Nome file
Seleziona Aggiorna
AEMG-Docs
e il percorso di pubblicazione come aemg-docs-en/docs/product-abc.
, l'output di AEM Sites verrà generato nel nodo aemg-docs-en/docs/product-abc/
in crx/de
.Titolo argomento: utilizza il titolo dell'argomento DITA per creare i nomi dei siti Experience Manager.
Si supponga di aver pubblicato una mappa DITA contenente gli argomenti a.dita, b.dita e c.dita. Prima di pubblicare di nuovo la mappa, hai rimosso l’argomento b.dita dalla mappa. Ora, se hai selezionato questa opzione, tutto il contenuto relativo a b.dita viene rimosso dall’output di AEM Sites e vengono pubblicati solo a.dita e c.dita.
Nota: le informazioni sulle pagine eliminate vengono acquisite anche nei registri di generazione dell'output. Per ulteriori informazioni sull'accesso ai file di log, Visualizzare e controllare il file di log.
Attenzione: quando si eliminano gli argomenti, le pagine non sono più disponibili nel sito pubblicato. Pertanto, prima di eliminare gli argomenti, viene visualizzato un avviso. Conferma l'eliminazione.
- Elimina tutte le pagine create da altre origini nel percorso: se si seleziona questa opzione, verranno eliminate tutte le pagine pubblicate nel percorso da altre mappe, singoli argomenti o qualsiasi altra origine. Le pagine non sono più disponibili dal sito pubblicato. Pertanto, prima di eliminare gli argomenti, viene visualizzato un avviso. Conferma l'eliminazione.
Contenuto
La scheda Contenuto contiene le seguenti opzioni di configurazione:
Visualizza Utilizza la previsione per ulteriori dettagli.
Nessuna: selezionare questa opzione se non si desidera applicare alcuna condizione all'output pubblicato.
Utilizzo di DITAVAL: selezionare i file DITAVal per generare contenuto condizionale. È possibile selezionare più file DITAVal utilizzando la finestra di dialogo Sfoglia o digitando il percorso del file. Utilizza l’icona a forma di croce accanto al nome del file per rimuoverlo. I file DITAVal vengono valutati nell'ordine specificato, pertanto le condizioni specificate nel primo file hanno la precedenza rispetto a quelle specificate nei file successivi. È possibile mantenere l'ordine dei file aggiungendo o eliminando file. Se il file DITAVal viene spostato in un'altra posizione o eliminato, non viene eliminato automaticamente dal dashboard delle mappe. È necessario aggiornare il percorso nel caso in cui i file vengano spostati o eliminati. Passa il cursore del mouse sul nome del file per visualizzare il percorso nell’archivio AEM in cui è memorizzato il file. È possibile selezionare solo i file DITAVal e viene visualizzato un errore se si seleziona un altro tipo di file.
Predefinito condizione: seleziona un predefinito condizione dall'elenco a discesa per applicare una condizione durante la pubblicazione dell'output. Questa opzione è visibile se è stata aggiunta una condizione per il file di mapping DITA. Le impostazioni condizionali sono disponibili nella scheda Predefiniti condizione della console delle mappe DITA. Per ulteriori informazioni sul predefinito di condizione, visualizzare Usa predefiniti di condizione.
Proprietà file (Assets)
Nota: le proprietà dei metadati fanno distinzione tra maiuscole e minuscole.
Se è stata selezionata una baseline, i valori delle proprietà si basano sulla versione della baseline selezionata. Se non è stata selezionata una baseline, i valori delle proprietà si basano sulla versione più recente.
È inoltre possibile trasferire i metadati all'output utilizzando la pubblicazione DITA-OT. Per ulteriori dettagli, Trasmettere i metadati all'output utilizzando DITA-OT.
Nota: se non hai definito
cq:tags
nell'opzione Proprietà, i valori per cq:tags
vengono scelti dalla copia di lavoro corrente anche se hai selezionato una previsione per la pubblicazione.Utilizza le proprietà mappa come fallback
È possibile passare alle pagine del sito AEM solo le proprietà String, Date o Long (singole e multivalore). I valori dei metadati per una proprietà di tipo String non supportano caratteri speciali (ad esempio
@, #, " "
).* Questa opzione deve essere utilizzata insieme all'opzione
Properties
.Elenco argomenti
Nella scheda Elenco argomenti viene visualizzato l'elenco degli argomenti presenti nella copia di lavoro corrente della mappa DITA. Per impostazione predefinita, sono inclusi tutti gli argomenti. Puoi selezionare argomenti specifici e generare l’output di AEM Sites solo per essi. Ad esempio, sono stati aggiornati alcuni argomenti in modo da poter pubblicare solo tali argomenti anziché l'intera mappa DITA.
Riferimenti tra mappe
Questo elenco contiene argomenti contenenti riferimenti a mappe incrociate con scope ="peer"
. È possibile specificare il contesto di pubblicazione per un elenco di riferimenti a mappe incrociate con scope="peer"
ad argomenti disponibili in altre mappe DITA. Questa scheda viene visualizzata se si utilizza la versione di Experience Manager Guides (UUID).
Per ulteriori dettagli, fare riferimento alla sezione Utilizzo degli argomenti collegati di seguito.
Una volta configurate, salvate le modifiche apportate al predefinito e selezionate Genera per generare AEM Sites per la mappa corrispondente.
Usa mappatura componenti legacy
I passaggi per creare il predefinito AEM Sites utilizzando la mappatura dei componenti legacy sono gli stessi descritti nella sezione Mappatura dei componenti compositi precedente. Tuttavia, durante la creazione del predefinito, accertati di selezionare l'opzione Usa mapping di componenti legacy nella finestra di dialogo Nuovo predefinito di output.
Nella console Mappa, le opzioni di configurazione predefinite per la mappatura dei componenti legacy sono organizzate nelle seguenti schede:
- Generale
- Contenuto
- Riferimenti a mappe incrociate
Generale
La scheda Generale contiene le seguenti opzioni di configurazione:
Viene creato un nodo nell'archivio AEM con il nome specificato qui. Se non si specifica il nome del sito, il nodo del sito viene creato con il nome del file mappa DITA.
Il nome del sito specificato viene utilizzato anche come titolo nella scheda del browser.
È inoltre possibile utilizzare le variabili durante l'impostazione del nome del sito. Per ulteriori dettagli, visualizzare Utilizzare le variabili per impostare le opzioni Percorso di destinazione, Nome sito o Nome file
user-guide
e il percorso di output come /content/output/aem-guides
, l'output finale viene generato nel nodo /content/output/aem-guides/user-guide
.È inoltre possibile utilizzare le variabili durante l'impostazione del percorso di output. Per ulteriori dettagli, visualizzare Utilizzare le variabili per impostare le opzioni Percorso di destinazione, Nome sito o Nome file
Selezionare l'opzione Elimina e crea per forzare l'eliminazione delle pagine esistenti durante la pubblicazione. Questa opzione elimina il nodo della pagina insieme al relativo contenuto e a tutte le pagine figlie al suo interno. Utilizza questa opzione se hai modificato il modello di progettazione del predefinito di output o se desideri rimuovere eventuali pagine aggiuntive già presenti nella destinazione.
Si supponga di aver pubblicato una mappa DITA contenente gli argomenti a.dita, b.dita e c.dita. Prima di pubblicare di nuovo la mappa, hai rimosso l’argomento b.dita dalla mappa. Ora, se hai selezionato questa opzione, tutto il contenuto relativo a b.dita viene rimosso dall’output di AEM Sites e vengono pubblicati solo a.dita e c.dita.
Nota: le informazioni sulle pagine eliminate vengono acquisite anche nei registri di generazione dell'output. Per ulteriori informazioni sull'accesso ai file di log, Visualizzare e controllare il file di log.
Attenzione: quando si eliminano gli argomenti, le pagine non sono più disponibili nel sito pubblicato. Pertanto, prima di eliminare gli argomenti, viene visualizzato un avviso. Conferma l'eliminazione.
Per informazioni dettagliate sull'utilizzo di modelli di progettazione personalizzati per generare output, contattare l'amministratore della pubblicazione.
Dopo aver generato l'output, selezionare l'icona Scarica file temporanei
Nota: se le proprietà del file vengono aggiunte durante la generazione, i file temporanei di output includono anche un file metadata.xml contenente tali proprietà.
Contenuto
La scheda Contenuto contiene le seguenti opzioni di configurazione:
Visualizza Utilizza la previsione per ulteriori dettagli.
Nessuna: selezionare questa opzione se non si desidera applicare alcuna condizione all'output pubblicato.
Utilizzo di DITAVAL: selezionare i file DITAVal per generare contenuto condizionale. È possibile selezionare più file DITAVal utilizzando la finestra di dialogo Sfoglia o digitando il percorso del file. Utilizza l’icona a forma di croce accanto al nome del file per rimuoverlo. I file DITAVal vengono valutati nell'ordine specificato, pertanto le condizioni specificate nel primo file hanno la precedenza rispetto a quelle specificate nei file successivi. È possibile mantenere l'ordine dei file aggiungendo o eliminando file. Se il file DITAVal viene spostato in un'altra posizione o eliminato, non viene eliminato automaticamente dal dashboard delle mappe. È necessario aggiornare il percorso nel caso in cui i file vengano spostati o eliminati. Passa il cursore del mouse sul nome del file per visualizzare il percorso nell’archivio AEM in cui è memorizzato il file. È possibile selezionare solo i file DITAVal e viene visualizzato un errore se si seleziona un altro tipo di file.
Predefinito condizione: seleziona un predefinito condizione dall'elenco a discesa per applicare una condizione durante la pubblicazione dell'output. Questa opzione è visibile se è stata aggiunta una condizione per il file di mapping DITA. Le impostazioni condizionali sono disponibili nella scheda Predefiniti condizione della console delle mappe DITA. Per ulteriori informazioni sul predefinito di condizione, visualizzare Usa predefiniti di condizione.
Proprietà file (Assets)
Nota: le proprietà dei metadati fanno distinzione tra maiuscole e minuscole.
Se è stata selezionata una baseline, i valori delle proprietà si basano sulla versione della baseline selezionata. Se non è stata selezionata una baseline, i valori delle proprietà si basano sulla versione più recente.
È inoltre possibile trasferire i metadati all'output utilizzando la pubblicazione DITA-OT. Per ulteriori dettagli, Trasmettere i metadati all'output utilizzando DITA-OT.
Nota: se non hai definito
cq:tags
nell'opzione Proprietà, i valori per cq:tags
vengono scelti dalla copia di lavoro corrente anche se hai selezionato una previsione per la pubblicazione.Utilizza le proprietà mappa come fallback
È possibile passare alle pagine del sito AEM solo le proprietà String, Date o Long (singole e multivalore). I valori dei metadati per una proprietà di tipo String non supportano caratteri speciali (ad esempio
@, #, " "
).* Questa opzione deve essere utilizzata insieme all'opzione
Properties
.Riferimenti tra mappe
Questo elenco contiene argomenti contenenti riferimenti a mappe incrociate con scope ="peer"
. È possibile specificare il contesto di pubblicazione per un elenco di riferimenti a mappe incrociate con scope="peer"
ad argomenti disponibili in altre mappe DITA. Questa scheda viene visualizzata se si utilizza la versione di Experience Manager Guides (UUID).
Per ulteriori dettagli, fare riferimento alla sezione Utilizzo degli argomenti collegati di seguito.
Utilizzo di argomenti collegati
Experience Manager Guides consente di creare riferimenti ad argomenti utilizzando peer @scope
. Puoi quindi definire il contesto di pubblicazione di questi riferimenti dai predefiniti di AEM Sites e infine generare l’output degli argomenti collegati.
Per ulteriori dettagli, visualizzare Genera output di argomenti di collegamento da altre mappe.
Per specificare il contesto di pubblicazione per i file con collegamento incrociato, effettua le seguenti operazioni:
-
Apri la scheda Riferimenti cross map. Per visualizzare questa scheda, verificare che
<xrefs>
disponga di ID univoci. Gli ID univoci per<xrefs>
verranno generati automaticamente quando si modifica o si salva il contenuto precedente, se l'ID non è presente.Non potrai visualizzare il collegamento delle mappe incrociate nei seguenti casi:
- Per i predefiniti creati prima della versione 4.6, la scheda Cross references (Riferimenti incrociati) è disabilitata e viene visualizzata una descrizione comando, Refer to Map dashboard.
- Per i predefiniti creati dal dashboard delle mappe, viene visualizzata la descrizione comando Fai riferimento a dashboard delle mappe.
- Per i predefiniti preconfigurati, viene visualizzata la descrizione comando Fai riferimento a Dashboard mappa.
- Per i predefiniti globali, create una copia locale di questo predefinito globale per impostare i riferimenti delle mappe incrociate.
-
Viene visualizzato un elenco di argomenti e relativi riferimenti
note note NOTE La scheda Riferimenti a mappe incrociate mostra gli argomenti collegati solo con scope="peer"
. Per i collegamenti conscope="local"
, non è necessario specificare il contesto di pubblicazione.Per impostazione predefinita, per tutti gli argomenti collegati vengono selezionati il predefinito di output e la mappa più recente. Per impostazione predefinita, il contesto di pubblicazione per tutti gli argomenti collegati è impostato su
<Most recently generated>
mappa. -
Se si desidera utilizzare l'output pubblicato più di recente di ciascun file dipendente nella mappa, selezionare Usa contesto di pubblicazione generato più di recente per tutti gli argomenti dipendenti.
È necessario pubblicare la mappa selezionata come mappa padre prima di pubblicare la mappa contenente gli argomenti collegati. Se la mappa con argomenti collegati non è pubblicata, i collegamenti verranno visualizzati come testo normale anziché come collegamenti ipertestuali nell’output di AEM Sites.
Seleziona lo stesso tipo di predefinito AEM Sites per l’argomento collegato. Ad esempio, se il predefinito AEM Sites corrente utilizza la mappatura di componenti legacy, seleziona un predefinito AEM Sites simile all’argomento collegato. -
Nell'elenco a discesa Mappa padre selezionare il file di mappa con il quale si desidera collegare l'output della mappa corrente.
Quando si seleziona un file di mappa, nella colonna UUID mappa principale viene visualizzato l'UUID della mappa. I predefiniti di output associati alla mappa selezionata sono elencati nell'elenco Predefiniti mappa padre. Ad esempio, l'argomento 1 nella Mappa A contiene un riferimento all'argomento 2. L'argomento 2 può essere presente in una o più mappe. Per ogni collegamento puoi selezionare la mappa principale e un predefinito specifico oppure l’output pubblicato più di recente. -
Se in un file si fa riferimento allo stesso argomento più di una volta, è possibile aggiungere un contesto di pubblicazione diverso per ogni istanza. Questo offre maggiore flessibilità e controllo sui contenuti. Ad esempio, l'argomento 3 è presente sia nella Mappa B che nella Mappa C. L'argomento 1 contiene due riferimenti all'argomento 3. Potete scegliere Mappa B come mappa padre per il primo collegamento e Mappa C come mappa padre per il secondo collegamento.
-
Nell'elenco a discesa Predefinito mappa padre selezionare il predefinito di output con cui si desidera collegare l'output della mappa corrente.
note note NOTE I diversi predefiniti di AEM Sites della mappa corrente vengono visualizzati nell’elenco a discesa. Se non selezioni un predefinito, viene visualizzata un’icona di avviso e la generazione dell’output ha esito negativo. -
Selezionare la mappa richiesta e il relativo predefinito di output per tutti gli argomenti di origine, quindi selezionare Genera.
Argomento padre: Informazioni sui predefiniti di output