DocumentazioneAEM GuidesDocumentazione di AEM Guides

Output di Publish PDF

Last update: Mon Jul 15 2024 00:00:00 GMT+0000 (Coordinated Universal Time)

Creato per:

  • Utente

Con AEM Guides, puoi generare PDF di singoli argomenti o un intero file di mappa. Puoi pubblicare il contenuto in formato PDF utilizzando uno dei tre metodi seguenti:

  • DITA-OT

Utilizzare questo metodo per generare un output PDF per una mappa dal dashboard delle mappe. Puoi impostare le proprietà di pubblicazione prima di generare il PDF creando un predefinito di output per la mappa aperta nel dashboard delle mappe. Per creare o modificare un predefinito di output, consulta la sezione Informazioni sui predefiniti di output nella Guida utente di AEM Guides as a Cloud Service.

Per ulteriori informazioni sulla generazione di un PDF utilizzando il metodo DITA-OT, vedere Generare PDF utilizzando DITA-OT.

  • FrameMaker Publishing Server (FMPS)

Utilizzare questo metodo per generare un output PDF non solo dal contenuto DITA, ma anche dai documenti di FrameMaker (con estensione book e fm) disponibili nell'archivio AEM. Il PDF può essere creato configurando un predefinito di output e pubblicato utilizzando FrameMaker Publishing Server (FMPS). Puoi progettare e configurare l’aspetto dell’output per PDF e altri formati e memorizzarlo in un file di impostazione (.sts). Questo file di impostazione viene quindi utilizzato da FMPS per generare l'output per una mappa DITA o un file book. Per creare o modificare un predefinito di output, consulta la sezione Informazioni sui predefiniti di output nella Guida utente di AEM Guides as a Cloud Service.

Per ulteriori informazioni sulla configurazione di FMPS, vedere Generare output dai documenti di FrameMaker.

  • Pubblicazione PDF nativa

Utilizza questo metodo per generare un output PDF ricco di funzioni basato sugli standard W3C CSS3 e CSS paged media. Con la pubblicazione di PDF nativi, puoi utilizzare i modelli per impostare il layout e lo stile dei contenuti e applicare varie impostazioni per perfezionare le impostazioni di PDF. Inoltre, puoi modificare e creare modelli personalizzati con l’editor di modelli.

Per ulteriori informazioni sulla pubblicazione di PDF nativi, vedere Utilizzo della pubblicazione di PDF nativi.

Utilizzo della pubblicazione nativa di PDF native-pdf-publishing

Durante l’authoring dei contenuti, è fondamentale assicurarsi che siano ottimizzati per la visualizzazione, la modifica e la stampa. Utilizzando gli standard W3C CSS3 per lo stile dei contenuti e gli standard CSS per i file multimediali di paging per le proprietà di definizione delle pagine, quali dimensioni, margini, orientamento, interruzioni di pagina, intestazioni, piè di pagina e numerazione delle pagine, è possibile impostare la visualizzazione e il layout per il documento PDF per garantire coerenza e usabilità. La funzione di pubblicazione di PDF nativi utilizza questi standard per generare un PDF.

Con la pubblicazione nativa di PDF, puoi utilizzare modelli predefiniti per garantire la coerenza del layout e della struttura del contenuto, applicare fogli di stile per modificare l’aspetto dell’output, ottimizzare PDF, impostare gli indicatori della stampante, consentire il supporto di utilità per la lettura dello schermo, impostare la conformità di PDF, i font da incorporare e molto altro.

La generazione di un PDF tramite la pubblicazione di PDF nativi presenta due aspetti:

  • Utilizzo di modelli per applicare lo stile al contenuto, impostare i layout di pagina e varie impostazioni per ottimizzare le PDF. Gli autori possono scegliere di utilizzare/modificare i modelli di esempio forniti o creare modelli personalizzati e impostare opzioni di configurazione avanzate utilizzate da autori e sviluppatori.

  • Crea o configura un predefinito di output PDF per controllare le impostazioni di PDF. Una volta creato un predefinito di output PDF, puoi generare il PDF.

Per ulteriori informazioni, vedere Generare un output PDF.

Creare un predefinito di output PDF create-output-preset

