DocumentazioneAEM GuidesDocumentazione di AEM Guides

Usa specializzazione DITA-OT e DITA personalizzata id181GAJ0005Z

Last update: Thu Sep 12 2024 00:00:00 GMT+0000 (Coordinated Universal Time)

Creato per:

  • Esperto
  • Amministratore

DITA Open Toolkit (DITA-OT) è un insieme di strumenti open source basati su Java che forniscono l'elaborazione per le mappe DITA e il contenuto dell'argomento. AEM Guides consente di importare e utilizzare facilmente plug-in DITA-OT personalizzati. Una volta importato, AEM Guides può essere configurato per utilizzare il plug-in DITA-OT personalizzato per generare output in qualsiasi formato. Al momento della generazione dell'output, è sufficiente selezionare l'opzione DITA-OT e AEM Guides utilizza il plug-in DITA-OT personalizzato per generare l'output richiesto.

Se desideri elaborare i parametri della formica durante la pubblicazione di un output, AEM Guides ti offre un modo semplice per farlo. È possibile specificare quali parametri di formica si desidera utilizzare e gli stessi vengono quindi elaborati dal processo di pubblicazione.

NOTE
AEM Guides viene fornito con la versione DITA-OT 3.3.2. Tuttavia, AEM Guides supporta DITA-OT versione 1.7 e successive. Per l'elenco completo delle versioni DITA-OT, vedere Versioni DITA-OT.
TIP
Consultare le sezioni Configurazione dei profili DITA-OT e Utilizzo di DITA-OT personalizzati nella Guida alle best practice per le procedure consigliate sull'utilizzo di plug-in DITA-OT personalizzati.

Usa plug-in DITA-OT personalizzati id181NH1020L7

Esistono due modi per utilizzare il plug-in DITA-OT personalizzato per la pubblicazione. Il primo metodo consiste nel caricare il plug-in DITA-OT personalizzato nell'archivio AEM. L'altro metodo consiste nel salvare il plug-in DITA-OT personalizzato sul server, creare un profilo e specificare la posizione del plug-in DITA-OT personalizzato nel profilo.

Per impostazione predefinita, AEM Guides viene fornito con un profilo preconfigurato che contiene le configurazioni dei modelli predefiniti da utilizzare per la modifica e la pubblicazione dei contenuti. È possibile creare profili personalizzati con modelli personalizzati da utilizzare durante la modifica di documenti e plug-in DITA-OT personalizzati per la pubblicazione di contenuti.

Il pacchetto DITA-OT predefinito disponibile con AEM Guides è dotato di processore Apache FOP XSL-FO, che non supporta il rendering delle equazioni MathML. Se utilizzi le equazioni di MathML nel contenuto, accertati di aver integrato un plug-in del motore di rendering MathML per Apache FOP o di utilizzare un processore XSL-FO diverso.

IMPORTANT
Se hai aggiornato AEM Guides dalla versione 2.2 alla versione 2.5.1 o 2.6, tutte le modifiche effettuate tramite la gestione della configurazione vengono selezionate e memorizzate automaticamente nel profilo predefinito.

Per caricare un plug-in DITA-OT personalizzato nell'archivio AEM, effettuare le seguenti operazioni:

  1. Accedi all’AEM e apri la modalità CRXDE Liti.

  2. Scarica il file DITA-OT.ZIP.

    Il percorso del file DITA-OT.ZIP è /libs/fmdita/dita_resources/DITA-OT.zip.

  3. Estrai il contenuto del file zip sul server.

  4. Utilizzare un meccanismo di integrazione plug-in DITA-OT per integrare la nuova versione di DITA-OT con il plug-in DITA-OT personalizzato.

    note note
    NOTE
    Il separatore del percorso di classe nel file ZIP del plug-in dipende dal sistema operativo. Ciò significa che se il server è ospitato su Windows, il separatore del percorso di classe sarà diverso da quello utilizzato su Linux. Per ulteriori informazioni sull'integrazione manuale dei plug-in, vedere l'argomento Installazione manuale dei plug-in nella documentazione di DITA-OT.

  5. Creare nuovamente il file ZIP mantenendo lo stesso nome (DITA-OT.ZIP) e la struttura della cartella.

  6. Carica di nuovo il file ZIP aggiornato nell’archivio AEM.

    Verifica quanto segue prima di caricare il file ZIP:

    • Eseguire l'integratore (per installare il plug-in personalizzato) su un sistema operativo Mac/Linux per evitare problemi con i separatori di file. Poiché i sistemi operativi Windows e Linux dispongono di separatori di file diversi, il plug-in integrato nel sistema operativo Mac/Linux è compatibile sia con il programma di installazione di Windows che con quello di Linux.
    • Verificare che il file DITA-OT.ZIP contenga una cartella denominata "DITA-OT" contenente tutti i plug-in e i file rilevanti.
    • Verificare che il file DITA-OT.ZIP creato sia di tipo mime: "nt:file" (questo corrisponde al tipo primario di file ZIP quando viene caricato su AEM). Utilizza uno strumento WebDAV o un’implementazione di codice per caricare il file ZIP nel percorso desiderato in AEM. (Non utilizzare Gestione pacchetti di AEM per distribuire questo file ZIP poiché questo file ZIP non è un pacchetto di contenuti AEM ma solo un file di archivio.)
    note note
    NOTE
    Si consiglia di non sovrascrivere il pacchetto DITA-OT predefinito. Caricare il pacchetto DITA-OT personalizzato contenente il plug-in in un'altra posizione nella cartella apps.

  7. Apri il profilo DITA predefinito per la modifica e salvalo (senza apportare aggiornamenti) per rendere effettive le modifiche.

