Merge pull request #94 from javaevolved/copilot/translate-site-content-korean

Add Korean (한국어) locale

Author: brunoborges

html-generators/locales.properties

@@ -7,3 +7,4 @@ zh-CN=中文 (简体)
 ar=العربية
 fr=Français
 ja=日本語
+ko=한국어

translations/content/ko/collections/collectors-teeing.yaml

@@ -0,0 +1,17 @@
+title: "Collectors.teeing()"
+oldApproach: "두 번 순회"
+modernApproach: "teeing()"
+summary: "스트림을 한 번만 순회하여 두 가지 집계를 동시에 계산합니다."
+explanation: "Collectors.teeing()은 각 요소를 두 개의 다운스트림 컬렉터에 전달하고 결과를 병합합니다. 데이터를 두 번 스트리밍하거나 가변 누산기를 사용하지 않아도 됩니다."
+whyModernWins:
+- icon: "⚡"
+  title: "단일 순회"
+  desc: "스트림을 두 번 대신 한 번만 처리합니다."
+- icon: "🧩"
+  title: "조합 가능"
+  desc: "병합 함수로 임의의 두 컬렉터를 결합합니다."
+- icon: "🔒"
+  title: "불변 결과"
+  desc: "레코드나 값 객체로 직접 병합합니다."
+support:
+  description: "JDK 12 (2019년 3월) 이후 널리 사용 가능"

translations/content/ko/collections/copying-collections-immutably.yaml

@@ -0,0 +1,17 @@
+title: "컬렉션 불변 복사"
+oldApproach: "수동 복사 + 래핑"
+modernApproach: "List.copyOf()"
+summary: "한 번의 호출로 모든 컬렉션의 불변 복사본을 만듭니다."
+explanation: "List.copyOf(), Set.copyOf(), Map.copyOf()는 기존 컬렉션의 불변 스냅샷을 만듭니다. 원본이 이미 불변 컬렉션이라면 복사가 생략됩니다."
+whyModernWins:
+- icon: "⚡"
+  title: "스마트 복사"
+  desc: "원본이 이미 불변이면 복사를 건너뜁니다."
+- icon: "📏"
+  title: "한 번의 호출"
+  desc: "ArrayList 수동 생성과 래핑이 필요 없습니다."
+- icon: "🛡️"
+  title: "방어적 복사"
+  desc: "원본을 변경해도 복사본에 영향을 주지 않습니다."
+support:
+  description: "JDK 10 (2018년 3월) 이후 널리 사용 가능"

translations/content/ko/collections/immutable-list-creation.yaml

@@ -0,0 +1,17 @@
+title: "불변 리스트 생성"
+oldApproach: "장황한 래핑"
+modernApproach: "List.of()"
+summary: "하나의 깔끔한 표현식으로 불변 리스트를 만듭니다."
+explanation: "List.of()는 래핑이나 방어적 복사 없이 진정한 불변 리스트를 만듭니다. null에 비허용적(null 요소 거부)이며 구조적으로 불변입니다. 이전 방식은 세 개의 중첩 호출이 필요했습니다."
+whyModernWins:
+- icon: "📏"
+  title: "한 번의 호출"
+  desc: "세 개의 중첩 호출을 단일 팩토리 메서드로 대체합니다."
+- icon: "🔒"
+  title: "진정한 불변"
+  desc: "단순 래퍼가 아니라 리스트 자체가 불변입니다."
+- icon: "🛡️"
+  title: "null 안전"
+  desc: "생성 시점에 null 요소를 거부하여 빠른 실패를 보장합니다."
+support:
+  description: "JDK 9 (2017년 9월) 이후 널리 사용 가능"

translations/content/ko/collections/immutable-map-creation.yaml

@@ -0,0 +1,17 @@
+title: "불변 맵 생성"
+oldApproach: "맵 빌더 패턴"
+modernApproach: "Map.of()"
+summary: "빌더 없이 인라인으로 불변 맵을 만듭니다."
+explanation: "Map.of()는 키-값 쌍을 인라인으로 받아 불변 맵을 반환합니다. 10개 초과 항목의 경우 Map.ofEntries()와 Map.entry() 쌍을 사용하세요."
+whyModernWins:
+- icon: "📏"
+  title: "인라인 생성"
+  desc: "임시 가변 맵이 필요 없습니다."
+- icon: "🔒"
+  title: "불변 결과"
+  desc: "생성 후 맵을 수정할 수 없습니다."
+- icon: "🚫"
+  title: "null 키/값 불허"
+  desc: "null 항목은 즉시 거부됩니다."
+support:
+  description: "JDK 9 (2017년 9월) 이후 널리 사용 가능"

translations/content/ko/collections/immutable-set-creation.yaml

