ContextualWisdomLab · seonghobae · Sep 3, 2026 · Sep 3, 2026
diff --git a/.jules/palette.md b/.jules/palette.md
@@ -73,3 +73,6 @@
 ## 2026-08-17 - 브라우저 번역과 화면 판독기의 호환성을 위한 텍스트 처리
 **Learning:** `aria-label` 속성으로 지정된 화면 판독기용 대체 텍스트는 Chrome Translate 등 브라우저 번역 도구에 의해 번역되지 않는 경우가 많습니다. 이로 인해 문서 언어가 변환되어도 스크린 리더에서는 원본 언어(예: 영어)로 읽혀 다국어 접근성이 저하됩니다.
 **Action:** 화면 판독기를 위한 숨겨진 설명 텍스트를 제공할 때 `aria-label` 대신 CSS `.visually-hidden` 클래스를 적용한 `<span>` 요소를 사용하여, 브라우저가 일반 텍스트로 인식하고 번역할 수 있도록 하여 다국어 접근성 호환성을 확보하십시오.
+## 2024-08-20 - RTL 문자열이 포함된 파일명을 위한 양방향(BiDi) 텍스트 지원
+**Learning:** 파일 서버는 다국어 파일 및 폴더명을 지원해야 하며, 오른쪽에서 왼쪽으로 쓰는(Right-To-Left) 문자가 포함된 이름의 경우 시맨틱상 기본 방향성을 콘텐츠에 맞게 설정하는 것이 바람직합니다.
+**Action:** 폴더나 파일명 등 사용자 생성 텍스트가 표시되는 구체적인 텍스트 노드(`<h1>` 및 파일명을 감싸는 `<span>` 태그)에 `dir="auto"` 속성을 명시하여 텍스트 내용에 맞게 방향성이 처리되도록 마크업을 개선하십시오. (고정된 UI 텍스트 제외)
diff --git 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<String>? = null, dirFiles: Array
      </head>
      <body>
        <main>
-         <h1>${directoryName.escapeHtml()}</h1>
+         <h1 dir="auto">${directoryName.escapeHtml()}</h1>
          <nav aria-label="디렉토리 목록">
          <ul role="list">
             <li><a class="dir-link" href="./.." title="상위 디렉토리로 이동"><span class="icon" aria-hidden="true">&#x21B0;</span> <span aria-hidden="true">..</span> <span class="visually-hidden">상위 디렉토리로 이동</span></a></li>
@@ -460,14 +460,14 @@ fun process_dir(curr_dir: File, excludeSet: Set<String>? = null, dirFiles: Array
                   val ariaLabel = "${fileName} ${if (isLinkedDirectory) { "디렉토리" } else { "파일" }}".escapeHtml()
                   val typeLabel = if (isLinkedDirectory) { "디렉토리" } else { "파일" }
                   val icon = if (isLinkedDirectory) { "&#128193;" } else { "&#128196;" }
-                  l.append("""          <li><a class="dir-link" href="${encodedHref}" title="${ariaLabel}"><span class="icon" aria-hidden="true">${icon}</span> <span>${fileName.escapeHtml()}</span> <span class="visually-hidden">${typeLabel}</span></a></li>""")
+                  l.append("""          <li><a class="dir-link" href="${encodedHref}" title="${ariaLabel}"><span class="icon" aria-hidden="true">${icon}</span> <span dir="auto">${fileName.escapeHtml()}</span> <span class="visually-hidden">${typeLabel}</span></a></li>""")
                   l.append('\n')
                }
            }
         }
 
         if(l.isEmpty()){
-            l.append("""          <li><div class="empty-dir" role="status"><span class="icon" aria-hidden="true">&#128194;</span> <span>이 디렉토리는 비어 있습니다.</span></div></li>""")
+            l.append("""          <li><div class="empty-dir"><span class="icon" aria-hidden="true">&#128194;</span> <span>이 디렉토리는 비어 있습니다.</span></div></li>""")
             l.append('\n')
         }
 

diff --git a/src/test/kotlin/html4tree/GeneratedIndexReadabilityTest.kt b/src/test/kotlin/html4tree/GeneratedIndexReadabilityTest.kt
@@ -62,7 +62,7 @@ class GeneratedIndexReadabilityTest {
 
         val generatedHtml = generatedHtml()
         val expectedEmptyRow =
-            """<li><div class="empty-dir" role="status"><span class="icon" aria-hidden="true">&#128194;</span> <span>이 디렉토리는 비어 있습니다.</span></div></li>"""
+            """<li><div class="empty-dir"><span class="icon" aria-hidden="true">&#128194;</span> <span>이 디렉토리는 비어 있습니다.</span></div></li>"""
 
         assertTrue(generatedHtml.contains(expectedEmptyRow))
         assertTrue(generatedHtml.indexOf(expectedEmptyRow) == generatedHtml.lastIndexOf(expectedEmptyRow))

diff --git a/src/test/kotlin/html4tree/MainTest.kt b/src/test/kotlin/html4tree/MainTest.kt
@@ -115,7 +115,6 @@ class MainTest {
         assertTrue(htmlContent.contains("<html lang=\"ko\">"))
         assertRobotsDirective(htmlContent)
         assertTrue(htmlContent.contains("이 디렉토리는 비어 있습니다."))
-        assertTrue(htmlContent.contains("role=\"status\""))
         assertTrue(htmlContent.contains("role=\"list\""))
         assertTrue(htmlContent.contains("&#128194;"))
     }
@@ -943,7 +942,24 @@ class MainTest {
         assertTrue(indexHtml.exists())
         val content = indexHtml.readText()
         assertTrue(content.contains("<title>Root - 디렉토리 목록</title>"))
-        assertTrue(content.contains("<h1>Root</h1>"))
+        assertTrue(content.contains("<h1 dir=\"auto\">Root</h1>"))
+    }
+
+
+    @Test
+    fun testBiDiDirectoryAndFileNames() {
+        val dirName = "מבחן_RTL_Dir"
+        val fileName = "ملف_RTL.txt"
+        val bidiDir = File(tempDir, dirName)
+        bidiDir.mkdir()
+        File(bidiDir, fileName).createNewFile()
+        process_dir(bidiDir, setOf(), arrayOf(File(bidiDir, fileName)))
+        val indexHtml = File(bidiDir, "index.html")
+        assertTrue(indexHtml.exists())
+        val content = indexHtml.readText()
+        assertTrue(content.contains("<h1 dir=\"auto\">מבחן_RTL_Dir</h1>"))
+        assertTrue(content.contains("<span dir=\"auto\">ملف_RTL.txt</span>"))
+        assertTrue(content.contains("<span aria-hidden=\"true\">..</span>"))
     }
 
 }