feat(ko): add the Korean online edition (#2006)

* feat(ko): add the complete Korean online edition

* Use UTF-8 for Python CI output on Windows

* Remove print-book promotion from the Korean site

* fix(ko): preserve emphasis before Korean particles

ko/codes/javascript/chapter_sorting/bubble_sort.js

@@ -0,0 +1,49 @@
+/**
+ * File: bubble_sort.js
+ * Created Time: 2022-12-01
+ * Author: IsChristina ([email protected])
+ */
+
+/* 버블 정렬 */
+function bubbleSort(nums) {
+    // 바깥쪽 반복문: 정렬되지 않은 구간은 [0, i]이다
+    for (let i = nums.length - 1; i > 0; i--) {
+        // 안쪽 반복문: 정렬되지 않은 구간 [0, i]의 최댓값을 교환하여 이 구간의 맨 오른쪽으로 옮긴다
+        for (let j = 0; j < i; j++) {
+            if (nums[j] > nums[j + 1]) {
+                // nums[j]와 nums[j + 1]을 교환한다
+                let tmp = nums[j];
+                nums[j] = nums[j + 1];
+                nums[j + 1] = tmp;
+            }
+        }
+    }
+}
+
+/* 버블 정렬(플래그 최적화)*/
+function bubbleSortWithFlag(nums) {
+    // 바깥쪽 반복문: 정렬되지 않은 구간은 [0, i]이다
+    for (let i = nums.length - 1; i > 0; i--) {
+        let flag = false; // 플래그를 초기화한다
+        // 안쪽 반복문: 정렬되지 않은 구간 [0, i]의 최댓값을 교환하여 이 구간의 맨 오른쪽으로 옮긴다
+        for (let j = 0; j < i; j++) {
+            if (nums[j] > nums[j + 1]) {
+                // nums[j]와 nums[j + 1]을 교환한다
+                let tmp = nums[j];
+                nums[j] = nums[j + 1];
+                nums[j + 1] = tmp;
+                flag = true; // 원소가 교환되었음을 기록한다
+            }
+        }
+        if (!flag) break; // 이번 버블 과정에서 원소 교환이 없었으므로 바로 종료한다
+    }
+}
+
+/* 실행 코드 */
+const nums = [4, 1, 3, 1, 5, 2];
+bubbleSort(nums);
+console.log('버블 정렬을 마친 후 nums =', nums);
+
+const nums1 = [4, 1, 3, 1, 5, 2];
+bubbleSortWithFlag(nums1);
+console.log('버블 정렬을 마친 후 nums =', nums1);

ko/codes/javascript/chapter_sorting/bucket_sort.js

@@ -0,0 +1,39 @@
+/**
+ * File: bucket_sort.js
+ * Created Time: 2023-04-08
+ * Author: Justin ([email protected])
+ */
+
+/* 버킷 정렬 */
+function bucketSort(nums) {
+    // 버킷 k = n/2개를 초기화하며, 각 버킷에 원소 2개가 배정될 것으로 예상한다
+    const k = nums.length / 2;
+    const buckets = [];
+    for (let i = 0; i < k; i++) {
+        buckets.push([]);
+    }
+    // 1. 배열 원소를 각 버킷에 배정한다
+    for (const num of nums) {
+        // 입력 데이터의 범위는 [0, 1)이며, num * k를 사용하여 인덱스 범위 [0, k-1]에 대응시킨다
+        const i = Math.floor(num * k);
+        // num을 버킷 i에 추가한다
+        buckets[i].push(num);
+    }
+    // 2. 각 버킷을 정렬한다
+    for (const bucket of buckets) {
+        // 내장 정렬 함수를 사용하며, 다른 정렬 알고리즘으로 대체할 수도 있다
+        bucket.sort((a, b) => a - b);
+    }
+    // 3. 버킷을 순회하여 결과를 합친다
+    let i = 0;
+    for (const bucket of buckets) {
+        for (const num of bucket) {
+            nums[i++] = num;
+        }
+    }
+}
+
+/* 실행 코드 */
+const nums = [0.49, 0.96, 0.82, 0.09, 0.57, 0.43, 0.91, 0.75, 0.15, 0.37];
+bucketSort(nums);
+console.log('버킷 정렬을 마친 후 nums =', nums);

ko/codes/javascript/chapter_sorting/counting_sort.js

@@ -0,0 +1,65 @@
+/**
+ * File: counting_sort.js
+ * Created Time: 2023-04-08
+ * Author: Justin ([email protected])
+ */
+
+/* 계수 정렬 */
+// 간단한 구현이며, 객체 정렬에는 사용할 수 없다
+function countingSortNaive(nums) {
+    // 1. 배열의 최댓값 m을 구한다
+    let m = Math.max(...nums);
+    // 2. 각 숫자의 등장 횟수를 센다
+    // counter[num]은 num의 등장 횟수를 나타낸다
+    const counter = new Array(m + 1).fill(0);
+    for (const num of nums) {
+        counter[num]++;
+    }
+    // 3. counter를 순회하며 각 원소를 원래 배열 nums에 채운다
+    let i = 0;
+    for (let num = 0; num < m + 1; num++) {
+        for (let j = 0; j < counter[num]; j++, i++) {
+            nums[i] = num;
+        }
+    }
+}
+
+/* 계수 정렬 */
+// 완전한 구현이며, 객체를 정렬할 수 있고 안정 정렬이다
+function countingSort(nums) {
+    // 1. 배열의 최댓값 m을 구한다
+    let m = Math.max(...nums);
+    // 2. 각 숫자의 등장 횟수를 센다
+    // counter[num]은 num의 등장 횟수를 나타낸다
+    const counter = new Array(m + 1).fill(0);
+    for (const num of nums) {
+        counter[num]++;
+    }
+    // 3. counter의 접두 합을 구하여 등장 횟수를 마지막 인덱스로 변환한다
+    // 즉, counter[num]-1은 res에서 num이 마지막으로 등장하는 인덱스이다
+    for (let i = 0; i < m; i++) {
+        counter[i + 1] += counter[i];
+    }
+    // 4. nums를 역순으로 순회하며 각 원소를 결과 배열 res에 채운다
+    // 결과를 기록할 배열 res를 초기화한다
+    const n = nums.length;
+    const res = new Array(n);
+    for (let i = n - 1; i >= 0; i--) {
+        const num = nums[i];
+        res[counter[num] - 1] = num; // num을 해당 인덱스에 배치한다
+        counter[num]--; // 접두 합을 1 감소시켜 다음에 num을 배치할 인덱스를 구한다
+    }
+    // 결과 배열 res로 원래 배열 nums를 덮어쓴다
+    for (let i = 0; i < n; i++) {
+        nums[i] = res[i];
+    }
+}
+
+/* 실행 코드 */
+const nums = [1, 0, 1, 2, 0, 4, 0, 2, 2, 4];
+countingSortNaive(nums);
+console.log('계수 정렬(객체 정렬 불가)을 마친 후 nums =', nums);
+
+const nums1 = [1, 0, 1, 2, 0, 4, 0, 2, 2, 4];
+countingSort(nums1);
+console.log('계수 정렬을 마친 후 nums1 =', nums1);

ko/codes/javascript/chapter_sorting/heap_sort.js

@@ -0,0 +1,49 @@
+/**
+ * File: heap_sort.js
+ * Created Time: 2023-06-04
+ * Author: Justin ([email protected])
+ */
+
+/* 길이가 n인 힙에서 노드 i부터 위에서 아래로 힙 재정렬 */
+function siftDown(nums, n, i) {
+    while (true) {
+        // 노드 i, l, r 중 값이 가장 큰 노드를 찾아 ma로 표시한다
+        let l = 2 * i + 1;
+        let r = 2 * i + 2;
+        let ma = i;
+        if (l < n && nums[l] > nums[ma]) {
+            ma = l;
+        }
+        if (r < n && nums[r] > nums[ma]) {
+            ma = r;
+        }
+        // 노드 i의 값이 가장 크거나 인덱스 l, r이 범위를 벗어나면 힙을 더 재정렬할 필요가 없으므로 종료한다
+        if (ma === i) {
+            break;
+        }
+        // 두 노드를 교환한다
+        [nums[i], nums[ma]] = [nums[ma], nums[i]];
+        // 아래쪽으로 힙 재정렬을 반복한다
+        i = ma;
+    }
+}
+
+/* 힙 정렬 */
+function heapSort(nums) {
+    // 힙 구성 연산: 리프 노드를 제외한 모든 노드에 힙 재정렬을 수행한다
+    for (let i = Math.floor(nums.length / 2) - 1; i >= 0; i--) {
+        siftDown(nums, nums.length, i);
+    }
+    // 힙에서 최댓값을 꺼내는 작업을 n-1회 반복한다
+    for (let i = nums.length - 1; i > 0; i--) {
+        // 루트 노드와 가장 오른쪽 리프 노드를 교환한다(첫 원소와 마지막 원소 교환)
+        [nums[0], nums[i]] = [nums[i], nums[0]];
+        // 루트 노드에서 시작하여 위에서 아래로 힙을 재정렬한다
+        siftDown(nums, i, 0);
+    }
+}
+
+/* 실행 코드 */
+const nums = [4, 1, 3, 1, 5, 2];
+heapSort(nums);
+console.log('힙 정렬을 마친 후 nums =', nums);

ko/codes/javascript/chapter_sorting/insertion_sort.js

@@ -0,0 +1,25 @@
+/**
+ * File: insertion_sort.js
+ * Created Time: 2022-12-01
+ * Author: IsChristina ([email protected])
+ */
+
+/* 삽입 정렬 */
+function insertionSort(nums) {
+    // 바깥쪽 반복문: 정렬된 구간은 [0, i-1]이다
+    for (let i = 1; i < nums.length; i++) {
+        let base = nums[i],
+            j = i - 1;
+        // 안쪽 반복문: base를 정렬된 구간 [0, i-1]의 올바른 위치에 삽입한다
+        while (j >= 0 && nums[j] > base) {
+            nums[j + 1] = nums[j]; // nums[j]를 오른쪽으로 한 칸 이동한다
+            j--;
+        }
+        nums[j + 1] = base; // 올바른 위치에 base를 대입한다
+    }
+}
+
+/* 실행 코드 */
+const nums = [4, 1, 3, 1, 5, 2];
+insertionSort(nums);
+console.log('삽입 정렬을 마친 후 nums =', nums);

ko/codes/javascript/chapter_sorting/merge_sort.js

@@ -0,0 +1,52 @@
+/**
+ * File: merge_sort.js
+ * Created Time: 2022-12-01
+ * Author: IsChristina ([email protected])
+ */
+
+/* 왼쪽 부분 배열과 오른쪽 부분 배열 병합 */
+function merge(nums, left, mid, right) {
+    // 왼쪽 부분 배열의 구간은 [left, mid]이고, 오른쪽 부분 배열의 구간은 [mid+1, right]이다
+    // 병합 결과를 저장할 임시 배열 tmp를 생성한다
+    const tmp = new Array(right - left + 1);
+    // 왼쪽 부분 배열과 오른쪽 부분 배열의 시작 인덱스를 초기화한다
+    let i = left,
+        j = mid + 1,
+        k = 0;
+    // 양쪽 부분 배열 모두에 원소가 남아 있으면 비교하여 더 작은 원소를 임시 배열에 복사한다
+    while (i <= mid && j <= right) {
+        if (nums[i] <= nums[j]) {
+            tmp[k++] = nums[i++];
+        } else {
+            tmp[k++] = nums[j++];
+        }
+    }
+    // 왼쪽 부분 배열과 오른쪽 부분 배열의 남은 원소를 임시 배열에 복사한다
+    while (i <= mid) {
+        tmp[k++] = nums[i++];
+    }
+    while (j <= right) {
+        tmp[k++] = nums[j++];
+    }
+    // 임시 배열 tmp의 원소를 원래 배열 nums의 해당 구간에 다시 복사한다
+    for (k = 0; k < tmp.length; k++) {
+        nums[left + k] = tmp[k];
+    }
+}
+
+/* 병합 정렬 */
+function mergeSort(nums, left, right) {
+    // 종료 조건
+    if (left >= right) return; // 부분 배열의 길이가 1이면 재귀를 종료한다
+    // 분할 단계
+    let mid = Math.floor(left + (right - left) / 2); // 중간 위치를 계산한다
+    mergeSort(nums, left, mid); // 왼쪽 부분 배열에 재귀 호출한다
+    mergeSort(nums, mid + 1, right); // 오른쪽 부분 배열에 재귀 호출한다
+    // 병합 단계
+    merge(nums, left, mid, right);
+}
+
+/* 실행 코드 */
+const nums = [7, 3, 2, 6, 0, 1, 5, 4];
+mergeSort(nums, 0, nums.length - 1);
+console.log('병합 정렬을 마친 후 nums =', nums);

ko/codes/javascript/chapter_sorting/quick_sort.js

@@ -0,0 +1,161 @@
+/**
+ * File: quick_sort.js
+ * Created Time: 2022-12-01
+ * Author: IsChristina ([email protected])
+ */
+
+/* 퀵 정렬 클래스 */
+class QuickSort {
+    /* 원소 교환 */
+    swap(nums, i, j) {
+        let tmp = nums[i];
+        nums[i] = nums[j];
+        nums[j] = tmp;
+    }
+
+    /* 센티널 분할 */
+    partition(nums, left, right) {
+        // nums[left]를 피벗으로 삼는다
+        let i = left,
+            j = right;
+        while (i < j) {
+            while (i < j && nums[j] >= nums[left]) {
+                j -= 1; // 오른쪽에서 왼쪽으로 피벗보다 작은 첫 번째 원소를 찾는다
+            }
+            while (i < j && nums[i] <= nums[left]) {
+                i += 1; // 왼쪽에서 오른쪽으로 피벗보다 큰 첫 번째 원소를 찾는다
+            }
+            // 원소 교환
+            this.swap(nums, i, j); // 두 원소를 교환한다
+        }
+        this.swap(nums, i, left); // 피벗을 두 부분 배열의 경계로 교환하여 옮긴다
+        return i; // 피벗의 인덱스를 반환한다
+    }
+
+    /* 퀵 정렬 */
+    quickSort(nums, left, right) {
+        // 부분 배열의 길이가 1이면 재귀를 종료한다
+        if (left >= right) return;
+        // 센티널 분할
+        const pivot = this.partition(nums, left, right);
+        // 왼쪽 부분 배열과 오른쪽 부분 배열에 재귀 호출한다
+        this.quickSort(nums, left, pivot - 1);
+        this.quickSort(nums, pivot + 1, right);
+    }
+}
+
+/* 퀵 정렬 클래스(중앙값 피벗 최적화) */
+class QuickSortMedian {
+    /* 원소 교환 */
+    swap(nums, i, j) {
+        let tmp = nums[i];
+        nums[i] = nums[j];
+        nums[j] = tmp;
+    }
+
+    /* 세 후보 원소의 중앙값 선택 */
+    medianThree(nums, left, mid, right) {
+        let l = nums[left],
+            m = nums[mid],
+            r = nums[right];
+        // m은 l과 r 사이에 있다
+        if ((l <= m && m <= r) || (r <= m && m <= l)) return mid;
+        // l은 m과 r 사이에 있다
+        if ((m <= l && l <= r) || (r <= l && l <= m)) return left;
+        return right;
+    }
+
+    /* 센티널 분할(세 수의 중앙값 선택) */
+    partition(nums, left, right) {
+        // 세 후보 원소의 중앙값 선택
+        let med = this.medianThree(
+            nums,
+            left,
+            Math.floor((left + right) / 2),
+            right
+        );
+        // 중앙값을 배열 맨 왼쪽으로 교환하여 옮긴다
+        this.swap(nums, left, med);
+        // nums[left]를 피벗으로 삼는다
+        let i = left,
+            j = right;
+        while (i < j) {
+            while (i < j && nums[j] >= nums[left]) j--; // 오른쪽에서 왼쪽으로 피벗보다 작은 첫 번째 원소를 찾는다
+            while (i < j && nums[i] <= nums[left]) i++; // 왼쪽에서 오른쪽으로 피벗보다 큰 첫 번째 원소를 찾는다
+            this.swap(nums, i, j); // 두 원소를 교환한다
+        }
+        this.swap(nums, i, left); // 피벗을 두 부분 배열의 경계로 교환하여 옮긴다
+        return i; // 피벗의 인덱스를 반환한다
+    }
+
+    /* 퀵 정렬 */
+    quickSort(nums, left, right) {
+        // 부분 배열의 길이가 1이면 재귀를 종료한다
+        if (left >= right) return;
+        // 센티널 분할
+        const pivot = this.partition(nums, left, right);
+        // 왼쪽 부분 배열과 오른쪽 부분 배열에 재귀 호출한다
+        this.quickSort(nums, left, pivot - 1);
+        this.quickSort(nums, pivot + 1, right);
+    }
+}
+
+/* 퀵 정렬 클래스(재귀 깊이 최적화) */
+class QuickSortTailCall {
+    /* 원소 교환 */
+    swap(nums, i, j) {
+        let tmp = nums[i];
+        nums[i] = nums[j];
+        nums[j] = tmp;
+    }
+
+    /* 센티널 분할 */
+    partition(nums, left, right) {
+        // nums[left]를 피벗으로 삼는다
+        let i = left,
+            j = right;
+        while (i < j) {
+            while (i < j && nums[j] >= nums[left]) j--; // 오른쪽에서 왼쪽으로 피벗보다 작은 첫 번째 원소를 찾는다
+            while (i < j && nums[i] <= nums[left]) i++; // 왼쪽에서 오른쪽으로 피벗보다 큰 첫 번째 원소를 찾는다
+            this.swap(nums, i, j); // 두 원소를 교환한다
+        }
+        this.swap(nums, i, left); // 피벗을 두 부분 배열의 경계로 교환하여 옮긴다
+        return i; // 피벗의 인덱스를 반환한다
+    }
+
+    /* 퀵 정렬(재귀 깊이 최적화) */
+    quickSort(nums, left, right) {
+        // 부분 배열의 길이가 1이면 종료한다
+        while (left < right) {
+            // 센티널 분할 연산
+            let pivot = this.partition(nums, left, right);
+            // 두 부분 배열 중 더 짧은 쪽에 퀵 정렬을 수행한다
+            if (pivot - left < right - pivot) {
+                this.quickSort(nums, left, pivot - 1); // 왼쪽 부분 배열을 재귀적으로 정렬한다
+                left = pivot + 1; // 남은 미정렬 구간은 [pivot + 1, right]이다
+            } else {
+                this.quickSort(nums, pivot + 1, right); // 오른쪽 부분 배열을 재귀적으로 정렬한다
+                right = pivot - 1; // 남은 미정렬 구간은 [left, pivot - 1]이다
+            }
+        }
+    }
+}
+
+/* 실행 코드 */
+/* 퀵 정렬  */
+const nums = [2, 4, 1, 0, 3, 5];
+const quickSort = new QuickSort();
+quickSort.quickSort(nums, 0, nums.length - 1);
+console.log('퀵 정렬을 마친 후 nums =', nums);
+
+/* 퀵 정렬(중앙값 피벗 최적화) */
+const nums1 = [2, 4, 1, 0, 3, 5];
+const quickSortMedian = new QuickSortMedian();
+quickSortMedian.quickSort(nums1, 0, nums1.length - 1);
+console.log('퀵 정렬(중앙값 피벗 최적화)을 마친 후 nums =', nums1);
+
+/* 퀵 정렬(재귀 깊이 최적화) */
+const nums2 = [2, 4, 1, 0, 3, 5];
+const quickSortTailCall = new QuickSortTailCall();
+quickSortTailCall.quickSort(nums2, 0, nums2.length - 1);
+console.log('퀵 정렬(재귀 깊이 최적화)을 마친 후 nums =', nums2);

ko/codes/javascript/chapter_sorting/radix_sort.js

@@ -0,0 +1,61 @@
+/**
+ * File: radix_sort.js
+ * Created Time: 2023-04-08
+ * Author: Justin ([email protected])
+ */
+
+/* 원소 num의 k번째 자릿값 반환. 이때 exp = 10^(k-1)이다 */
+function digit(num, exp) {
+    // k 대신 exp를 전달하면 여기서 비용이 큰 거듭제곱 계산을 반복하지 않아도 된다
+    return Math.floor(num / exp) % 10;
+}
+
+/* 계수 정렬(nums의 k번째 자릿값을 기준으로 정렬) */
+function countingSortDigit(nums, exp) {
+    // 십진수의 각 자리는 0~9 범위이므로 길이가 10인 버킷 배열이 필요하다
+    const counter = new Array(10).fill(0);
+    const n = nums.length;
+    // 0~9 각 숫자의 등장 횟수를 센다
+    for (let i = 0; i < n; i++) {
+        const d = digit(nums[i], exp); // nums[i]의 k번째 자릿값을 구하여 d로 표시한다
+        counter[d]++; // 숫자 d의 등장 횟수를 센다
+    }
+    // 접두 합을 구하여 등장 개수를 배열 인덱스로 변환한다
+    for (let i = 1; i < 10; i++) {
+        counter[i] += counter[i - 1];
+    }
+    // 역순으로 순회하며 버킷에 집계된 결과에 따라 각 원소를 res에 채운다
+    const res = new Array(n).fill(0);
+    for (let i = n - 1; i >= 0; i--) {
+        const d = digit(nums[i], exp);
+        const j = counter[d] - 1; // 배열에서 d의 인덱스 j를 구한다
+        res[j] = nums[i]; // 현재 원소를 인덱스 j에 채운다
+        counter[d]--; // d의 개수를 1 줄인다
+    }
+    // 결과로 원래 배열 nums를 덮어쓴다
+    for (let i = 0; i < n; i++) {
+        nums[i] = res[i];
+    }
+}
+
+/* 기수 정렬 */
+function radixSort(nums) {
+    // 배열의 최댓값을 구하여 최대 자릿수를 판단한다
+    let m = Math.max(... nums);
+    // 낮은 자리에서 높은 자리 순서로 순회한다
+    for (let exp = 1; exp <= m; exp *= 10) {
+        // 배열 원소의 k번째 자릿값에 대해 계수 정렬을 수행한다
+        // k = 1 -> exp = 1
+        // k = 2 -> exp = 10
+        // 즉, exp = 10^(k-1)이다
+        countingSortDigit(nums, exp);
+    }
+}
+
+/* 실행 코드 */
+const nums = [
+    10546151, 35663510, 42865989, 34862445, 81883077, 88906420, 72429244,
+    30524779, 82060337, 63832996,
+];
+radixSort(nums);
+console.log('기수 정렬을 마친 후 nums =', nums);

ko/codes/javascript/chapter_sorting/selection_sort.js

@@ -0,0 +1,27 @@
+/**
+ * File: selection_sort.js
+ * Created Time: 2023-06-04
+ * Author: Justin ([email protected])
+ */
+
+/* 선택 정렬 */
+function selectionSort(nums) {
+    let n = nums.length;
+    // 바깥쪽 반복문: 정렬되지 않은 구간은 [i, n-1]이다
+    for (let i = 0; i < n - 1; i++) {
+        // 안쪽 반복문: 정렬되지 않은 구간의 최솟값을 찾는다
+        let k = i;
+        for (let j = i + 1; j < n; j++) {
+            if (nums[j] < nums[k]) {
+                k = j; // 최솟값의 인덱스를 기록한다
+            }
+        }
+        // 이 최솟값과 정렬되지 않은 구간의 첫 원소를 교환한다
+        [nums[i], nums[k]] = [nums[k], nums[i]];
+    }
+}
+
+/* 실행 코드 */
+const nums = [4, 1, 3, 1, 5, 2];
+selectionSort(nums);
+console.log('선택 정렬을 마친 후 nums =', nums);