Sito AEM id205BE3008SW

Per l’output del sito AEM sono disponibili le seguenti opzioni:

Puoi creare il predefinito per sito AEM in due modi:

Dall'editor Web: Nel pannello Archivio aprire il file di mappa DITA in Vista mappa, quindi nella scheda Output selezionare l'icona + per creare un predefinito di output, quindi selezionare Sito AEM dal menu a discesa Tipo nella finestra di dialogo Aggiungi predefinito. Nell’editor web le configurazioni sono organizzate nelle schede Generali e Avanzate:

Generale

La scheda Generale contiene le seguenti configurazioni:

Avanzate

La scheda Avanzate contiene le seguenti configurazioni:

Per ulteriori informazioni, vedere Configurazione sito AEM.

Dal dashboard delle mappe

Per aprire i predefiniti di output per il sito AEM, fare clic su un file di mappa DITA dall'interfaccia utente di Assets, quindi fare clic su Predefiniti di output e quindi sull'opzione di output Sito AEM.Nel dashboard delle mappe, fare clic su Modifica nella parte superiore per aggiornare le varie configurazioni, quindi fare clic su Salva.

Configurazione sito AEM id_aem_site_config

Per l’output del sito AEM sono disponibili le seguenti opzioni:

Opzioni sito AEM

Descrizione

Tipo di output

Tipo di output che si desidera generare. Per generare l'output responsivo del sito AEM, scegliere l'opzione Sito AEM.

Nome impostazione

Assegna un nome descrittivo alle impostazioni del sito AEM che stai creando. Ad esempio, puoi specificare Output clienti interni o Output utenti finali.

Nome sito

Nome del sito in cui l’output viene archiviato nell’archivio AEM.

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 sull'utilizzo delle variabili, vedere Utilizzare le variabili per impostare le opzioni Percorso di destinazione, Nome sito o Nome file.

Design

Selezionare il modello struttura da utilizzare per generare l'output.

Per informazioni dettagliate sull'utilizzo di modelli di progettazione personalizzati per generare output, contattare l'amministratore della pubblicazione.

Percorso di destinazione

Il percorso all’interno dell’archivio AEM in cui è memorizzato l’output. Durante la generazione dell’output finale, il Nome sito e il Percorso di destinazione vengono combinati. Ad esempio, se si specifica Nome sito come user-guide e Percorso di destinazione come /content/output/aem-guides, l'output finale viene generato sotto il nodo /content/output/aem-guides/user-guide.

È inoltre possibile utilizzare le variabili durante l'impostazione del percorso di destinazione. Per ulteriori dettagli sull'utilizzo delle variabili, vedere Utilizzare le variabili per impostare le opzioni Percorso di destinazione, Nome sito o Nome file.

Applica condizioni tramite

Selezionare una delle opzioni seguenti:

Nessuna applicazione: selezionare questa opzione se non si desidera applicare alcuna condizione all'output pubblicato.
File 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, vedere Utilizzare i predefiniti di condizione.

Pagine di output esistenti

Selezionare l'opzione Sovrascrivi contenuto per sovrascrivere il contenuto nelle pagine esistenti. Questa opzione sovrascrive solo il contenuto presente nei nodi content e head della pagina. Questa opzione consente la pubblicazione mista dei contenuti. Selezionando questa opzione è possibile selezionare l'eliminazione di pagine orfane dall'output pubblicato. Opzione default per la creazione dell'output del sito AEM.

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.

Elimina pagine del sito orfano

Se si seleziona Sovrascrivi contenuto nell'impostazione Pagine di output esistenti, viene visualizzata questa opzione. Se selezioni questa opzione, tutte le pagine orfane vengono eliminate dal sito AEM pubblicato. Per eseguire correttamente questa funzione, è necessario pubblicare l'intera mappa DITA e non utilizzare la pubblicazione incrementale.

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 del sito AEM e vengono pubblicati solo a.dita e c.dita.

