Add korean documents

.vuepress/configs/navbar/index.ts

@@ -6,3 +6,4 @@ export * from './ja.js';
 export * from './pt-BR.js';
 export * from './ru.js';
 export * from './zh-CN.js';
+export * from './ko.js';

.vuepress/configs/navbar/ko.ts

@@ -0,0 +1,8 @@
+import type { NavbarConfig } from '@vuepress/theme-default';
+
+export const navbarKo: NavbarConfig = [
+  { text: '문서', link: '/ko/book/' },
+  // { text: "Contributor Book", link: "/contributor-book/" },
+  { text: 'Cookbook', link: '/cookbook/' },
+  { text: '블로그', link: '/blog/' },
+];

.vuepress/configs/sidebar/index.ts

@@ -6,3 +6,4 @@ export * from './ja.js';
 export * from './pt-BR.js';
 export * from './ru.js';
 export * from './zh-CN.js';
+export * from './ko.js';

.vuepress/configs/sidebar/ko.ts

@@ -0,0 +1,76 @@
+import type { SidebarConfig } from '@vuepress/theme-default';
+import type { commandCategories } from './command_categories';
+
+export const sidebarKo: SidebarConfig = {
+  '/ko/book/': [
+    {
+      text: '소개',
+      link: '/ko/book/README.md',
+      collapsible: false,
+    },
+    {
+      text: '시작하기',
+      link: '/ko/book/getting_started.md',
+      collapsible: false,
+      children: [
+        '/ko/book/installation',
+        '/ko/book/moving_around',
+        '/ko/book/thinking_in_nushell',
+      ],
+    },
+    {
+      text: 'Nu 기본',
+      link: '/ko/book/nu_fundamentals.md',
+      collapsible: false,
+      children: [
+        '/ko/book/types_of_data',
+        '/ko/book/loading_data',
+        '/ko/book/pipeline.md',
+        '/ko/book/working_with_strings',
+        '/ko/book/working_with_lists',
+        '/ko/book/working_with_tables',
+      ],
+    },
+    {
+      text: 'Nu에서 프로그래밍하기',
+      link: '/ko/book/programming_in_nu.md',
+      collapsible: false,
+      children: [
+        '/ko/book/custom_commands',
+        '/ko/book/aliases',
+        '/ko/book/operators',
+        '/ko/book/variables_and_subexpressions.md',
+        '/ko/book/scripts',
+        '/ko/book/overlays',
+        '/ko/book/command_signature',
+      ],
+    },
+    {
+      text: '셸로서의 Nu',
+      link: '/ko/book/nu_as_a_shell.md',
+      collapsible: false,
+      children: [
+        '/ko/book/configuration',
+        '/ko/book/environment',
+        '/ko/book/escaping',
+        '/ko/book/3rdpartyprompts',
+        '/ko/book/custom_completions',
+        '/ko/book/coloring_and_theming',
+        '/ko/book/hooks',
+        '/ko/book/background_jobs.md',
+      ],
+    },
+    {
+      text: 'Nu로 전환하기',
+      link: '/ko/book/coming_to_nu.md',
+      collapsible: false,
+      children: ['/ko/book/coming_from_bash', '/ko/book/command_reference'],
+    },
+    {
+      text: '(단지) 고급 사용자를 위한 것은 아닙니다',
+      link: '/ko/book/advanced.md',
+      collapsible: false,
+      children: ['/ko/book/plugins', '/ko/book/metadata.md'],
+    },
+  ],
+};

ko/README.md

