Communitygithub.com

rtl-bidi

페르시아어/아랍어와 영어 텍스트, 숫자, 전화번호, 이메일, URL, 코드, 통화가 RTL 인터페이스 내에서 혼합될 때 처리합니다. 텍스트에 두 스크립트가 모두 포함되어 있거나, 출력이 잘못된 숫자/순서 배치로 뒤섞여 보일 때, 또는 RTL 페이지의 입력 필드, 가격, 코드 블록에서 사용하세요. 양방향 알고리즘, bdi 요소, unicode-bidi CSS, 일반적인 뒤섞임 버그를 다룹니다.

rtl-bidi란 무엇인가요?

이 스킬은 유니코드 양방향(BiDi) 알고리즘이 혼합된 페르시아어/아랍어-영어 콘텐츠를 처리할 때 발생하는 일반적인 문제를 해결하는 방법을 개발자에게 가르칩니다. 기본 방향(dir), 중립 문자, bdi 요소, unicode-bidi CSS 속성 및 보이지 않는 방향 마크(RLM/LRM)를 포함한 정신 모델과 도구 상자를 설명합니다. 전화번호, 이메일, URL, 가격, 코드 블록, 제품 식별자, 사용자 생성 콘텐츠에 대한 구체적인 예제를 제공하며, 이러한 각 경우를 올바르게 처리하는 HTML 패턴을 보여줍니다. 또한 디버깅 체크리스트와 금융 애플리케이션에서 JS로 문자열을 재정렬하거나 논리적 순서를 변경하지 말아야 하는 중요성과 같은 일반적인 함정에 대해 논의합니다.

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

즐겨 사용하는 AI에게 물어보기

이 에이전트 스킬이 미리 로드된 새 채팅을 엽니다.

문서

Bidi: 혼합 페르시아어/영어 콘텐츠

유니코드 양방향(BiDi) 알고리즘은 혼합 방향 텍스트를 자동으로 재정렬하지만, 때로는 잘못된 방향으로 재정렬하기도 합니다. 이 스킬은 언제 개입해야 하는지와 정확히 어떻게 해야 하는지를 알려줍니다.

1. 정신 모델

  • 기본 방향은 가장 가까운 조상 요소의 dir 속성에서 가져옵니다(페이지: RTL).
  • 강한 LTR 콘텐츠(라틴 문자)의 실행은 내장되어 LTR 방향으로 흐릅니다.
  • 중립 문자(구두점, 숫자 인접 기호: + - / $ %)는 주변의 방향을 따릅니다. 이것이 뒤섞임이 발생하는 지점입니다.

2. 개입 도구 상자

도구사용 시기예시
<bdi> 요소페르시아어 텍스트 내 방향을 알 수 없는 인라인 외래 단어«فایل report_final.pdf را ببینید»
<span dir="ltr">내부적으로 왼쪽 정렬하려는 알려진 LTR 요소<span dir="ltr">+98 912 345 6789</span>
dir="auto"사용자 생성 또는 예측할 수 없는 콘텐츠채팅 버블, 댓글, 파일 이름
CSS unicode-bidi: plaintext스타일이 적용된 span에서 dir="auto"와 동일.user-content { unicode-bidi: plaintext; }
isolate (bdi의 기본값)요소가 인접 요소를 재정렬하지 못하도록 방지<bdi>의 기본 동작

3. 표준 사례

전화번호

페르시아어 텍스트에서 +98 912는 종종 +가 잘못된 쪽에 렌더링됩니다.

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

외화 가격

RTL 텍스트에 있는 $99는 99$로 표시됩니다:

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

이메일, URL, 핸들

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

문장 중간의 라틴 브랜드 이름

일반적으로 일반 텍스트로 괜찮지만, 페르시아어 접미사 뒤에는 문제가 발생합니다: «نسخه‌ی جدید Node.js» — «Node.js»는 안전함; «های Node.js»는 라틴 실행 부분이 접미사와 결합되면 <bdi>가 필요함: <bdi>Node.js</bdi>های는 잘못됨 — «افزونه‌های Node.js»로 다시 표현하세요.

코드 및 명령 — 항상 LTR 블록

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

페르시아어 문장의 인라인 명령: <code dir="ltr">npx create-next-app</code>.

혼합 항목 목록

