Compatibilidad con variables de idioma
AEM Guides proporciona la función para utilizar variables de idioma. Puede utilizar variables de idioma para definir cadenas localizadas en la salida del PDF o para localizar cualquier texto estático en las plantillas de salida. Puede utilizar estilos CSS para localizar las cadenas procedentes de un archivo CSS.
Usar variables de idioma en la salida del PDF
Puede utilizar variables de idioma para definir una versión localizada de las etiquetas integradas, como Nota, Precaución y Advertencia o texto estático en la salida del PDF. El nombre de la variable es el mismo para todos los idiomas, pero puede tener valores diferentes para los distintos idiomas. Puede actualizar el valor de estas variables en uno o más idiomas y, a continuación, el valor localizado se selecciona automáticamente en la salida del PDF.
Por ejemplo, puede tener las siguientes maneras de presentar la etiqueta Note
en la salida del PDF:
-
Inglés: Nota
-
Francés: Remarque
-
Alemán: Hinweis
Una nota de ejemplo en los idiomas inglés, francés y alemán.
en_us
) o bien selecciona el valor inglés(en
) y muestra lo mismo en la salida del PDF.Tipos de variables de idioma
AEM Guides admite dos tipos de variables: variables de aplicación y de usuario.
Variables de la aplicación
AEM Guides proporciona un conjunto de variables de aplicación predefinidas o listas para usar. Puede utilizar estas variables predefinidas para agregar información sobre un documento específico de AEM Guides. Por ejemplo, la variable chapter-number
, si se incluye en una página, muestra el número de capítulo al que pertenece la página. La variable author-label
muestra el nombre del autor del documento.
Variables de usuario
También puede crear nuevas variables de idioma. Por ejemplo, puede crear una variable de usuario Publicador para la etiqueta del publicador del documento.
Agregue y vea las variables de idioma de un idioma seleccionado.
Añadir una nueva variable de idioma
-
En el Editor web, vaya a la pestaña Output.
-
Seleccionar variables de idioma {width="25"} en el panel izquierdo.
-
Seleccione Editar para abrir la ventana Variables de idioma. La aplicación y las variables de usuario presentes en el idioma seleccionado se enumeran en orden alfabético. Los valores se muestran según el idioma seleccionado. Por ejemplo, si selecciona el idioma francés, "Tip" se muestra como "Conseil".
-
En el menú desplegable Idioma, seleccione el idioma en el que desee editar una variable.
note note NOTE Si no ve los idiomas deseados, habilite el idioma deseado en Configuración de la variable de idioma. Seleccionar configuración {width="25"} para abrir el diálogo Configuración de variables de idioma. -
Escriba el nombre de la variable en la columna Nombre y su valor en la columna Valor.
note note NOTE Puede utilizar cualquier contenido de HTML como valor de variable para mostrar el valor de la variable en un formato específico. Por ejemplo, puede agregar la etiqueta <b>
al valor de la variable para mostrar el Publicador en negrita. -
Seleccionar Agregar variable de idioma {width="25"} para agregar una nueva variable de idioma al idioma seleccionado. Al agregar una variable a un idioma, se agrega automáticamente a todos los idiomas. No se puede crear una variable con el mismo nombre que una variable existente. Se muestra un error.
Exportar e importar variables de idioma
Experience Manager Guides proporciona compatibilidad para exportar e importar las variables de idioma presentes en el idioma seleccionado. Puede exportar fácilmente todas las variables de idioma junto con los valores definidos. Esto incluye variables de aplicación y de usuario. Utilice el archivo exportado para realizar los cambios deseados en los valores o localizarlos en otros idiomas.
También puede importar el archivo XML, que contiene las variables de idioma. Experience Manager Guides solo importa las variables de idioma que ya están definidas, incluidas las variables de aplicación y de usuario. No importa ninguna variable que aún no esté definida.
Exportar variables de idioma
Para exportar las variables de idioma de un idioma, selecciona el idioma en la lista desplegable y selecciona Exportar
{width="25"}.
Crea un archivo XML con el formato language_variable_<ln>
, donde <ln>
es el código del idioma seleccionado. Por ejemplo, language_variable_en.xml
para inglés y language_variable_fr.xml
para francés.
Importar variables de idioma
Para importar las variables de idioma:
- Seleccione un idioma en el menú desplegable y seleccione Importar {width="25"}.
- Busque y seleccione el XML, que contiene las variables de idioma. Por ejemplo, language_variable_en.xml.
Puede importar archivos XML en el siguiente formato:
<?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 <img src="/content/dam/assets/images/image_with_text.png" /> </variable>
</variables>
Las variables con el mismo ID se importan una vez importado el archivo. Los valores de las variables del idioma seleccionado se actualizan con los del archivo XML. Se muestra un mensaje sobre el número de variables actualizadas.
- Si el archivo no es un archivo XML o si contiene un formato incorrecto que no se asigna con las variables de idioma, verá un error que indica que hay un problema con el archivo XML. >
- Si el archivo no contiene variables con el mismo ID, verá una advertencia que indica que no se encuentra ninguna variable de idioma coincidente en el archivo importado.
Opciones de una variable de idioma
Pase el ratón sobre la variable para ver el menú Opciones correspondiente.
Use el menú Opciones para eliminar, obtener una vista previa o duplicar una variable de idioma.
Puede obtener una vista previa de las variables aplicación y usuario. Para ver cómo se muestra el valor de la variable en la salida, seleccione Vista previa en el menú Opciones de la variable seleccionada.
También puede elegir Eliminar o Duplicar las variables de usuario. Al eliminar una variable de un idioma, se elimina automáticamente de todos los idiomas.
Editar o revertir las variables de la aplicación
También puede editar los valores de una variable de aplicación. Posteriormente, puede revertir una variable de aplicación al valor original. Revertir variable {width="25"} aparece para una variable de aplicación con un valor modificado.
Usar variables de idioma en las plantillas de salida
Debe agregar variables de idioma en los documentos localizados. Puede insertar estas variables de idioma dentro del diseño de página que aparece en las distintas páginas de los documentos localizados. Por ejemplo, puede agregar la variable de idioma para author-name
que aparece en el área de encabezado del diseño de página (o cualquier otra parte como el pie de página o el cuerpo).
El autor y el nombre de la marca se localizaron en la salida del PDF generada para el idioma francés.
Para insertar una variable de idioma como su copyright-label
en el área de encabezado, realice los siguientes pasos:
-
Abra el diseño de página necesario para editarlo.
note note NOTE Ver la sección Personalizar un diseño de página para abrir un diseño de página y personalizarlo o editarlo. -
Seleccione el encabezado para activarlo e insertar una variable.
-
Seleccionar Insertar variable {width="25"} en la barra de herramientas.
-
En el elemento emergente Insertar variable, seleccione el nombre de la variable de idioma que desea insertar y haga clic en Insertar para insertarla en el área de encabezado.
note note NOTE También puede introducir la cadena de búsqueda en el cuadro de texto. Los nombres de las variables que contienen la cadena dada se filtran y se muestran en la lista.
La variable de idioma seleccionada se inserta en el área de encabezado.
Se agregó el copyright-label
en el área de encabezado.
Aplicar estilo de contenido a variables de idioma
Además del valor que asigna a una variable de idioma, también puede utilizar etiquetas de HTML para mostrar el valor de la variable en un formato específico. Por ejemplo, puede mostrar el valor de publisher-label
en negrita.
-
También puede dar formato a los estilos de los valores mediante la etiqueta . Por ejemplo, con la variable de idioma page-number, puede mostrar el número de página en formato de número romano en inglés y especificar el formato para otros idiomas.
Valor para inglés:
<span data-field="page-number" data-format="upper-roman">1</span>
Valor para tamil:
<span data-field="page-number" data-format="tamil">1</span>
Del mismo modo, puede agregar variables de idioma y dar formato a otros campos enumerados en la función Insertar campos de los diseños de página. Para obtener más información sobre cómo agregar campos, vea Agregar campos y metadatos.
-
También puede agregar imágenes localizadas en los valores. Por ejemplo, se puede añadir un icono de imagen en el lenguaje de número de capítulo y obtener imágenes localizadas del icono en la salida del PDF.
En inglés, el valor de la variable para una imagen puede ser como
<img src="banner-en.jpg">
, y para la misma variable en alemán, puede ser<img src="banner-de.jpg">
. Por lo tanto, recoge las imágenes en función del idioma.
Localice las cadenas mediante estilos CSS
Con los estilos CSS, también puede localizar las cadenas utilizadas en Numeración automática, como Capítulo, Sección, Figura y Tabla. Como estas cadenas provienen de archivos CSS, no puede localizarlas mediante variables de idioma. Para localizar estas cadenas, puede crear estilos CSS para cada idioma en el que desee localizarlas.
Por ejemplo, puede utilizar la siguiente CSS para mostrar el prefijo del capítulo y el formato de número correspondiente en varios idiomas.
Por ejemplo, puede utilizar la siguiente CSS para mostrar el capítulo como Hoofdstuk en alemán y el número de capítulo en formato decimal. Mientras que para japonés, puede utilizar el formato de número japonés para mostrar los números de capítulo en la tabla de contenido.
// 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)".";
}
Las siguientes capturas de pantalla muestran las cadenas localizadas en la salida del PDF alemán y japonés
Dar formato a los prefijos
Con los estilos CSS, también puede dar formato a los prefijos. Por ejemplo, puede dar formato a la etiqueta Note
para que aparezca en color rojo en la salida del PDF en varios idiomas.
.note .prefix-content
{
color: red;
}