Refine Korean translations, fix image paths, and update Quarto callouts

Author: partrita

mybook/_quarto.yml

@@ -2,33 +2,55 @@ project:
   type: book
 
 book:
-  title: "Python Programming for Data Science"
+  title: "데이터 과학을 위한 파이썬 프로그래밍"
   author: "Tomas Beuzen"
   repo-url: "https://github.com/TomasBeuzen/python-programming-for-data-science"
-  chapters:
-    - index.qmd
-    - part: "Chapters"
-      chapters:
-        - chapters/chapter1-basics.ipynb
-        - chapters/chapter2-loops-functions.ipynb
-        - chapters/chapter3-tests-classes.ipynb
-        - chapters/chapter4-style-scripts-imports.ipynb
-        - chapters/chapter5-numpy.ipynb
-        - chapters/chapter6-numpy-addendum.ipynb
-        - chapters/chapter7-pandas.ipynb
-        - chapters/chapter8-wrangling-basics.ipynb
-        - chapters/chapter9-wrangling-advanced.ipynb
-    - part: "Practice Exercises"
-      chapters:
-        - practice-exercises/chapter1-basics-practice.ipynb
-        - practice-exercises/chapter2-loops-functions-practice.ipynb
-        - practice-exercises/chapter3-tests-classes-practice.ipynb
-        - practice-exercises/chapter4-style-scripts-imports-practice.ipynb
-        - practice-exercises/chapter5-numpy-practice.ipynb
-        - practice-exercises/chapter7-pandas-practice.ipynb
-        - practice-exercises/chapter8-wrangling-basics-practice.ipynb
-        - practice-exercises/chapter9-wrangling-advanced-practice.ipynb
+  sidebar:
+    style: "floating"
+    search: true
+    contents:
+      - index.qmd
+      - part: "강의 본문"
+        chapters:
+          - text: "1장: 파이썬 기초"
+            file: chapters/chapter1-basics.ipynb
+          - text: "2장: 반복문과 함수"
+            file: chapters/chapter2-loops-functions.ipynb
+          - text: "3장: 단위 테스트와 클래스"
+            file: chapters/chapter3-tests-classes.ipynb
+          - text: "4장: 스타일 가이드, 스크립트, 임포트"
+            file: chapters/chapter4-style-scripts-imports.ipynb
+          - text: "5장: NumPy 기초"
+            file: chapters/chapter5-numpy.ipynb
+          - text: "6장: NumPy 추가 내용"
+            file: chapters/chapter6-numpy-addendum.ipynb
+          - text: "7장: Pandas 기초"
+            file: chapters/chapter7-pandas.ipynb
+          - text: "8장: 데이터 랭글링 기초"
+            file: chapters/chapter8-wrangling-basics.ipynb
+          - text: "9장: 데이터 랭글링 심화"
+            file: chapters/chapter9-wrangling-advanced.ipynb
+      - part: "연습 문제"
+        chapters:
+          - text: "1장 연습 문제"
+            file: practice-exercises/chapter1-basics-practice.ipynb
+          - text: "2장 연습 문제"
+            file: practice-exercises/chapter2-loops-functions-practice.ipynb
+          - text: "3장 연습 문제"
+            file: practice-exercises/chapter3-tests-classes-practice.ipynb
+          - text: "4장 연습 문제"
+            file: practice-exercises/chapter4-style-scripts-imports-practice.ipynb
+          - text: "5장 연습 문제"
+            file: practice-exercises/chapter5-numpy-practice.ipynb
+          - text: "7장 연습 문제"
+            file: practice-exercises/chapter7-pandas-practice.ipynb
+          - text: "8장 연습 문제"
+            file: practice-exercises/chapter8-wrangling-basics-practice.ipynb
+          - text: "9장 연습 문제"
+            file: practice-exercises/chapter9-wrangling-advanced-practice.ipynb
 
 format:
   html:
     theme: cosmo