Il primo passaggio nella generazione di un output PDF consiste nella creazione di un predefinito di output PDF, ovvero una raccolta di proprietà di pubblicazione assegnate a una mappa. Potete creare un predefinito di output per qualsiasi mappa aperta nel pannello Vista mappa o configurare un predefinito esistente per generare rapidamente un PDF per la stessa mappa.

Dal predefinito di output di PDF puoi selezionare un modello, applicare condizioni, impostare restrizioni per controllare il modo in cui un utente interagisce con il PDF, configurare impostazioni avanzate come la compressione, la conformità e altro ancora.

Per creare o configurare un predefinito di output PDF:

  1. Nella scheda Output, fai clic su Predefiniti nella barra laterale a sinistra.
    Viene visualizzato il pannello Predefinito.

    pannello predefinito {width="600"}

  2. Nel pannello Predefiniti di output eseguire una delle operazioni seguenti:

    • Fate doppio clic su un predefinito di output PDF predefinito per visualizzarlo.
    • Fai clic sull'icona + accanto a Predefiniti per aggiungere un nuovo predefinito di output di Tipo: PDF

  3. Per configurare le impostazioni di un predefinito PDF esistente:

    • Fai clic sull'icona Opzioni opzioni accanto al predefinito di output desiderato e seleziona Modifica.
      Puoi utilizzare le seguenti impostazioni nelle schede Generale, Metadati, Layout, Sicurezza e Avanzate per configurare un predefinito di output PDF:

Generale

Consente di specificare le impostazioni di output di base, ad esempio il percorso di output, il nome del file PDF e altro ancora.

Impostazione
Descrizione
Percorso di output
Percorso all’interno dell’archivio AEM in cui è memorizzato l’output del PDF. Assicurati che il percorso di output non si trovi all’interno della cartella del progetto. Se questo campo viene lasciato vuoto, l'output viene generato nella posizione di output predefinita della mappa DITA.
Per definire il percorso di output è inoltre possibile utilizzare le seguenti variabili predefinite. Puoi utilizzare una singola variabile o una combinazione di variabili per definire questa opzione.
${map_filename}: utilizza il nome dei file di mapping DITA per creare il percorso di destinazione.
${map_title}: utilizza il titolo della mappa DITA per creare il percorso di destinazione.
${preset_name}: usa il nome del predefinito di output per creare il percorso di destinazione.
${language_code}: utilizza il codice della lingua in cui si trova il file di mappa per creare il percorso di destinazione.
${map_parentpath}: utilizza il percorso completo del file di mappa per creare il percorso di destinazione.
${path_after_langfolder}: utilizza il percorso del file di mappa dopo la cartella della lingua per creare il percorso di destinazione.
File PDF
Specificare un nome di file per il salvataggio del PDF. Per impostazione predefinita, il nome del file PDF aggiunge il nome della mappa DITA insieme al nome del predefinito. Ad esempio, ditamap è "TestMap" e il nome del predefinito è "preset1"; il nome predefinito del pdf sarà "TestMap_preset1.pdf".
Per definire il file PDF è inoltre possibile utilizzare le seguenti variabili predefinite. Puoi utilizzare una singola variabile o una combinazione di variabili per definire questa opzione.
${map_filename}
${map_title}
${preset_name}
${language_code}.
Applica condizioni utilizzando

Per il contenuto condizionale, scegliere una delle opzioni seguenti per generare un output PDF in base a tali condizioni:

  • Nessuna applicazione Selezionare questa opzione se non si desidera applicare alcuna condizione alla mappa e al contenuto di origine.
  • File Ditaval Selezionare un file DITAVAL per generare contenuto condizionale. Per selezionare, fai clic su in base a Predefinito condizione e individua il 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.
Usa Base Line
Se è stata creata una baseline per la mappa DITA selezionata, selezionare questa opzione per specificare la versione da pubblicare. Per ulteriori dettagli, vedi Utilizzare la previsione.
Crea PDF con barra di modifica tra le versioni pubblicate

