Configurare le impostazioni di generazione dell’output id181AI0B0E30

AEM Guides offre numerose opzioni di configurazione per personalizzare il processo di generazione dell’output. Questo argomento descrive tutte le configurazioni e le personalizzazioni utili per configurare il processo di generazione dell’output.

Configurare la scheda Baseline nel dashboard delle mappe DITA id223MD0D0YRM

Per nascondere la scheda Linea di base nel quadro comandi Mappa DITA, effettuare le seguenti operazioni:

Configurare la pubblicazione mista in un sito AEM esistente id1691I0V0MGR

Se si dispone di un sito AEM che contiene contenuto DITA, è possibile configurare l'output del sito AEM per pubblicare contenuto DITA in una posizione predefinita all'interno del sito. Ad esempio, nella schermata seguente di una pagina del sito AEM, il nodo ditacontent è riservato per l'archiviazione del contenuto DITA:

I nodi rimanenti nella pagina vengono creati direttamente dall’editor del sito AEM. La configurazione dell'impostazione di pubblicazione per la pubblicazione del contenuto DITA in una posizione predefinita garantisce che nessuno dei contenuti non DITA esistenti venga modificato dal processo di pubblicazione di AEM Guides.

Per consentire la pubblicazione di contenuto DITA in un nodo predefinito, è necessario eseguire le seguenti configurazioni sul sito esistente:

Per configurare le proprietà del modello del sito esistente, effettua le seguenti operazioni:

La prossima volta che pubblichi un contenuto DITA utilizzando le configurazioni dei modelli del sito, il contenuto viene pubblicato nei nodi specificati nelle proprietà topicContentNode e topicHeadNode.

Personalizzare l’output del sito AEM id166TG0B30WR

AEM Guides supporta la creazione di output nei seguenti formati:

Per l'output Sito AEM, è possibile assegnare diversi modelli struttura con diverse attività di output. Questi modelli di progettazione possono eseguire il rendering del contenuto DITA in layout diversi. Ad esempio, puoi specificare diversi modelli di progettazione per il pubblico interno ed esterno.

È inoltre possibile utilizzare plug-in personalizzati DITA Open Toolkit (DITA-OT) con AEM Guides. È possibile caricare questi plug-in DITA-OT personalizzati per generare l'output di PDF in un modo specifico.

Personalizza modello struttura per generare output customize_xml-add-on

AEM Guides utilizza un set di modelli di progettazione predefiniti per generare l’output del sito AEM. Puoi personalizzare i modelli di progettazione di AEM Guides per generare l’output conforme al tuo branding aziendale. Un modello di progettazione è una raccolta di vari stili (CSS), script (lato server e lato client), risorse (immagini, loghi e altre risorse) e nodi JCR che collegano tutte queste risorse. Un modello di progettazione può essere semplice come un singolo script lato server con solo un paio di nodi JCR o una combinazione complessa di stili, risorse e nodi JCR. I modelli di progettazione vengono utilizzati dal sottosistema di pubblicazione di AEM Guides durante la generazione dell’output del sito AEM e controllano la struttura, l’aspetto dell’output generato.

Non esiste alcuna restrizione relativa alla posizione delle risorse del modello di progettazione nel server, ma in genere sono organizzate in modo logico in base alla loro funzione. Ad esempio, tutti i file JavaScript e CSS del modello predefinito sono memorizzati nella cartella /etc/designs/fmdita/clientlibs/siteoutput/default. Ovunque si trovino questi file, sono collegati tra loro da una raccolta di nodi JCR. Insieme, questi nodi JCR e i file costituiscono l’intero modello di progettazione.

Il modello struttura predefinito fornito con AEM Guides consente di personalizzare i componenti della pagina di destinazione, dell’argomento e della ricerca. Potete creare una copia del progetto di default e delle maschere di riferimento corrispondenti e specificare componenti diversi per generare l'output desiderato.

Per specificare il modello di progettazione da utilizzare per la generazione di output del sito AEM, effettua le seguenti operazioni:

