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:
-
Inglês: Note
-
Francês: Remarque
-
Alemão: Hinweis
Uma observação de exemplo em inglês, francês e alemão.
en_us) ou então escolherá o valor inglês (en) e exibirá o mesmo na saída do PDF.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
-
No Editor da Web, vá para a guia Saída.
-
Selecionar Variáveis de Idioma
-
Selecione Editar para abrir a janela Variáveis de Idioma. O aplicativo e as variáveis de usuário presentes no idioma selecionado são listados em ordem alfabética. Os valores são exibidos de acordo com o idioma selecionado. Por exemplo, se você selecionar o idioma francês, "Dica" será exibida como "Conseil".
-
Na lista suspensa Idioma, selecione o idioma desejado no qual deseja editar uma variável.
note note NOTE Se você não exibir os idiomas desejados, habilite o idioma desejado nas Configurações de Variável de Idioma. Selecionar configurações 
-
Insira o nome da variável na coluna Nome e seu valor na coluna Valor.
note note NOTE Você pode usar qualquer conteúdo HTML como um valor de variável para exibir o valor da variável em formatação específica. Por exemplo, você pode adicionar a tag <b>ao valor da variável para exibir o Editor em negrito. -
Selecionar Adicionar 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
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.
Importar variáveis de idioma
Para importar as variáveis de idioma:
-
Selecione um idioma na lista suspensa e selecione Importar
.
-
Procure e selecione o XML, que contém as variáveis de idioma. Por exemplo, language_variable_en.xml.
Você pode importar arquivos XML no seguinte 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>
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.
- Se o arquivo não for um arquivo XML ou se contiver um formato incorreto que não mapeie com as variáveis de idioma, você verá um erro de que há um problema com o arquivo XML. >
- Se o arquivo não contiver variáveis com a mesma ID, você verá um aviso de que nenhuma variável de idioma correspondente é encontrada no arquivo importado.
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
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:
-
Abra o layout de página desejado para edição.
note note NOTE Exibir Personalizar uma seção de layout de página para abrir um layout de página para personalização ou edição. -
Selecione o cabeçalho para torná-lo ativo e inserir uma variável.
-
Selecionar Inserir Variável
-
No pop-up Inserir variável, selecione o nome da variável de idioma a ser inserida e clique em Inserir para inseri-la na área de cabeçalho.
note note NOTE Você também pode inserir a string de pesquisa na caixa de texto. Os nomes das variáveis que contêm a cadeia de caracteres fornecida são filtrados e exibidos na lista.
A variável de idioma selecionada é inserida na área de cabeçalho.
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.
-
Também é possível formatar os estilos dos valores usando a tag . Por exemplo, usando a variável de idioma page-number, é possível exibir o número da página no formato de número romano em inglês e especificar o formato para outros idiomas.
Valor para inglês:
<span data-field="page-number" data-format="upper-roman">1</span>Valor para tâmil:
<span data-field="page-number" data-format="tamil">1</span>
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.
-
Também é possível adicionar imagens localizadas nos valores. Por exemplo, você pode adicionar um ícone de imagem na linguagem de número de capítulo e obter imagens localizadas do ícone na saída do PDF.
Para inglês, o valor da variável para uma imagem pode ser como
<img src="banner-en.jpg">, e para a mesma variável em alemão, pode ser<img src="banner-de.jpg">. Então, ele pega as imagens dependendo da linguagem.
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;
}