Per creare un nuovo profilo e configurarlo per l'utilizzo di un plug-in DITA-OT personalizzato memorizzato sul server, effettuare le seguenti operazioni:

  1. Memorizzare il plug-in DITA-OT personalizzato sul server.

    note note
    NOTE
    La struttura di cartelle per l'archiviazione del plug-in DITA-OT personalizzato deve essere: \*<parent-folder\>*\DITA-OT.

  2. Fai clic sul collegamento Adobe Experience Manager in alto e scegli Strumenti.

  3. Selezionare Guide dall'elenco degli strumenti.

  4. Fare clic sulla sezione Profili DITA.

    note note
    NOTE
    Le informazioni di profilo predefinite vengono visualizzate nella pagina Profili. Se hai aggiornato AEM Guides dalla versione 2.2 alla versione 2.5.1 o 2.6, tutte le modifiche effettuate tramite la gestione della configurazione vengono selezionate e memorizzate automaticamente nel profilo predefinito.

  5. Per creare un nuovo profilo, potete scegliere di modificare il profilo predefinito, crearne uno nuovo o duplicare le impostazioni del profilo predefinito.

    note note
    NOTE
    È possibile aggiornare il profilo predefinito, ma non eliminarlo. Tuttavia, tutti i nuovi profili creati possono essere modificati ed eliminati.

  6. Configurare le seguenti proprietà per l'utilizzo del plug-in DITA-OT personalizzato:

    table 0-row-2 1-row-2 2-row-2 3-row-2 4-row-2 5-row-2 6-row-2 7-row-2 8-row-2 9-row-2 10-row-2 11-row-2 12-row-2 13-row-2 14-row-2 15-row-2 16-row-2 17-row-2 18-row-2 19-row-2
    Nome proprietà Descrizione
    Proprietà profilo
    Nome profilo Specifica un nome univoco per questo profilo.
    Riutilizza output (Facoltativo) Se il profilo è basato su un profilo esistente, selezionare questa opzione. Selezionando questa opzione, AEM Guides non estrae nuovamente il contenuto del pacchetto DITA-OT e riutilizza il pacchetto DITA-OT esistente.
    Percorso di estrazione profilo (Facoltativo) Specificare il percorso in cui viene conservato DITA-OT sul disco. Per impostazione predefinita, AEM Guides raggruppa un pacchetto DITA-OT nel proprio archivio e lo estrae sul disco in questo percorso.
    Nota Puoi definire questo percorso utilizzando qualsiasi variabile o proprietà di sistema esistente. Per ulteriori informazioni, vedere la descrizione della proprietà Variabili di ambiente DITA-OT.
    Percorso assegnato (Facoltativo) Specificare il percorso nell'archivio dei contenuti a cui è applicabile il profilo. È possibile specificare più posizioni.
    Proprietà DITA-OT
    Timeout DITA-OT (Facoltativo) Specificare il tempo (in secondi) per il quale AEM Guides attende una risposta dal plug-in DITA-OT. Se non viene ricevuta alcuna risposta entro il tempo specificato, AEM Guides interrompe l’attività di pubblicazione e l’attività viene contrassegnata come non riuscita. Inoltre, i registri degli errori sono resi disponibili nel file di registro di generazione dell’output.
    Valore predefinito: 300 secondi (5 minuti)
    Argomenti PDF DITA-OT Specificare gli argomenti della riga di comando elaborati dal plug-in DITA-OT personalizzato per la generazione dell'output PDF. Per tutti i profili DITA-OT personalizzati, specificare il seguente argomento della riga di comando:-lib plugins/org.dita.pdf2.fop/lib/
    Argomenti AEM DITA-OT (Facoltativo) Specificare gli argomenti della riga di comando personalizzati elaborati dal plug-in DITA-OT personalizzato per la generazione dell'output del sito AEM.
    Percorsi libreria DITA-OT (Facoltativo) Specificare i percorsi di libreria aggiuntivi del plug-in DITA-OT.
    XML build DITA-OT (Facoltativo) Specificare il percorso dello script di compilazione Ant personalizzato fornito con il plug-in DITA-OT personalizzato. Questo percorso è relativo alla directory DITA-OT del file system.
    Cartella script ant DITA-OT (Facoltativo) Specificare il percorso della cartella degli script di annotazione DITA-OT. Questo percorso è relativo alla directory DITA-OT del file system.
    Variabili di ambiente DITA-OT (Facoltativo) Specificare le variabili di ambiente da passare al processo DITA-OT. Per impostazione predefinita, AEM Guides aggiunge quattro variabili: ANT_OPTS, ANT_HOME, PATH e CLASSPATH.
    È possibile riutilizzare una qualsiasi delle variabili di ambiente di sistema o delle proprietà esistenti per la creazione di nuove variabili di ambiente. Ad esempio, se nel sistema sono definite JAVA_HOME variabili di sistema e si desidera definire una nuova variabile di ambiente denominata JAVA_BIN che viene generata utilizzando JAVA_HOME. È quindi possibile aggiungere la definizione di JAVA_BIN come:
    JAVA_BIN= ${JAVA_HOME}/bin
    Nota Puoi anche utilizzare le proprietà del sistema Java per generare le variabili di ambiente. Ad esempio, se lo script di avvio AEM definisce una proprietà del sistema Java java.io.tmpdir in una directory temporanea, è possibile utilizzare questa proprietà per definire una nuova variabile come: ${java.io.tmpdir}/fmdita/dita_ot.
    Importante Per riutilizzare una variabile o una proprietà di sistema esistente, è necessario racchiuderla in ${}.
    Sovrascrivi output DITA-OT (Facoltativo) Se questa opzione è selezionata, è possibile specificare il pacchetto DITA-OT disponibile nel sistema locale per generare output utilizzando DITA-OT. Questa configurazione è impostata all'attivazione di ConfigManager.
    Se si desidera specificare il percorso di un pacchetto DITA-OT memorizzato sul server AEM, deselezionare questa opzione.
    Percorso Zip/percorso directory DITA-OT locale AEM A seconda della selezione effettuata in Sovrascrivi output DITA-OT, specificare il percorso completo in cui è memorizzato il file DITA-OT.zip personalizzato. Questo potrebbe essere il percorso nell’archivio AEM o nel sistema locale.
    Percorso plug-in DITA-OT Percorso del plug-in personalizzato. Questo plug-in viene integrato automaticamente con il pacchetto principale DITA-OT.
    Integrare cataloghi (Facoltativo) Percorso dei file DTD e XSD catalog.xml personalizzati nell'archivio AEM. Questa opzione deve essere fornita solo quando i cataloghi non sono presenti nel pacchetto DITA-OT. Questi cataloghi vengono integrati automaticamente con il DITA-OT principale come plug-in.
    Aggiungi catalogo ID sistema (Facoltativo) Selezionare questa opzione solo se mancano voci di ID pubblico nel catalogo o se i file DITA utilizzano solo gli ID di sistema relativi al percorso del server da cui vengono caricati.
    Percorso temporaneo DITA-OT (Facoltativo) Specificare un percorso temporaneo in cui copiare i file DITA per l'elaborazione. Prima che DITA-OT elabori i file, questi vengono copiati in questa posizione temporanea. Per impostazione predefinita, il percorso di archiviazione temporanea è:
    Nota Puoi definire questo percorso utilizzando qualsiasi variabile o proprietà di sistema esistente. Per ulteriori informazioni, vedere la descrizione della proprietà Variabili di ambiente DITA-OT.
    note note
    NOTE
    Il programma di installazione di AEM Guides crea due variabili di ambiente che è possibile utilizzare per specificare il percorso dei file plug-in DITA-OT personalizzati. Queste variabili di ambiente sono: DITAOT_DIR, che contiene il percorso della directory DITA-OT nel file system, e DITAMAP_DIR, che contiene il percorso in cui il contenuto della mappa DITA viene estratto nel file system.

  7. Fai clic su Fine per salvare il profilo.

