Skip to content

Commit 19c1be0

Browse files
partritaImgBotAppgoogle-labs-jules[bot]deepthought
authored
Add korean documents (#2001)
* [ImgBot] Optimize images *Total -- 4,038.39kb -> 3,965.60kb (1.8%) /assets/images/logo-contest/font-logo.png -- 19.74kb -> 10.68kb (45.92%) /assets/images/0_84_table_padding.png -- 16.98kb -> 9.83kb (42.1%) /assets/images/0_84_table_compact.png -- 8.54kb -> 5.25kb (38.43%) /assets/images/bday_4_grid.png -- 16.49kb -> 10.37kb (37.12%) /assets/images/bday_4_hex_colours.png -- 4.59kb -> 3.39kb (26.12%) /.vuepress/public/icon.png -- 0.83kb -> 0.65kb (21.84%) /assets/images/0_60_0_completions_external.gif -- 7.15kb -> 6.52kb (8.84%) /assets/images/0_92_0_binary_data_explore.png -- 180.96kb -> 167.02kb (7.71%) /assets/images/open_cargo.png -- 10.76kb -> 10.07kb (6.39%) /assets/images/logo-contest/JustinGarrison/mascot.png -- 34.95kb -> 32.84kb (6.02%) /assets/images/0_60_0_completions_internal.gif -- 12.42kb -> 11.85kb (4.63%) /assets/images/eq_git_branch_completion.gif -- 31.04kb -> 29.67kb (4.41%) /assets/images/0_60_0_history.gif -- 31.30kb -> 30.08kb (3.89%) /assets/images/logo-contest/JustinGarrison/logo.png -- 19.88kb -> 19.44kb (2.19%) /assets/images/nushell-autocomplete4.gif -- 684.58kb -> 671.33kb (1.93%) /assets/images/0_60_0_history_complete.gif -- 64.60kb -> 64.06kb (0.84%) /assets/images/logo-contest/shell-mascot.png -- 999.68kb -> 992.88kb (0.68%) /assets/images/0_60_completions.gif -- 490.33kb -> 488.04kb (0.47%) /assets/images/0_4_0_streaming_table.gif -- 269.12kb -> 268.46kb (0.24%) /assets/images/0_22_flatten.gif -- 152.10kb -> 151.91kb (0.13%) /assets/images/0_19_autocomplete.gif -- 713.78kb -> 712.90kb (0.12%) /assets/images/0_21_bar_charts.gif -- 242.89kb -> 242.67kb (0.09%) /assets/images/bday_4_subcommand_help.png -- 25.69kb -> 25.68kb (0.04%) Signed-off-by: ImgBotApp <ImgBotHelp@gmail.com> * Add Korean translation files and configuration * ko/book 폴더의 모든 마크다운 파일을 한국어로 번역했습니다. * ko/book 폴더의 나머지 마크다운 파일을 한국어로 번역해 드릴게요. * ko/book 폴더의 나머지 마크다운 파일을 한국어로 번역하겠습니다. * lint markdown file to fix CI error * Fix unclosed tag error Which is caused from `:::` in markdown files. I need to fix it orginal file in `book` directory to escape from error. * Revert "[ImgBot] Optimize images" * Add Korean translations and update links in documentation --------- Signed-off-by: ImgBotApp <ImgBotHelp@gmail.com> Co-authored-by: ImgBotApp <ImgBotHelp@gmail.com> Co-authored-by: google-labs-jules[bot] <161369871+google-labs-jules[bot]@users.noreply.github.com> Co-authored-by: deepthought <deepthough@postech.ac.kr>
1 parent e1e013e commit 19c1be0

Some content is hidden

Large Commits have some content hidden by default. Use the searchbox below for content that may be hidden.

74 files changed

+15574
-62
lines changed

.vuepress/config.js

Lines changed: 14 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -20,6 +20,7 @@ import {
2020
navbarPtBR,
2121
navbarRU,
2222
navbarZhCN,
23+
navbarKo,
2324
sidebarDe,
2425
sidebarEn,
2526
sidebarFr,
@@ -28,6 +29,7 @@ import {
2829
sidebarPtBR,
2930
sidebarRU,
3031
sidebarZhCN,
32+
sidebarKo,
3133
} from './configs/index.js';
3234

3335
const compareDate = (dateA, dateB) => {
@@ -88,6 +90,11 @@ export default defineUserConfig({
8890
title: 'Nushell',
8991
description: 'Новый тип оболочки.',
9092
},
93+
'/ko/': {
94+
lang: 'ko-KR',
95+
title: 'Nushell',
96+
description: '새로운 유형의 셸',
97+
},
9198
},
9299
head: [
93100
[
@@ -185,6 +192,13 @@ export default defineUserConfig({
185192
navbar: navbarZhCN,
186193
sidebar: sidebarZhCN,
187194
},
195+
'/ko/': {
196+
selectText: '언어',
197+
selectLanguageName: '한국어',
198+
editLinkText: 'GitHub에서 수정하기',
199+
navbar: navbarKo,
200+
sidebar: sidebarKo,
201+
},
188202
},
189203
themePlugins: {
190204
prismjs: false,

.vuepress/configs/navbar/index.ts

Lines changed: 1 addition & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -6,3 +6,4 @@ export * from './ja.js';
66
export * from './pt-BR.js';
77
export * from './ru.js';
88
export * from './zh-CN.js';
9+
export * from './ko.js';

.vuepress/configs/navbar/ko.ts

Lines changed: 8 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,8 @@
1+
import type { NavbarConfig } from '@vuepress/theme-default';
2+
3+
export const navbarKo: NavbarConfig = [
4+
{ text: '문서', link: '/ko/book/' },
5+
// { text: "Contributor Book", link: "/contributor-book/" },
6+
{ text: '쿡북', link: '/cookbook/' },
7+
{ text: '블로그', link: '/blog/' },
8+
];

.vuepress/configs/sidebar/index.ts

Lines changed: 1 addition & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -6,3 +6,4 @@ export * from './ja.js';
66
export * from './pt-BR.js';
77
export * from './ru.js';
88
export * from './zh-CN.js';
9+
export * from './ko.js';

.vuepress/configs/sidebar/ko.ts

Lines changed: 123 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,123 @@
1+
import type { SidebarConfig } from '@vuepress/theme-default';
2+
import type { commandCategories } from './command_categories';
3+
4+
export const sidebarKo: SidebarConfig = {
5+
'/ko/book/': [
6+
{
7+
text: '소개',
8+
link: '/ko/book/README.md',
9+
collapsible: false,
10+
},
11+
{
12+
text: '설치하기',
13+
link: '/ko/book/installation.md',
14+
collapsible: false,
15+
children: ['/ko/book/default_shell.md'],
16+
},
17+
{
18+
text: '시작하기',
19+
link: '/ko/book/getting_started.md',
20+
collapsible: false,
21+
children: [
22+
'/ko/book/quick_tour.md',
23+
'/ko/book/moving_around.md',
24+
'/ko/book/thinking_in_nu.md',
25+
'/ko/book/cheat_sheet.md',
26+
],
27+
},
28+
{
29+
text: 'Nu 기본',
30+
link: '/ko/book/nu_fundamentals.md',
31+
collapsible: false,
32+
children: [
33+
'/ko/book/types_of_data.md',
34+
'/ko/book/loading_data.md',
35+
'/ko/book/pipelines.md',
36+
'/ko/book/working_with_strings.md',
37+
'/ko/book/working_with_lists.md',
38+
'/ko/book/working_with_records.md',
39+
'/ko/book/working_with_tables.md',
40+
'/ko/book/navigating_structured_data.md',
41+
'/ko/book/special_variables.md',
42+
],
43+
},
44+
{
45+
text: 'Nu에서 프로그래밍하기',
46+
link: '/ko/book/programming_in_nu.md',
47+
collapsible: false,
48+
children: [
49+
'/ko/book/custom_commands',
50+
'/ko/book/aliases',
51+
'/ko/book/operators',
52+
'/ko/book/variables.md',
53+
'/ko/book/control_flow.md',
54+
'/ko/book/scripts.md',
55+
{
56+
text: '모듈',
57+
link: '/ko/book/modules.md',
58+
collapsible: false,
59+
children: [
60+
'/ko/book/modules/using_modules.md',
61+
'/ko/book/modules/creating_modules.md',
62+
],
63+
},
64+
'/ko/book/overlays.md',
65+
'/ko/book/sorting.md',
66+
'/ko/book/testing.md',
67+
'/ko/book/style_guide.md',
68+
],
69+
},
70+
{
71+
text: '셸로서의 Nu',
72+
link: '/ko/book/nu_as_a_shell.md',
73+
collapsible: false,
74+
children: [
75+
'/ko/book/configuration.md',
76+
'/ko/book/environment.md',
77+
'/ko/book/stdout_stderr_exit_codes.md',
78+
'/ko/book/running_externals.md',
79+
'/ko/book/3rdpartyprompts.md',
80+
'/ko/book/directory_stack.md',
81+
'/ko/book/line_editor.md',
82+
'/ko/book/custom_completions.md',
83+
'/ko/book/externs.md',
84+
'/ko/book/coloring_and_theming.md',
85+
'/ko/book/hooks.md',
86+
'/ko/book/background_jobs.md',
87+
],
88+
},
89+
{
90+
text: 'Nu로 전환하기',
91+
link: '/ko/book/coming_to_nu.md',
92+
collapsible: false,
93+
children: [
94+
'/ko/book/coming_from_bash.md',
95+
'/ko/book/coming_from_cmd.md',
96+
'/ko/book/nushell_map.md',
97+
'/ko/book/nushell_map_imperative.md',
98+
'/ko/book/nushell_map_functional.md',
99+
'/ko/book/nushell_operator_map.md',
100+
],
101+
},
102+
{
103+
text: '디자인 노트',
104+
link: '/ko/book/design_notes.md',
105+
collapsible: false,
106+
children: ['/ko/book/how_nushell_code_gets_run.md'],
107+
},
108+
{
109+
text: '(약간)고급 사용법',
110+
link: '/ko/book/advanced.md',
111+
collapsible: false,
112+
children: [
113+
'/ko/book/standard_library.md',
114+
'/ko/book/dataframes.md',
115+
'/ko/book/metadata.md',
116+
'/ko/book/creating_errors.md',
117+
'/ko/book/parallelism.md',
118+
'/ko/book/plugins.md',
119+
'/ko/book/explore.md',
120+
],
121+
},
122+
],
123+
};

book/coming_from_bash.md

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -109,4 +109,4 @@ This behavior extends to "Edit command-line in Editor" as well. While Bash immed
109109
executes the command after exiting the editor, Nushell (like other, more modern shells
110110
such as Fish and Zsh) inserts the editor contents into the command-line, allowing you
111111
to review and make changes before committing it to execution.
112-
:::
112+
:::

ko/README.md

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

ko/book/3rdpartyprompts.md

Lines changed: 99 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,99 @@
1+
# 타사 프롬프트 구성 방법
2+
3+
## 너드 글꼴
4+
5+
너드 글꼴은 필수는 아니지만 추가 글리프와 아이코노그래피를 통해 프롬프트 표현을 개선할 수 있습니다.
6+
7+
> 너드 글꼴은 많은 수의 글리프(아이콘)로 개발자 대상 글꼴을 패치합니다.
8+
> 특히 Font Awesome, Devicons, Octicons 등과 같은 인기 있는 '상징적 글꼴'에서 많은 추가 글리프를 추가합니다.
9+
10+
* [너드 글꼴 웹사이트](https://www.nerdfonts.com)
11+
* [소스 저장소](https://github.com/ryanoasis/nerd-fonts)
12+
13+
## oh-my-posh
14+
15+
[사이트](https://ohmyposh.dev/)
16+
17+
[저장소](https://github.com/JanDeDobbeleer/oh-my-posh)
18+
19+
[oh-my-posh](https://ohmyposh.dev/)를 좋아한다면 몇 단계만 거치면 누셸에서 oh-my-posh를 사용할 수 있습니다. 누셸과 잘 작동합니다. 누셸과 함께 oh-my-posh를 설정하는 방법:
20+
21+
1. [가이드](https://ohmyposh.dev/docs/installation/linux)에 따라 Oh My Posh를 설치하고 oh-my-posh의 테마를 다운로드합니다.
22+
2. [너드 글꼴](https://github.com/ryanoasis/nerd-fonts)을 다운로드하여 설치합니다.
23+
3. .oh-my-posh.nu 파일을 생성합니다. 기본적으로 홈 디렉터리에 생성됩니다. `--config`를 사용하여 테마를 지정할 수 있으며, 그렇지 않으면 oh-my-posh에 기본 테마가 제공됩니다.
24+
4. ~/.config/nushell/config.nu(또는 `$nu.config-path`의 경로 출력)에 추가하여 oh-my-posh 프롬프트를 초기화하여 ~/.oh-my-posh.nu를 소스로 사용합니다.
25+
26+
```nu
27+
# .oh-my-posh.nu 파일 생성
28+
oh-my-posh init nu --config ~/.poshthemes/M365Princess.omp.json
29+
30+
# config.nu 파일에 이 줄을 추가하여 셸 시작 시 oh-my-posh.nu를 초기화합니다.
31+
source ~/.oh-my-posh.nu
32+
```
33+
34+
MacOS 사용자의 경우:
35+
36+
1. `brew`를 사용하여 oh-my-posh를 설치할 수 있습니다. [여기 가이드](https://ohmyposh.dev/docs/installation/macos)를 따르십시오.
37+
2. [너드 글꼴](https://github.com/ryanoasis/nerd-fonts)을 다운로드하여 설치합니다.
38+
3. `$nu.config-path`에서 출력한 파일에 PROMPT_COMMAND를 설정합니다. 다음은 코드 스니펫입니다.
39+
40+
```nu
41+
let posh_dir = (brew --prefix oh-my-posh | str trim)
42+
let posh_theme = $'($posh_dir)/share/oh-my-posh/themes/'
43+
# 테마 이름을 zash/space/robbyrussel/powerline/powerlevel10k_lean/
44+
# material/half-life/lambda 또는 이중 라인 테마: amro/pure/spaceship 등으로 변경합니다.
45+
# 자세한 내용은 [테마 데모](https://ohmyposh.dev/docs/themes)를 참조하십시오.
46+
$env.PROMPT_COMMAND = { || oh-my-posh prompt print primary --config $'($posh_theme)/zash.omp.json' }
47+
# 선택 사항
48+
$env.PROMPT_INDICATOR = $"(ansi y)$> (ansi reset)"
49+
```
50+
51+
## Starship
52+
53+
[사이트](https://starship.rs/)
54+
55+
[저장소](https://github.com/starship/starship)
56+
57+
1. 위의 링크를 따라 Starship을 설치합니다.
58+
2. 기본 설정에 따라 너드 글꼴을 설치합니다.
59+
3. 아래의 구성 예를 사용합니다. `STARSHIP_SHELL` 환경 변수를 설정해야 합니다.
60+
61+
::: tip
62+
Starship을 활성화하는 다른 방법은 [Starship 빠른 설치](https://starship.rs/#nushell) 지침에 설명되어 있습니다.
63+
64+
위의 링크는 Starship과 누셸의 공식 통합이며 수동으로 아무것도 하지 않고 Starship을 실행하는 가장 간단한 방법입니다.
65+
66+
- Starship은 자체 구성/환경 설정 스크립트를 만듭니다.
67+
- `env.nu`에서 만들고 `config.nu`에서 `use`하기만 하면 됩니다.
68+
:::
69+
70+
다음은 Starship의 구성 섹션 예입니다.
71+
72+
```nu
73+
$env.STARSHIP_SHELL = "nu"
74+
75+
def create_left_prompt [] {
76+
starship prompt --cmd-duration $env.CMD_DURATION_MS $'--status=($env.LAST_EXIT_CODE)'
77+
}
78+
79+
# nushell 함수를 사용하여 오른쪽 및 왼쪽 프롬프트를 정의합니다.
80+
$env.PROMPT_COMMAND = { || create_left_prompt }
81+
$env.PROMPT_COMMAND_RIGHT = ""
82+
83+
# 프롬프트 표시기는 프롬프트의 상태를 나타내는 환경 변수입니다.
84+
$env.PROMPT_INDICATOR = ""
85+
$env.PROMPT_INDICATOR_VI_INSERT = ": "
86+
$env.PROMPT_INDICATOR_VI_NORMAL = "〉"
87+
$env.PROMPT_MULTILINE_INDICATOR = "::: "
88+
```
89+
90+
이제 Nu를 다시 시작하십시오.
91+
92+
```
93+
nushell on 📙 main is 📦 v0.60.0 via 🦀 v1.59.0
94+
95+
```
96+
97+
## Purs
98+
99+
[저장소](https://github.com/xcambar/purs)

0 commit comments

Comments
 (0)