Questa caratteristica non rimuove alcuna mappa figlio pubblicata. Ad esempio, se la mappa padre contiene una mappa figlio e si rimuove l'intera mappa figlio, il contenuto della mappa figlio non viene eliminato dall'output pubblicato. Tuttavia, se rimuovi un argomento da una mappa figlio e lo ripubblichi, il contenuto dell'argomento rimosso viene eliminato dall'output del sito.

Inoltre, se è presente contenuto di riferimento che viene rimosso prima della ripubblicazione, i dati del contenuto di riferimento non vengono rimossi.

Nota: le informazioni sulle pagine orfane eliminate vengono acquisite anche nei registri di generazione dell'output. Per ulteriori informazioni sull'accesso ai file di log, vedere Visualizzare e controllare il file di log.

Scarica file temporanei

Selezionare questa opzione per scaricare i file temporanei generati da DITA-OT. Il percorso in cui DITA-OT memorizza i file temporanei si trova nel registro di generazione dell'output. Se si verificano errori durante la generazione dell'output tramite DITA-OT, selezionare questa opzione per mantenere i file temporanei. È quindi possibile utilizzare tali file per risolvere eventuali errori di generazione dell'output.

Dopo aver generato l'output, selezionare l'icona Scarica file temporanei per scaricare la cartella ZIP contenente i file temporanei.

Nota: se si selezionano alcune proprietà di file e quindi si scaricano i file temporanei, nella cartella ZIP verrà ottenuto anche il file metadata.xml.

Genera PDF separati per ciascun argomento

Se questa opzione è selezionata, viene creato anche un PDF per ogni argomento della mappa DITA. Quando selezionate questa opzione, viene visualizzata una nuova opzione Dividi percorso PDF.

Nel campo Dividi percorso PDF specificare il percorso in cui memorizzare i PDF generati per ciascun argomento.

Nota: AEM Guides utilizza il plug-in DITA-OT denominato pdfx per generare PDF per ogni argomento. Questo plug-in è fornito in dotazione con il pacchetto DITA-OT fornito con il prodotto. Puoi personalizzare questo plug-in per generare PDF in base alle tue esigenze. Se si utilizza un plug-in DITA-OT personalizzato, assicurarsi di integrare il plug-in pdfx per disporre della funzionalità di generazione PDF a livello di argomento.

Esegui flusso di lavoro di generazione Post

Quando scegli questa opzione, viene visualizzato un nuovo elenco a discesa Flusso di lavoro di generazione Post contenente tutti i flussi di lavoro configurati nell’AEM. È necessario selezionare un flusso di lavoro da eseguire dopo il completamento del flusso di lavoro di generazione dell'output.

Usa linea di base

Se è stata creata una baseline per la mappa DITA selezionata, selezionare questa opzione per specificare la versione da pubblicare.

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.

Per ulteriori dettagli, vedere Utilizzare la previsione.

Proprietà file

Seleziona le proprietà da elaborare come metadati. Queste proprietà vengono impostate dalla pagina Proprietà del file mappa DITA o del file mappa segnalibro. Le proprietà selezionate dall'elenco a discesa vengono visualizzate nel campo Proprietà file. Seleziona l’icona a forma di croce accanto alla proprietà per rimuoverla.

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, vedere 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.

Usa Le Proprietà Della Mappa Se Mancano Nell’Argomento

Se questa opzione è selezionata, le proprietà definite per il file mappa vengono copiate anche negli argomenti in cui tali proprietà non sono definite. Durante l'utilizzo di questa opzione, prendere in considerazione i seguenti punti:

È 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.

Nota aggiuntiva sul sito AEM

Genera output basato su articoli dall’editor web

È possibile generare l'output del sito AEM per uno o più argomenti o per l'intera mappa DITA dall'editor Web. È necessario creare predefiniti di output per la mappa DITA e quindi generare facilmente l'output del sito AEM per la mappa. Se sono stati aggiornati alcuni argomenti della mappa, è inoltre possibile generare l'output del sito AEM solo per tali argomenti dall'editor Web. Per ulteriori dettagli, vedere Pubblicazione basata su articolo dall'editor Web.