@@ -0,0 +1,51 @@
+---
+home: true
+heroImage: null
+heroText: Nushell
+tagline: 새로운 종류의 셸
+actionText: 시작하기 →
+actionLink: /ko/book/
+features:
+  - title: 모든 OS를 제어하는 파이프라인
+    details: Nu는 Linux, macOS, Windows에서 작동합니다. 한 번 배우면 어디서든 사용할 수 있습니다.
+  - title: 어디서나 구조화된 데이터
+    details: Nu의 파이프라인은 쉽게 선택하고, 필터링하고, 정렬할 수 있는 구조화된 데이터를 사용합니다. 더 이상 문자열을 파싱하지 않고 바로 문제 해결을 시작하세요.
+  - title: 강력한 플러그인
+    details: Nu는 강력한 플러그인 시스템 덕분에 쉽게 확장할 수 있습니다.
+---
+
+<img src="https://www.nushell.sh/frontpage/ls-example.png" alt="ls 명령어 사용법을 보여주는 스크린샷" class="hero"/>
+
+### Nu는 기존 데이터와 함께 작동합니다
+
+Nu는 [JSON, YAML, XML, Excel 등](/book/loading_data.md)을 이해합니다. 파일, 데이터베이스 또는 웹 API에 있든 상관없이 Nu 파이프라인으로 데이터를 가져오는 것은 쉽습니다.
+
+<img src="https://www.nushell.sh/frontpage/fetch-example.png" alt="웹 API에서 데이터를 로드하는 것을 보여주는 스크린샷" class="hero"/>
+
+### Nu는 훌륭한 오류 메시지를 제공합니다
+
+Nu는 형식화된 데이터로 작업하므로 다른 셸이 감지하지 못하는 오류를 포착합니다. 그리고 문제가 발생하면 어디서 왜 발생했는지 정확히 알려줍니다.
+
+<img src="https://www.nushell.sh/frontpage/miette-example.png" alt="Nu가 유형 오류를 포착할 때 오류 메시지를 보여주는 스크린샷" class="hero"/>
+
+## Nu 설치
+
+Nushell은 [컴파일된 프로그램](https://github.com/nushell/nushell/releases), [패키지 관리자](https://repology.org/project/nushell/versions) 및 [소스 코드](https://github.com/nushell/nushell)로 제공됩니다. 자세한 설치 지침은 [여기](/ko/book/installation.md)에서 찾을 수 있습니다. 또는 바로 시작하세요.
+
+#### macOS / Linux:
+
+```sh
+$ brew install nushell
+```
+
+#### Windows:
+
+```powershell
+winget install nushell
+```
+
+## 커뮤니티
+
+궁금한 점이 있으면 (영문) [Discord 서버](https://discord.gg/NtAbbGn)에 참여하세요. Nu를 처음 접하든 아니든 기꺼이 도와줄 사람들이 많이 있습니다.
+
+[피드백](https://github.com/nushell/nushell.github.io/issues)이나 [풀 리퀘스트](https://github.com/nushell/nushell.github.io/pulls)를 통해 이 페이지를 개선하는 데 기여해주세요.

ko/book/3rdpartyprompts.md

@@ -0,0 +1,99 @@
+# 타사 프롬프트 구성 방법
+
+## 너드 글꼴
+
+너드 글꼴은 필수는 아니지만 추가 글리프와 아이코노그래피를 통해 프롬프트 표현을 개선할 수 있습니다.
+
+> 너드 글꼴은 많은 수의 글리프(아이콘)로 개발자 대상 글꼴을 패치합니다.
+> 특히 Font Awesome, Devicons, Octicons 등과 같은 인기 있는 '상징적 글꼴'에서 많은 추가 글리프를 추가합니다.
+
+* [너드 글꼴 웹사이트](https://www.nerdfonts.com)
+* [소스 저장소](https://github.com/ryanoasis/nerd-fonts)
+
+## oh-my-posh
+
+[사이트](https://ohmyposh.dev/)
+
+[저장소](https://github.com/JanDeDobbeleer/oh-my-posh)
+
+[oh-my-posh](https://ohmyposh.dev/)를 좋아한다면 몇 단계만 거치면 누셸에서 oh-my-posh를 사용할 수 있습니다. 누셸과 잘 작동합니다. 누셸과 함께 oh-my-posh를 설정하는 방법:
+
+1. [가이드](https://ohmyposh.dev/docs/installation/linux)에 따라 Oh My Posh를 설치하고 oh-my-posh의 테마를 다운로드합니다.
+2. [너드 글꼴](https://github.com/ryanoasis/nerd-fonts)을 다운로드하여 설치합니다.
+3. .oh-my-posh.nu 파일을 생성합니다. 기본적으로 홈 디렉터리에 생성됩니다. `--config`를 사용하여 테마를 지정할 수 있으며, 그렇지 않으면 oh-my-posh에 기본 테마가 제공됩니다.
+4. ~/.config/nushell/config.nu(또는 `$nu.config-path`의 경로 출력)에 추가하여 oh-my-posh 프롬프트를 초기화하여 ~/.oh-my-posh.nu를 소스로 사용합니다.
+
+```nu
+# .oh-my-posh.nu 파일 생성
+oh-my-posh init nu --config ~/.poshthemes/M365Princess.omp.json
+
+# config.nu 파일에 이 줄을 추가하여 셸 시작 시 oh-my-posh.nu를 초기화합니다.
+source ~/.oh-my-posh.nu
+```
+
+MacOS 사용자의 경우:
+
+1. `brew`를 사용하여 oh-my-posh를 설치할 수 있습니다. [여기 가이드](https://ohmyposh.dev/docs/installation/macos)를 따르십시오.
+2. [너드 글꼴](https://github.com/ryanoasis/nerd-fonts)을 다운로드하여 설치합니다.
+3. `$nu.config-path`에서 출력한 파일에 PROMPT_COMMAND를 설정합니다. 다음은 코드 스니펫입니다.
+
+```nu
+let posh_dir = (brew --prefix oh-my-posh | str trim)
+let posh_theme = $'($posh_dir)/share/oh-my-posh/themes/'
+# 테마 이름을 zash/space/robbyrussel/powerline/powerlevel10k_lean/
+# material/half-life/lambda 또는 이중 라인 테마: amro/pure/spaceship 등으로 변경합니다.
+# 자세한 내용은 [테마 데모](https://ohmyposh.dev/docs/themes)를 참조하십시오.
+$env.PROMPT_COMMAND = { || oh-my-posh prompt print primary --config $'($posh_theme)/zash.omp.json' }
+# 선택 사항
+$env.PROMPT_INDICATOR = $"(ansi y)$> (ansi reset)"
+```
+
+## Starship
+
+[사이트](https://starship.rs/)
+
+[저장소](https://github.com/starship/starship)
+
+1. 위의 링크를 따라 Starship을 설치합니다.
+2. 기본 설정에 따라 너드 글꼴을 설치합니다.
+3. 아래의 구성 예를 사용합니다. `STARSHIP_SHELL` 환경 변수를 설정해야 합니다.
+
+::: tip
+Starship을 활성화하는 다른 방법은 [Starship 빠른 설치](https://starship.rs/#nushell) 지침에 설명되어 있습니다.
+
+위의 링크는 Starship과 누셸의 공식 통합이며 수동으로 아무것도 하지 않고 Starship을 실행하는 가장 간단한 방법입니다.
+
+- Starship은 자체 구성/환경 설정 스크립트를 만듭니다.
+- `env.nu`에서 만들고 `config.nu`에서 `use`하기만 하면 됩니다.
+  :::
+
+다음은 Starship의 구성 섹션 예입니다.
+
+```nu
+$env.STARSHIP_SHELL = "nu"
+
+def create_left_prompt [] {
+    starship prompt --cmd-duration $env.CMD_DURATION_MS $'--status=($env.LAST_EXIT_CODE)'
+}
+
+# nushell 함수를 사용하여 오른쪽 및 왼쪽 프롬프트를 정의합니다.
+$env.PROMPT_COMMAND = { || create_left_prompt }
+$env.PROMPT_COMMAND_RIGHT = ""
+
+# 프롬프트 표시기는 프롬프트의 상태를 나타내는 환경 변수입니다.
+$env.PROMPT_INDICATOR = ""
+$env.PROMPT_INDICATOR_VI_INSERT = ": "
+$env.PROMPT_INDICATOR_VI_NORMAL = "〉"
+$env.PROMPT_MULTILINE_INDICATOR = "::: "
+```
+
+이제 Nu를 다시 시작하십시오.
+
+```
+nushell on 📙 main is 📦 v0.60.0 via 🦀 v1.59.0
+❯
+```
+
+## Purs
+
+[저장소](https://github.com/xcambar/purs)

ko/book/README.md

@@ -0,0 +1,64 @@
+# 소개
+
+안녕하세요, 누셸 프로젝트에 오신 것을 환영합니다.
+이 프로젝트의 목표는 파이프가 간단한 명령을 함께 연결하는 셸의 유닉스 철학을 현대적인 개발 스타일에 도입하는 것입니다.
+따라서 누셸은 셸이나 프로그래밍 언어 중 하나가 아니라 풍부한 프로그래밍 언어와 모든 기능을 갖춘 셸을 하나의 패키지로 결합하여 둘 다를 연결합니다.
+
+Nu는 bash와 같은 전통적인 셸, PowerShell과 같은 개체 기반 셸, TypeScript와 같은 점진적으로 유형이 지정된 언어, 함수형 프로그래밍, 시스템 프로그래밍 등 많은 익숙한 영역에서 단서를 얻습니다. 그러나 모든 거래의 잭이 되려고 하기보다는 Nu는 몇 가지 일을 잘하는 데 에너지를 집중합니다.
+
+- 현대적인 느낌의 유연한 크로스 플랫폼 셸
+- 데이터 구조와 함께 작동하는 최신 프로그래밍 언어로서 문제 해결
+- 명확한 오류 메시지와 깔끔한 IDE 지원 제공
+
+## 이 책
+
+이 책은 여러 장으로 나뉘며, 각 장은 다시 여러 섹션으로 나뉩니다.
+자세한 내용은 장 머리글을 클릭하면 볼 수 있습니다.
+
+- [설치](installation.md)는 물론 시스템에 누셸을 설치하는 데 도움이 됩니다.
+- [시작하기](getting_started.md)는 요령을 보여줍니다. 또한 누셸이 Bash와 같은 일반적인 셸과 다른 설계 원칙 중 일부를 설명합니다.
+- [Nu 기본 사항](nu_fundamentals.md)은 누셸 언어의 기본 개념을 설명합니다.
+- [Nu로 프로그래밍하기](programming_in_nu.md)는 언어 기능을 더 깊이 파고들어 코드를 구성하고 구조화하는 여러 가지 방법을 보여줍니다.
+- [셸로서의 Nu](nu_as_a_shell.md)는 셸 기능, 특히 구성 및 환경에 중점을 둡니다.
+- [Nu 시작하기](coming_to_nu.md)는 다른 셸이나 언어에서 온 사용자를 위한 빠른 시작을 제공하기 위한 것입니다.
+- [설계 노트](design_notes.md)에는 누셸의 설계 선택 사항 중 일부에 대한 심층적인 설명이 있습니다.
+- [(그렇게) 고급이 아닌](advanced.md)에는 몇 가지 더 고급 항목이 포함되어 있습니다(그렇게 고급은 아니므로 꼭 확인하십시오!).
+
+## 누셸의 여러 부분
+
+누셸 프로젝트는 여러 다른 저장소와 하위 프로젝트로 구성됩니다.
+[GitHub의 우리 조직](https://github.com/nushell)에서 모두 찾을 수 있습니다.
+
+- 기본 누셸 저장소는 [여기](https://github.com/nushell/nushell)에서 찾을 수 있습니다. 원하는 경우 자신의 프로젝트에서 독립적인 라이브러리로 사용할 수 있는 여러 크레이트로 나뉩니다.
+- 이 책을 포함한 [nushell.sh](https://www.nushell.sh) 페이지의 저장소는 [여기](https://github.com/nushell/nushell.github.io)에서 찾을 수 있습니다.
+- 누셸에는 [자체 저장소가 있는](https://github.com/nushell/reedline) 자체 줄 편집기가 있습니다.
+- [`nu_scripts`](https://github.com/nushell/nu_scripts)는 일종의 패키지 관리자가 생길 때까지 다른 사용자와 스크립트 및 모듈을 공유하는 곳입니다.
+- [Nana](https://github.com/nushell/nana)는 누셸의 그래픽 사용자 인터페이스를 탐색하기 위한 실험적인 노력입니다.
+- [Awesome Nu](https://github.com/nushell/awesome-nu)에는 누셸 생태계와 함께 작동하는 도구 목록이 포함되어 있습니다: 플러그인, 스크립트, 편집기 확장, 타사 통합 등.
+- [Nu Showcase](https://github.com/nushell/showcase)는 블로그, 아트워크 또는 기타 무엇이든 누셸에 대한 작업을 공유하는 곳입니다.
+- [의견 요청(RFC)](https://github.com/nushell/rfcs)는 주요 설계 변경 사항을 제안하고 논의하는 장소 역할을 합니다. 현재는 활용도가 낮지만 1.0에 가까워지고 그 이상이 되면 더 많이 사용할 것으로 예상됩니다.
+
+## 기여
+
+기여를 환영합니다!
+[보시다시피](#the-many-parts-of-nushell) 기여할 곳이 많습니다.
+대부분의 저장소에는 시작하는 데 도움이 되는 팁과 세부 정보가 포함된 `CONTRIBUTING.md` 파일이 있습니다(그렇지 않은 경우 수정을 기여하는 것을 고려하십시오!).
+
+누셸 자체는 [Rust](https://www.rust-lang.org)로 작성되었습니다.
+그러나 도움을 주기 위해 Rust 프로그래머가 될 필요는 없습니다.
+웹 개발을 알고 있다면 이 웹사이트나 Nana 프로젝트를 개선하는 데 기여할 수 있습니다.
+[데이터프레임](dataframes.md)은 데이터 처리 전문 지식을 사용할 수 있습니다.
+
+멋진 스크립트, 플러그인을 작성했거나 누셸을 어딘가에 통합했다면 `nu_scripts` 또는 Awesome Nu에 대한 기여를 환영합니다.
+재현 단계가 있는 버그를 발견하고 이에 대한 GitHub 문제를 제출하는 것도 귀중한 도움이 됩니다!
+누셸을 사용하는 것만으로도 누셸에 기여할 수 있습니다!
+
+누셸은 빠르게 발전하므로 이 책은 지속적으로 업데이트해야 합니다.
+이 책에 기여하는 데는 마크다운에 대한 기본적인 지식 외에 특별한 기술이 필요하지 않습니다.
+또한 일부를 귀하의 언어로 번역하는 것을 고려할 수 있습니다.
+
+## 커뮤니티
+
+누셸에 대해 논의할 수 있는 주요 장소는 [Discord](https://discord.com/invite/NtAbbGn)입니다.
+뉴스 및 업데이트는 [블로그](https://www.nushell.sh/blog)를 팔로우할 수도 있습니다.
+마지막으로 GitHub 토론을 사용하거나 GitHub 문제를 제출할 수 있습니다.

ko/book/advanced.md

@@ -0,0 +1,28 @@
+---
+prev:
+  text: 누셸 코드가 실행되는 방법
+  link: /book/how_nushell_code_gets_run.md
+next:
+  text: 표준 라이브러리 (미리보기)
+  link: /book/standard_library.md
+---
+# (그렇게) 고급은 아님
+
+"고급"이라는 제목이 부담스러워 이 장을 건너뛰고 싶을 수도 있지만, 사실 가장 흥미롭고 강력한 기능 중 일부는 여기에서 찾을 수 있습니다.
+
+내장 명령어 외에도 누셸에는 [표준 라이브러리](standard_library.md)가 있습니다.
+
+누셸은 _구조화된 데이터_에서 작동합니다.
+누셸은 "데이터 우선" 셸이자 프로그래밍 언어라고 말할 수 있습니다.
+데이터 중심 방향을 더 탐색하기 위해 누셸은 백엔드로 [Polars](https://github.com/pola-rs/polars)를 사용하는 모든 기능을 갖춘 데이터프레임 처리 엔진을 포함합니다.
+셸에서 직접 대용량 데이터를 효율적으로 처리하려면 [데이터프레임 설명서](dataframes.md)를 확인하십시오.
+
+누셸의 값에는 몇 가지 추가 [메타데이터](metadata.md)가 포함되어 있습니다.
+이 메타데이터는 예를 들어 [사용자 지정 오류를 만드는 데](creating_errors.md) 사용할 수 있습니다.
+
+누셸의 엄격한 범위 지정 규칙 덕분에 [컬렉션을 병렬로 반복](parallelism.md)하기가 매우 쉬워 몇 글자만 입력하여 오래 실행되는 스크립트의 속도를 높이는 데 도움이 될 수 있습니다.
+
+[`explore`](/commands/docs/explore.md) 명령을 사용하여 [대화형으로 데이터를 탐색](explore.md)할 수 있습니다.
+
+마지막으로 [플러그인](plugins.md)으로 누셸의 기능을 확장할 수 있습니다.
+누셸이 이해하는 프로토콜로 누셸과 통신하는 한 거의 모든 것이 플러그인이 될 수 있습니다.