Per ulteriori informazioni, vedere Creazione del primo sito Web Adobe Experience Manager e Nozioni di base sullo sviluppo di un sito Web personalizzato sull'AEM.

Usa il titolo del documento per generare l'output del sito AEM

Quando si genera l’output del sito AEM, il modo in cui gli URL vengono generati svolge un ruolo importante nella reperibilità dei contenuti. Se utilizzi nomi di file basati su UUID, la generazione di URL basati su UUID dei file non sarà semplice da cercare. In qualità di amministratore o di editore, hai il controllo su come generare gli URL per l’output del sito AEM. AEM Guides offre una configurazione attraverso la quale puoi scegliere di generare gli URL dell’output del sito AEM utilizzando il titolo del file invece dei nomi di file basati su UUID. Per impostazione predefinita, per i file system basati su UUID questa opzione è attivata. Ciò implicava che quando si genera l'output del sito AEM per file system basati su UUID, i titoli del file vengono utilizzati per generare gli URL e non gli UUID dei file.

Utilizza le istruzioni fornite in Sostituzioni configurazione per creare il file di configurazione. Nel file di configurazione, fornisci i seguenti dettagli (property) per configurare la generazione di URL nell’output del sito AEM:

Configura l’URL dell’output del sito AEM per utilizzare il titolo del documento

Puoi utilizzare i titoli dei documenti nell’URL dell’output del sito AEM. Se il nome del file non esiste o contiene tutti i caratteri speciali, puoi configurare il sistema per sostituire i caratteri speciali con un separatore nell’URL dell’output del sito AEM. Puoi anche configurarlo per sostituirli con il nome del primo argomento secondario.

Per configurare i nomi delle pagine, effettuare le seguenti operazioni:

Se ad esempio il @navtitle in <topichead> contiene tutti i caratteri speciali e si imposta la proprietà aemsite.pagetitle su true, per impostazione predefinita viene utilizzato un separatore. Se si imposta la proprietà nodename.systemDefinedPageName su true, verrà visualizzato il nome del primo argomento figlio.

Configurare le regole di bonifica del nome file per la creazione di argomenti e la pubblicazione dell'output del sito AEM id2164D0KD0XA

In qualità di amministratore, puoi definire un elenco di caratteri speciali validi consentiti nei nomi dei file, che alla fine formeranno l’URL di un output di sito AEM. Nelle versioni precedenti, gli utenti potevano definire nomi di file contenenti caratteri speciali come @, $, > e altri. Questi caratteri speciali hanno prodotto un URL codificato nella generazione di pagine del sito AEM.

A partire dalla versione 3.8, sono state aggiunte configurazioni per definire un elenco di caratteri speciali consentiti nei nomi dei file. Per impostazione predefinita, la configurazione del nome file valida contiene "a-z A-Z 0-9 - _". Ciò implica che durante la creazione di un file, è possibile inserire qualsiasi carattere speciale nel titolo del file, ma internamente verrà sostituito con un trattino (-) nel nome del file. Ad esempio, puoi assegnare al file il titolo Introduzione 1 o Introduction@1; il nome file corrispondente generato in entrambi i casi sarà Introduzione-1.

Quando definisci un elenco di caratteri validi, ricorda che questi caratteri "*/:[\]|#%{}?&<>"/+" e a space verranno sempre sostituiti da un trattino (-).

Utilizza le istruzioni fornite in Sostituzioni configurazione per creare il file di configurazione. Nel file di configurazione, fornisci i seguenti dettagli (property) per configurare i caratteri speciali validi nei nomi dei file e nell’output del sito AEM:

Puoi anche configurare le altre proprietà, ad esempio l’utilizzo di lettere minuscole nei nomi dei file, di un separatore per la gestione dei caratteri non validi e del numero massimo di caratteri consentiti nei nomi dei file. Per configurare queste proprietà, aggiungi le seguenti coppie di valori chiave nel file di configurazione:

Configurare l’appiattimento della struttura dei nodi del sito AEM

