Este documento explica o que a configuração “suportar direção de texto mista” faz no Discourse, como funciona e como impacta a composição de posts.
Nível de usuário necessário: Administrador
A configuração “suportar direção de texto mista” é crucial para sites que apresentam idiomas tanto da esquerda para a direita (LTR) quanto da direita para a esquerda (RTL). Ativar essa configuração garante que o Discourse ajuste automaticamente a direção do texto para vários elementos, como conteúdo de posts, títulos de tópicos, nomes de categorias e a área de visualização do editor, com base no idioma detectado. Além disso, define a direção do texto para campos de entrada de acordo com o idioma de entrada do usuário. Desde que o conteúdo seja separado por uma nova linha, é possível ter texto misto dentro de um único post.
Resumo
Esta documentação abordará:
- Como a configuração “suportar direção de texto mista” funciona
- Seu impacto na exibição de conteúdo
- Como ela afeta a composição de posts
- Melhores práticas e problemas comuns
Como funciona
A configuração suportar direção de texto mista afeta apenas a exibição do conteúdo no navegador. Ela não altera o conteúdo armazenado no banco de dados. Quando ativada, o Discourse adiciona o atributo dir="auto" a elementos HTML, como parágrafos de posts, títulos de tópicos, nomes de categorias e campos de entrada de texto. O navegador então determina e aplica automaticamente a direção correta do texto com base no conteúdo de cada elemento.
Compondo um post
Ao compor um post, os campos de entrada detectam automaticamente a direção do texto sendo digitado, graças ao atributo dir="auto". Para auxiliar nas necessidades de direção de texto mista, a configuração também introduz um botão Alternar Direção na barra de ferramentas do editor. Clicar nesse botão alterna a direção de toda a área de texto.
Na área de visualização do editor, o texto será exibido com a direção correta, independentemente da direção atual da área de texto.
Melhores práticas
- Ative essa configuração se sua comunidade usar frequentemente idiomas LTR e RTL.
- Use o botão Alternar Direção para ajustar a direção do texto ao compor posts, garantindo a legibilidade.
- Informe os usuários sobre o botão Alternar Direção para melhor usabilidade em posts com idiomas mistos.
Problemas comuns e soluções
- Alinhamento de texto não aparecendo corretamente: Certifique-se de que a configuração está ativada. O
dir="auto"do navegador determina a direção com base no primeiro caractere direcional forte em cada elemento. - Direção do texto citado: Os títulos de citações sempre seguem a direção do idioma do site, enquanto os parágrafos citados usam
dir="auto"para detecção automática.
Perguntas frequentes (FAQs)
P: O que acontece se a configuração estiver desativada?
R: A direção do texto não será ajustada automaticamente com base no idioma, o que pode causar problemas de legibilidade em posts com idiomas mistos.
P: Isso altera o conteúdo real no banco de dados?
R: Não, afeta apenas como o conteúdo é exibido no navegador.
P: Posso definir manualmente a direção do texto sem essa configuração?
R: Sim, mas ativar essa configuração simplifica o processo e garante consistência em todo o site.