Utilizza le seguenti opzioni per creare un PDF che mostri le differenze di contenuto tra due versioni utilizzando le barre di modifica:

  • Baseline della versione precedente Scegliere la versione della baseline da confrontare con la versione corrente o con un'altra baseline. Nel PDF viene visualizzata una barra delle modifiche che indica il contenuto modificato. Una barra delle modifiche è una linea verticale che identifica visivamente il contenuto nuovo o rivisto. La barra delle modifiche viene visualizzata a sinistra del contenuto inserito, modificato o eliminato.
    Nota: se si seleziona Usa baseline e si sceglie una baseline da pubblicare, il confronto verrà eseguito tra le due versioni della baseline selezionate. Ad esempio, se si sceglie la versione 1.3 della baseline in Usa la baseline e la versione 1.1 in Baseline della versione precedente, verrà eseguito il confronto tra la versione 1.1 della baseline e la versione 1.3 della baseline.
  • Mostra testo aggiunto Seleziona questa opzione per mostrare il testo inserito in verde e sottolineato. Questa opzione è selezionata per impostazione predefinita.
  • Mostra testo eliminato Selezionare questa opzione per visualizzare il testo eliminato in rosso e contrassegnato con un barrato. Questa opzione è selezionata per impostazione predefinita.
    Nota È inoltre possibile personalizzare lo stile della barra delle modifiche, del contenuto inserito o del contenuto eliminato utilizzando il foglio di stile.
Flusso di lavoro di generazione Post
Seleziona questa opzione per visualizzare un elenco a discesa contenente tutti i flussi di lavoro configurati in AEM. Puoi selezionare il flusso di lavoro da eseguire dopo il completamento del flusso di lavoro di generazione PDF.

Metadati

I metadati sono la descrizione o la definizione del contenuto. I metadati sono utili per la gestione dei contenuti e per la ricerca di file su Internet.

Utilizzare la scheda Metadati per impostare i campi metadati, ad esempio il nome dell'autore, il titolo del documento, le parole chiave, le informazioni sul copyright e altri campi dati per l'output PDF. Puoi anche aggiungere metadati personalizzati per l’output PDF.

Questi metadati sono mappati ai metadati nella scheda Descrizione all'interno delle Proprietà documento del tuo PDF di output.

scheda metadati {width="600"}

Dai predefiniti di output, seleziona PDF > PDF nativo > Metadati per aggiungere e personalizzare le opzioni dei metadati.

  • Usa metadati aggiunti in topicmeta

    Questa opzione è selezionata per impostazione predefinita. È possibile utilizzare i metadati aggiunti nell'elemento topicmeta della mappa DITA per popolare i campi metadati dell'output PDF.

  • Fornire il file XMP

    Puoi anche compilare direttamente i campi di metadati importando il file XMP (Extensible Metadata Platform). Puoi scaricare un esempio di file XMP da qui.

Scarica

In alternativa, puoi generare un file XMP utilizzando Adobe Acrobat.

  1. Fare clic su File > Proprietà in Acrobat.
  2. In Descrizione, fare clic su Metadati aggiuntivi.
  3. Nel pannello a sinistra, seleziona Avanzate.
  4. Fai clic su Salva.

Il file XMP viene salvato sul dispositivo.

  • Fornisci nomi e valori metadati

    1. Aggiungi il nome selezionando dall’elenco a discesa o aggiungi metadati personalizzati digitando direttamente nel campo del nome.
    2. Inserisci il valore per i metadati e fai clic sull’icona "+".
      I metadati vengono aggiunti all’elenco dei metadati per PDF.

Puoi anche utilizzare le variabili per definire i valori dei metadati. È possibile utilizzare i metadati definiti per il file mappa DITA o mappa segnalibro come variabili. I metadati si trovano nel nodo /jcr:content/metadata della mappa DITA o del file di mappa di libri.
Quando utilizzi una variabile, il relativo valore viene scelto dalle proprietà dei metadati.

Per utilizzare una variabile, è necessario definirla nel formato ${<variable>}.

Ad esempio, una delle proprietà dei metadati definite nel nodo /jcr:content/metadata è
dc:title. È possibile specificare ${dc:title} e il valore del titolo viene utilizzato nell'output finale.