Genera argomenti di collegamento di output da altre mappe

È uno scenario molto comune disporre di un set elevato di documenti distribuiti in più cartelle e mappe DITA. Diventa estremamente complesso pubblicare contenuti collegati da varie posizioni. Per impostazione predefinita, tutti i collegamenti <xref> sono creati con local @scope. La pubblicazione di tali argomenti non comporta alcuna sfida, in quanto utilizza un collegamento diretto all’argomento. Se l'argomento non è incluso nella mappa DITA corrente, il collegamento non visualizza il contenuto collegato.

Un altro modo per collegare il contenuto consiste nel creare un collegamento utilizzando peer @scope. Per tali contenuti, il collegamento viene risolto in fase di esecuzione scegliendo il titolo del file e il contesto configurato per l'argomento collegato dal contesto di pubblicazione della mappa DITA. La schermata seguente mostra il pannello Proprietà per un collegamento con peer @scope:

Per semplificare la pubblicazione di mappe complesse e argomenti collegati ad altri argomenti in altre mappe, AEM Guides consente di impostare il contesto di pubblicazione per ciascun predefinito di output.

Il contesto di pubblicazione consente di specificare l’argomento da utilizzare per la mappatura per la pubblicazione di un output specifico. Comprendiamo questo con l'aiuto di un esempio — supponiamo che tu abbia quattro cartelle: campione a, campione b, campione c e campione d. Ogni cartella contiene una mappa DITA, ovvero mappa DITA A, mappa DITA B, mappa DITA C e mappa DITA D. Il collegamento tra mappe si verifica quando un argomento nella mappa DITA A si collega a un argomento nella mappa DITA B, C o D. Nella schermata seguente, un argomento di esempio contiene i collegamenti (o riferimenti) ai file che fanno parte di altre mappe DITA.

Ora, quando configuri le impostazioni di pubblicazione del sito AEM per il file di mappa che contiene questo argomento, puoi selezionare quale contesto di pubblicazione viene utilizzato per la pubblicazione del contenuto collegato. Un contesto di pubblicazione è una combinazione di mappa DITA e relativo predefinito di output. Il predefinito di output, a sua volta, contiene una versione specifica del contenuto e dei predefiniti condizionali. L'intera combinazione della mappa DITA, del predefinito di output, della versione di (files) e delle condizioni definisce il contesto di pubblicazione di una mappa collegata.

Per specificare il contesto di pubblicazione per i file con collegamento incrociato, effettua le seguenti operazioni:

Pubblicazione mista

AEM Guides supporta la pubblicazione di contenuti DITA all’interno del sito AEM esistente. Se ad esempio si dispone di un sito esistente, è possibile utilizzare l'output Sito AEM per pubblicare solo il contenuto DITA del sito. In questo processo, il contenuto non DITA esistente non viene modificato dal processo di pubblicazione. Per ulteriori informazioni sulla configurazione del sito per la pubblicazione di solo contenuti DITA, contattare l'amministratore della pubblicazione.

Pubblicazione conref

Se utilizzi conref nel contenuto, questo verrà pubblicato come contenuto normale o incorporato insieme al contenuto nell'argomento sorgente (o riferimento). Viene eseguito il rendering del contenuto conref insieme al contenuto principale e non viene creata alcuna pagina del sito separata per lo stesso. Quando si cerca il contenuto a cui si fa riferimento in conref, nei risultati della ricerca verrà visualizzato solo l'argomento principale o la pagina contenente il contenuto di conref.

Cercare una stringa all’interno del contenuto

Puoi cercare una stringa nell’output del sito AEM. Per impostazione predefinita, è possibile cercare la stringa solo nei titoli. Per cercare la stringa nel contenuto o nel corpo dell'output del sito AEM, contattare l'amministratore di sistema per abilitare la proprietà flattening.enabled.

Per ulteriori dettagli, vedere la sezione Configurare l'appiattimento della struttura dei nodi del sito AEM nella guida Installare e configurare Adobe Experience Manager Guides.

Argomento padre: ​ Informazioni sui predefiniti di output