Pubblicazione di un documento tramite XSL

È possibile utilizzare i fogli di stile XSL per la pubblicazione di documenti. I fogli di stile XSL applicano trasformazioni strutturali e la formattazione ai documenti XML. Il formato delle immagini contenute in un documento non viene modificato nell'output. Il formato originale del file di grafica viene conservato e referenziato nell'output.

Nell'output HTML, le equazioni con input TeX vengono visualizzate come caselle vuote.

I fogli di stile XSL devono essere memorizzati nella cartella di installazione di Arbortext Editor o nelle cartelle APTCUSTOM o APTAPPLICATION.

1. Scegliere File > Pubblica > Utilizza XSL. Viene visualizzata la Finestra di dialogo Pubblica tramite XSL.

2. Nella casella Salva con nome, specificare il nome file e il percorso oppure accettare le impostazioni di default. Fare clic su Sfoglia per individuare un file esistente.

Se viene selezionato Inserisci in coda transazione, Salva con nome non è disponibile.

3. Nell'elenco Foglio di stile, scegliere il foglio di stile da utilizzare per la pubblicazione del documento. Fare clic su Sfoglia per individuare un foglio di stile esistente non visualizzato nell'elenco.

Se in precedenza è stata eseguita una pubblicazione con un foglio di stile che include o importa un foglio di stile XSL modificato, per applicare le modifiche è necessario eliminare tale foglio di stile dalla cache. A questo scopo, nella riga di comando di Arbortext Editor digitare:

clear_stylesheets()

In caso di Utilizzo di Arbortext Publishing Engine per la pubblicazione di documenti, nell'elenco vengono visualizzati i fogli di stile disponibili in Server Arbortext PE. La notazione (pe) precede il nome del foglio di stile. I fogli di stile locali vengono ignorati.

4. Se si sta pubblicando un documento DITA a cui è associato un file DITAVAL, scegliere il file nell'elenco File DITAVAL. Fare clic su Sfoglia per individuare un file DITAVAL esistente non visualizzato nell'elenco.

5. Se nel documento è attivata la traccia delle revisioni, sarà possibile pubblicare il documento in uno qualsiasi degli stati di traccia delle revisioni. Per default è selezionata la visualizzazione della traccia delle revisioni nella finestra Modifica, eccetto quando si esegue la pubblicazione da una mappa DITA.

Se si sta pubblicando una mappa DITA, l'opzione Modifiche applicate è selezionata per default. Durante la pubblicazione da una mappa DITA, la visualizzazione Traccia delle revisioni selezionata si applica solo agli argomenti referenziati dalle mappe DITA. La mappa DITA e le altre mappe referenziate vengono sempre pubblicate con Modifiche applicate, indipendentemente dalla visualizzazione Traccia delle revisioni selezionata (anche se una mappa include il markup della traccia delle revisioni).

Le scelte disponibili sono:

◦ Modifiche con evidenziazione - Mostra tutte le modifiche proposte, evidenziate da segni di revisione.

◦ Modifiche applicate - Mostra tutte le modifiche proposte incorporate nel documento, senza segni di revisione.

◦ Originale - Mostra il documento originale senza le modifiche proposte incorporate nel documento.

6. Scegliere se eseguire o meno l'inserimento in Inserisci in coda transazione. Se è selezionato, cancella il valore Salva con nome. La selezione di questa casella indica che verrà eseguita una richiesta per il nome file Salva con nome nel momento in cui viene recuperato il risultato dall'elenco Transazioni in coda, disponibile nel menu Strumenti

Se è stato immesso un valore in Salva con nome, verrà nuovamente visualizzato se si seleziona la casella di controllo Inserisci in coda transazione. Il comportamento di Inserisci in coda transazione è controllato da un insieme di preferenze di Arbortext Publishing Engine.

7. Scegliere se immettere un Nome transazione. Il nome della transazione verrà visualizzato nel momento in cui viene recuperato il risultato dall'elenco Transazioni in coda, disponibile nel menu Strumenti.

È possibile immettere nomi di transazione da utilizzare per default o per tipi specifici di output specificando i valori nella Finestra di dialogo Nomi transazioni in coda.

8. Se si desidera applicare la creazione profili al documento, fare clic su Imposta profili per accedere alla finestra di dialogo corrispondente. Fare clic su OK o su Annulla per uscire dalla finestra di dialogo Imposta profili. Il pulsante Imposta profili è disponibile solo se sono stati configurati profili per il tipo di documento selezionato.

9. Per creare una regola di pubblicazione, fare clic su Crea regola per aprire Crea nuova regola di pubblicazione, in cui è possibile creare una nuova regola o un insieme di regole di pubblicazione.

10. Fare clic su OK per iniziare la pubblicazione. Nella barra delle applicazioni un messaggio indica l'avanzamento o il completamento della pubblicazione.