Puoi utilizzare una singola variabile o una combinazione di variabili per definire i metadati. Ad esempio, ${dc:title} ${dc:docstate}. Puoi anche utilizzare la combinazione di una variabile e una stringa. Esempio: View ${dc:title} in ${dc:language}.

Utilizza le variabili di linguaggio per definire il valore localizzato delle proprietà dei metadati. A seconda della lingua scelta, il valore localizzato viene selezionato automaticamente nell’output di PDF. Ad esempio, puoi stampare "Autore" come valore dei metadati in inglese e "Autorin" in tedesco.

Formato: ${lng:<variable name>}. Ad esempio, ${lng:author-label} dove author-label è una variabile di linguaggio.

Passa il cursore sopra icona info {width="25"} vicino all'opzione per visualizzare ulteriori dettagli su di essa.

Layout

Utilizzare per impostare i layout di pagina e specificare le opzioni di visualizzazione della pagina per l'output PDF, ad esempio Visualizzazione pagina e impostazione dei livelli di zoom.

Impostazione
Descrizione
Modello PDF
I modelli di PDF forniscono una chiara struttura per definire i layout di pagina, lo stile del contenuto e applicare varie impostazioni all’output di PDF. Seleziona dall’elenco a discesa Modello PDF per scegliere il modello desiderato.
Puoi anche selezionare Sfoglia modello icona Sfoglia modelli {width="25"} per scegliere un modello. Nella finestra di dialogo Seleziona modello PDF è inoltre possibile visualizzare l'anteprima della miniatura e il titolo e la descrizione del modello selezionato.
Visualizzazione pagina

Utilizza Visualizzazione pagina per la visualizzazione della pagina che mostra come viene visualizzato il PDF all’apertura. Seleziona dall’elenco a discesa Visualizzazione pagina per scegliere una visualizzazione preferita.

  • Predefinito viene visualizzato in base all'impostazione predefinita del visualizzatore di PDF nel computer di un utente.
  • Visualizzazione a pagina singola Visualizza una pagina alla volta.
  • Scorrimento di una singola pagina Visualizza una singola pagina in una colonna verticale continua.
  • Visualizzazione a due pagine Visualizza due pagine affiancate alla volta. .
  • Scorrimento di due pagine Visualizza due pagine affiancate con scorrimento continuo.
Zoom

Selezionare questa opzione per ridimensionare la visualizzazione della pagina che mostra la modalità di visualizzazione del PDF all'apertura.

  • Predefinito viene visualizzato come impostazione predefinita del visualizzatore di PDF nel computer di un utente
  • 100% Fa apparire la pagina nelle sue dimensioni effettive.
  • Adatta pagina Adatta la larghezza e l'altezza della pagina al riquadro del documento. .
  • Adatta larghezza pagina Assegna alla larghezza della pagina la larghezza del riquadro del documento.
  • Adatta altezza pagina Imposta l'altezza della pagina come riempimento del riquadro del documento.

Sicurezza

Protect il PDF aggiungendo restrizioni per aprire e leggere il file. Utilizza le opzioni seguenti per evitare accessi non autorizzati.

Impostazione
Descrizione
Imposta la password per aprire il documento
Seleziona questa opzione per aggiungere una password sicura per visualizzare il file PDF. Specificare una password nel campo Password utente. Gli utenti possono aprire il PDF solo immettendo la password fornita in questo campo.
Impostare le restrizioni per i documenti

Seleziona per limitare il modo in cui gli utenti possono interagire con il PDF. Specifica una password nel campo Password proprietario per il funzionamento delle impostazioni di restrizione seguenti.

  • Stampa Selezionare questa opzione per consentire a un utente di stampare il PDF.
  • Stampa di qualità bozza Selezionare questa opzione per consentire a un utente di stampare il PDF con una risoluzione inferiore.
  • Copia del contenuto Seleziona questa opzione per consentire a un utente di copiare il contenuto dal PDF.
  • Annotazioni Selezionare questa opzione per consentire a un utente di aggiungere una nota o un commento nel PDF.
  • Modifiche al contenuto Selezionare questa opzione per consentire a un utente di modificare il contenuto del PDF.
  • Copia del contenuto per l'accessibilità Selezionare questa opzione per consentire agli assistenti vocali di leggere e navigare nel contenuto in PDF.
    Assembly documenti Selezionare questa opzione per consentire agli utenti di inserire pagine nel PDF.
    Nota: gli utenti devono immettere la password del proprietario per modificare eventuali restrizioni da File > Proprietà in Adobe Acrobat.

