seonghobae · Aug 14, 2026 · Aug 14, 2026 · Aug 14, 2026 · Aug 14, 2026 · Aug 14, 2026
diff --git a/.jules/palette.md b/.jules/palette.md
@@ -69,3 +69,7 @@
 ## 2024-08-16 - 명확한 페이지 컨텍스트를 위한 문서 제목(Title) 개선
 **Learning:** 파일 서버 탐색 시 `<title>` 요소에 단순히 디렉토리 이름만 제공하면, 사용자가 여러 탭을 열어두었거나 화면 판독기를 통해 창을 전환할 때 해당 페이지가 '디렉토리 목록'임을 즉시 인지하기 어려워 접근성 및 사용성이 저하됩니다.
 **Action:** 항상 `<title>` 요소에 페이지의 목적을 명확히 알 수 있는 접미사(예: " - 디렉토리 목록")를 추가하여, 브라우저 탭 이름만으로도 컨텍스트를 제공할 수 있도록 하십시오.
+
+## 2024-08-20 - Bidirectional(BiDi) 텍스트 지원 개선
+**학습:** 아랍어나 히브리어와 같은 Right-To-Left(RTL) 텍스트가 파일/디렉토리 이름에 포함될 경우, 명시적인 방향성(Directionality) 지정이 없으면 Left-To-Right(LTR) 레이아웃 내에서 텍스트가 깨지거나 잘못 렌더링되어 접근성 및 가독성을 크게 저해합니다.
+**조치:** 텍스트를 포함하는 요소(예: `<h1>`, 파일 이름을 감싸는 `<span>`)에 항상 `dir="auto"` 속성을 추가하여, 브라우저가 콘텐츠 자체의 텍스트 방향을 올바르게 감지하고 렌더링할 수 있도록 보장하십시오.
diff --git a/src/main/kotlin/html4tree/main.kt b/src/main/kotlin/html4tree/main.kt
@@ -415,10 +415,10 @@ 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="./.." aria-label="상위 디렉토리로 이동" title="상위 디렉토리로 이동"><span class="icon" aria-hidden="true">&#x21B0;</span> <span>..</span></a></li>
+            <li><a class="dir-link" href="./.." aria-label="상위 디렉토리로 이동" title="상위 디렉토리로 이동"><span class="icon" aria-hidden="true">&#x21B0;</span> <span dir="auto">..</span></a></li>
 """ 
 
     val index_middle = fun():String{ 
@@ -448,7 +448,7 @@ fun process_dir(curr_dir: File, excludeSet: Set<String>? = null, dirFiles: Array
                   val encodedHref = if (isLinkedDirectory) { "./${fileName.urlEncodePath()}/" } else { "./${fileName.urlEncodePath()}" }
                   val ariaLabel = "${fileName} ${if (isLinkedDirectory) { "디렉토리" } else { "파일" }}".escapeHtml()
                   val icon = if (isLinkedDirectory) { "&#128193;" } else { "&#128196;" }
-                  l.append("""          <li><a class="dir-link" href="${encodedHref}" aria-label="${ariaLabel}" title="${ariaLabel}"><span class="icon" aria-hidden="true">${icon}</span> <span>${fileName.escapeHtml()}</span></a></li>""")
+                  l.append("""          <li><a class="dir-link" href="${encodedHref}" aria-label="${ariaLabel}" title="${ariaLabel}"><span class="icon" aria-hidden="true">${icon}</span> <span dir="auto">${fileName.escapeHtml()}</span></a></li>""")
                   l.append('\n')
                }
            }

diff --git a/src/test/kotlin/html4tree/GeneratedIndexReadabilityTest.kt b/src/test/kotlin/html4tree/GeneratedIndexReadabilityTest.kt
@@ -44,7 +44,7 @@ class GeneratedIndexReadabilityTest {
         )
 
         val generatedHtml = generatedHtml()
-        val parentIndex = generatedHtml.indexOf("<span>..</span>")
+        val parentIndex = generatedHtml.indexOf("<span dir=\"auto\">..</span>")
         val firstIndex = generatedHtml.indexOf("alpha.txt")
         val middleIndex = generatedHtml.indexOf("middle.txt")
         val lastIndex = generatedHtml.indexOf("zulu.txt")

diff --git a/src/test/kotlin/html4tree/MainTest.kt b/src/test/kotlin/html4tree/MainTest.kt
@@ -943,7 +943,7 @@ 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>"))
     }
 
 }