Suporte para variáveis de idioma

O AEM Guides fornece o recurso para usar variáveis de idioma. Você pode usar variáveis de idioma para definir strings localizadas na saída de PDF ou para localizar qualquer texto estático nos templates de saída. Você pode usar estilos CSS para localizar as cadeias de caracteres provenientes de um CSS.

Usar variáveis de linguagem na saída do PDF

Você pode usar variáveis de idioma para definir uma versão localizada dos rótulos prontos para uso como Observação, Cuidado e Aviso ou texto estático na saída de PDF. O nome da variável é o mesmo para todos os idiomas, mas pode ter valores diferentes para os vários idiomas. Você pode atualizar o valor dessas variáveis em um ou mais idiomas e, em seguida, o valor localizado é escolhido automaticamente na saída do PDF.

Por exemplo, você pode ter as seguintes maneiras de apresentar o rótulo Note na saída do PDF:

Uma observação de exemplo em inglês, francês e alemão.

Tipos de variáveis de idioma

O AEM Guides oferece suporte a dois tipos de variáveis: Variáveis de aplicativo e de usuário.

Variáveis de aplicativo

O AEM Guides fornece um conjunto de variáveis de aplicativo predefinidas ou prontas para uso. Você pode usar essas variáveis predefinidas para adicionar informações sobre um documento específico do AEM Guides. Por exemplo, a variável chapter-number, se incluída em uma página, exibe o número do capítulo ao qual a página pertence. A variável author-label exibe o nome do autor do documento.

Variáveis do usuário

Você também pode criar novas variáveis de idioma. Por exemplo, você pode criar uma variável de usuário Editor para o rótulo do editor do documento.

Adicione e exiba as variáveis de idioma para um idioma selecionado.

Adicionar uma nova variável de idioma

Exportar e importar variáveis de idioma

O Experience Manager Guides fornece suporte para exportar e importar as variáveis de idioma presentes no idioma selecionado. É possível exportar facilmente todas as variáveis de idioma juntamente com os valores definidos. Isso inclui as variáveis de aplicativo e usuário. Use o arquivo exportado para fazer as alterações desejadas nos valores ou localizá-las em outros idiomas.

Você também pode importar o arquivo XML, que contém as variáveis de idioma. O Experience Manager Guides importa somente as variáveis de idioma já definidas, incluindo as variáveis de aplicativo e usuário. Ela não importa nenhuma variável que ainda não esteja definida.

Exportar variáveis de idioma

Para exportar as variáveis de idioma para um idioma, selecione o idioma na lista suspensa e selecione Exportar {width="25"}.
Ele cria um arquivo XML com o formato language_variable_<ln>, onde <ln> é o código do idioma selecionado. Por exemplo, language_variable_en.xml para inglês e language_variable_fr.xml para francês.

NOTE

Se você tiver alterações não salvas nas variáveis de idioma, não poderá exportá-las. Salve as alterações para exibir a Exportação habilitada Ícone {width="25"}.

Importar variáveis de idioma

Para importar as variáveis de idioma:

<?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>

As variáveis com a mesma ID são importadas após a importação do arquivo. Os valores das variáveis no idioma selecionado são atualizados com aqueles no arquivo XML. Uma mensagem sobre o número de variáveis atualizadas é exibida.

Opções para uma variável de idioma

Passe o mouse sobre a variável para ver o menu Opções para ela.

Use o menu Opções ​para excluir, visualizar ou duplicar uma variável de idioma.

Você pode visualizar as variáveis do aplicativo e do usuário. Para exibir como o valor da variável é exibido na saída, selecione Visualizar no menu Opções da variável selecionada.
Você também pode optar por Excluir ou Duplicar as variáveis de usuário. A exclusão de uma variável de um idioma a exclui automaticamente de todos os idiomas.

Editar ou reverter as variáveis do aplicativo

Também é possível editar os valores de uma variável de aplicativo. Posteriormente, é possível reverter uma variável do aplicativo para o valor original. Reverter variável {width="25"} aparece para uma variável de aplicativo com um valor alterado.

Usar variáveis de idioma nos modelos de saída

Você deve adicionar variáveis de idioma nos documentos localizados. Você pode inserir essas variáveis de idioma no layout de página que aparece em páginas diferentes nos documentos localizados. Por exemplo, você pode adicionar a variável de idioma para o author-name que aparece na área de cabeçalho do layout da página (ou qualquer outra parte, como o rodapé ou o corpo).

O autor e o nome da marca localizados na saída de PDF gerada para o idioma francês.

Para inserir uma variável de idioma como o copyright-label na área de cabeçalho, execute as seguintes etapas:

O copyright-label foi adicionado à área do cabeçalho.

Aplicar estilo de conteúdo a variáveis de idioma

Além do valor atribuído a uma variável de linguagem, também é possível usar tags HTML para exibir o valor da variável em formatação específica. Por exemplo, você pode exibir o valor de publisher-label em negrito.

Da mesma forma, é possível adicionar variáveis de idioma e formatar outros campos listados no recurso Inserir campos dos layouts de página. Para obter mais detalhes sobre como adicionar campos, exiba Adicionar campos e metadados.

Localizar as cadeias de caracteres usando estilos CSS

Usando estilos CSS, você também pode localizar as cadeias de caracteres usadas na Numeração automática, como Capítulo, Seção, Figura e Tabela. Como essas cadeias de caracteres vêm de arquivos CSS, não é possível localizá-las usando variáveis de idioma. Para traduzir essas cadeias de caracteres, você pode criar estilos de CSS para cada idioma em que deseja localizá-las.
Por exemplo, você pode usar o CSS a seguir para exibir o prefixo do capítulo e o formato de número correspondente em vários idiomas.
Por exemplo, você pode usar o CSS a seguir para exibir o Chapter como Hoofdstuk em alemão e o número do capítulo no formato decimal. No caso do japonês, é possível usar o formato de número japonês para mostrar os números de capítulo no índice.

// 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)".";
}

As capturas de tela a seguir exibem as cadeias de caracteres localizadas na saída em PDF alemão e japonês.

Formatar os prefixos

Usando estilos CSS, você também pode formatar os prefixos. Por exemplo, você pode formatar o rótulo Note para aparecer na cor vermelha na saída em PDF de vários idiomas.

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