Avanzate

Utilizza le seguenti opzioni per specificare impostazioni avanzate per unire i PDF, utilizzare la compressione, selezionare lo standard di conformità e altro ancora.

Impostazione
Descrizione
Crea PDF accessibile (con tag)
Seleziona questa opzione per generare un PDF con i tag. Un PDF con tag consente agli assistenti vocali di leggere e navigare più facilmente in contenuti, collegamenti ipertestuali, segnalibri e così via. Ad esempio, se una tabella viene contrassegnata, l’assistente vocale saprà che sta leggendo la tabella e non solo le righe e il testo.
Unisci PDF inclusi nel sommario
Selezionare questa opzione per unire i PDF esistenti nell'output aggiungendoli alla mappa DITA come file di risorse. I PDF verranno inseriti nella posizione rappresentata nella mappa e le pagine verranno incrementate di conseguenza.
Incorpora font usati
Selezionare questa opzione quando si utilizzano caratteri che potrebbero non essere installati nel computer dell'utente finale. Selezionando questa opzione, i font usati vengono incorporati nel PDF, garantendo all’utente di vedere il PDF come previsto anche se i font non sono installati nel computer.
Nota: un tipo di carattere può essere incorporato solo se contiene un'impostazione del fornitore che ne consente l'incorporamento. Prima di incorporare un carattere, assicurati di disporre dell’impostazione o della licenza richiesta.
Usa sillabazione automatica
Con la sillabazione automatica attivata, le parole alla fine delle righe vengono interrotte in posizioni grammaticalmente corrette con un trattino.
Abilita JavaScript
Abilita questa opzione se disponi di un codice JavaScript che desideri utilizzare per trasformare dinamicamente il contenuto prima di generare un PDF.
Incorpora file multimediali
Seleziona questa opzione per includere nel PDF qualsiasi contenuto audio, video e interattivo.
Usa la compressione completa per ottimizzare le dimensioni delle PDF
Selezionare questa opzione se si desidera comprimere/ridurre le dimensioni di un PDF di grandi dimensioni. Ricordate che la compressione del PDF può ridurre la qualità del file.
Utilizza la compressione delle immagini per ottimizzare le dimensioni delle PDF
Seleziona questa opzione se desideri comprimere/ridurre le dimensioni delle immagini utilizzate nel PDF. La compressione di un'immagine può ridurne la qualità.
Usa risoluzione personalizzata (pixel per pollice)
Si tratta della risoluzione di visualizzazione della pagina in pixel per pollice. Immetti un valore preferito nel campo che viene visualizzato quando questa opzione è selezionata. Il valore predefinito è 96 pixel per pollice. Impostate un valore più alto per adattare più contenuto in pollice e viceversa, se impostate un valore più basso.
Mostra filigrana
Selezionare questa opzione per sovrapporre una filigrana nell'output. È possibile immettere una nuova stringa di testo nella casella di testo con il carattere maiuscolo nel modo desiderato.

