Communitygithub.com

rtl-bidi

Lida com texto misto em persa/árabe com inglês, números, telefones, e-mails, URLs, código e moedas em interfaces RTL. Use quando o texto contiver ambos os scripts, quando a saída parecer embaralhada com posicionamento errado de números/ordem, ou para inputs, preços e blocos de código em páginas RTL. Abrange o algoritmo bidi, elementos bdi, CSS unicode-bidi e bugs comuns de embaralhamento.

O que é rtl-bidi?

Este skill aborda os desafios do algoritmo de bidirecionalidade (BiDi) do Unicode ao lidar com conteúdo misto em persa/árabe e inglês em interfaces RTL (direita para esquerda). Ele ensina como e quando intervir usando ferramentas HTML e CSS como `<bdi>`, `dir="ltr"`, `dir="auto"` e `unicode-bidi: plaintext`. O skill cobre casos canônicos como números de telefone, preços em moeda estrangeira, e-mails, URLs, nomes de marcas latinas, blocos de código, identificadores técnicos e conteúdo gerado pelo usuário (chat, comentários, nomes de arquivos). Ele também fornece listas de verificação para depuração de saída embaralhada, uso criterioso de marcas de direção invisíveis (RLM/LRM) e boas práticas para títulos, metadados e payloads de API. É útil para desenvolvedores web que trabalham com sites multilíngues, especialmente aqueles que usam persa, árabe, hebraico ou outros scripts RTL intercalados com conteúdo em inglês ou outros scripts LTR.

Funciona com~Claude Code~Codex CLI~Cursor
npx skills add https://github.com/mhmdsdqi87-cloud/TEKA_raast/tree/HEAD/skills/rtl-bidi

Perguntar na sua IA favorita

Abre um novo chat com esta habilidade de agente já pré-carregada.

Documentação

Bidi: Conteúdo Misto Persa/Inglês

O algoritmo BiDi do Unicode reordena automaticamente o texto de direção mista — às vezes, incorretamente. Este skill ensina quando intervir e exatamente como.

1. O modelo mental

  • A direção base vem de dir no ancestral mais próximo (página: RTL).
  • Sequências de conteúdo forte LTR (letras latinas) são incorporadas e fluem LTR internamente.
  • Caracteres neutros (pontuação, sinais adjacentes a dígitos como + - / $ %) assumem a direção do ambiente ao redor — é aqui que ocorre o embaralhamento.

2. A caixa de ferramentas de intervenção

FerramentaQuandoExemplo
Elemento <bdi>Átomo estrangeiro inline dentro de texto persa, direção desconhecida«فایل report_final.pdf را ببینید»
<span dir="ltr">Átomo conhecido LTR que você também quer alinhado à esquerda internamente<span dir="ltr">+98 912 345 6789</span>
dir="auto"Conteúdo gerado pelo usuário ou imprevisívelbolhas de chat, comentários, nomes de arquivos
CSS unicode-bidi: plaintextMesmo que dir="auto", mas para spans estilizados.user-content { unicode-bidi: plaintext; }
isolate (padrão para bdi)Impede que o átomo reordene vizinhoscomportamento padrão de <bdi>

3. Casos canônicos

Números de telefone

+98 912 em texto persa frequentemente renderiza o + no lado errado.

تلفن پشتیبانی: <span dir="ltr">+98 21 9100 2000</span>

Preços em moeda estrangeira

$99 flutuando em texto RTL se torna 99$:

اشتراک جهانی: <span dir="ltr">$99/mo</span> — اشتراک داخلی: ۹۹٬۰۰۰ تومان

E-mails, URLs, handles

به <bdi>[email protected]</bdi> ایمیل بزنید.
مستندات: <bdi>https://docs.example.co/fa</bdi>

Nomes de marcas latinas no meio da frase

Geralmente funciona como texto simples, mas após um sufixo persa quebra: «نسخه‌ی جدید Node.js» — «Node.js» está seguro; «های Node.js» precisa de <bdi> ao redor da sequência latina se um sufixo se anexar: <bdi>Node.js</bdi>های está errado — reformule para «افزونه‌های Node.js».

