HTML
Traduza texto e atributos HTML, mantendo intacto o restante código-fonte e definindo o idioma de destino como idioma do documento.
O HTML organiza texto legível numa estrutura que também contém ligações, comportamentos e informações de acessibilidade. O processador html seleciona os segmentos de texto e os atributos descritivos suportados e insere as respetivas traduções no código-fonte original para um único idioma de destino. Não divide uma página multilingue em regiões separadas por idioma.
Preservar a estrutura do documento de entrada #
Os documentos mantêm a declaração doctype original e os elementos explícitos. Os fragmentos continuam a ser fragmentos: a tradução não acrescenta elementos envolventes <html>, <head> ou <body>. Os comentários, os atributos não alterados, os tipos de aspas e os espaços em branco fora dos segmentos traduzidos mantêm-se tal como estão no código-fonte.
Se existir um elemento <html> explícito, o valor do respetivo atributo lang é substituído pelo idioma de destino. Se não tiver esse atributo, é-lhe acrescentado um atributo lang. Por exemplo, <html lang="en"> passa a <html lang="fr"> para francês. Um fragmento sem um elemento <html> explícito não recebe esse elemento apenas para indicar o idioma.
Por exemplo, este fragmento contém texto visível e texto de acessibilidade:
<section>
<h2>Delivery options</h2>
<p>Read the <a href="/delivery">delivery policy</a>.</p>
<img src="/truck.svg" alt="Delivery truck" />
<input placeholder="Enter your address" aria-label="Delivery address" />
</section>O título, o parágrafo, o rótulo da ligação, o texto alternativo da imagem, o texto de exemplo do campo de entrada e o rótulo ARIA são elementos de texto suportados. O destino da ligação e a origem da imagem continuam a ser propriedades estruturais. Traduzir este fragmento não cria ligações localizadas nem substitui os recursos de imagem.
Seleção de atributos e regiões #
Os atributos suportados por predefinição incluem alt e title em imagens, placeholder e title em campos de entrada e áreas de texto, determinados atributos title, o atributo content de metadados e atributos de rótulo ARIA. Reveja os metadados com atenção: selecionar um atributo pelo nome não garante que todos os seus valores sejam texto em linguagem natural. As regras configuradas para propriedades de componentes permitem acrescentar atributos para elementos com nomes específicos.
O conteúdo de scripts, estilos, código pré-formatado, código, expressões matemáticas, modelos, noscript e áreas de texto fica de fora da extração normal de texto. Um elemento ignorado pode, ainda assim, ter um atributo descritivo suportado. No SVG, a seleção é específica para o conteúdo suportado de title, desc e text, em vez de se traduzirem dados de desenho arbitrários.
A marcação em linha e os tokens {{...}} são protegidos por marcadores de posição durante a tradução do texto. A reconstrução repõe-nos nos segmentos traduzidos. Verifique a estrutura dos elementos no resultado e renderize as respetivas variáveis com valores representativos da aplicação.
Reutilização e preservação do código-fonte no resultado #
Para permitir a reutilização, o original e a tradução anteriores têm de apresentar texto e estruturas de marcadores de posição correspondentes. O processador verifica o alinhamento entre ambos e pode rejeitar um par ambíguo. Mantenha a tradução aceite associada à respetiva revisão do original, em vez de comparar páginas renderizadas sem relação entre si.
Apenas os segmentos traduzidos e o atributo de idioma do elemento <html> explícito são alterados; o restante código-fonte é copiado diretamente para o resultado. O processador não elimina conteúdo potencialmente perigoso de HTML não fidedigno. Mantenha as verificações de segurança e de renderização da própria aplicação.
Se um aninhamento incorreto levar o analisador a combinar texto de elementos de marcação sem relação entre si, o processador rejeita o documento em vez de produzir uma tradução ambígua. Corrija o aninhamento e tente novamente. Quando a omissão de etiquetas HTML é válida, não é necessário acrescentar uma estrutura de documento.
Configurar ficheiros HTML na CLI ou na GitHub App #
A CLI e a GitHub App inferem html a partir de .html e .htm. Selecione os ficheiros de origem em .lingo/config.json, mantendo os ficheiros de destino gerados fora dos padrões de seleção dos ficheiros de origem:
{
"sourceLocale": "en",
"targetLocales": ["fr"],
"files": [
{ "pattern": "pages/en/**/*.html", "format": "html" },
{ "pattern": "pages/en/**/*.htm", "format": "html" }
]
}A indicação explícita de format é opcional para estas extensões. Associe o projeto à sua organização e ao motor de localização através da configuração da CLI ou indique o motor para a GitHub App. Cada destino corresponde a um ficheiro de idioma separado, como pages/fr/index.html. O HTML não suporta tradução ao nível de chaves.
Depois de obter o resultado, renderize o documento ou fragmento na aplicação que o utiliza. Compare as ligações e os atributos não textuais e reveja o texto de acessibilidade em conjunto com o texto visível. Se o HTML for fornecido por um CMS, siga as instruções desse conector para selecionar campos e gravar os resultados; os conectores podem aceitar entradas diferentes, mesmo quando o processamento de HTML faz parte da sua implementação.