Quando si genera l'output Sito AEM, viene creato internamente un nodo per ogni elemento degli argomenti. Per una mappa DITA con migliaia di argomenti, questa struttura di nodi può diventare troppo profonda. Questo tipo di struttura di nodi profondamente nidificata può presentare problemi di prestazioni per siti più grandi. L’istantanea seguente mostra la struttura dei nodi profondamente nidificati per un output di un sito AEM:

Nell'istantanea precedente, si noti che viene creato un nodo per ogni elemento p e i relativi sottoelementi successivi e che viene creata una struttura simile per ogni altro elemento utilizzato nell'argomento.

AEM Guides consente di configurare la modalità di creazione interna della struttura dei nodi dell’output del sito AEM. È possibile appiattire la struttura del nodo in corrispondenza di elementi specifici, il che significa che è possibile definire un elemento che verrà considerato come elemento principale e tutti i sottoelementi al suo interno verranno uniti all’elemento principale. Se ad esempio si decide di appiattire l'elemento p, qualsiasi elemento visualizzato all'interno dell'elemento p verrà unito all'elemento p principale. Non verrà creata una nota separata per alcun sottoelemento all'interno dell'elemento p. Lo snapshot seguente visualizza la struttura del nodo appiattita in corrispondenza dell'elemento p:

Per appiattire la struttura dei nodi del sito AEM, effettuare le seguenti operazioni:

Ora, quando si genera l'output del sito AEM, i nodi all'interno dell'elemento p vengono appiattiti e memorizzati all'interno dell'elemento p stesso. Le nuove proprietà di conversione per l'elemento p sono disponibili in CRXDE.

Cerca una stringa all'interno del contenuto nell'output del sito AEM

Per impostazione predefinita, è possibile cercare una stringa nei titoli solo all’interno dell’output del sito AEM. Puoi configurare il sistema in modo da cercare una stringa sia nei titoli che nel contenuto o nel corpo dell’output del sito AEM.

Per abilitare la ricerca, devi configurare l’appiattimento della struttura dei nodi del sito AEM.

ATTENZIONE:

È possibile cercare fino a 1 MB di contenuto appiattito. Ad esempio, nella schermata precedente, puoi cercare se il contenuto sotto il tag <p> è <= 1Mb.

Impedisci appiattimento della struttura del nodo del sito AEM

Simile a specificare il nodo da appiattire nell'output del sito AEM, puoi anche specificare un elemento che desideri escludere da questa configurazione. Ad esempio, se si desidera appiattire i nodi in corrispondenza dell'elemento body, ma non si desidera appiattire alcun elemento table in body, è possibile aggiungere la proprietà exclude all'interno della definizione dell'elemento table.

Per escludere l'elemento table dall'appiattimento, aggiungere la seguente proprietà alla definizione dell'elemento table:

<preventancestorflattening>true|false</preventancestorflattening>

Configurare il controllo delle versioni per le pagine eliminate nell’output del sito AEM

Quando si genera l'output del sito AEM con l'opzione Elimina e Crea ​ ​selezionata per l'impostazione Pagine di output esistenti, viene creata una versione per le pagine\ da eliminare. Puoi configurare il sistema in modo da interrompere la creazione di una versione prima dell’eliminazione.

Per interrompere la creazione di una versione per le pagine da eliminare, effettua le seguenti operazioni:

Configurare il rewriter personalizzato con Experience Manager Guides custom-rewriter

Experience Manager Guides dispone di un modulo rewriter Sling personalizzato per la gestione dei collegamenti generati in caso di mappe incrociate (collegamenti tra gli argomenti di due mappe diverse). La configurazione del rewriter è installata nel percorso seguente:
/apps/fmdita/config/rewriter/fmdita-crossmap-link-patcher.

Se nel codebase è presente un altro rewriter sling personalizzato, utilizza un valore 'order' maggiore di 50, in quanto il rewriter sling di Experience Manager Guides utilizza 'order' 50. Per evitare questo problema, è necessario un valore >50. Per ulteriori dettagli, visualizza Pipeline di riscrittura output.

Utilizzare i metadati nell'output di pubblicazione tramite DITA-OT id191LF0U0TY4

