From d39eb72b64f9c6743af259c1141a5be751c15441 Mon Sep 17 00:00:00 2001
From: seonghobae <8172694+seonghobae@users.noreply.github.com>
Date: Mon, 29 Jun 2026 21:28:39 +0000
Subject: [PATCH] =?UTF-8?q?=EC=A0=91=EA=B7=BC=EC=84=B1:=20=EC=9D=B8?=
 =?UTF-8?q?=EB=8D=B1=EC=8A=A4=20html=EC=97=90=20main=20=ED=83=9C=EA=B7=B8?=
 =?UTF-8?q?=20=EC=B6=94=EA=B0=80=20=EB=B0=8F=20=EC=9D=B4=EB=AA=A8=EC=A7=80?=
 =?UTF-8?q?=20aria-hidden=20=EC=86=8D=EC=84=B1=20=EC=A0=81=EC=9A=A9?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

- `index.html` 생성 시 스크린 리더 환경 개선
- 페이지 콘텐츠를 `<main>` 태그로 래핑
- 장식용 이모지(폴더/파일 아이콘)에 `<span aria-hidden="true">` 추가
- 100% 테스트 커버리지를 위한 관련 테스트 코드 갱신
- `.jules/palette.md`에 배운 점(learning) 추가
- Java 최신 버전 호환을 위한 gradle 및 dependencies 버전 업그레이드
---
 .jules/palette.md                        |  4 ++++
 CHANGELOG.md                             |  5 +++++
 build.gradle                             | 26 +++++++++++++-----------
 gradle/wrapper/gradle-wrapper.properties |  2 +-
 src/main/kotlin/html4tree/main.kt        |  6 ++++--
 src/test/kotlin/html4tree/MainTest.kt    |  4 ++++
 6 files changed, 32 insertions(+), 15 deletions(-)
 create mode 100644 .jules/palette.md
 create mode 100644 CHANGELOG.md

