Supporto per le variabili di lingua

AEM Guides fornisce la funzione per utilizzare le variabili di lingua. È possibile utilizzare le variabili di lingua per definire stringhe localizzate nell'output di PDF o per localizzare qualsiasi testo statico nei modelli di output. È possibile utilizzare gli stili CSS per localizzare le stringhe provenienti da un CSS.

Utilizzare le variabili di lingua nell’output di PDF

È 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. Il nome della variabile è lo stesso per tutte le lingue, ma può avere valori diversi per le varie lingue. Puoi aggiornare il valore di queste variabili in una o più lingue, quindi il valore localizzato viene selezionato automaticamente nell’output di PDF.

Per presentare l'etichetta Note nell'output di PDF, ad esempio, è possibile procedere come segue:

Nota di esempio in inglese, francese e tedesco.

Tipi di variabili di linguaggio

AEM Guides supporta due tipi di variabili: variabili applicazione e variabili utente.

Variabili dell’applicazione

AEM Guides fornisce un set di variabili di applicazione predefinite o pronte all’uso. Puoi utilizzare queste variabili predefinite per aggiungere informazioni su un documento specifico di AEM Guides. Ad esempio, la variabile chapter-number, se inclusa in una pagina, visualizza il numero del capitolo a cui appartiene la pagina. La variabile author-label visualizza il nome dell'autore del documento.

Variabili utente

Puoi anche creare nuove variabili di lingua. È ad esempio possibile creare una variabile utente Publisher per l'etichetta dell'autore del documento.

Aggiungere e visualizzare le variabili di lingua per una lingua selezionata.

Aggiungi una nuova variabile di lingua

Esportare e importare variabili di lingua

Experience Manager Guides fornisce il supporto per esportare e importare le variabili di lingua presenti nella lingua selezionata. Puoi esportare facilmente tutte le variabili di lingua insieme ai valori definiti. Sono incluse sia le variabili dell’applicazione che quelle dell’utente. Utilizza il file esportato per apportare le modifiche desiderate nei valori o per localizzarli in altre lingue.

È inoltre possibile importare il file XML, che contiene le variabili di lingua. Experience Manager Guides importa solo le variabili di lingua già definite, incluse sia le variabili applicazione che quelle utente. Non importa variabili non ancora definite.

Esporta variabili di lingua

Per esportare le variabili di lingua per una lingua, selezionare la lingua dal menu a discesa e selezionare Esporta {width="25"}.
Crea un file XML con formato language_variable_<ln> dove <ln> è il codice della lingua selezionata. language_variable_en.xml per l'inglese e language_variable_fr.xml per il francese.

NOTE

Se nelle variabili di lingua sono presenti modifiche non salvate, non è possibile esportarle. Salva le modifiche per visualizzare l'Esportazione abilitata Icona {width="25"}.

Importa variabili di lingua

Per importare le variabili di lingua:

<?xml version="1.0" encoding="UTF-8"?>
<variables>
<variable id="note-important">Important: </variable>
<variable id="note-caution">Avertir: </variable>
<variable id="image-with-text">Text and image &lt;img src=&quot;/content/dam/assets/images/image_with_text.png&quot; /&gt; </variable>
</variables>

Le variabili con lo stesso ID vengono importate una volta importato il file. I valori delle variabili nella lingua selezionata vengono aggiornati con quelli del file XML. Viene visualizzato un messaggio sul numero di variabili aggiornate.

Opzioni per una variabile di lingua

Passa il puntatore del mouse sulla variabile per visualizzare il relativo menu Opzioni.

Utilizza il menu Opzioni ​per eliminare, visualizzare in anteprima o duplicare una variabile di lingua.

Puoi visualizzare in anteprima sia le variabili dell’applicazione che quelle dell’utente. Per visualizzare la modalità di visualizzazione del valore della variabile nell'output, selezionare Anteprima dal menu Opzioni della variabile selezionata.
Puoi anche scegliere di eliminare o duplicare le variabili utente. Se si elimina una variabile da una lingua, questa viene eliminata automaticamente da tutte le lingue.

Modificare o ripristinare le variabili dell’applicazione

È inoltre possibile modificare i valori di una variabile di applicazione. In seguito, sarà possibile ripristinare il valore originale di una variabile di applicazione. Ripristina variabile {width="25"} viene visualizzato per una variabile di applicazione con un valore modificato.

Utilizzare le variabili di lingua nei modelli di output

È necessario aggiungere variabili di lingua nei documenti localizzati. È possibile inserire queste variabili di lingua all'interno del layout di pagina visualizzato in pagine diverse nei documenti localizzati. È ad esempio possibile aggiungere la variabile di lingua per author-name visualizzata nell'area di intestazione del layout di pagina o in qualsiasi altra parte, ad esempio il piè di pagina o il corpo.

L'autore e il nome del marchio localizzati nell'output PDF generato per la lingua francese.

Per inserire una variabile di lingua come copyright-label nell'area dell'intestazione, effettuare le seguenti operazioni:

Elemento copyright-label aggiunto nell'area dell'intestazione.

Applicare lo stile del contenuto alle variabili di lingua

Oltre al valore assegnato a una variabile di lingua, puoi anche utilizzare i tag HTML per visualizzare il valore della variabile in una formattazione specifica. È ad esempio possibile visualizzare il valore di publisher-label in grassetto.

Analogamente, è possibile aggiungere variabili di lingua e formattare altri campi elencati nella funzione Inserisci campi dei layout di pagina. Per ulteriori dettagli sull'aggiunta di campi, visualizzare Aggiungi campi e metadati.

Localizzare le stringhe utilizzando gli stili CSS

Utilizzando gli stili CSS, puoi anche localizzare le stringhe utilizzate in Numerazione automatica come Capitolo, Sezione, Figura e Tabella. Poiché queste stringhe provengono da file CSS, non è possibile localizzarle utilizzando variabili di linguaggio. Per localizzare queste stringhe, puoi creare stili CSS per ogni lingua in cui desideri localizzarle.
Ad esempio, puoi utilizzare il seguente CSS per visualizzare il prefisso del capitolo e il formato numerico corrispondente in varie lingue.
Ad esempio, puoi utilizzare il seguente CSS per visualizzare il capitolo come Hoofdstuk in tedesco e il numero del capitolo in formato decimale. Mentre per il giapponese, è possibile utilizzare il formato numerico giapponese per visualizzare i numeri dei capitoli nel sommario.

// for English
h1:before {
  counter-increment: h11;
  content: "Chapter " counter(h11, decimal)".";
}

// for German
:root:lang(de) h1:before {
  content: "Hoofdstuk " counter(h11, decimal)".";
}

// for Japanese
:root:lang(ja) h1:before {
  content: "章 " counter(h11, japanese-formal)".";
}

Le schermate seguenti mostrano le stringhe localizzate nell’output PDF in tedesco e giapponese.

Formattare i prefissi

Utilizzando gli stili CSS, puoi anche formattare i prefissi. È possibile, ad esempio, formattare l'etichetta Note in modo che venga visualizzata in rosso nell'output PDF di varie lingue.

.note .prefix-content
{
color: red;
}