WordPress e IA: como corrigir o idioma e a direção de um trecho de HTML colado

Identificar que parte da página muda de idioma

Um trecho em árabe é adicionado a uma página em francês sobre uma oficina fictícia. A frase diz que a oficina começa às 10h30. Depois de a colar num bloco HTML personalizado, os caracteres árabes aparecem na página. No entanto, o trecho não tem uma declaração de idioma própria e assume a direção do texto da página. Noutra versão da sugestão, lang="ar" está presente, mas dir="ltr" ainda impõe uma direção da esquerda para a direita. Cada um destes casos exige uma correção diferente.

Comece por ler a página à volta do trecho. O título, a introdução, o menu e as indicações que vêm a seguir estão em francês. O idioma geral é definido na tag html que o WordPress e o tema geram. Mantenha o francês como idioma de referência do documento. No trecho adicionado, indique o idioma real da frase e a direção adequada ao seu sistema de escrita. O idioma descreve o texto. A direção de base determina como o navegador organiza caracteres, números e sinais de pontuação naquele contexto.

Anote o resultado que espera antes de mexer no bloco. A página continua em francês, com texto da esquerda para a direita. A frase deve ser identificável como árabe e fazer parte de um trecho cuja direção de base vai da direita para a esquerda. As duas frases vizinhas em francês devem manter o comportamento inicial. Verifique também o número 10:30 depois de guardar. A correção incide sobre os atributos e o seu alcance. Mantenha a frase e o idioma geral do site.

Guardar uma referência antes de guardar o conteúdo colado

Trabalhe numa cópia de uma publicação ou página. Escreva uma frase de introdução em francês, uma citação sobre o horário e outra frase em francês depois da citação. As duas frases à volta do bloco servem de referência para a comparação. No estado inicial, a citação está em francês. Guarde a revisão ou o conteúdo exato do bloco e abra a cópia como visitante. Anote o texto das três zonas e o idioma indicado na tag principal. Se a página já indicar um idioma incorreto, anote esse problema à parte. Para avaliar a configuração das outras páginas, faça verificações separadas.

Para reproduzir a sugestão sem recorrer a um serviço, substitua a citação em francês pela frase de exemplo em árabe, num bloco HTML personalizado. Guarde uma primeira versão em que a citação não indique idioma nem direção. Prepare uma segunda em que a citação tenha lang="ar" e dir="ltr". Mantenha o mesmo texto árabe nas duas versões. Dessa forma, pode atribuir as diferenças observadas aos atributos, já que as palavras e o número são os mesmos.

Se estiver a trabalhar com uma sugestão real, verifique o texto e a marcação antes de colar. Um trecho de conteúdo deve entrar no corpo da página. Se a sugestão incluir a estrutura de um documento inteiro com html, head ou body, guarde só o trecho necessário. Quando traduz uma página inteira, o idioma principal depende da página apresentada e da sua configuração. Neste procedimento, apenas uma citação muda de idioma. Limite a declaração a essa citação.

Mantenha as versões separadas nas suas notas. O bloco de referência permite voltar rapidamente ao início se um erro ao colar atingir também outra parte do texto. Para localizar o trecho certo depois de guardar, anote as primeiras palavras das frases em francês antes e depois da citação. Também pode guardar um identificador de teste na cópia. Se houver várias citações no conteúdo, anote a posição exata para encontrar a que interessa, mesmo que apareça mais adiante na página.

Distinguir o idioma herdado da direção herdada

No DOM, o idioma declarado num elemento também se aplica aos elementos descendentes que não têm uma declaração própria. Uma citação sem lang pode, por isso, herdar o francês da página mesmo que o texto tenha caracteres árabes. O navegador pode apresentar esses caracteres independentemente do idioma declarado. No primeiro estado do teste, a inspeção mostra que o idioma efetivo é o francês, porque a declaração mais próxima está na página.

Para indicar que o idioma é o árabe, basta usar lang="ar" neste exercício. A direção de base é definida separadamente. No segundo estado, o navegador identifica a citação como árabe e mantém a direção da esquerda para a direita, porque dir="ltr" continua na citação. Anotar os dois valores em separado ajuda a explicar por que motivo uma primeira correção pode parecer completa quando a direção ainda está errada.