AEM Guides consente di trasmettere metadati personalizzati durante la pubblicazione dell'output tramite DITA-OT. In qualità di amministratore e di editore, è necessario eseguire le seguenti attività per configurare e utilizzare metadati personalizzati nell’output pubblicato:

Per aggiungere i metadati richiesti nel sistema, effettuare le seguenti operazioni:

Il nuovo parametro ora viene visualizzato nella pagina Proprietà per tutte le mappe DITA.

Successivamente, è necessario rendere disponibili i metadati personalizzati nella console delle mappe DITA. Per rendere disponibili i metadati personalizzati sulla dashboard delle mappe DITA, effettuare le seguenti operazioni:

Ora i metadati personalizzati verranno visualizzati nell'elenco a discesa Proprietà della console delle mappe DITA.

Infine, in qualità di editore, è necessario includere i metadati personalizzati nell’output pubblicato. Per elaborare i metadati personalizzati durante la generazione dell’output, effettua le seguenti operazioni:

Le proprietà/metadati selezionati vengono trasmessi al processo di pubblicazione e sono resi disponibili nell’output finale.

Convalida metadati passati a DITA-OT per l'elaborazione

Per convalidare i valori dei metadati passati al DITA-OT, è possibile utilizzare un ambiente locale che utilizza un file jar pronto per il cloud. Poiché non è possibile accedere al file system locale sul cloud, l’unico modo per convalidare il file dei metadati è tramite cloud ready jar.

Personalizzare la mappatura degli elementi DITA con i componenti AEM id1679J600HEL

Gli elementi DITA in AEM Guides sono mappati ai relativi componenti AEM corrispondenti. AEM Guides utilizza questa mappatura nei flussi di lavoro, ad esempio pubblicazione e revisione, per convertire l’elemento DITA in un componente AEM corrispondente. Il mapping è definito nel file elementmapping.xml, a cui è possibile accedere tramite Gestione pacchetti.

È possibile utilizzare le mappature di elementi DITA predefinite oppure mappare gli elementi DITA ai componenti AEM personalizzati. Per utilizzare i componenti AEM personalizzati, è necessario comprendere la struttura del file elementmapping.xml.

struttura elementmapping.xml

Di seguito viene illustrata una panoramica di alto livello della struttura elementmapping.xml:

Schema elemento DITA

Di seguito è riportato un esempio dello schema dell'elemento DITA nel file elementmapping.xml:

<ditaelement>
    <name>element_name</name>
    <class>element_class</class>
    <componentpath>fmdita/components/dita/component_name</componentpath>
    <type>COMPOSITE|STANDALONE</type>
    <attributeprop>propname_a</attributeprop>
    <textprop>propname_t</textprop>
    <xmlprop>propname_x</xmlprop>
    <xpath>xpath expression string</xpath>
    <target>head|para</target>
    <wrapelement>div</wrapelement>
    <wrapclass>class_name</wrapclass>
    <attributemap>
        <attribute from="attrname"         to="propname"         ispath="true|false"         rel="source|target" />
    </attributemap>
    <skip>true|false</skip>
</ditaelement>

Nella tabella seguente vengono descritti gli elementi dello schema di elementi DITA:

Note aggiuntive

Personalizza console mappe DITA id188HC08M0CZ

AEM Guides offre la flessibilità di estendere le funzionalità della console delle mappe DITA. Ad esempio, se disponi di un set di rapporti diversi da quelli disponibili in AEM Guides, puoi aggiungerli alla console delle mappe. Per personalizzare la console delle mappe, devi creare una libreria client AEM (o ClientLib) che conterrà il codice necessario per eseguire la funzionalità necessaria.

AEM Guides fornisce la categoria apps.fmdita.dashboard-extn per personalizzare la console delle mappe. Ogni volta che la console delle mappe viene caricata, la funzionalità creata nella categoria apps.fmdita.dashboard-extn viene eseguita e caricata.

Gestione della rappresentazione delle immagini durante la generazione dell'output id177BF0G0VY4

