Novità della versione 4.3.0 di Adobe Experience Manager Guides (luglio 2023)
Questo articolo descrive le funzioni nuove e migliorate della versione 4.3.0 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 Note sulla versione.
Connettersi a un'origine dati e inserire dati negli argomenti
Ora puoi connetterti rapidamente alle origini dati utilizzando connettori predefiniti di AEM Guides. La connessione a un’origine dati consente di mantenere le informazioni sincronizzate con l’origine e tutti gli aggiornamenti ai dati vengono rispecchiati automaticamente, rendendo AEM Guides un vero e proprio hub di contenuti. Questa funzione ti consente di risparmiare tempo e fatica nell’aggiungere o copiare manualmente i dati.
AEM Guides consente all’amministratore di configurare i connettori predefiniti per i database JIRA e SQL (MySQL, PostgreSQL, SQL Server, SQLite). Possono inoltre aggiungere altri connettori estendendo le interfacce predefinite.
Una volta aggiunti, puoi visualizzare i connettori configurati elencati nel pannello Origini dati nell’Editor web.
Crea uno snippet di contenuto per recuperare i dati da un’origine dati connessa. È quindi possibile inserire i dati negli argomenti e modificarli. Dopo aver creato un generatore di frammenti di contenuto, puoi riutilizzarlo per inserire i dati in qualsiasi argomento.
Ora è anche possibile creare un argomento da un'origine dati connessa. Un argomento può contenere dati in vari formati, ad esempio tabelle, elenchi e paragrafi. Consente inoltre di creare una mappa DITA per tutti gli argomenti. È possibile associare i metadati all'argomento quando si estrae da un'origine dati.
Per ulteriori dettagli, visualizzare Utilizzare i dati dell'origine dati.
Aggiungere citazioni al contenuto
Le citazioni sono riferimenti all’origine delle informazioni aggiunte al contenuto. Le citazioni ti aiutano a stabilire credibilità e a prevenire il plagio. Le citazioni consentono ai lettori di individuare la sorgente e verificare le informazioni presentate nel testo.
In AEM Guides, puoi aggiungere citazioni o importarle e applicarle al contenuto. È possibile aggiungere queste citazioni da qualsiasi origine di libri, siti Web e giornali.
Dopo aver inserito le citazioni negli argomenti, è possibile visualizzarne l'anteprima nell'editor Web. Puoi anche pubblicare i contenuti con le citazioni utilizzando Native PDF.
Per ulteriori dettagli, visualizza Aggiungi e gestisci citazioni nel contenuto.
Da Publish a un frammento di contenuto
I frammenti di contenuto sono parti discrete di contenuto nell’AEM. Sono contenuti strutturati basati su un modello di contenuto. I frammenti di contenuto sono contenuti puri senza informazioni di progettazione o layout. Possono essere creati e gestiti indipendentemente dai canali supportati dall’AEM. La modularità e la riutilizzabilità dei frammenti di contenuto determinano maggiore flessibilità, coerenza, efficienza e gestione più semplice.
Ora AEM Guides offre un modo per pubblicare un argomento o gli elementi all’interno di un argomento in un frammento di contenuto. Puoi creare una mappatura basata su JSON tra un argomento e un modello per frammenti di contenuto. Utilizza questa mappatura per pubblicare in un frammento di contenuto il contenuto presente in alcuni o in tutti gli elementi di un argomento.
Sfrutta la potenza di AEM Guides e dei frammenti di contenuto e utilizza i frammenti di contenuto in qualsiasi sito AEM. Puoi anche estrarre i dettagli tramite API supportate da frammenti di contenuto.
Revisione dei miglioramenti
AEM Guides fornisce ora una funzionalità di revisione migliorata con le seguenti funzionalità:
Pannello Revisione per mostrare i progetti di revisione e le attività di revisione attive
Ora AEM Guides rende le tue recensioni più fluide. Fornisce il pannello Revisioni all'interno dell'Editor Web. Il pannello Revisioni visualizza tutti i progetti di revisione e le attività di revisione attive all'interno dei progetti di revisione di cui fai parte.
In qualità di autore, questa funzione consente di aprire facilmente le attività di revisione, visualizzare i commenti e indirizzarli rapidamente in una visualizzazione centralizzata.
Per ulteriori dettagli, visualizzare la descrizione della funzionalità Rivedi nella sezione Pannello sinistro.
Cerca argomenti di revisione
La conduzione delle recensioni è una caratteristica fondamentale di AEM Guides. Aiuta i revisori a rivedere i documenti loro assegnati .
È ora possibile cercare un argomento immettendo una parte del testo del titolo o del percorso file nella barra di ricerca della visualizzazione argomenti del pannello di revisione. È inoltre possibile scegliere di visualizzare tutti gli argomenti o visualizzare gli argomenti con commenti. Per impostazione predefinita, è possibile visualizzare tutti gli argomenti presenti nell'attività di revisione.
Per ulteriori dettagli, visualizzare Rivedi argomenti.
Framework di estensione delle guide
Crea pacchetti personalizzati sopra AEM Guides per fornire estensibilità utilizzando AEM Guides Extension Framework. Questi pacchetti sono utili per sviluppatori e consulenti e consentono l’estensibilità ai componenti nell’editor. Possono essere indirizzati a pulsanti, finestre di dialogo e elenchi a discesa e aggiungere JavaScript personalizzati che possono interagire facilmente con l’interfaccia utente di AEM Guides.
Miglioramenti di Native PDF
I seguenti miglioramenti di Native PDF sono stati apportati nella versione 4.3.0 per rendere AEM Guides un prodotto più robusto:
Supporto per le variabili di lingua
AEM Guides fornisce il supporto per le variabili di lingua. È possibile utilizzare le variabili di lingua per definire una versione localizzata delle etichette predefinite, ad esempio Nota, Avvertenza e Avvertenza, o del testo statico nell’output di PDF.
Puoi aggiungere le variabili di lingua o la versione localizzata delle etichette alle sezioni appropriate nell’output di PDF e nei modelli di output.
Variabili di lingua nell’output di PDF
È possibile utilizzare le variabili di lingua per definire etichette localizzate per elementi quali Nota, Attenzione e Avvertenza. Puoi aggiornare il valore di queste variabili in una o più lingue, quindi il valore localizzato viene selezionato automaticamente nell’output di PDF.
Ad esempio, puoi presentare l’etichetta Nota nell’output PDF nei seguenti modi:
- Inglese: Note
- Francese: Remarque
- Tedesco: Hinweis
Variabili di lingua nei modelli di output
Per creare l'output di PDF in diverse lingue, è necessario creare diversi modelli di PDF contenenti testo localizzato per ogni lingua. Ora, con la funzione Variabili di lingua, è sufficiente creare il modello una sola volta. Quindi, per qualsiasi testo statico da localizzare, puoi creare variabili di lingua corrispondenti e utilizzarle nel modello.
Puoi creare variabili di lingua per testo più lungo, ad esempio una frase intera o anche un paragrafo. Puoi anche applicare stili e utilizzare il markup HTML per formattare queste variabili di lingua.
Per ulteriori dettagli, visualizzare Supporto per le variabili di lingua.
Aggiungere una filigrana all'output PDF per i documenti bozza
Ora è possibile aggiungere una filigrana all’output PDF del documento che non è ancora stato approvato. Questa filigrana non viene visualizzata se si genera il PDF per il documento nello stato "Approvato". Ad esempio, puoi aggiungere una bozza di filigrana per l’output PDF.
Per ulteriori dettagli, visualizzare Aggiungere una filigrana all'output PDF per le bozze di documenti.
Possibilità di utilizzare i metadati dell’AEM nei layout PDF
I metadati sono la descrizione o la definizione del contenuto. Questi metadati vengono memorizzati nel contenuto della mappa DITA di origine.
Ora in AEM Guides puoi anche selezionare le proprietà dei metadati delle risorse e aggiungerle al layout di pagina. AEM Guides seleziona quindi queste proprietà di metadati delle risorse e le pubblica nell’output PDF.
Per ulteriori dettagli, visualizzare Aggiungi campi e metadati.
Ordinare le pagine nell’output di PDF
Puoi mostrare o nascondere le seguenti sezioni nel PDF e anche disporre l’ordine in cui devono essere visualizzate nell’output PDF finale:
- Sommario
- Capitoli e argomenti
- Elenco delle figure
- Elenco delle tabelle
- Indice
- Glossario
- Citazione
- Layout di pagina
Se non desideri visualizzare una particolare sezione nell’output PDF, puoi nasconderla disattivando l’interruttore.
Per ulteriori dettagli, visualizzare Ordine pagine.
Unisci pagine
In un output di PDF nativo per impostazione predefinita, tutte le sezioni iniziano su una nuova pagina. È ora possibile unire una sezione alla pagina precedente o a quella successiva. In questo modo la sezione viene pubblicata insieme alla pagina selezionata nell’output di PDF e non vi è alcuna interruzione di pagina tra le pagine.
Per ulteriori dettagli, vedi la descrizione della funzione Unisci pagine nella sezione Ordine pagine.
Pagine statiche
Puoi anche creare layout di pagina personalizzati e pubblicarli come pagine statiche nell’output di PDF. Questo consente di aggiungere qualsiasi contenuto statico come note o pagine vuote.
Per ulteriori dettagli, vedi la descrizione della funzione Pagine statiche nella sezione Ordine pagine.
Variabili nei riferimenti incrociati
Potete utilizzare le variabili per definire un riferimento incrociato. Quando utilizzi una variabile, il relativo valore viene selezionato dalle proprietà.
Ora puoi anche utilizzare {figure} e {table}.
Utilizzare {figure} per aggiungere un riferimento incrociato al numero di figura. Il numero di figura viene selezionato dagli stili di numerazione automatica definiti per la didascalia delle figure.
Utilizzare {table} per aggiungere un riferimento incrociato al numero di tabella. Il numero di tabella viene selezionato dagli stili di numerazione automatica definiti per la didascalia.
Per ulteriori dettagli, visualizzare Riferimenti incrociati.
Inizia qualsiasi capitolo dalla pagina corrente
È possibile impostare le impostazioni di configurazione di base per l'avvio di un capitolo da una pagina pari o dispari, la struttura del sommario e definire il formato della linea guida per le voci del sommario.
Ora è anche possibile iniziare un capitolo dalla pagina corrente. Se scegli di farlo, tutti i capitoli vengono pubblicati in continuazione senza interruzioni di pagina. Ad esempio, se un capitolo termina a metà della pagina 15, anche il capitolo successivo inizia dalla quindicesima pagina.
Possibilità di accedere ai file temporanei di HTML durante la generazione dell'output nativo di PDF
Ora AEM Guides consente di scaricare i file HTML temporanei creati durante la generazione dell’output PDF nativo. Nelle impostazioni del predefinito di output, seleziona l’opzione per scaricare i file temporanei. AEM Guides ti consente quindi di scaricare i file temporanei creati durante la generazione dell’output utilizzando tale predefinito.
Questa funzione consente di ottenere informazioni migliori sul processo di generazione con accesso a stili e layout provvisori e consente di correggere o modificare gli stili CSS in base alle esigenze.
Per ulteriori dettagli, visualizzare Creare un predefinito di output PDF.
Riprogettazione dell’editor CSS
Ora l’editor CSS è stato riprogettato per offrire una migliore esperienza utente con selettori e proprietà di stile.
Miglioramento della finestra di dialogo Aggiungi stile
Ora puoi utilizzare selettori personalizzati per aggiungere stili complessi. Il nuovo campo Selettore consente di aggiungere selettori personalizzati oltre alla combinazione di Classe, Tag e Pseudo classe. Ad esempio, è possibile creare lo stile table a.link per tutti i collegamenti ipertestuali all'interno di una tabella.
Personalizzare le proprietà dello stile
Ora AEM Guides presenta un nuovo pannello delle proprietà nella sezione di anteprima relativa agli stili. Potete modificare le proprietà degli stili in modo più efficiente e rapido dal pannello delle proprietà.
Rinominare e spostare i file nella vista Archivio
Ora è anche possibile rinominare o spostare un file dal pannello dell’archivio. Questa funzione è utile e consente di gestire facilmente i file dal pannello Archivio. Puoi selezionare un file e rinominarlo o spostarlo utilizzando il menu Opzioni per il file selezionato. Quando si sposta o si rinomina un file, in AEM Guides viene visualizzato un messaggio di operazione riuscita.
Per ulteriori dettagli sul menu Opzioni di un file, visualizzare la descrizione della funzione Vista archivio nella sezione Pannello sinistro.
Rapporto Collegamenti interrotti nell’editor web
AEM Guides consente di verificare la completezza complessiva dei documenti tecnici e generare rapporti dall’editor web. Ora, nella versione di giugno 2023, AEM Guides offre la funzionalità per visualizzare e correggere i collegamenti interrotti. Si tratta di un report utile che consente di gestire i collegamenti interrotti. È possibile visualizzare facilmente i collegamenti interrotti presenti nella mappa DITA e correggerli.
Una volta corretto un collegamento, questo non viene visualizzato nell’elenco dei collegamenti interrotti.
Per ulteriori dettagli, vedere Visualizzare e correggere i collegamenti interrotti.
Miglioramenti apportati a Schematron
Utilizzare le istruzioni di report per verificare la presenza di regole in Schematron
AEM Guides ora supporta anche le istruzioni del rapporto con Schematron. Un’istruzione di report genera un messaggio quando un’istruzione di test restituisce true. Ad esempio, se desideri che la descrizione breve sia inferiore o uguale a 150 caratteri, puoi definire un’istruzione di rapporto per verificare gli argomenti in cui la descrizione breve è superiore a 150 caratteri.
Per ulteriori dettagli, visualizzare Utilizzare le istruzioni di asserzione e di report per verificare la presenza di regole.
Usa espressioni Regex
È inoltre possibile utilizzare le espressioni Regex per definire una regola con la funzione matches() e quindi eseguire la convalida utilizzando il file Schematron.
Per ulteriori dettagli, visualizzare Usa espressioni Regex.
Definire pattern astratti
AEM Guides supporta anche i modelli astratti in Schematron. È possibile definire pattern astratti generici e riutilizzarli. I modelli astratti possono semplificare lo schema Schematron e aiutarti a gestire e aggiornare la logica di convalida.
Per ulteriori dettagli, visualizzare Definire modelli astratti.
Supporto per il formato XLIFF nella traduzione
AEM Guides fornisce anche il supporto per il formato XLIFF (XML Localization Interchange File Format) in traduzione. Ora puoi anche scegliere di Creare un nuovo progetto di traduzione XLIFF per convertire il contenuto XML in formato XLIFF. AEM Guides supporta XLIFF versione 1.2.
Utilizzando questo formato, puoi esportare il contenuto nel formato XLIFF standard di settore e quindi fornire lo stesso ai fornitori di traduzione. Per ulteriori dettagli, visualizzare Crea un progetto di traduzione.
Miglioramenti alla raccolta mappe
Una raccolta di mappe consente di organizzare più mappe e di pubblicarle in batch. Sono stati apportati molti nuovi miglioramenti alla raccolta Mappa:
-
Ora è possibile aggiungere predefiniti di output di PDF nativi a una raccolta di mappe e utilizzarli per generare l'output di PDF.
-
Puoi visualizzare i predefiniti per i profili globali e delle cartelle creati dall’amministratore e utilizzarli per generare l’output PDF.
-
Ora non solo è possibile selezionare un singolo predefinito, ma è anche possibile abilitare tutti i predefiniti del profilo di cartella per una mappa DITA in un'unica operazione.
Per ulteriori dettagli, visualizzare Utilizza raccolta mappe per la generazione dell'output.
Supporto dei PDF nativi nel dashboard Publish in blocco
Con la funzione Bulk Activation di AEM Guides, puoi attivare in modo rapido e semplice il contenuto dall’istanza di authoring a quella di pubblicazione. Nella mappa Bulk Activation puoi includere il predefinito di output PDF nativo, l’output Sito AEM, PDF, HTML5, Personalizzato e JSON.
Per ulteriori dettagli, visualizzare Attivazione in blocco del contenuto pubblicato.
Migliorato strumento di spostamento in blocco
Ora, in qualità di amministratore, puoi utilizzare il migliorato strumento Sposta in blocco per spostare cartelle con molti file da una posizione all’altra.
È possibile utilizzare la finestra di dialogo Sfoglia file per selezionare le cartelle di origine che si desidera spostare. È inoltre possibile selezionare il percorso di destinazione per spostare le cartelle di origine. Seleziona l'icona
Per ulteriori dettagli, visualizzare Sposta i file in blocco.
Pannello Preferiti migliorato
AEM Guides consente di creare una raccolta o un elenco di file e cartelle preferito e di utilizzarli facilmente. Il menu Opzioni è ora disponibile anche nel pannello Preferiti. È possibile rinominare la raccolta selezionata o eliminarla dal menu Opzioni. È possibile selezionare l'opzione Aggiorna per ottenere un nuovo elenco di file o cartelle dal repository. Puoi anche visualizzare il contenuto della cartella nell’interfaccia utente di Assets.
Per ulteriori dettagli sul menu Opzioni di una raccolta Preferiti, visualizzare la descrizione della funzionalità Preferiti nella sezione Pannello sinistro.
Passa al tema di sistema
Ora puoi anche utilizzare il tema del dispositivo. Utilizzando le Preferenze utente, puoi configurare AEM Guides per passare automaticamente dai temi chiaro a scuro in base al tema del dispositivo.
Per ulteriori dettagli, visualizzare la descrizione della funzionalità Preferenze utente nella sezione Barra degli strumenti principale.