Novità della versione 4.2 di Adobe Experience Manager Guides (febbraio 2023)
Questo articolo descrive le funzioni nuove e migliorate della versione 4.2 di Adobe Experience Manager Guides (in seguito denominato AEM Guides).
Per ulteriori dettagli sulle istruzioni di aggiornamento, sulla matrice di compatibilità e sui problemi risolti in questa versione, consulta l'articolo Note sulla versione.
Generare rapporti dall’editor web
AEM Guides dispone di una funzione nell’editor web che consente di verificare la completezza complessiva dei documenti tecnici e di generare per essi rapporti.
È possibile visualizzare l'elenco degli argomenti e gestire i metadati di tutti i riferimenti per la mappa corrente da
Scheda Rapporti nell'editor Web.
Generare la visualizzazione Elenco argomenti
È possibile generare l'Elenco argomenti che fornisce informazioni dettagliate sugli argomenti, ad esempio il tipo di riferimento, lo stato del documento e l'autore. È inoltre possibile generare il file CSV per scaricare lo snapshot corrente degli argomenti nella mappa DITA.
Gestione dei metadati e modifica dello stato del documento
È possibile applicare tag a un singolo argomento oppure utilizzare la funzione di assegnazione tag in blocco per applicare più tag a più argomenti, a una mappa DITA o a una mappa secondaria. È inoltre possibile modificare lo stato del documento di tutti gli argomenti selezionati al successivo possibile stato comune del documento.
UX rinnovata per la funzionalità di revisione
Ora le guide AEM forniscono un’interfaccia utente migliorata che consente di rivedere gli argomenti condivisi per la revisione. Nell’esperienza più recente, la funzionalità di revisione presenta i seguenti miglioramenti:
- Interfaccia utente aggiornata
- Pannello Condizioni che consente di evidenziare il contenuto in base alle condizioni disponibili nell’argomento.
- Ogni commento nel pannello dei commenti è collegato al testo corrispondente nell'argomento corrente. Consente di identificare il testo commentato.
- I commenti vengono visualizzati nell'ordine del testo commentato nel documento.
- Il nome dell'attività di revisione viene visualizzato nel flusso di lavoro di revisione.
- Selezionare la rootmap per l'attività di revisione utilizzata per risolvere tutti i riferimenti chiave e i termini del glossario utilizzati nel contenuto della revisione.
- Barra degli strumenti contestuale che consente di evidenziare o barrare rapidamente il testo.
- Menu Opzioni per modificare o eliminare i commenti.
- Per i commenti obsoleti, è possibile accedere alla visualizzazione affiancata che consente di confrontare la versione precedente dell'argomento con la versione di revisione corrente
- Quando si utilizzano i filtri, i commenti nel pannello di destra vengono filtrati in base alla selezione e al
il numero di commenti nel pannello a sinistra viene aggiornato di conseguenza.
Per ulteriori dettagli, consulta la sezione Rivedi argomenti o mappe nella guida Utilizzo di Adobe Experience Manager Guides.
Miglioramenti alla traduzione
Sono ora disponibili miglioramenti più semplici nel dashboard di traduzione che consentono di tradurre facilmente i documenti dall’editor web.
Colonna etichetta versione aggiunta al dashboard di traduzione
Nel dashboard di traduzione è inoltre possibile visualizzare la colonna Etichetta versione. Viene visualizzata l'etichetta per la versione selezionata del file di origine. Questo può aiutarti a selezionare tutti i file con un’etichetta specifica e a tradurli in una volta sola.
Visualizza la differenza di versione per i file non sincronizzati dal dashboard di traduzione
È ora possibile verificare le differenze tra la versione selezionata e l'ultima versione di origine tradotta degli argomenti. Puoi anche scegliere di tradurre i file Non sincronizzati in base alle modifiche apportate tra le due versioni di un argomento.
Passa l'etichetta della versione alla versione di destinazione
AEM Guides consente di passare l’etichetta del file di origine al file di destinazione. Questo consente di identificare facilmente la versione sorgente del file tradotto.
Ad esempio, se disponi di alcuni file sorgente a cui è applicata l’etichetta di versione Release 1.0, puoi anche trasmettere l’etichetta di origine (Release 1.0) al file tradotto.
Forza sincronizzazione per risorse non sincronizzate
Se apporti modifiche ad alcune delle risorse, AEM Guides le contrassegna come non sincronizzate. Puoi tradurre nuovamente le risorse modificate o scegliere di ignorare lo stato Non sincronizzato. Ad esempio, se hai apportato alcune modifiche minori che non richiedono alcuna traduzione, puoi contrassegnarle come In sincronia.
Visualizza progetti di traduzione in corso per un argomento o una mappa
Alcuni dei riferimenti nel dashboard di traduzione potrebbero essere in corso. Ora AEM Guides fornisce una funzione per aiutarti a visualizzare l’elenco di tutti i progetti di traduzione in corso (insieme alla lingua di destinazione) che contengono il riferimento selezionato.
Per ulteriori dettagli, fare riferimento alla sezione Traduci documenti dall'editor Web nella guida Utilizzo di Adobe Experience Manager Guides.
Genera output in vari formati dall’editor web
Ora è possibile generare facilmente l'output per gli argomenti o la mappa DITA dall'Editor Web. Puoi configurare vari predefiniti di output come AEM Site, PDF, HTML5,
JSON (un formato di output headless) e output personalizzato. Utilizzale per generare i rispettivi output. È possibile definire gli attributi negli argomenti DITA e quindi utilizzare il predefinito di condizione per applicare una condizione durante la pubblicazione dell'output. È inoltre possibile utilizzare la funzione di pubblicazione della linea di base per pubblicare selettivamente una versione specifica della mappa o dell'argomento DITA.
Gestione predefiniti di output globali e del profilo cartella
AEM Guides offre la funzione di creare e gestire predefiniti di output per i profili globali e cartelle. Puoi quindi utilizzare facilmente questi predefiniti di output per generare l’output per tutte le mappe correlate al profilo globale o cartella.
Questi predefiniti globali vengono visualizzati nella scheda Output di tutte le mappe correlate. Puoi utilizzarli per generare l’output per tutte le mappe correlate. Per generare l'output di PDF, potete selezionare il predefinito come predefinito di default PDF. Puoi anche Modificare, Rinominare, Duplicare o Eliminare un predefinito di output esistente dal menu Opzioni.
Trova e sostituisci il testo a livello di mappa
È ora possibile cercare all'interno di una mappa i file che contengono testo specifico. Il testo cercato viene evidenziato nei file. È inoltre possibile sostituire la parola o la frase cercata con un'altra parola o frase all'interno dei file. Selezionare l'icona Sostituisci singola occorrenza per sostituire l'occorrenza corrente e l'icona Sostituisci tutto nel file per sostituire tutte le occorrenze nel file selezionato. È possibile selezionare l'icona Sostituisci tutto per sostituire tutte le occorrenze del termine cercato in tutti i file.
Per impostazione predefinita, le opzioni File di estrazione prima di sostituzione e Crea nuova versione dopo sostituzione sono selezionate, pertanto un file viene estratto prima di sostituire il testo e viene creata una nuova versione dopo la sostituzione del testo. È inoltre possibile eseguire ricerche nella stringa nei riferimenti indiretti all'interno della mappa DITA. Per impostazione predefinita, questa opzione è disabilitata, pertanto la ricerca viene eseguita solo sui riferimenti diretti.
Vista Layout nell’Editor mappa
Ora è possibile visualizzare il layout completo di una mappa DITA nell'Editor mappe. Quando apri una mappa per la modifica, viene aperta la vista Layout dell’Editor mappa. In questa vista è possibile visualizzare la gerarchia delle mappe in una vista ad albero. È inoltre possibile modificare e organizzare o strutturare gli argomenti in una mappa.
La visualizzazione Layout contiene una barra degli strumenti separata che consente di eseguire molte attività sugli argomenti presenti in una mappa.
È possibile inserire riferimenti ad argomenti, gruppi di argomenti e definizioni chiave in una mappa. È possibile riorganizzare gli argomenti presenti in una mappa spostandoli verso l'alto, verso il basso, a sinistra o a destra. È inoltre possibile trascinare gli argomenti per spostarli in una mappa. L'Editor mappe fornisce anche le icone per bloccare o sbloccare i file, controllare la cronologia delle versioni ed eseguire una gestione delle etichette delle versioni.
Nella visualizzazione Layout è inoltre disponibile Opzioni visualizzazione per visualizzare o nascondere il numero di riga, mostrare o nascondere la casella di controllo o visualizzare il nome o il titolo del file per gli argomenti in una mappa.
Puoi anche visualizzare gli argomenti in base ai filtri condizionali applicati.
Oltre ad organizzare gli argomenti nel file mappa, è possibile aggiungere, spostare, copiare, incollare o eliminare i riferimenti utilizzando il menu Opzioni disponibile per un elemento nella visualizzazione Layout.
Nel pannello di destra vengono visualizzate le Proprietà contenuto e le Proprietà mappa nella vista Layout dell’Editor mappa. Ora è anche possibile impostare le informazioni sui metadati per gli argomenti o la mappa. È possibile definire il Titolo navigazione, il Testo collegamento, la Descrizione breve e le Parole chiave per l'argomento o la mappa selezionata.
Per ulteriori dettagli, consulta la sezione Visualizzazione layout nella guida Utilizzo di Adobe Experience Manager Guides.
Pannello Generazione rapida
Ora AEM Guides fornisce il pannello Generazione rapida che consente di generare e visualizzare rapidamente l'output dei predefiniti creati per la mappa DITA.
Nel pannello Generazione rapida è possibile visualizzare l'elenco di tutti i predefiniti di output creati per la mappa DITA. Potete anche visualizzare rapidamente l'output generato per i predefiniti. Al termine della generazione dell’output viene visualizzato un messaggio di esito positivo o negativo. Puoi anche visualizzare il registro degli errori che contiene i dettagli dell’errore che si è verificato nel processo di generazione.
Creare una baseline dinamica basata su etichette
Ora AEM Guides offre la funzione di creare linee di base dinamiche basate su etichette. Se si genera una baseline, si scarica una baseline o si crea un progetto di traduzione utilizzando una baseline, i file vengono selezionati in modo dinamico in base alle etichette aggiornate. Questa funzione è utile in quanto non è necessario modificare la linea di base quando si aggiornano le etichette.
Eliminare e duplicare i file dal pannello dell’archivio
Ora è possibile eliminare facilmente i file (file singolo alla volta) dal menu Opzioni del file selezionato dal pannello del repository. Viene visualizzata una richiesta di conferma prima di eliminare il file. Se non viene fatto riferimento al file da alcun altro file, questo viene eliminato e viene visualizzato un messaggio di operazione riuscita.
È inoltre possibile creare un duplicato o una copia del file selezionato. Per impostazione predefinita, il file viene creato con
un suffisso (come filename_1.extension).
Altri miglioramenti dell’editor web
-
In AEM Guides è possibile eseguire alcune operazioni comuni per immagini e file multimediali utilizzando il menu di scelta rapida. Ora puoi anche individuare l’immagine o il supporto selezionato nell’archivio o visualizzare l’anteprima del file nell’interfaccia utente di Assets.
-
Il nome del profilo cartella corrente viene visualizzato come etichetta per l'icona Preferenze utente nella barra degli strumenti principale. Questo ti aiuta a identificare il profilo di cartella su cui stai lavorando.
-
Quando apri una mappa nella vista mappa, il titolo della mappa corrente viene visualizzato al centro della barra degli strumenti principale. Questa funzione è utile per comunicare agli utenti quale mappa è attualmente aperta.
Rimozione delle versioni selezionate dei file
Durante la creazione e la gestione del contenuto, è possibile che vengano create molte versioni dei file DITA nell'archivio. AEM Guides consente di eliminare versioni precedenti dei file DITA dall'archivio e di liberare spazio su disco.
AEM Guides non elimina la prima versione del file o una versione inclusa in una baseline o a cui è applicata un'etichetta. L’operazione di rimozione non elimina nemmeno i file inclusi in un flusso di lavoro di traduzione o revisione. Puoi scegliere il numero di versioni da mantenere e decidere anche di eliminare i file che sono più vecchi del numero di giorni definito.
Prima di avviare l'operazione di rimozione, è possibile visualizzare in anteprima il report per visualizzare le versioni che verranno eliminate. È quindi possibile decidere di avviare o annullare l'operazione di rimozione.
Una volta completata l'operazione di rimozione, è possibile controllare il report di rimozione per visualizzare i file eliminati.
Titolo da visualizzare al posto di UUID nell’editor di ossigeno
Ora AEM Guides ti consente di scegliere l'opzione Usa titolo nell'editor e Gestione mappe nelle impostazioni. Se si seleziona questa opzione, il titolo del file viene visualizzato nella scheda del file quando viene aperto nell'Editor o in Gestione mappe DITA. Se non selezioni questa opzione, nella scheda del file viene visualizzato l’UUID del file.
Interfaccia utente metadati disponibile per i predefiniti di PDF
È possibile impostare i metadati dal predefinito di output di una mappa DITA. È possibile impostare i metadati Titolo, Autore, Oggetto e Parole chiave. Questi metadati vengono mappati ai metadati nelle Proprietà file del PDF di output. Questi metadati sostituiscono i metadati definiti a livello di libro. Potete definire i metadati in modo specifico in ciascun predefinito di output e trasmetterli al PDF di output.
Native PDF | PDF con barra delle modifiche che mostra la differenza tra le versioni dei documenti
Ora puoi creare un PDF che mostra le differenze di contenuto tra due versioni utilizzando la barra delle modifiche. È possibile scegliere di confrontare la versione corrente con una baseline della versione precedente o confrontare le due versioni della baseline selezionate.
Nel PDF viene visualizzata una barra delle modifiche che indica il contenuto modificato, inserito o eliminato. Sono inoltre disponibili le seguenti opzioni:
- Mostra il contenuto inserito in verde e sottolineato
- Mostra il contenuto eliminato in rosso e contrassegnato con barrato
Native PDF | Supporto variabile per percorso di output e nome file PDF
Ora puoi anche utilizzare le seguenti variabili predefinite per definire il percorso di output e il file di PDF. Puoi utilizzare una singola variabile o una combinazione di variabili per definire queste opzioni:
${map_filename}${map_title}${preset_name}${language_code}${map_parentpath}(solo per il percorso di output)${path_after_langfolder}(solo per il percorso di output)
Native PDF | Genera sommario per mappe DITA e riordina i layout di pagina
È inoltre possibile generare il sommario nelle mappe DITA utilizzando un'impostazione PDF avanzata del modello. Puoi scegliere di abilitare o disabilitare la visualizzazione dei vari layout di pagina e anche riordinarne la posizione.
Native PDF | Aggiungere un segnalibro personalizzato nell’output di PDF
Ora puoi aggiungere un segnalibro personalizzato a un particolare contenuto nell’output PDF finale per facilitarne la navigazione. Questa opzione viene aggiunta al sommario creato dai titoli di argomento o di sezione nella mappa DITA.
Native PDF | Applicare uno stile personalizzato alle voci del sommario e al contenuto dell’argomento
AEM Guides fornisce la funzione di applicare uno stile personalizzato alle voci del sommario o a un particolare argomento nell’output PDF. È ad esempio possibile modificare il colore del testo nel sommario e nel titolo dell'argomento. È inoltre possibile applicare stili all'intero contenuto dell'argomento.