A direção determina como o texto é disposto. Uma frase da direita para a esquerda pode conter algarismos, uma hora ou um nome noutro sistema de escrita. Evite inverter manualmente a ordem dos caracteres ou deslocar a pontuação para compensar uma declaração incorreta no elemento que contém o trecho. Corrija primeiro a direção de base e depois releia a frase e a hora na página. O alinhamento à direita define a posição do texto na linha. A direção de leitura é definida à parte.

Escolha o elemento que abrange exatamente o trecho. Para uma citação toda em árabe, use o elemento que contém a citação. Para algumas palavras numa frase em francês, marque apenas a parte relevante. Um nome próprio isolado ou um termo já usado no idioma do texto pode dispensar uma declaração separada. Em caso de dúvida sobre o idioma ou a direção, peça uma revisão do texto antes de escolher os atributos. A declaração deve descrever com precisão o texto que o leitor recebe.

Corrigir o trecho no bloco que o gera

Na cópia, abra o bloco HTML personalizado e procure a citação. Adicione ou corrija lang="ar" e dir="rtl" no elemento que a contém. Mantenha as duas frases em francês fora desse elemento. No trecho abaixo, a frase diz que a oficina começa às 10h30. Os atributos descrevem a citação inteira e também se aplicam ao parágrafo dentro dela.

Limite a correção aos atributos que descrevem o idioma e a direção. Releia o texto antes de guardar para evitar que uma nova colagem altere a hora. Se a sugestão usava uma regra CSS de direção ou de alinhamento, verifique o alcance dessa regra. A marcação HTML é o ponto de partida para a direção de base. Dependendo do tema, uma regra de apresentação ainda pode produzir uma direção calculada diferente. Nesse caso, verifique qual regra se aplica ao trecho.

Se o bloco vier de um modelo ou de um padrão reutilizado, verifique onde o texto está guardado. Alterar a fonte comum pode afetar várias páginas. Este procedimento usa um bloco local de uma única publicação para limitar esse alcance. Se precisar de alterar um elemento comum, localize outra ocorrência da mesma fonte numa cópia do site. Assim, pode confirmar que as páginas sem a citação mantêm o comportamento inicial.

<blockquote lang="ar" dir="rtl">
  <p>تبدأ الورشة عند الساعة 10:30.</p>
</blockquote>

Verificar o DOM da página depois de guardar

Guarde a cópia, feche a pré-visualização anterior e volte a abrir o endereço da publicação. Inspecione a citação no painel Elementos do navegador. Verifique primeiro se a tag html continua a declarar o francês. Depois, confirme se os atributos estão na citação do documento que o navegador apresenta. O seu alcance deve incluir o parágrafo em árabe e terminar antes da frase seguinte. Uma declaração no nível errado pode corrigir a citação e também mudar o comportamento de outro bloco.

Compare o código do bloco com o DOM. Se lang ou dir estava no conteúdo colado, mas falta no DOM, volte a abrir o bloco para ver o que ficou guardado. Se o atributo já tiver desaparecido do bloco, há uma diferença entre o que foi colado e o que foi guardado. Se o bloco tiver conservado o atributo, examine o componente que gera a página e o resultado da análise do HTML pelo navegador. Em ambos os casos, anote a diferença antes de alterar uma definição global ou as permissões da conta.

Nos estilos calculados da citação, procure a propriedade direction. Com o trecho corrigido deste procedimento, o valor é rtl. Na frase seguinte em francês, continua a ser ltr. Se o DOM tiver dir="rtl" mas a direção calculada continuar a ser ltr, procure uma regra aplicada ao elemento ou a um dos seus descendentes. Anote também a declaração de idioma mais próxima de cada parágrafo. O painel de estilos mostra o que o navegador aplica à apresentação. Verifique os atributos em separado para determinar o idioma declarado.

