From 22f8362635ae001c60f8e949a637fadcebb7c3d3 Mon Sep 17 00:00:00 2001 From: seonghobae <8172694+seonghobae@users.noreply.github.com> Date: Wed, 2 Sep 2026 21:05:28 +0000 Subject: [PATCH 1/3] Add BiDi support for file and directory names in generated HTML MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit 파일 및 디렉토리 이름이 렌더링되는

및 요소에 `dir="auto"` 속성을 추가하여 아랍어 및 히브리어와 같은 Right-To-Left(RTL) 텍스트가 LTR 레이아웃 내에서도 구두점 및 확장자 위치가 깨지지 않고 올바르게 표시되도록 개선했습니다. --- .jules/palette.md | 4 ++++ src/main/kotlin/html4tree/main.kt | 4 ++-- src/test/kotlin/html4tree/MainTest.kt | 2 +- 3 files changed, 7 insertions(+), 3 deletions(-) diff --git a/.jules/palette.md b/.jules/palette.md index 604d7810..65461bf5 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-10-24 - 파일 및 디렉토리 이름의 양방향 텍스트(BiDi) 지원 개선 +**학습:** 아랍어나 히브리어와 같은 Right-To-Left(RTL) 문자가 포함된 파일 또는 디렉토리 이름이 Left-To-Right(LTR) 레이아웃 내에 렌더링될 때, 텍스트 방향성이 지정되지 않으면 구두점이나 확장자의 위치가 잘못 표시되어 가독성을 심각하게 해칩니다. +**조치:** 파일 이름이나 디렉토리 이름과 같이 사용자 제공 텍스트가 렌더링되는 HTML 요소(`

`, `` 등)에 항상 `dir="auto"` 속성을 추가하여 브라우저가 해당 콘텐츠의 텍스트 방향을 양방향 텍스트(BiDi) 알고리즘에 따라 올바르게 렌더링하도록 보장하십시오. diff --git a/src/main/kotlin/html4tree/main.kt b/src/main/kotlin/html4tree/main.kt index 0972fa2c..11756599 100644 --- a/src/main/kotlin/html4tree/main.kt +++ b/src/main/kotlin/html4tree/main.kt @@ -426,7 +426,7 @@ fun process_dir(curr_dir: File, excludeSet: Set? = null, dirFiles: Array
-

${directoryName.escapeHtml()}

+

${directoryName.escapeHtml()}