From 5aa6389b73feedb06e2e70f52a17c8dd336caaa3 Mon Sep 17 00:00:00 2001
From: seonghobae <8172694+seonghobae@users.noreply.github.com>
Date: Mon, 20 Jul 2026 03:39:07 +0000
Subject: [PATCH] =?UTF-8?q?=F0=9F=8E=A8=20Palette:=20=EB=94=94=EB=A0=89?=
=?UTF-8?q?=ED=86=A0=EB=A6=AC=20=EC=9D=B4=EB=A6=84=EC=9D=B4=20=EB=B9=84?=
=?UTF-8?q?=EC=96=B4=EC=9E=88=EC=9D=84=20=EB=95=8C=20=EC=A0=88=EB=8C=80=20?=
=?UTF-8?q?=EA=B2=BD=EB=A1=9C=EB=A5=BC=20=EB=B3=B4=EC=97=AC=EC=A3=BC?=
=?UTF-8?q?=EB=8F=84=EB=A1=9D=20=EC=A0=91=EA=B7=BC=EC=84=B1=20=ED=96=A5?=
=?UTF-8?q?=EC=83=81?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit
---
.jules/palette.md | 3 +++
src/main/kotlin/html4tree/main.kt | 6 ++++--
src/test/kotlin/html4tree/MainTest.kt | 18 ++++++++++++++++++
3 files changed, 25 insertions(+), 2 deletions(-)
diff --git a/.jules/palette.md b/.jules/palette.md
index 9a12c9d..bf8951f 100644
--- a/.jules/palette.md
+++ b/.jules/palette.md
@@ -48,3 +48,6 @@
## 2024-08-01 - 네이티브 브라우저 UI의 다크 모드 지원 강제
**학습:** CSS 미디어 쿼리(`@media (prefers-color-scheme: dark)`)를 통해 다크 모드를 지원하더라도, 브라우저의 네이티브 UI 요소(스크롤바, 기본 폼 컨트롤, 기본 백그라운드 등)는 테마 변경을 인식하지 못해 어두운 테마 환경에서 밝은 스크롤바가 표시되는 등 시각적 불일치를 초래합니다.
**조치:** 항상 HTML 문서의 `
` 영역에 `` 메타 태그를 명시적으로 추가하여 브라우저 수준에서 사용자의 시스템 테마(다크 모드 등)를 완전히 상속받아 일관성 있는 네이티브 UI를 렌더링하도록 보장하십시오.
+## 2026-07-20 - File system root accessibility issue
+**Learning:** When an application dynamically generates HTML titles and headers based on file system paths, the root directory can return an empty string for the file name. This results in empty `` and `
` tags, which severely degrades screen reader accessibility.
+**Action:** Provide a robust fallback, such as the absolute path, when generating semantic HTML tags from user-provided or system-generated identifiers.
diff --git a/src/main/kotlin/html4tree/main.kt b/src/main/kotlin/html4tree/main.kt
index b455862..7af016d 100644
--- a/src/main/kotlin/html4tree/main.kt
+++ b/src/main/kotlin/html4tree/main.kt
@@ -317,6 +317,8 @@ fun process_dir(curr_dir: File, excludeSet: Set? = null, dirFiles: Array
${cssContent}
"""
+ val dirName = if (curr_dir.name.isEmpty()) curr_dir.absolutePath else curr_dir.name
+
val index_top = """
@@ -327,12 +329,12 @@ ${cssContent}
- ${curr_dir.getName().escapeHtml()}
+ ${dirName.escapeHtml()}
${css}
-