Código e comandos — sempre blocos LTR

<pre dir="ltr" style="text-align: left;">npm install raast</pre>

Comandos inline em prosa persa: <code dir="ltr">npx create-next-app</code>.

Listas de itens mistos

Marcadores de item (۱ ۲ ۳) vivem no fluxo RTL; itens LTR longos dentro permanecem isolados por item — coloque <bdi> em qualquer item que comece com letras latinas/dígitos.

Identificadores de produto, seriais e IDs técnicos

A categoria de maior embaralhamento — letras, dígitos e traços misturados:

شماره سریال: <bdi dir="ltr">SN-9F42-KM18</bdi>
کد پیگیری: <bdi dir="ltr">TRK-IR-14050823-0042</bdi>
شناسه محصول: <bdi dir="ltr">SKU 88451-B</bdi>

Regras:

  • Identificadores devem permanecer byte-exatos quando copiados — o isolamento só altera a renderização, nunca a string.
  • Sequências de traço/dígito no final dentro de uma frase RTL serão reordenadas sem <bdi> (ex.: 88451-B → B-88451).
  • Consultas a banco de dados feitas em JS: mantenha a string lógica; não "pré-inverta" para exibição.
  • Fonte monoespaçada de largura fixa + dir="ltr" + text-align: start para colunas de ID em tabelas.

Conteúdo gerado pelo usuário (chat, comentários, nomes de arquivos)

  • Contêiner: dir="auto" + CSS unicode-bidi: plaintext — cada mensagem se orienta pelo seu primeiro caractere forte.
  • Um usuário persa colando texto em inglês, ou vice-versa, deve ler corretamente sem alternar dir manualmente.
  • Nunca imponha a direção da página ao UGC com dir="rtl" + text-align: start sozinho; a regra do primeiro caractere forte é o objetivo de plaintext.
  • Nomes de arquivos/downloads: renderize em <bdi> para que extensões (.pdf, .zip) não se desprendam.

4. Inputs de formulário

  • dir="auto": o input adota a direção do primeiro caractere forte — certo para campos de nome/mensagem.
  • dir="ltr" explícito: e-mail, telefone, nome de usuário, número de cartão, URL, preço (com text-align: end para o cursor começar à direita para usuários RTL... na verdade, mantenha text-align: start no input ltr para sanidade do cursor; teste).

5. Depuração de saída embaralhada — a lista de verificação

  1. O átomo está encapsulado/isolado? (bdi / span dir=ltr)
  2. Caracteres neutros (+ - / . , ( )) estão adjacentes a um limite de direção? Adicione isolamento ou uma marca RLM (\u200F)/LRM (\u200E).
  3. Pontuação final de um átomo LTR pulando para a extremidade errada → inclua o espaço final dentro do isolamento.
  4. String construída em JS? Bidi é uma preocupação de renderização — não reordene no código, corrija o DOM/CSS.
  5. Dump de caracteres invisíveis: cole em um inspetor bidi ou JSON.stringify() o texto para ver a colocação de U+200E/F.

6. RLM/LRM — o bisturi

&rlm; (U+200F) / &lrm; (U+200E) forçam caracteres neutros para um lado quando o isolamento é impossível (ex.: e-mails de texto simples, células CSV):

متن فارسی‎ +98‎  -> mantém o + anexado ao número

Use com moderação — mojibake visível em algumas fontes; prefira isolamento estrutural na web.

7. Títulos, meta e contextos de linha única

  • <title> com scripts mistos: navegadores renderizam bidi em abas razoavelmente, mas comece com o idioma da página: «raast — مهارت‌های RTL» vs «مهارت‌های RTL — raast»: coloque o script forte do idioma da página primeiro.
  • Strings aria-label seguem as mesmas regras; leitores de tela lidam com marcas bidi unicode, então mantenha-as.
  • Payloads JSON/API: sempre armazene a ordem lógica; nunca inverta previamente nada para exibição.

Individual skills in this repo

This repo contains 3 individual skills — each has its own dedicated page.

Habilidades Relacionadas