@@ -0,0 +1,17 @@
+title: "불변 셋 생성"
+oldApproach: "장황한 래핑"
+modernApproach: "Set.of()"
+summary: "단일 팩토리 호출로 불변 셋을 만듭니다."
+explanation: "Set.of()는 null과 중복 요소를 생성 시점에 거부하는 진정한 불변 셋을 만듭니다. 더 이상 가변 셋을 래핑할 필요가 없습니다."
+whyModernWins:
+- icon: "📏"
+  title: "간결함"
+  desc: "세 개의 중첩 호출 대신 한 줄로 작성합니다."
+- icon: "🚫"
+  title: "중복 감지"
+  desc: "중복 요소를 실수로 전달하면 예외를 던집니다."
+- icon: "🔒"
+  title: "불변"
+  desc: "생성 후 추가/제거가 불가능합니다."
+support:
+  description: "JDK 9 (2017년 9월) 이후 널리 사용 가능"

translations/content/ko/collections/map-entry-factory.yaml

@@ -0,0 +1,17 @@
+title: "Map.entry() 팩토리"
+oldApproach: "SimpleEntry"
+modernApproach: "Map.entry()"
+summary: "깔끔한 팩토리 메서드로 맵 항목을 만듭니다."
+explanation: "Map.entry()는 장황한 AbstractMap.SimpleEntry 생성자를 대체합니다. 불변 항목을 반환하므로 Map.ofEntries()와 스트림 연산에 이상적입니다."
+whyModernWins:
+- icon: "📏"
+  title: "간결함"
+  desc: "세 줄 대신 더 명확한 의도로 한 줄에 작성합니다."
+- icon: "🔒"
+  title: "불변"
+  desc: "반환된 항목을 수정할 수 없습니다."
+- icon: "🧩"
+  title: "조합 가능"
+  desc: "대형 맵에서 Map.ofEntries()와 완벽하게 작동합니다."
+support:
+  description: "JDK 9 (2017년 9월) 이후 널리 사용 가능"

translations/content/ko/collections/reverse-list-iteration.yaml

@@ -0,0 +1,17 @@
+title: "리스트 역순 반복"
+oldApproach: "수동 ListIterator"
+modernApproach: "reversed()"
+summary: "깔끔한 향상된 for 루프로 리스트를 역순으로 반복합니다."
+explanation: "SequencedCollection의 reversed() 메서드는 리스트의 역순 뷰를 반환합니다. 이 뷰는 원본 리스트와 연결되어 있어 복사가 발생하지 않습니다. 향상된 for 루프 구문으로 역순 반복이 순방향만큼 읽기 쉬워집니다."
+whyModernWins:
+- icon: "📖"
+  title: "자연스러운 문법"
+  desc: "장황한 ListIterator 대신 향상된 for 루프를 사용합니다."
+- icon: "⚡"
+  title: "복사 없음"
+  desc: "reversed()는 뷰를 반환합니다 — 성능 오버헤드가 없습니다."
+- icon: "🧩"
+  title: "일관된 API"
+  desc: "List, Deque, SortedSet에서 동일하게 작동합니다."
+support:
+  description: "JDK 21 LTS (2023년 9월) 이후 널리 사용 가능"

translations/content/ko/collections/sequenced-collections.yaml

@@ -0,0 +1,17 @@
+title: "시퀀스 컬렉션"
+oldApproach: "인덱스 산술"
+modernApproach: "getFirst/getLast"
+summary: "깔끔한 API 메서드로 첫/마지막 요소와 역순 뷰에 접근합니다."
+explanation: "SequencedCollection은 List, Deque, SortedSet, LinkedHashSet에 getFirst(), getLast(), reversed(), addFirst(), addLast()를 추가합니다. 더 이상 size-1 산술이나 수동 역순 반복이 필요 없습니다."
+whyModernWins:
+- icon: "📖"
+  title: "자기 문서화"
+  desc: "getLast()는 get(size()-1)보다 훨씬 명확합니다."
+- icon: "🔄"
+  title: "역순 뷰"
+  desc: "reversed()는 뷰를 제공합니다 — 복사가 필요 없습니다."
+- icon: "🧩"
+  title: "통일된 API"
+  desc: "List, Deque, SortedSet에서 동일하게 작동합니다."
+support:
+  description: "JDK 21 LTS (2023년 9월) 이후 널리 사용 가능"

translations/content/ko/collections/stream-toarray-typed.yaml

@@ -0,0 +1,17 @@
+title: "타입이 지정된 스트림 toArray"
+oldApproach: "수동 배열 복사"
+modernApproach: "toArray(생성자)"
+summary: "메서드 참조로 스트림을 타입이 지정된 배열로 변환합니다."
+explanation: "toArray(IntFunction) 메서드는 스트림에서 올바르게 타입이 지정된 배열을 만듭니다. 생성자(String[]::new)는 스트림에 생성할 배열 타입을 알려줍니다."
+whyModernWins:
+- icon: "🎯"
+  title: "타입 안전"
+  desc: "Object[] 캐스트 없이 정확한 배열 타입을 얻습니다."
+- icon: "🔗"
+  title: "체이닝 가능"
+  desc: "스트림 파이프라인의 끝에서 작동합니다."
+- icon: "📏"
+  title: "간결함"
+  desc: "수동 루프를 하나의 표현식으로 대체합니다."
+support:
+  description: "JDK 8 (2014년 3월) 이후 널리 사용 가능"