Utilizzare variabili di testo statiche o di lingua per pubblicare la versione localizzata della filigrana. A seconda della lingua scelta, il valore localizzato viene selezionato automaticamente nell’output di PDF. Ad esempio, è possibile stampare "Publisher" come filigrana in inglese e "Auteure" in francese. Formato
: ${lng:<variable name>}. Ad esempio, $ {lng:publisher-label} dove publisher-label è una variabile di linguaggio.
al passaggio del mouse icona info {width="25"} vicino all'opzione per visualizzare ulteriori dettagli su di essa.
Abilita equazioni MathML
Seleziona questa opzione per eseguire il rendering delle equazioni MathML presenti nel contenuto. In caso contrario, per impostazione predefinita, le equazioni verranno ignorate.
Scarica file temporanei
Selezionare questa opzione se si desidera scaricare i file di HTML provvisori creati durante la generazione dell'output di PDF nativo. Successivamente puoi scaricare i file temporanei dopo aver generato l’output.
Conformità PDF
È lo standard al quale intendi salvare il PDF per assicurarti che sia conforme. Seleziona dall’elenco a discesa per scegliere dall’elenco degli standard PDF disponibili. Per ulteriori dettagli sugli standard supportati, vedere Informazioni sugli standard PDF.
Proprietà file
Seleziona i metadati da passare alla pubblicazione di PDF nativi. Nel menu a discesa sono elencate sia le proprietà personalizzate che quelle predefinite. Ad esempio, dc:description, dc:language, dc:title e docstate sono le proprietà predefinite, mentre è possibile avere author come proprietà personalizzata. Le proprietà dei metadati selezionate vengono passate al file PDF generato utilizzando Native PDF.
Queste proprietà vengono selezionate dal file metadataList disponibile in:/libs/fmdita/config/metadataList.
Il file può essere sovrapposto in: /apps/fmdita/config/metadataList.

Generare un output PDF generate-pdf-output

Dopo aver configurato il predefinito di output, puoi generare l'output dal pannello Predefiniti utilizzando la funzione Genera predefinito.

  1. Nella scheda Autore selezionare la visualizzazione Archivio.
    Verrà aperto il pannello Archivio.

  2. Nel pannello Archivio aprire il file di mapping DITA in Visualizzazione mappa.

  3. Nella scheda Output, fai clic su Predefiniti per visualizzare il pannello Predefiniti.
    Per creare o configurare un predefinito di output, vedere Creare un predefinito di output PDF.

  4. Per salvare le impostazioni, fare clic sull'icona Salva tutto salva tutto nell'angolo superiore sinistro della barra degli strumenti standard nella visualizzazione Output.

  5. Fai clic sull'icona Genera predefinito Genera predefinito nella barra superiore.
    Potete visualizzare una barra di avanzamento accanto al predefinito di output selezionato nel pannello Predefiniti di output.

  6. Al termine della generazione dell'output, fare clic sull'icona Visualizza output Visualizza output nella barra superiore per visualizzare l'output.
    Una finestra di dialogo Operazione riuscita è visibile nell'angolo inferiore destro dello schermo.
    Se un output non ha esito positivo, viene visualizzato il seguente messaggio di errore.
    registro errori {width="250"}

Per visualizzare il registro degli errori, fai clic su Ignora, passa il puntatore del mouse sulla scheda del predefinito selezionato e fai clic su opzioni Opzioni > Visualizza registro.

Scarica i file temporanei dopo la generazione dell’output di Native PDF

Se si seleziona l'opzione Scarica file temporanei nelle impostazioni avanzate, è possibile scaricare i file HTML provvisori creati durante la generazione dell'output di PDF nativo. Dopo aver generato l'output, puoi scaricare i file temporanei utilizzando l'icona Scarica file temporanei Scarica file temporanei nella barra superiore. Questa funzione consente di visualizzare gli stili e i layout provvisori di HTML e di correggere o modificare gli stili CSS in base alle tue esigenze.

NOTE
L'icona Scarica file temporanei Scarica file temporanei viene visualizzata solo se hai generato l'ultimo output di PDF utilizzando il predefinito in cui hai selezionato l'opzione nella scheda Avanzate.

Utilizzare le variabili di lingua

AEM Guides fornisce anche il supporto per le variabili di lingua. Seleziona Variabili di lingua {width="25"} nel pannello a sinistra per definire una versione localizzata delle etichette predefinite come Nota, Attenzione e Avvertenza o testo statico nell'output di PDF. Per ulteriori dettagli, vedere Supporto per le variabili di lingua.

Supporto per i documenti Markdown

Experience Manager Guides fornisce anche il supporto per i documenti Markdown. I file Markdown sono facili da creare e
offre diverse opzioni di formattazione. Scopri come creare documenti Markdown dall'editor Web.

È possibile aggiungere gli argomenti Markdown alla mappa DITA e generare l'output PDF utilizzando i predefiniti di output di PDF nativi. Scopri come configurare o creare un predefinito di output PDF.

recommendation-more-help
11125c99-e1a1-4369-b5d7-fb3098b9b178