+    number-sections: false
+    code-fold: true

mybook/chapters/chapter1-basics.ipynb

@@ -4,7 +4,7 @@
    "cell_type": "markdown",
    "metadata": {},
    "source": [
-    "![](../docs/banner.png)"
+    "![](../images/banner.png)"
    ]
   },
   {
@@ -20,17 +20,17 @@
     "toc": true
    },
    "source": [
-    "<h2>장 개요<span class=\"tocSkip\"></span></h2>\n",
-    "<시간>\n",
-    "<div class=\"toc\"><ul class=\"toc-item\"><li><span><a href=\"#1.-Introduction\" data-toc-modified-id=\"1.-Introduction-1\">1. 소개</a></span></li><li><span><a href=\"#2.-Basic-Python-Data-Types\" data-toc-modified-id=\"2.-Basic-Python-Data-Types-2\">2. 기본 Python 데이터 유형</a></span></li><li><span><a href=\"#3.-Lists-and-Tuples\" data-toc-modified-id=\"3.-Lists-and-Tuples-3\">3. 목록 및 튜플</a></span></li><li><span><a href=\"#4.-String-Methods\" data-toc-modified-id=\"4.-String-Methods-4\">4. 문자열 메소드</a></span></li><li><span><a href=\"#5.-Dictionaries\" data-toc-modified-id=\"5.-Dictionaries-5\">5. 사전</a></span></li><li><span><a href=\"#6.-Empties\" data-toc-modified-id=\"6.-Empties-6\">6. 비어 있음</a></span></li><li><span><a href=\"#7.-Conditionals\" data-toc-modified-id=\"7.-Conditionals-7\">7. 조건부</a></span></li></ul></div>"
+    "<h2>장 구성<span class=\"tocSkip\"></span></h2>\n",
+    "<hr>\n",
+    "<div class=\"toc\"><ul class=\"toc-item\"><li><span><a href=\"#1.-Introduction\" data-toc-modified-id=\"1.-Introduction-1\">1. 소개</a></span></li><li><span><a href=\"#2.-Basic-Python-Data-Types\" data-toc-modified-id=\"2.-Basic-Python-Data-Types-2\">2. 기본 파이썬 데이터 타입</a></span></li><li><span><a href=\"#3.-Lists-and-Tuples\" data-toc-modified-id=\"3.-Lists-and-Tuples-3\">3. 리스트와 튜플</a></span></li><li><span><a href=\"#4.-String-Methods\" data-toc-modified-id=\"4.-String-Methods-4\">4. 문자열 메서드</a></span></li><li><span><a href=\"#5.-Dictionaries\" data-toc-modified-id=\"5.-Dictionaries-5\">5. 딕셔너리</a></span></li><li><span><a href=\"#6.-Empties\" data-toc-modified-id=\"6.-Empties-6\">6. 빈 객체들</a></span></li><li><span><a href=\"#7.-Conditionals\" data-toc-modified-id=\"7.-Conditionals-7\">7. 조건문</a></span></li></ul></div>"
    ]
   },
   {
    "cell_type": "markdown",
    "metadata": {},
    "source": [
-    "## 장 학습 목표\n",
-    "<시간>"
+    "## 학습 목표\n",
+    "<hr>"
    ]
   },
   {
@@ -40,19 +40,19 @@
     "- `int`, `float`, `string`, `list`, `dict`, `tuple` 등과 같은 표준 Python 데이터 유형을 생성, 설명 및 구별합니다.\n",
     "- 숫자 값에 대해 `+`, `-`, `*`, `**`와 같은 산술 연산을 수행합니다.\n",
     "- `.lower()`, `.split()`과 같은 기본 문자열 작업을 수행하여 문자열을 조작합니다.\n",
-    "- 비교 연산자 연산(`==`, `!=`, `>` 등)과 부울 연산자(`and`, `or`, `not`)를 사용하여 부울 값을 계산합니다.\n",
+    "- 비교 연산자 연산(`==`, `!=`, `>` 등)과 부울 연산자(`and`, `or`, `not`)를 사용하여 불리언 값을 계산합니다.\n",
     "- 튜플, 목록, 문자열 및 사전에 값을 할당하고, 인덱스하고, 슬라이스하고, 부분 집합을 만듭니다.\n",
     "- `if`, `elif`, `else`를 사용하여 조건문을 작성합니다.\n",
     "- 들여쓰기 수준에 따라 코드 블록을 식별합니다.\n",
-    "- `list`와 같은 변경 가능한 객체와 `tuple`과 같은 변경 불가능한 객체의 차이점을 설명하세요."
+    "- `list`와 같은 가변(mutable) 객체와 `tuple`과 같은 불변(immutable) 객체의 차이점을 설명하세요."
    ]
   },
   {
    "cell_type": "markdown",
    "metadata": {},
    "source": [
     "## 1. 소개\n",
-    "<시간>"
+    "<hr>"
    ]
   },
   {
@@ -70,8 +70,8 @@
    "cell_type": "markdown",
    "metadata": {},
    "source": [
-    "## 2. 기본 Python 데이터 유형\n",
-    "<시간>"
+    "## 2. 기본 파이썬 데이터 타입\n",
+    "<hr>"
    ]
   },
   {
@@ -86,9 +86,9 @@
     "\n",
     "다음에서 수정된 이미지: [medium.com](https://www.google.com/url?sa=i&url=https%3A%2F%2Fmedium.com%2F%40stevenpcurtis.sc%2Fwhat-is-a-variable-3447ac133 1b9&psig=AOvVaw3YbYfgb7XFOJ_sHP5eliob&ust=1595365663851000&source=images&cd=vfe&ved=0CA0QjhxqFwoTCMi8nrfe3OoCFQAAAAAdAAAAABAZ)\n",
     "\n",
-    "``{팁}\n",
-    "표준 내장 Python 데이터 유형에 대한 요약은 [Python 3 문서](https://docs.python.org/3/library/stdtypes.html)를 참조하세요.\n",
-    "````"
+    "::: {.callout-tip}\n",
+    "표준 내장 파이썬 데이터 타입에 대한 요약은 [파이썬 3 문서](https://docs.python.org/3/library/stdtypes.html)를 참고하세요.\n",
+    ":::"
    ]
   },
   {
@@ -101,7 +101,7 @@
     "| :--------- | :--------- | :--------------- | :------------------------------- | :---------------------------- |\n",
     "| 정수 | `정수` | 숫자 유형 | 양수/음수 정수 | `42` |\n",
     "| 부동 소수점 수 | `플로트` | 숫자 유형 | 십진수 형식의 실수 | `3.14159` |\n",
-    "| 부울 | `부울` | 부울 값 | 참 또는 거짓 | '사실' |\n",
+    "| 부울 | `부울` | 불리언 값 | 참 또는 거짓 | '사실' |\n",
     "| 문자열 | `str` | 시퀀스 유형 | 텍스트 | ``치즈버거를 먹을 수 있나요?'' |\n",
     "| 목록 | `목록` | 시퀀스 유형 | 개체 모음 - 변경 가능하고 순서가 지정됨 | `['알리', '신이', '미리암']` |\n",
     "| 튜플 | `튜플` | 시퀀스 유형 | 개체 모음 - 불변 및 순서 | `('목요일', 2018년 6월 9일)` |\n",
@@ -252,7 +252,7 @@
     "|   `*` |  곱셈 |\n",
     "|   `/` |     부문 |\n",
     "|   `**` |  지수 |\n",
-    "|   `//` | 정수 나누기/바닥 나누기 |\n",
+    "|   `//` | 정수 나눗셈(내림 나눗셈) |\n",
     "|   `%` |      모듈로 |\n",
     "\n",
     "이러한 연산자를 숫자 유형에 적용하고 결과를 관찰해 보겠습니다."
@@ -590,9 +590,9 @@
     "\n",
     "텍스트는 '문자열'이라는 데이터 유형으로 저장됩니다. 문자열은 일련의 문자로 생각할 수 있습니다. \n",
     "\n",
-    "``{팁}\n",
+    "::: {.callout-tip}\n",
     "실제로 이는 일련의 유니코드 코드 포인트입니다. 관심이 있으시면 유니코드에 대한 [훌륭한 블로그 게시물](https://www.joelonsoftware.com/2003/10/08/the-absolute-minimum-every-software-developer-absolutely- positively-must-know-about-unicode-and-character-sets-no-excuses/)을 참조하세요.\n",
-    "````\n",
+    ":::\n",
     "\n",
     "문자열은 다음 중 하나로 묶인 문자로 작성됩니다.\n",
     "  - 작은따옴표(예: `'Hello'`) \n",
@@ -1189,9 +1189,9 @@
    "cell_type": "markdown",
    "metadata": {},
    "source": [
-    "``{참고}\n",
+    "::: {.callout-note}\n",
     "Python에는 `&` 및 `|`와 같은 [비트 연산자](https://wiki.python.org/moin/BitwiseOperators)도 있습니다. 비트 연산자는 문자 그대로 두 정수의 비트를 비교합니다. 이는 이 과정의 범위를 벗어나지만 실제로 작동하는 모습을 보여주기 위해 아래에 코드 조각을 포함시켰습니다.\n",
-    "````"
+    ":::"
    ]
   },
   {
@@ -1403,7 +1403,7 @@
    "metadata": {},
    "source": [
     "## 3. 리스트와 튜플\n",
-    "<시간>"
+    "<hr>"
    ]
   },
   {
@@ -2345,8 +2345,8 @@
    "cell_type": "markdown",
    "metadata": {},
    "source": [
-    "## 4. 문자열 메소드\n",
-    "<시간>"
+    "## 4. 문자열 메서드\n",
+    "<hr>"
    ]
   },
   {
@@ -2632,8 +2632,8 @@
    "cell_type": "markdown",
    "metadata": {},
    "source": [
-    "## 5. 사전\n",
-    "<시간>"
+    "## 5. 딕셔너리\n",
+    "<hr>"
    ]
   },
   {
@@ -3110,8 +3110,8 @@
    "cell_type": "markdown",
    "metadata": {},
    "source": [
-    "## 7. 조건부\n",
-    "<시간>"
+    "## 7. 조건문\n",
+    "<hr>"
    ]
   },
   {
@@ -3288,9 +3288,9 @@
     "- `True` 값: `False` 값을 갖는 `bool` 객체이거나 `len()` == 0을 갖지 않는 한 모든 객체는 `True`를 반환합니다.\n",
     "- `False` 값: `None`, `False`, `0`, 빈 시퀀스 및 컬렉션: `''`, `()`, `[]`, `{}`, `set()`\n",
     "\n",
-    "``{팁}\n",
+    "::: {.callout-tip}\n",
     "[여기 문서](https://docs.python.org/3/library/stdtypes.html#truth-value-testing)에서 자세히 알아보세요.\n",
-    "````"
+    ":::"
    ]
   },
   {

mybook/chapters/chapter2-loops-functions.ipynb

@@ -4,7 +4,7 @@
    "cell_type": "markdown",
    "metadata": {},
    "source": [
-    "![](../docs/banner.png)"
+    "![](../images/banner.png)"
    ]
   },
   {
@@ -20,17 +20,17 @@
     "toc": true
    },
    "source": [
-    "<h2>장 개요<span class=\"tocSkip\"></span></h2>\n",
-    "<시간>\n",
+    "<h2>장 구성<span class=\"tocSkip\"></span></h2>\n",
+    "<hr>\n",
     "<div class=\"toc\"><ul class=\"toc-item\"><li><span><a href=\"#1.-for-Loops\" data-toc-modified-id=\"1.-for-Loops-1\">1. <code>for</code> 루프</a></span></li><li><span><a href=\"#2.-while-loops\" data-toc-modified-id=\"2.-while-loops-2\">2. <code>while</code> 루프</a></span></li><li><span><a href=\"#3.-Comprehensions\" data-toc-modified-id=\"3.-Comprehensions-3\">3. 이해</a></span></li><li><span><a href=\"#4.-try-/-excess\" data-toc-modified-id=\"4.-try-/-just-4\">4. <code>시도</code> / <code>제외</code></a></span></li><li><span><a href=\"#5.-Functions\" data-toc-modified-id=\"5.-Functions-5\">5. 함수</a></span></li><li><span><a href=\"#6.-Functions-as--a-data-type\" data-toc-modified-id=\"6.-Functions-as--a-data-type-6\">6. 데이터 유형으로서의 기능</a></span></li><li><span><a href=\"#7.-Anonymous-functions\" data-toc-modified-id=\"7.-Anonymous-functions-7\">7. 익명 함수</a></span></li><li><span><a href=\"#8.-DRY-principle,-designing-good-functions\" data-toc-modified-id=\"8.-DRY-principle,-designing-good-functions-8\">8. DRY 원칙, 좋은 기능 설계</a></span></li><li><span><a href=\"#9.-Generators\" data-toc-modified-id=\"9.-Generators-9\">9. 생성기</a></span></li><li><span><a href=\"#10.-Docstrings\" data-toc-modified-id=\"10.-Docstrings-10\">10. 독스트링</a></span></li></ul></div>"
    ]
   },
   {
    "cell_type": "markdown",
    "metadata": {},
    "source": [
-    "## 장 학습 목표\n",
-    "<시간>"
+    "## 학습 목표\n",
+    "<hr>"
    ]
   },
   {
@@ -54,7 +54,7 @@
    "metadata": {},
    "source": [
     "## 1. `for` 루프\n",
-    "<시간>"
+    "<hr>"
    ]
   },
   {
@@ -455,7 +455,7 @@
    "metadata": {},
    "source": [
     "## 2. `while` 루프\n",
-    "<시간>"
+    "<hr>"
    ]
   },
   {
@@ -632,7 +632,7 @@
    "metadata": {},
    "source": [
     "## 3. 이해\n",
-    "<시간>"
+    "<hr>"
    ]
   },
   {
@@ -866,7 +866,7 @@
    "metadata": {},
    "source": [
     "## 4. `시도` / `제외`\n",
-    "<시간>"
+    "<hr>"
    ]
   },
   {
@@ -1262,7 +1262,7 @@
    "metadata": {},
    "source": [
     "## 5. 기능\n",
-    "<시간>"
+    "<hr>"
    ]
   },
   {
@@ -2126,7 +2126,7 @@
    "metadata": {},
    "source": [
     "## 6. 데이터 유형으로서의 기능\n",
-    "<시간>"
+    "<hr>"
    ]
   },
   {
@@ -2242,7 +2242,7 @@
    "metadata": {},
    "source": [
     "## 7. 익명 함수\n",
-    "<시간>"
+    "<hr>"
    ]
   },
   {
@@ -2381,7 +2381,7 @@
    "metadata": {},
    "source": [
     "## 8. DRY 원칙, 좋은 기능을 디자인하다\n",
-    "<시간>"
+    "<hr>"
    ]
   },
   {
@@ -2676,7 +2676,7 @@
    "metadata": {},
    "source": [
     "## 9. 발전기\n",
-    "<시간>"
+    "<hr>"
    ]
   },
   {
@@ -3117,7 +3117,7 @@
    "metadata": {},
    "source": [
     "## 1. 소개\n",
-    "<시간>"
+    "<hr>"
    ]
   },
   {