From 3f64f2643f349b699517788a8a67753d10eaf89e Mon Sep 17 00:00:00 2001 From: seonghobae <8172694+seonghobae@users.noreply.github.com> Date: Tue, 1 Sep 2026 21:00:21 +0000 Subject: [PATCH 1/4] =?UTF-8?q?=F0=9F=8E=A8=20Palette:=20[UX=20improvement?= =?UTF-8?q?]=20Add=20BiDi=20support=20to=20generated=20HTML?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit This commit adds `dir="auto"` attributes to the `

` and `` elements in the generated directory listings to correctly support bidirectional text (like mixed Arabic/Hebrew and English filenames). --- .jules/palette.md | 4 ++++ src/main/kotlin/html4tree/main.kt | 6 +++--- src/test/kotlin/html4tree/GeneratedIndexReadabilityTest.kt | 2 +- src/test/kotlin/html4tree/MainTest.kt | 2 +- 4 files changed, 9 insertions(+), 5 deletions(-) diff --git a/.jules/palette.md b/.jules/palette.md index 604d7810..1bc613ea 100644 --- a/.jules/palette.md +++ b/.jules/palette.md @@ -73,3 +73,7 @@ ## 2026-08-17 - 브라우저 번역과 화면 판독기의 호환성을 위한 텍스트 처리 **Learning:** `aria-label` 속성으로 지정된 화면 판독기용 대체 텍스트는 Chrome Translate 등 브라우저 번역 도구에 의해 번역되지 않는 경우가 많습니다. 이로 인해 문서 언어가 변환되어도 스크린 리더에서는 원본 언어(예: 영어)로 읽혀 다국어 접근성이 저하됩니다. **Action:** 화면 판독기를 위한 숨겨진 설명 텍스트를 제공할 때 `aria-label` 대신 CSS `.visually-hidden` 클래스를 적용한 `` 요소를 사용하여, 브라우저가 일반 텍스트로 인식하고 번역할 수 있도록 하여 다국어 접근성 호환성을 확보하십시오. + +## 2024-08-20 - HTML 렌더링에서 양방향(BiDi) 텍스트 지원 +**Learning:** 파일 서버가 여러 언어(예: RTL 언어인 아랍어나 히브리어와 LTR 언어의 혼합)로 된 파일이나 디렉토리 이름을 표시할 때 `dir="auto"`가 없으면 레이아웃이 깨지거나 텍스트가 잘못된 방향으로 표시될 수 있습니다. +**Action:** 항상 텍스트가 렌더링되는 요소(`

`, 파일 이름을 감싸는 ``)에 `dir="auto"` 속성을 추가하여 브라우저가 콘텐츠 자체를 기반으로 올바른 텍스트 방향(LTR 또는 RTL)을 동적으로 감지하고 적용하도록 보장하십시오. diff --git a/src/main/kotlin/html4tree/main.kt b/src/main/kotlin/html4tree/main.kt index 0972fa2c..66284007 100644 --- a/src/main/kotlin/html4tree/main.kt +++ b/src/main/kotlin/html4tree/main.kt @@ -426,10 +426,10 @@ fun process_dir(curr_dir: File, excludeSet: Set? = null, dirFiles: Array
-

${directoryName.escapeHtml()}

+

${directoryName.escapeHtml()}