NOTE
Per risparmiare tempo, potete esportare il profilo DITA personalizzato come pacchetto e caricarlo sulle altre istanze di AEM Guides. Per ulteriori informazioni, vedere Appendice.

Integrare la specializzazione DITA id211MB0E00XA

La specializzazione DITA è il processo di creazione di nuove strutture DITA mediante l'aggiunta di nuovi elementi o la rimozione di elementi esistenti. Per creare un nuovo elemento DITA, è possibile utilizzare come base un elemento DITA esistente e modificarlo in base alle proprie esigenze di creazione. In sostanza, la specializzazione DITA consente di creare modelli di informazioni personalizzati in grado di soddisfare le esigenze aziendali mantenendo i vantaggi dell'architettura DITA esistente.

È possibile utilizzare la funzione Profilo per memorizzare le impostazioni di specializzazione DITA personalizzate. Queste impostazioni possono quindi essere utilizzate al momento dell'authoring e della pubblicazione di contenuti DITA personalizzati. AEM Guides consente di utilizzare l'ID pubblico e l'ID sistema nelle DTD/XSD personalizzate.

NOTE
AEM Guides Web Editor non supporta XSD.

Per creare un nuovo profilo e configurarlo per l'utilizzo di DTD e XSD AEM Guides specializzati, effettua le seguenti operazioni:

  1. Creare nel computer locale una cartella di specializzazione contenente le DTD e le XSD specializzate.

  2. Specificare i dettagli DTD nel file catalog.xml che devono essere inclusi anche nella cartella di specializzazione.

    note note
    NOTE
    Nel caso di DITA 1.3, la posizione predefinita per il file DTD catalog.xml nell'archivio AEM è: /libs/fmdita/dita_resources/DITA-1.3/dtd/catalog.xml.

  3. Specificare i dettagli XSD nel file catalog.xml che devono essere inclusi anche nella cartella di specializzazione.

    note note
    NOTE
    Nel caso di DITA 1.3, la posizione predefinita del file catalog.xml XSD nell'archivio AEM è: /libs/fmdita/dita_resources/DITA-1.3/xsd/catalog.xml.

  4. Carica la cartella nel percorso seguente:

    /apps/fmdita/dita_resources

  5. Fai clic sul collegamento Adobe Experience Manager in alto e scegli Strumenti.

  6. Selezionare Guide dall'elenco degli strumenti.

  7. Fare clic sulla sezione Profili DITA.

    note note
    NOTE
    Le informazioni di profilo predefinite vengono visualizzate nella pagina Profili. Se hai aggiornato AEM Guides dalla versione 2.2 alla versione 2.5.1 o 2.6, tutte le modifiche effettuate tramite la gestione della configurazione vengono selezionate e memorizzate automaticamente nel profilo predefinito.

  8. Per creare un nuovo profilo, potete scegliere di modificare il profilo predefinito, crearne uno nuovo o duplicare le impostazioni del profilo predefinito.

    note note
    NOTE
    Non è possibile eliminare il profilo predefinito. Tuttavia, tutti i nuovi profili creati possono essere modificati ed eliminati.

  9. Nelle impostazioni Schema > Catalogo, specifica il percorso dei file catalog.xml DTD e XSD personalizzati nel tuo archivio AEM.

    note note
    NOTE
    Se si utilizza lo schema personalizzato, è necessario definire il percorso dei file DTD e XSD catalog.xml personalizzati nell'archivio AEM nell'opzione Integrate Catalog.

  10. Selezionare l'opzione Aggiungi catalogo ID sistema.

    note note
    NOTE
    Selezionare questa opzione solo se nel catalogo mancano voci di ID pubblico o se i file DITA utilizzano solo gli ID di sistema relativi al percorso del file locale da cui vengono caricati.

    Per ulteriori informazioni sulle altre proprietà della pagina Profili, vedere la tabella delle proprietà in Passaggio 6 della sezione Utilizzare plug-in DITA-OT personalizzati.

  11. Fai clic su Fine per salvare il profilo.

NOTE
Per risparmiare tempo, potete esportare il profilo DITA personalizzato come pacchetto e caricarlo sulle altre istanze di AEM Guides. Per ulteriori informazioni, vedere Appendix.md.
recommendation-more-help
11125c99-e1a1-4369-b5d7-fb3098b9b178