L’AEM viene fornito con una serie di flussi di lavoro e di handle di file multimediali predefiniti per l’elaborazione delle risorse. In AEM, esistono flussi di lavoro predefiniti per gestire l’elaborazione delle risorse per i tipi MIME più comuni. In genere, per ogni immagine caricata, AEM crea più rappresentazioni dello stesso in formato binario. Queste rappresentazioni possono avere dimensioni diverse, una risoluzione diversa, una filigrana aggiunta o altre caratteristiche modificate. Per ulteriori informazioni sulla gestione delle risorse da parte dell'AEM, consulta Elaborazione di Assets tramite gestori di supporti e flussi di lavoro nella documentazione AEM.

AEM Guides consente di configurare la rappresentazione dell’immagine da utilizzare al momento della generazione dell’output per i documenti. Ad esempio, puoi scegliere una delle rappresentazioni immagine predefinite oppure crearne una e utilizzare la stessa opzione per pubblicare i documenti. Il mapping della rappresentazione dell'immagine per la pubblicazione dei documenti è memorizzato nel file /libs/fmdita/config/ **renditionmap.xml**. Uno snippet di file renditionmap.xml è il seguente:

<renditionmap>
   <mapelement>
      <mimetype>image/png</mimetype>
      <rendition output="AEMSITE">cq5dam.web.1280.1280.jpeg</rendition>
      <rendition output="PDF">original</rendition>
      <rendition output="HTML5">cq5dam.web.1280.1280.jpeg</rendition>
      <rendition output="EPUB">cq5dam.web.1280.1280.jpeg</rendition>
      <rendition output="CUSTOM">cq5dam.web.1280.1280.jpeg</rendition>
   </mapelement>
...
</renditionmap>

L'elemento mimetype specifica il tipo MIME del formato di file. L'elemento rendition output specifica il tipo di formato di output e il nome della rappresentazione (ad esempio, cq5dam.web.1280.1280.jpeg) da utilizzare per la pubblicazione dell'output specificato. Puoi specificare le rappresentazioni di immagini da utilizzare per tutti i formati di output supportati: AEMSITE, PDF, HTML5, EPUB e CUSTOM.

Se la rappresentazione specificata non è presente, il processo di pubblicazione di AEM Guides cerca innanzitutto la rappresentazione web dell’immagine specificata. Se non viene trovata nemmeno la rappresentazione web, viene utilizzata la rappresentazione originale dell’immagine.

Configurare il periodo di rimozione automatica per la cronologia di output id19AAI070V8Q

Quando generi un output, questo viene creato insieme ai registri di output. Per le mappe DITA di grandi dimensioni, questi registri possono occupare una grande quantità di spazio nell’archivio. Per impostazione predefinita, i registri vengono memorizzati nella seguente posizione nell’archivio:

/var/dxml/metadata/outputHistory

In un certo periodo di tempo, le dimensioni collettive di tutti i file di registro potevano raggiungere i GB. AEM Guides consente di configurare un periodo di tempo per mantenere questi file di registro nell’archivio. Dopo il periodo di tempo specificato, i registri e la cronologia di generazione dell’output vengono eliminati dall’archivio.

La configurazione della funzione di rimozione della cronologia influisce sulla generazione dell'output per tutte le mappe DITA nel repository. Nella scheda Output di una mappa DITA, la cronologia viene eliminata dopo il numero di giorni e all'ora specificati nell'impostazione.

Utilizza le istruzioni fornite in Sostituzioni configurazione per creare il file di configurazione. Nel file di configurazione, fornisci i seguenti dettagli (property) per impostare un giorno e un’ora per eliminare la cronologia e i registri di output:

Modifica il limite dell’elenco di output generato di recente id1679JH0H0O2

È possibile modificare il numero massimo di output generati visualizzati nella scheda Output per una mappa DITA.

Utilizza le istruzioni fornite in Sostituzioni configurazione per creare il file di configurazione. Nel file di configurazione, fornisci i seguenti dettagli (property) per modificare il numero di output da visualizzare nell’elenco: