Predefiniti di AEM Sites nell’editor web
Puoi creare predefiniti di AEM Sites dall’editor web e configurarli per generare l’output di AEM Sites. L'output di AEM Sites si basa sulla mappatura dei componenti compositi insieme a guides-components, facilitando la creazione e la gestione efficienti dei contenuti.
Experience Manager Guides fornisce modelli predefiniti per la creazione di AEM Sites. Questi predefiniti 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.
Creare predefiniti di AEM Sites
Per creare i predefiniti di AEM Sites dall’editor web, effettua le seguenti operazioni:
- Nel pannello Repository, aprire il file mappa DITA in Vista mappa.
- Nella scheda 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 nella finestra di dialogo Nuovo predefinito di output.
- 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 il Cloud Service.
Aggiungi predefiniti al profilo cartella corrente
In qualità di amministratore, Experience Manager Guides ti consente di creare e gestire i predefiniti di output per i profili globali e delle cartelle. Selezionare l'opzione Aggiungi al profilo cartella corrente nella finestra di dialogo Nuovo predefinito di output per creare un predefinito di output per il profilo cartella corrente. L'icona
Predefiniti di AEM Sites basati sulla mappatura di componenti legacy
Puoi anche creare i predefiniti di AEM Sites utilizzando la mappatura dei componenti legacy. Per creare i predefiniti di AEM Sites in base alla mappatura dei componenti legacy, seleziona Utilizza mappatura componenti legacy nella finestra di dialogo Nuovo predefinito di output.
Alcune opzioni possono differire per i predefiniti che utilizzano la mappatura di componenti legacy.
Configurare i predefiniti di AEM Sites
Le configurazioni sono organizzate nelle schede Generale, Contenuto, Elenco argomenti e Riferimenti a mappe incrociate.
Generale
La scheda Generale contiene le seguenti configurazioni relative alla generazione di output:
-
Usa percorso del sito
-
Percorso sito
-
Sito
-
Percorso Publish
-
Modello pagina argomento
-
Genera nomi di pagina in base a
- Nome file argomento
- Titolo argomento
-
Pulizia delle pagine generate in precedenza
- Elimina le pagine generate in precedenza per gli argomenti rimossi dalla mappa
- Elimina tutte le pagine create da altre origini nel percorso seguente:
-
Flusso di lavoro di post generazione
Contenuto
La scheda Contenuto contiene le seguenti configurazioni:
-
Usa linea di base
-
Filtro condizione
-
Argomenti aggiuntivi della riga di comando DITA-OT
-
Metadati
- Proprietà file (Assets)
- Utilizzare le proprietà della mappa come fallback
Per ulteriori informazioni, vedere Configurazione AEM Sites.
Elenco argomenti
In 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.
La scheda Elenco argomenti è presente nei predefiniti AEM che non sono stati creati in base alla mappatura legacy.
Riferimenti cross-map
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).
Ulteriori informazioni su come pubblicare argomenti collegati.
Configurazione AEM Sites aem_sites_config
Per l’output di AEM Sites sono disponibili le seguenti opzioni:
Seleziona Aggiorna
AEMG-Docs e il percorso di Publish 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 del sito 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.
Importante: quando si genera l'output incrementale per il sito AEM, l'output viene creato utilizzando la versione corrente dei file e non la baseline allegata.
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.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à.
Generare l’output di AEM Sites utilizzando i modelli
Experience Manager Guides consente di utilizzare i modelli predefiniti o di aggiungere modelli AEM Sites personalizzati.
Prima di configurare i predefiniti di AEM Sites, accertati di creare una struttura AEM Sites utilizzando i modelli.
Per ulteriori dettagli, visualizzare Scaricare e installare i modelli di AEM Sites.
Per creare e configurare un predefinito AEM Sites, effettua le seguenti operazioni:
-
Aprire la scheda Predefiniti di output della mappa DITA che si desidera pubblicare.
-
Seleziona il predefinito di output AEM Sites.
-
(Facoltativo) Deseleziona l'opzione Usa mappatura componenti legacy per creare un predefinito AEM Sites non legacy.
-
Fare clic su Aggiungi. Viene creato il predefinito per AEM Sites.
-
Puoi configurare il modello predefinito di Sites in due modi:
-
Selezionare Sito, quindi scegliere il percorso di pubblicazione e i modelli di pagina dell'argomento dalle opzioni popolate:
- Seleziona il sito.
- Seleziona Sito. Esempio:
AEMG Docs. - Le opzioni Percorso Publish e Modello pagina argomento vengono impostate automaticamente nel menu a discesa. Puoi anche scegliere le opzioni. Ad esempio,
AEMG-Docs-Site/en/docs/product1eTopic pagesono impostati rispettivamente.
-
Selezionare il percorso completo del sito:
- Selezionare l'opzione Usa percorso sito.
- Selezionare il percorso completo del sito. Esempio:
/content/AEMG-Docs-Site/en/docs/product1. - Il 'modello pagina argomento' viene impostato automaticamente come
Topic Page.
-
-
Salvate le modifiche apportate al predefinito.
-
Selezionare l'opzione Genera.
-
Genera AEM Sites per la mappa corrispondente. Esempio:
/content/AEMG-Docs-Site/en/docs/product.note note NOTE Se pubblichi il contenuto in un sito AEM per la prima volta, si consiglia di pubblicare le pagine a livello di sito. In questo modo l'output verrà visualizzato correttamente nell'istanza Publish senza alcuna interruzione CSS.
Argomenti collegati a Publish
Experience Manager Guides semplifica la pubblicazione di documenti complessi consentendo la creazione di 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:
-
Aprire la scheda Predefiniti di output della mappa DITA che si desidera pubblicare.
-
Seleziona il predefinito di output AEM Sites.
Puoi visualizzare le schede Generale, Contenuto, Elenco argomenti e Riferimenti a più mappe. I riferimenti di mappe incrociate vengono visualizzati se si utilizza la versione di Experience Manager Guides (UUID).
Non potrai visualizzare il collegamento delle mappe incrociate nei seguenti casi:
- Per i predefiniti creati prima della versione 4.6. La scheda Riferimenti incrociati (Cross references) è disattivata e viene visualizzata una descrizione comando, Fare riferimento al quadro comandi Mappa (Map).
- Per i predefiniti creati dal dashboard delle mappe. Viene visualizzata la descrizione comando Mappa dashboard.
- Per i predefiniti preconfigurati, viene visualizzata la descrizione comando Mappa dashboard.
- Per i predefiniti globali, create una copia locale di questo predefinito globale per impostare i riferimenti delle mappe incrociate.
Se desiderate utilizzare i predefiniti di AEM Sites dall'editor Web, create un nuovo predefinito o duplicate quello esistente.
-
Apri la scheda Riferimenti cross map.
Viene visualizzato un elenco di argomenti e relativi riferimenti. È possibile specificare il contesto di pubblicazione per un elenco di riferimenti di mappe incrociate ad argomenti disponibili in altre mappe DITA con
scope=”peer”.Per utilizzare il pannello dei riferimenti delle mappe incrociate dall'editor Web,
<xrefs>deve avere ID univoci. Gli ID univoci per<xrefs>verranno generati automaticamente quando si modifica o si salva il contenuto precedente, se l'ID non è presente.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, seleziona il file di mappa con il cui output desideri collegare l’output della mappa corrente.
Quando si seleziona un file di mappa, nella colonna UUID della mappa principale viene visualizzato l’UUID della mappa. I predefiniti di output associati alla mappa scelta sono elencati nell’elenco Predefiniti della mappa principale. 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 della mappa principale, seleziona il predefinito di output con cui vuoi 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 non riesce. 1. 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