ko/book 폴더의 나머지 마크다운 파일을 한국어로 번역하겠습니다.

Author: google-labs-jules[bot]

ko/book/special_variables.md

@@ -1,95 +1,92 @@
 ---
 next:
-  text: Programming in Nu
+  text: Nu로 프로그래밍하기
   link: /book/programming_in_nu.md
 ---
-# Special Variables
+# 특수 변수
 
-Nushell makes available and uses a number of special variables and constants. Many of these are mentioned or documented in other places in this Book, but this page
-should include _all_ variables for reference.
+누셸은 여러 특수 변수와 상수를 사용 가능하게 하고 사용합니다. 이들 중 다수는 이 책의 다른 곳에서 언급되거나 문서화되어 있지만, 이 페이지는 참조를 위해 _모든_ 변수를 포함해야 합니다.
 
 [[toc]]
 
 ## `$nu`
 
-The `$nu` constant is a record containing several useful values:
-
-- `default-config-dir`: The directory where the configuration files are stored and read.
-- `config-path`: The path of the main Nushell config file, normally `config.nu` in the config directory.
-- `env-path`: The optional environment config file, normally `env.nu` in the config directory.
-- `history-path`: The text or SQLite file storing the command history.
-- `loginshell-path`: The optional config file which runs for login shells, normally `login.nu` in the config directory.
-- `plugin-path`: The plugin registry file, normally `plugin.msgpackz` in the config directory.
-- `home-path`: The user's home directory which can be accessed using the shorthand `~`.
-- `data-dir`: The data directory for Nushell, which includes the `./vendor/autoload` directories loaded at startup and other user data.
-- `cache-dir`: A directory for non-essential (cached) data.
-- `vendor-autoload-dirs`: A list of directories where third-party applications should install configuration files that will be auto-loaded during startup.
-- `user-autoload-dirs`: A list of directories where the user may create additional configuration files which will be auto-loaded during startup.
-- `temp-path`: A path for temporary files that should be writeable by the user.
-- `pid`: The PID of the currently running Nushell process.
-- `os-info`: Information about the host operating system.
-- `startup-time`: The amount of time (in duration) that it took for Nushell to start and process all configuration files.
-- `is-interactive`: A boolean indicating whether Nushell was started as an interactive shell (`true`) or is running a script or command-string. For example:
+`$nu` 상수는 여러 유용한 값을 포함하는 레코드입니다.
+
+- `default-config-dir`: 구성 파일이 저장되고 읽히는 디렉터리.
+- `config-path`: 주 누셸 구성 파일의 경로, 일반적으로 구성 디렉터리의 `config.nu`입니다.
+- `env-path`: 선택적 환경 구성 파일, 일반적으로 구성 디렉터리의 `env.nu`입니다.
+- `history-path`: 명령 기록을 저장하는 텍스트 또는 SQLite 파일.
+- `loginshell-path`: 로그인 셸에 대해 실행되는 선택적 구성 파일, 일반적으로 구성 디렉터리의 `login.nu`입니다.
+- `plugin-path`: 플러그인 레지스트리 파일, 일반적으로 구성 디렉터리의 `plugin.msgpackz`입니다.
+- `home-path`: 약어 `~`를 사용하여 액세스할 수 있는 사용자의 홈 디렉터리.
+- `data-dir`: 시작 시 로드되는 `./vendor/autoload` 디렉터리 및 기타 사용자 데이터를 포함하는 누셸의 데이터 디렉터리.
+- `cache-dir`: 필수적이지 않은(캐시된) 데이터용 디렉터리.
+- `vendor-autoload-dirs`: 시작 시 자동으로 로드될 구성 파일을 타사 응용 프로그램이 설치해야 하는 디렉터리 목록입니다.
+- `user-autoload-dirs`: 사용자가 시작 시 자동으로 로드될 추가 구성 파일을 만들 수 있는 디렉터리 목록입니다.
+- `temp-path`: 사용자가 쓸 수 있어야 하는 임시 파일 경로.
+- `pid`: 현재 실행 중인 누셸 프로세스의 PID.
+- `os-info`: 호스트 운영 체제에 대한 정보.
+- `startup-time`: 누셸이 시작되고 모든 구성 파일을 처리하는 데 걸린 시간(기간).
+- `is-interactive`: 누셸이 대화형 셸로 시작되었는지(`true`) 또는 스크립트나 명령 문자열을 실행 중인지 여부를 나타내는 부울입니다. 예시:
 
   ```nu
   $nu.is-interactive
   # => true
   nu -c "$nu.is-interactive"
   # => false
 
-  # Force interactive with --interactive (-i)
+  # --interactive(-i)로 대화형 강제 실행
   nu -i -c "$nu.is-interactive"
   # => true
   ```
 