항목 마커(۱ ۲ ۳)는 RTL 흐름에 속하며, 긴 LTR 항목 내부는 항목별로 분리된 상태를 유지합니다 — 라틴 문자/숫자로 시작하는 항목에는 <bdi>를 넣으세요.

제품 식별자, 시리얼 번호 및 기술 ID

가장 많이 뒤섞이는 범주 — 문자, 숫자, 대시가 혼합됨:

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

규칙:

  • 식별자는 복사 시 바이트 정확해야 합니다 — 격리(Isolation)는 렌더링만 변경하고 문자열 자체는 변경하지 않습니다.
  • RTL 문장 내에서 후행 대시/숫자 실행은 <bdi> 없이 재정렬됩니다(예: 88451-B → B-88451).
  • JS로 구축된 데이터베이스 조회: 논리 문자열을 유지하고, 표시를 위해 "미리 뒤집지" 마십시오.
  • 테이블의 ID 열에는 고정 폭 모노 폰트 + dir="ltr" + text-align: start를 사용하십시오.

사용자 생성 콘텐츠(채팅, 댓글, 파일 이름)

  • 컨테이너: dir="auto" + CSS unicode-bidi: plaintext — 각 메시지는 첫 번째 강한 문자로 방향을 정합니다.
  • 페르시아어 사용자가 영어 텍스트를 붙여넣거나 그 반대의 경우에도 수동으로 dir을 전환하지 않고 올바르게 읽혀야 합니다.
  • dir="rtl" + text-align: start만으로 페이지 방향을 UGC에 강제하지 마십시오. 첫 번째 강한 문자 규칙이 plaintext의 핵심입니다.
  • 파일 이름/다운로드: <bdi>로 렌더링하여 확장자(.pdf, .zip)가 분리되지 않도록 합니다.

4. 양식 입력

  • dir="auto": 입력 필드는 첫 번째 강한 문자의 방향을 채택합니다 — 이름/메시지 필드에 적합.
  • 명시적 dir="ltr": 이메일, 전화, 사용자 이름, 카드 번호, URL, 가격(text-align: end와 함께 사용하면 RTL 사용자의 커서 시작 위치가 오른쪽이 됨... 그러나 실제로는 ltr 입력 필드에서 커서 편의를 위해 text-align: start를 유지하세요. 테스트 필요).

5. 뒤섞인 출력 디버깅 — 체크리스트

  1. 요소가 래핑/격리되었습니까? (bdi / span dir=ltr)
  2. 중립 문자(+ - / . , ( ))가 방향 경계에 인접해 있습니까? 격리 또는 RLM(\u200F)/LRM(\u200E) 마크를 추가하십시오.
  3. LTR 요소의 후행 구두점이 잘못된 끝으로 이동합니까? → 격리 내부에 후행 공백을 포함시키십시오.
  4. JS로 문자열을 구성했습니까? 양방향은 렌더링 문제입니다 — 코드에서 재정렬하지 말고 DOM/CSS를 수정하십시오.
  5. 보이지 않는 문자 덤프: 양방향 검사기나 JSON.stringify()로 텍스트를 붙여넣어 U+200E/F 배치를 확인하십시오.

6. RLM/LRM — 메스

&rlm; (U+200F) / &lrm; (U+200E)는 격리가 불가능할 때(예: 일반 텍스트 이메일, CSV 셀) 중립 문자를 한쪽으로 강제합니다:

متن فارسی‎ +98‎  -> 번호에 +를 붙여 유지

드물게 사용하십시오 — 일부 폰트에서 보이는 모지바케(mojibake)가 발생할 수 있습니다. 웹에서는 구조적 격리를 선호하십시오.

7. 제목, 메타 및 한 줄 컨텍스트

  • 혼합 스크립트가 있는 <title>: 브라우저는 탭에서 양방향을 합리적으로 렌더링하지만, 페이지 언어로 시작하십시오: «raast — مهارت‌های RTL» 대신 «مهارت‌های RTL — raast»: 페이지 언어의 강한 스크립트를 먼저 넣으십시오.
  • aria-label 문자열도 동일한 규칙을 따릅니다. 화면 읽기 프로그램이 유니코드 양방향 마크를 처리하므로 유지하십시오.
  • JSON/API 페이로드: 항상 논리적 순서를 저장하십시오. 표시를 위해 미리 뒤집지 마십시오.

Individual skills in this repo

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

관련 스킬