diff --git a/.jules/palette.md b/.jules/palette.md
new file mode 100644
index 00000000..d138494b
--- /dev/null
+++ b/.jules/palette.md
@@ -0,0 +1,4 @@
+
+## 2024-06-29 - 장식용 파일/폴더 아이콘에 대한 aria-hidden 적용
+**배운 점:** 디렉토리 구조를 표현하는 HTML에서 장식용으로 사용되는 이모지(파일 또는 폴더 아이콘)는 스크린 리더 환경에서 사용자를 혼란스럽게 할 수 있습니다 (예: 불필요한 이모지 이름 읽기).
+**액션 아이템:** 시각적인 요소로만 의미를 갖는 이모지나 특수 문자는 항상 `<span aria-hidden="true">`로 감싸서, 시각 장애가 없는 사용자의 시각적 정보는 유지하면서 스크린 리더 사용자에게는 보다 깔끔한 오디오 경험을 제공하도록 해야 합니다.
diff --git a/CHANGELOG.md b/CHANGELOG.md
new file mode 100644
index 00000000..14b8e968
--- /dev/null
+++ b/CHANGELOG.md
@@ -0,0 +1,5 @@
+# 변경 사항
+
+## [Unreleased]
+### 추가됨
+- `index.html` 생성 시 스크린 리더 사용자를 위한 접근성 개선을 적용했습니다. 주요 콘텐츠 영역을 `<main>` 태그로 감쌌으며, 시각적인 장식 역할을 하는 파일/폴더 아이콘(이모지)에 `aria-hidden="true"` 속성을 추가하여 스크린 리더가 불필요하게 읽지 않도록 수정했습니다.
diff --git a/build.gradle b/build.gradle
index 6d59eb57..0a748ff9 100644
--- a/build.gradle
+++ b/build.gradle
@@ -1,5 +1,5 @@
 buildscript {
-    ext.kotlin_version = '1.3.72'
+    ext.kotlin_version = '1.9.22'
 
     repositories {
        mavenCentral()
@@ -13,7 +13,9 @@ apply plugin: 'kotlin'
 apply plugin: 'application'
 apply plugin: 'jacoco'
 
-mainClassName = 'html4tree.MainKt'
+application {
+    mainClass = 'html4tree.MainKt'
+}
 
 defaultTasks 'build'
 
@@ -22,29 +24,29 @@ repositories {
 }
 
 dependencies {
-    compile "org.jetbrains.kotlin:kotlin-stdlib:$kotlin_version"
-    testCompile 'junit:junit:4.11'
-    testCompile "org.jetbrains.kotlin:kotlin-test-junit:$kotlin_version"
-    compile "com.github.ajalt:clikt:2.7.1"
+    implementation "org.jetbrains.kotlin:kotlin-stdlib:$kotlin_version"
+    testImplementation 'junit:junit:4.13.2'
+    testImplementation "org.jetbrains.kotlin:kotlin-test-junit:$kotlin_version"
+    implementation "com.github.ajalt.clikt:clikt:3.5.0"
 }
 
 jar {
     manifest {
         attributes 'Main-Class': 'html4tree.MainKt'
     }
-
-    from { configurations.compile.collect { it.isDirectory() ? it : zipTree(it) } }
+    duplicatesStrategy = DuplicatesStrategy.EXCLUDE
+    from { configurations.runtimeClasspath.collect { it.isDirectory() ? it : zipTree(it) } }
 }
 
 jacoco {
-    toolVersion = "0.8.7"
+    toolVersion = "0.8.11"
 }
 
 jacocoTestReport {
     reports {
-        xml.enabled false
-        csv.enabled false
-        html.destination file("${buildDir}/jacocoHtml")
+        xml.required.set(false)
+        csv.required.set(false)
+        html.outputLocation.set(file("${buildDir}/jacocoHtml"))
     }
 }
 
diff --git a/gradle/wrapper/gradle-wrapper.properties b/gradle/wrapper/gradle-wrapper.properties
index 558870da..a5952066 100644
--- a/gradle/wrapper/gradle-wrapper.properties
+++ b/gradle/wrapper/gradle-wrapper.properties
@@ -1,5 +1,5 @@
 distributionBase=GRADLE_USER_HOME
 distributionPath=wrapper/dists
-distributionUrl=https\://services.gradle.org/distributions/gradle-5.1.1-bin.zip
+distributionUrl=https\://services.gradle.org/distributions/gradle-8.5-bin.zip
 zipStoreBase=GRADLE_USER_HOME
 zipStorePath=wrapper/dists
diff --git a/src/main/kotlin/html4tree/main.kt b/src/main/kotlin/html4tree/main.kt
index 50b2680d..78c3cd1c 100644
--- a/src/main/kotlin/html4tree/main.kt
+++ b/src/main/kotlin/html4tree/main.kt
@@ -118,9 +118,10 @@ fun process_dir(curr_dir: File){
         ${css}
      </head>
      <body>
+       <main>
        <h1>${curr_dir.getName().escapeHtml()}</h1>
        <ul>
-          <li><a style="display:block; width:100%" href="./.." aria-label="상위 디렉토리로 이동">&#x21B0; ..</a></li>
+          <li><a style="display:block; width:100%" href="./.." aria-label="상위 디렉토리로 이동"><span aria-hidden="true">&#x21B0;</span> ..</a></li>
 """ 
 
     val index_middle = fun():String{ 
@@ -131,7 +132,7 @@ fun process_dir(curr_dir: File){
         dir_files.forEach {
            val isLinkedDirectory = it.isDirectory() && !java.nio.file.Files.isSymbolicLink(it.toPath())
            if((it.getName() !in exclude) && (isLinkedDirectory || !it.isDirectory())) {
-              l += """          <li><a style="display:block; width:100%" href="${if (isLinkedDirectory) { "./${it.getName().urlEncodePath()}/" } else { "./${it.getName().urlEncodePath()}" }}">${if (isLinkedDirectory) { "&#128193;" } else { "&rtrif;" }} ${it.getName().escapeHtml()}</a></li>"""+"\n"
+              l += """          <li><a style="display:block; width:100%" href="${if (isLinkedDirectory) { "./${it.getName().urlEncodePath()}/" } else { "./${it.getName().urlEncodePath()}" }}"><span aria-hidden="true">${if (isLinkedDirectory) { "&#128193;" } else { "&rtrif;" }}</span> ${it.getName().escapeHtml()}</a></li>"""+"\n"
            }
         }
 
@@ -140,6 +141,7 @@ fun process_dir(curr_dir: File){
 
    val index_bottom="""
        </ul>
+       </main>
     </body>
 </html>
 """
diff --git a/src/test/kotlin/html4tree/MainTest.kt b/src/test/kotlin/html4tree/MainTest.kt
index 31c193a2..0506313c 100644
--- a/src/test/kotlin/html4tree/MainTest.kt
+++ b/src/test/kotlin/html4tree/MainTest.kt
@@ -70,6 +70,7 @@ class MainTest {
         val indexFile = File(tempDir, "index.html")
         assertTrue(indexFile.exists())
         assertTrue(indexFile.readText().contains("<html lang=\"ko\">"))
+        assertTrue(indexFile.readText().contains("<main>"))
     }
 
     @Test
@@ -110,10 +111,13 @@ class MainTest {
         assertTrue(indexFile.exists())
         val htmlContent = indexFile.readText()
         assertTrue(htmlContent.contains("<html lang=\"ko\">"))
+        assertTrue(htmlContent.contains("<main>"))
+        assertTrue(htmlContent.contains("</main>"))
         assertTrue(htmlContent.contains("aria-label=\"상위 디렉토리로 이동\""))
         assertTrue(htmlContent.contains("file1.txt"))
         assertTrue(htmlContent.contains("subdir/"))
         assertTrue(htmlContent.contains("&#128193;"))
+        assertTrue(htmlContent.contains("<span aria-hidden=\"true\">"))
         assertFalse(htmlContent.contains("test.ignore"))
     }