-  Note: When started as an interactive shell, startup config files are processed. When started as a non-interactive shell, no config files are read unless explicitly called via flag.
+  참고: 대화형 셸로 시작하면 시작 구성 파일이 처리됩니다. 비대화형 셸로 시작하면 플래그를 통해 명시적으로 호출되지 않는 한 구성 파일이 읽히지 않습니다.
 
-- `is-login`: Indicates whether or not Nushell was started as a login shell.
-- `history-enabled`: History may be disabled via `nu --no-history`, in which case this constant will be `false`.
-- `current-exe`: The full path to the currently-running `nu` binary. Can be combined with `path dirname` (which is constant) to determine the directory where the binary is located.
+- `is-login`: 누셸이 로그인 셸로 시작되었는지 여부를 나타냅니다.
+- `history-enabled`: `nu --no-history`를 통해 기록을 비활성화할 수 있으며, 이 경우 이 상수는 `false`가 됩니다.
+- `current-exe`: 현재 실행 중인 `nu` 바이너리의 전체 경로입니다. 바이너리가 있는 디렉터리를 확인하기 위해 `path dirname`(상수)과 결합할 수 있습니다.
 
 ## `$env`
 
-`$env` is a special mutable variable containing the current environment variables. As with any process, the initial environment is inherited from the parent process which started `nu`.
+`$env`는 현재 환경 변수를 포함하는 특수 가변 변수입니다. 모든 프로세스와 마찬가지로 초기 환경은 `nu`를 시작한 부모 프로세스에서 상속됩니다.
 
-There are also several environment variables that Nushell uses for specific purposes:
+누셸이 특정 목적으로 사용하는 몇 가지 환경 변수도 있습니다.
 
 ### `$env.CMD_DURATION_MS`
 
-The amount of time in milliseconds that the previous command took to run.
+이전 명령이 실행되는 데 걸린 시간(밀리초).
 
 ### `$env.config`
 
-`$env.config` is the main configuration record used in Nushell. Settings are documented in `config nu --doc`.
+`$env.config`는 누셸에서 사용되는 주 구성 레코드입니다. 설정은 `config nu --doc`에 문서화되어 있습니다.
 
 ### `$env.CURRENT_FILE`
 
-Inside a script, module, or sourced-file, this variable holds the fully-qualified filename. Note that this
-information is also available as a constant through the [`path self`](/commands/docs/path_self.md) command.
+스크립트, 모듈 또는 소싱된 파일 내에서 이 변수는 정규화된 파일 이름을 보유합니다. 이 정보는 [`path self`](/commands/docs/path_self.md) 명령을 통해 상수로도 사용할 수 있습니다.
 
 ### `$env.ENV_CONVERSIONS`
 