Releia a frase em árabe e o número no seu contexto. O teste compara o texto do DOM com o texto inicial, incluindo 10:30. Esta comparação ajuda a identificar alterações de conteúdo durante a colagem. A posição visual de cada sinal exige outra verificação. Se o trecho usar mais de um sistema de escrita, veja como aparece com os estilos habituais do site e peça a alguém que conheça o idioma para o rever.

Interpretar os resultados e indicar os limites do teste

Na instalação de demonstração do WordPress, a tag principal manteve lang="fr-FR" e uma direção calculada da esquerda para a direita nos cinco estados. Na primeira colagem, sem atributos, a citação herdou o francês da página. Na segunda versão, o Chrome reconheceu lang="ar" e manteve a direção da esquerda para a direita. Depois da correção, a citação tinha os valores esperados e o seu parágrafo herdava esses valores. As duas frases em francês conservaram o idioma, a direção e o texto.

As versões foram guardadas num bloco HTML personalizado com as funções do núcleo do WordPress. Depois, foram inspecionadas no DOM da página carregada. O procedimento confirma que os atributos e o texto se mantêm ao guardar e apresentar a página nesse ambiente. As versões reproduzem possíveis estados depois de colar. Colar a partir da área de transferência no editor visual pode dar resultados diferentes. O teste bloqueia as folhas de estilo do tema e os scripts da página para isolar o efeito dos atributos.

O teste deixou de fora os leitores de tela (ou de ecrã). O atributo lang="ar" fornece uma informação de idioma que as tecnologias de assistência podem usar. A mudança de voz, a pronúncia do texto e a leitura da hora exigem uma verificação própria. Se a validação incluir essa experiência, faça um teste com o leitor e a voz que usa habitualmente. Anote o resultado da leitura em separado do resultado da inspeção do DOM.

Restaurar a referência e guardar a verificação para reutilizar

Para desfazer a alteração na cópia, restaure a revisão que contém o trecho de referência. Se outras partes foram editadas desde então, reponha apenas a citação e os atributos que anotou no início. Volte a abrir a publicação no navegador. Verifique a tag principal, a citação e as duas frases de referência. A restauração pode ficar incompleta se o texto voltar ao estado original, mas um atributo adicionado continuar no elemento que contém a citação.

No teste, a revisão repôs exatamente o conteúdo guardado e o trecho apresentado. A citação voltou a estar em francês e os elementos à volta conservaram o seu comportamento. O resultado seria diferente se a referência já incluísse um trecho válido em árabe. Nesse caso, reponha o texto e os atributos originais desse trecho. Use a referência que guardou para a página em questão.

Ao entregar o trabalho para revisão, indique o endereço da cópia, o trecho em causa e os valores esperados. Acrescente os atributos observados e a direção calculada nas três zonas. Guarde a sugestão tal como foi testada e a versão corrigida. Assim, quem revê pode confirmar que a hora não mudou, que a citação está bem identificada e que o resto da página mantém o idioma e a direção previstos.

Adaptar a verificação a uma expressão dentro de uma frase

O trecho pode ser apenas uma expressão em inglês no meio de um parágrafo em francês. Nesse caso, os dois textos seguem a mesma direção. Marque a expressão com o idioma correspondente e releia as palavras anteriores e posteriores. Se toda a frase em francês herdar o inglês, o atributo está num nível demasiado alto no documento. Verifique também as palavras em redor da expressão, mesmo quando a direção visível da linha não muda.

Se todo o trecho for um parágrafo num sistema de escrita da direita para a esquerda, aplique a direção ao parágrafo ou ao elemento que o contém. A margem à qual o texto se alinha pode continuar a depender do tema. Verifique a direção declarada e a direção calculada antes de mudar esse alinhamento. Se o leitor tiver de reconhecer uma hora ou uma referência, peça uma revisão do resultado final e mantenha o número nas notas.

Nos dois casos, abra o bloco depois de guardar e verifique o ponto exato onde foi colocado o atributo. Se a sugestão adicionar vários trechos, escolha um texto em francês entre dois deles para servir de referência. Assim, pode identificar se um elemento abrange mais do que devia e transmite os seus atributos a tudo o que vem depois. Comece com uma correção isolada. Estenda-a aos outros trechos depois de confirmar o idioma, a direção e o lugar de cada um no DOM.