-Allows users to specify how to convert certain environment variables to Nushell types. See [ENV_CONVERSIONS](./configuration.md#env-conversions).
+사용자가 특정 환경 변수를 누셸 유형으로 변환하는 방법을 지정할 수 있습니다. [ENV_CONVERSIONS](./configuration.md#env-conversions)를 참조하십시오.
 
 ### `$env.FILE_PWD`
 
-Inside a script, module, or sourced-file, this variable holds the fully qualified name of the directory in which
-the file resides. Note that this value is also available as a constant through:
+스크립트, 모듈 또는 소싱된 파일 내에서 이 변수는 파일이 있는 디렉터리의 정규화된 이름을 보유합니다. 이 값은 다음을 통해 상수로도 사용할 수 있습니다.
 
 ```nu
 path self | path dirname
 ```
 
 ### `$env.LAST_EXIT_CODE`
 
-The exit code of the last command, usually used for external commands — Equivalent to `$?` from POSIX. Note that this information is also made available to the `catch` block in a `try` expression for external commands. For instance:
+마지막 명령의 종료 코드, 일반적으로 외부 명령에 사용됩니다. POSIX의 `$?`와 동일합니다. 이 정보는 외부 명령에 대한 `try` 표현식의 `catch` 블록에서도 사용할 수 있습니다. 예시:
 
 ```nu
 ^ls file-that-does-not-exist e> /dev/null
 $env.LAST_EXIT_CODE
 # => 2
 
-# or
+# 또는
 try {
   ^ls file-that-does-not-exist e> /dev/null
 } catch {|e|
@@ -100,15 +97,15 @@ try {
 
 ### `$env.NU_LIB_DIRS`
 
-A list of directories which will be searched when using the `source`, `use`, or `overlay use` commands. See also:
+`source`, `use` 또는 `overlay use` 명령을 사용할 때 검색할 디렉터리 목록입니다. 참조:
 
-- The `$NU_LIB_DIRS` constant below
-- [Module Path](./modules/using_modules.md#module-path)
-- [Configuration - `$NU_LIB_DIRS`](./configuration.md#nu-lib-dirs-constant)
+- 아래 `$NU_LIB_DIRS` 상수
+- [모듈 경로](./modules/using_modules.md#module-path)
+- [구성 - `$NU_LIB_DIRS`](./configuration.md#nu-lib-dirs-constant)
 
 ### `$env.NU_LOG_LEVEL`
 
-The [standard library](/book/standard_library.md) offers logging in `std/log`. The `NU_LOG_LEVEL` environment variable is used to define the log level being used for custom commands, modules, and scripts.
+[표준 라이브러리](/book/standard_library.md)는 `std/log`에서 로깅을 제공합니다. `NU_LOG_LEVEL` 환경 변수는 사용자 지정 명령, 모듈 및 스크립트에 사용되는 로그 수준을 정의하는 데 사용됩니다.
 
 ```nu
 nu -c '1 | print; use std/log; log debug 1111; 9 | print'
@@ -126,77 +123,75 @@ nu -c '1 | print; use std/log; $env.NU_LOG_LEVEL = "debug"; log debug 1111; 9 |
 # => 9
 ```
 
-Note that `$env.NU_LOG_LEVEL` is different from `nu --log-level`, which sets the log level for built-in native Rust Nushell commands. It does not influence the `std/log` logging used in custom commands and scripts.
+`$env.NU_LOG_LEVEL`은 기본 제공 네이티브 Rust 누셸 명령의 로그 수준을 설정하는 `nu --log-level`과 다릅니다. 사용자 지정 명령 및 스크립트에서 사용되는 `std/log` 로깅에 영향을 미치지 않습니다.
 
 ```nu
 nu --log-level 'debug' -c '1 | print; use std/log; log debug 1111; 9 | print'
-# => … a lot more log messages, with references to the Nushell command Rust source files
-#      and without our own `log debug` message
+# => … 훨씬 더 많은 로그 메시지, 누셸 명령 Rust 소스 파일에 대한 참조 포함
+#      그리고 우리 자신의 `log debug` 메시지 없이
 # => 1
 # => 9
 # => …
 ```
 
 ### `$env.NU_PLUGIN_DIRS`
 
-A list of directories which will be searched when registering plugins with `plugin add`. See also:
+`plugin add`로 플러그인을 등록할 때 검색할 디렉터리 목록입니다. 참조:
 
-- [Plugin Search Path](./plugins.md#plugin-search-path)
+- [플러그인 검색 경로](./plugins.md#plugin-search-path)
 
 ### `$env.NU_VERSION`
 
-The current Nushell version. The same as `(version).version`, but, as an environment variable, it is exported to and can be read by child processes.
+현재 누셸 버전입니다. `(version).version`과 동일하지만 환경 변수이므로 자식 프로세스로 내보내지고 읽을 수 있습니다.
 
 ### `$env.PATH`
 
-The search path for executing other applications. It is initially inherited from the parent process as a string, but converted to a Nushell `list` at startup for easy access.
+다른 응용 프로그램을 실행하기 위한 검색 경로입니다. 처음에는 부모 프로세스에서 문자열로 상속되지만 쉽게 액세스할 수 있도록 시작 시 누셸 `list`로 변환됩니다.
 
-It is converted back to a string before running a child-process.
+자식 프로세스를 실행하기 전에 문자열로 다시 변환됩니다.
 
 ### `$env.PROCESS_PATH`
 
-When _executing a script_, this variable represents the name and relative path of the script. Unlike the two variables
-above, it is not present when sourcing a file or importing a module.
+_스크립트를 실행할 때_ 이 변수는 스크립트의 이름과 상대 경로를 나타냅니다. 위의 두 변수와 달리 파일을 소싱하거나 모듈을 가져올 때는 존재하지 않습니다.
 
-Note: Also unlike the two variables above, the exact path (including symlinks) that was used to _invoke_ the file is returned.
+참고: 또한 위의 두 변수와 달리 파일을 _호출_하는 데 사용된 정확한 경로(심볼릭 링크 포함)가 반환됩니다.
 
-### `$env.PROMPT_*` and `$env.TRANSIENT_PROMPT_*`
+### `$env.PROMPT_*` 및 `$env.TRANSIENT_PROMPT_*`
 
-A number of variables are available for configuring the Nushell prompt that appears on each commandline. See also:
+각 명령줄에 나타나는 누셸 프롬프트를 구성하는 데 사용할 수 있는 여러 변수가 있습니다. 참조:
 
-- [Configuration - Prompt Configuration](./configuration.md#prompt-configuration)
+- [구성 - 프롬프트 구성](./configuration.md#prompt-configuration)
 - `config nu --doc`
 
 ### `$env.SHLVL`
 
-`SHLVL` is incremented by most shells when entering a new subshell. It can be used to determine the number of nested shells. For instance,
-if `$env.SHLVL == 2` then typing `exit` should return you to a parent shell.
+`SHLVL`은 새 하위 셸에 들어갈 때 대부분의 셸에서 증가합니다. 중첩된 셸 수를 확인하는 데 사용할 수 있습니다. 예를 들어, `$env.SHLVL == 2`이면 `exit`를 입력하면 부모 셸로 돌아가야 합니다.
 
 ### `$env.XDG_CONFIG_HOME`
 
-Can be used to optionally override the `$nu.default-config-dir` location. See [Configuration - Startup Variables](./configuration.md#startup-variables).
+선택적으로 `$nu.default-config-dir` 위치를 재정의하는 데 사용할 수 있습니다. [구성 - 시작 변수](./configuration.md#startup-variables)를 참조하십시오.
 
 ### `$env.XDG_DATA_DIR`
 
-Can be used to optionally override the `$nu.data-dir` location. See [Configuration - Startup Variables](./configuration.md#startup-variables).
+선택적으로 `$nu.data-dir` 위치를 재정의하는 데 사용할 수 있습니다. [구성 - 시작 변수](./configuration.md#startup-variables)를 참조하십시오.
 
 ## `$in`
 
-The `$in` variable represents the pipeline input into an expression. See [Pipelines - The Special `$in` Variable](./pipelines.md#pipeline-input-and-the-special-in-variable).
+`$in` 변수는 표현식에 대한 파이프라인 입력을 나타냅니다. [파이프라인 - 특수 `$in` 변수](./pipelines.md#pipeline-input-and-the-special-in-variable)를 참조하십시오.
 
 ## `$it`
 
-`$it` is a special variable that is _only_ available in a `where` "row condition" — a convenient shorthand which simplifies field access. See `help where` or [where](/commands/docs/where.md) for more information.
+`$it`은 `where` "행 조건"에서만 사용할 수 있는 특수 변수입니다. 필드 액세스를 단순화하는 편리한 약어입니다. 자세한 내용은 `help where` 또는 [where](/commands/docs/where.md)를 참조하십시오.
 
 ## `$NU_LIB_DIRS`
 
-A constant version of `$env.NU_LIB_DIRS` - a list of directories which will be searched when using the `source`, `use`, or `overlay use` commands. See also:
+`$env.NU_LIB_DIRS`의 상수 버전 - `source`, `use` 또는 `overlay use` 명령을 사용할 때 검색할 디렉터리 목록입니다. 참조:
 
-- [Module Path](./modules/using_modules.md#module-path)
-- [Configuration - `$NU_LIB_DIRS`](./configuration.md#nu-lib-dirs-constant)
+- [모듈 경로](./modules/using_modules.md#module-path)
+- [구성 - `$NU_LIB_DIRS`](./configuration.md#nu-lib-dirs-constant)
 
 ## `$NU_PLUGIN_DIRS`
 
-A constant version of `$env.NU_PLUGIN_DIRS` - a list of directories which will be searched when registering plugins with `plugin add`. See also:
+`$env.NU_PLUGIN_DIRS`의 상수 버전 - `plugin add`로 플러그인을 등록할 때 검색할 디렉터리 목록입니다. 참조:
 
-- [Plugin Search Path](./plugins.md#plugin-search-path)
+- [플러그인 검색 경로](./plugins.md#plugin-search-path)