From 418664249f01dba17cdb29c1c213be70a9d9de6b Mon Sep 17 00:00:00 2001 From: Shia Date: Fri, 7 Feb 2025 18:44:43 +0900 Subject: [PATCH 1/4] Align & fill up missed text --- ko/documentation/installation/index.md | 82 ++++++++++++++++---------- 1 file changed, 52 insertions(+), 30 deletions(-) diff --git a/ko/documentation/installation/index.md b/ko/documentation/installation/index.md index 994c51c327..1916cb2898 100644 --- a/ko/documentation/installation/index.md +++ b/ko/documentation/installation/index.md @@ -4,8 +4,8 @@ title: "Ruby 설치하기" lang: ko --- -Ruby를 설치하고 관리할 수 있는 다양한 패키지 관리 시스템들과 서드파티 도구들이 있습니다. - +Ruby를 설치하고 관리할 수 있는 다양한 패키지 관리 시스템들과 +서드파티 도구들이 있습니다. {: .summary} 컴퓨터에 이미 Ruby가 설치되어 있을 수도 있습니다. @@ -55,6 +55,7 @@ Windows 10을 사용 중이라면 [Windows Subsystem for Linux][wsl]를 사용 * [RubyInstaller](#rubyinstaller) (Windows) * [Ruby Stack](#rubystack) * [관리자](#managers) + * [asdf-vm](#asdf-vm) * [chruby](#chruby) * [rbenv](#rbenv) * [rbenv for Windows](#rbenv-for-windows) @@ -72,10 +73,12 @@ Ruby를 설치하기 위해 자신의 시스템의 패키지 관리자를 사용 Ruby 커뮤니티의 일부 회원들은 Ruby를 설치할 때 패키지 관리자를 사용하지 말아야 하고, 대신 도구를 사용해야 한다고 느끼고 있습니다. -대부분의 패키지 관리자들은 오래된 버전의 Ruby를 설치합니다. -최신의 Ruby를 사용하고자 한다면, 패키지의 버전 번호가 올바른지 확인하거나 +대부분의 패키지 관리자들은 최근 릴리스 대신 +오래된 버전의 Ruby를 설치합니다. 최신의 Ruby를 사용하고자 한다면, +패키지의 버전 번호가 올바른지 확인하거나 특정 [인스톨러][installers]를 사용하세요. + ### apt (Debian이나 Ubuntu) {: #apt} @@ -86,6 +89,7 @@ Debian GNU/Linux와 Ubuntu는 apt 패키지 관리 시스템을 사용합니다. $ sudo apt-get install ruby-full {% endhighlight %} + ### yum (CentOS, Fedora, RHEL) {: #yum} @@ -96,20 +100,24 @@ CentOS, Fedora, RHEL은 yum 패키지 관리 시스템을 사용합니다. $ sudo yum install ruby {% endhighlight %} -설치된 버전은 보통 그 특정 배포 버전 릴리스 시기의 최신 버전의 Ruby입니다. +설치된 버전은 보통 그 특정 배포 버전 릴리스 시기의 +최신 버전의 Ruby입니다. ### snap (Ubuntu나 다른 리눅스 배포판) {: #snap} -Snap은 Canonical에 의해 개발된 패키지 매니저입니다. 이는 Ubuntu에서 바로 사용 가능합니다만, 다른 리눅스 배포판에서도 동작합니다. +Snap은 Canonical에 의해 개발된 패키지 매니저입니다. +이는 Ubuntu에서 바로 사용 가능합니다만, +다른 리눅스 배포판에서도 동작합니다. 다음과 같이 사용할 수 있습니다. {% highlight sh %} $ sudo snap install ruby --classic {% endhighlight %} -Ruby의 마이너 시리즈를 위한 채널을 제공합니다. 예를 들어, 다음 명령은 Ruby 2.3으로 변경할 수 있게 해줍니다. +Ruby의 마이너 시리즈를 위한 채널을 제공합니다. +예를 들어, 다음 명령은 Ruby 2.3으로 변경할 수 있게 해줍니다. {% highlight sh %} $ sudo snap switch ruby --channel=2.3/stable @@ -146,7 +154,8 @@ $ sudo pacman -S ruby ### Homebrew (macOS) {: #homebrew} -엘 캐피탄(10.11)부터 모하비(10.14)까지의 macOS 릴리스에서는 Ruby 2.0 이상이 포함되어 있습니다. +엘 캐피탄(10.11)부터 macOS 릴리스에서는 +Ruby 2.0 이상이 포함되어 있습니다. [Homebrew][homebrew]는 macOS에서 일반적으로 사용되는 패키지 관리자입니다. Homebrew를 사용해 새로운 버전의 Ruby를 설치하는 것은 쉽습니다. @@ -168,8 +177,9 @@ pkg를 이용하여 패키지를 설치할 수 있습니다: $ pkg install ruby {% endhighlight %} -[포트 컬렉션][freebsd-ports-collection]을 사용하여 Ruby를 소스로부터 설치 -할 수 있습니다. 이는 설치 설정을 변경하고 싶을 때 유용합니다. +[포트 컬렉션][freebsd-ports-collection]을 사용하여 Ruby를 소스로부터 +설치 할 수 있습니다. 이는 설치 설정을 변경하고 싶을 때 +유용합니다. FreeBSD 상의 Ruby와 그 환경에 대해서 더 자세한 정보는 [FreeBSD Ruby Project 웹사이트][freebsd-ruby]에서 얻을 수 있습니다. @@ -178,8 +188,9 @@ FreeBSD 상의 Ruby와 그 환경에 대해서 더 자세한 정보는 ### OpenBSD {: #openbsd} -OpenBSD와 그 배포판인 adJ에는 3개의 Ruby 메이저 버전의 패키지가 있습니다. -다음 명령을 통해 설치 가능한 버전을 확인하고 설치할 수 있습니다. +OpenBSD와 그 배포판인 adJ에는 3개의 Ruby 메이저 버전의 패키지가 +있습니다. 다음 명령을 통해 설치 가능한 버전을 확인하고 +설치할 수 있습니다. {% highlight sh %} $ doas pkg_add ruby @@ -190,7 +201,8 @@ $ doas pkg_add ruby 가장 최신의 Ruby 버전이 릴리스된 며칠 후면 OpenBSD 포트 컬렉션의 `HEAD` 브랜치에 이 플랫폼을 위한 Ruby 버전이 추가되어 있을 것입니다. -[가장 최신의 포트 컬렉션의 lang/ruby 디렉터리][openbsd-current-ruby-ports]를 확인하세요. +[가장 최신의 포트 컬렉션의 lang/ruby 디렉터리][openbsd-current-ruby-ports]를 +확인하세요. ### OpenIndiana에서의 Ruby @@ -205,7 +217,8 @@ Ruby 바이너리와 RubyGems를 직접 받아 설치합니다. 아주 쉽습니 $ pkg install runtime/ruby {% endhighlight %} -하지만, 서드파티 도구를 사용하는 것이 최신 버전의 Ruby를 얻는 더 좋은 방법입니다. +하지만, 서드파티 도구를 사용하는 것이 최신 버전의 Ruby를 얻는 +더 좋은 방법입니다. ### Windows 패키지 관리자 {: #winget} @@ -233,13 +246,14 @@ Windows에서 [Windows 패키지 관리자 CLI](https://github.com/microsoft/win > choco install ruby {% endhighlight %} -`msys2`가 이미 설치되어 있다면 이를 그대로 사용하고, 아니면 완전한 Ruby 개발 -환경을 위해서 새로 설치합니다. +`msys2`가 이미 설치되어 있다면 이를 그대로 사용하고, 아니면 완전한 Ruby 개발 환경을 위해서 새로 설치합니다. ### 다른 배포판 +{: #other-systems} -다른 시스템에서는 자신의 Linux 배포 관리자를 위한 패키지 저장소를 검색할 수 있습니다. -아니면 [서드파티 인스톨러][installers]를 사용할 수도 있습니다. +다른 시스템에서는 자신의 Linux 배포 관리자를 위한 패키지 저장소를 +검색할 수 있습니다. 아니면 [서드파티 인스톨러][installers]를 +사용할 수도 있습니다. ## 인스톨러 @@ -248,8 +262,9 @@ Windows에서 [Windows 패키지 관리자 CLI](https://github.com/microsoft/win 시스템이나 패키지 관리자에서 제공하는 Ruby가 구 버전이라면, 서드 파티 인스톨러를 사용해 새로운 버전의 Ruby를 설치할 수 있습니다. -어떤 인스톨러는 여러 버전의 Ruby를 같은 시스템에 설치하게 합니다. -관련된 관리자는 다른 Ruby 간의 전환을 도와줍니다. +어떤 인스톨러는 여러 버전의 Ruby를 같은 시스템에 설치하게 +합니다. 관련된 관리자는 다른 Ruby 간의 전환을 +도와줍니다. [RVM](#rvm)을 버전 관리자로 사용할 계획이라면 포함되어 있으므로 별도의 인스톨러는 필요 없습니다. @@ -285,26 +300,30 @@ Windows에서는 [RubyInstaller][rubyinstaller]는 전체 Ruby 개발 환경을 ### Ruby Stack {: #rubystack} -Ruby on Rails를 사용하기 위해 Ruby를 설치하신다면 다음 인스톨러를 사용할 수 있습니다. +Ruby on Rails를 사용하기 위해 Ruby를 설치하신다면 다음 인스톨러를 +사용할 수 있습니다. -* [Bitnami Ruby Stack][rubystack]는 Ruby on Rails를 위한 완전한 개발환경을 제공합니다. +* [Bitnami Ruby Stack][rubystack]는 Ruby on Rails를 위한 + 완전한 개발환경을 제공합니다. macOS, Linux, Windows, 가상 머신, 클라우드 이미지를 지원합니다. ## 관리자 +{: #managers} 많은 루비스트들이 여러 버전의 Ruby를 관리하기 위해 Ruby 관리자를 사용합니다. 각 프로젝트에서 서로 다른 Ruby 버전을 사용할 수 있도록 간단하게 또는 자동으로 버전을 변경해주며 그 이외의 장점들이 있지만, 공식적으로 지원되는 것은 아닙니다. 하지만, 각각의 커뮤니티에서 도움을 구할 수 있습니다. -### asdf-vm +### asdf-vm {: #asdf-vm} -[asdf-vm][asdf-vm]은 프로젝트 단위로 여러 언어 런타임 버전을 관리할 수 있는 -확장 가능한 버전 관리자입니다. Ruby를 설치하려면 [asdf-ruby][asdf-ruby] -플러그인이 필요합니다(이는 [ruby-build](#ruby-build)를 사용합니다). +[asdf-vm][asdf-vm]은 프로젝트 단위로 여러 언어 런타임 버전을 +관리할 수 있는 확장 가능한 버전 관리자입니다. Ruby를 설치하려면 +[asdf-ruby][asdf-ruby] 플러그인이 필요합니다(이는 [ruby-build](#ruby-build)를 +사용합니다). ### chruby @@ -323,13 +342,16 @@ rbenv 자체는 Ruby 설치를 지원하지 않습니다만, [ruby-build](#ruby- 유명한 플러그인에서 Ruby를 설치할 수 있습니다. rbenv, ruby-build 모두 macOS, Linux나 다른 UNIX-계열 운영체제에서 사용가능합니다. + ### rbenv for Windows {: #rbenv-for-windows} -[rbenv for Windows][rbenv-for-windows]는 Windows에서 여러 종류의 Ruby를 설치하고 -관리할 수 있도록 합니다. 이는 PowerShell로 작성되었으므로 Windows에서 Ruby를 -이용하는 사용자들에게 자연스러운 수단을 제공합니다. 또한 커맨드 라인 인터페이스는 -UNIX-계열 운영체제의 [rbenv][rbenv]와 호환됩니다. +[rbenv for Windows][rbenv-for-windows]는 Windows에서 여러 종류의 Ruby를 +설치하고 관리할 수 있도록 합니다. 이는 PowerShell로 작성되었으므로 +Windows에서 Ruby를 이용하는 사용자들에게 자연스러운 수단을 제공합니다. +또한 커맨드 라인 인터페이스는 UNIX-계열 +운영체제의 [rbenv][rbenv]와 호환됩니다. + ### RVM ("Ruby Version Manager") {: #rvm} From 42cabc897ad11e067c685b70329a975a57506074 Mon Sep 17 00:00:00 2001 From: Shia Date: Fri, 7 Feb 2025 18:47:00 +0900 Subject: [PATCH 2/4] Copy "added mise-en-place" --- ko/documentation/installation/index.md | 11 +++++++++++ 1 file changed, 11 insertions(+) diff --git a/ko/documentation/installation/index.md b/ko/documentation/installation/index.md index 1916cb2898..6b806c5ddd 100644 --- a/ko/documentation/installation/index.md +++ b/ko/documentation/installation/index.md @@ -57,6 +57,7 @@ Windows 10을 사용 중이라면 [Windows Subsystem for Linux][wsl]를 사용 * [관리자](#managers) * [asdf-vm](#asdf-vm) * [chruby](#chruby) + * [mise-en-place](#mise-en-place) * [rbenv](#rbenv) * [rbenv for Windows](#rbenv-for-windows) * [RVM](#rvm) @@ -334,6 +335,14 @@ chruby는 [ruby-install](#ruby-install)로 설치된 Ruby뿐만 아니라 소스에서 빌드 된 Ruby도 관리할 수 있습니다. +### mise-en-place +{: #mise-en-place} + +[mise-en-place][mise-en-place] allows you to switch between multiple Rubies without requiring additional tools. +It manages installations automatically and includes a [gem backend](https://mise.jdx.dev/dev-tools/backends/gem.html) to manage versions of CLIs written in Ruby. +It supports UNIX-like and Windows operating systems. + + ### rbenv {: #rbenv} @@ -421,4 +430,6 @@ $ sudo make install [wsl]: https://docs.microsoft.com/ko-kr/windows/wsl/about [asdf-vm]: https://asdf-vm.com/ [asdf-ruby]: https://github.com/asdf-vm/asdf-ruby +[mise-en-place]: https://mise.jdx.dev +[mise-en-place-ruby]: https://mise.jdx.dev/lang/ruby.html [openbsd-current-ruby-ports]: https://cvsweb.openbsd.org/cgi-bin/cvsweb/ports/lang/ruby/?only_with_tag=HEAD From 37cf32bfdc7de1ffd8ef5f1a9e748ba9f6977087 Mon Sep 17 00:00:00 2001 From: Shia Date: Fri, 7 Feb 2025 18:49:21 +0900 Subject: [PATCH 3/4] Tranlate "mise-in-place" --- ko/documentation/installation/index.md | 6 +++--- 1 file changed, 3 insertions(+), 3 deletions(-) diff --git a/ko/documentation/installation/index.md b/ko/documentation/installation/index.md index 6b806c5ddd..e2c529c51b 100644 --- a/ko/documentation/installation/index.md +++ b/ko/documentation/installation/index.md @@ -338,9 +338,9 @@ chruby는 [ruby-install](#ruby-install)로 설치된 Ruby뿐만 ### mise-en-place {: #mise-en-place} -[mise-en-place][mise-en-place] allows you to switch between multiple Rubies without requiring additional tools. -It manages installations automatically and includes a [gem backend](https://mise.jdx.dev/dev-tools/backends/gem.html) to manage versions of CLIs written in Ruby. -It supports UNIX-like and Windows operating systems. +[mise-en-place][mise-en-place]는 추가 도구 없이 여러 Ruby 간의 전환을 할 수 있게 합니다. +설치를 자동으로 관리하며 Ruby로 작성된 CLI의 버전을 관리하기 위한 [gem 백엔드](https://mise.jdx.dev/dev-tools/backends/gem.html)를 포함합니다. +UNIX-계열 운영체제와 Windows 운영체제를 지원합니다. ### rbenv From 6967b8dc26a911652fb753139d26ac4eec0360af Mon Sep 17 00:00:00 2001 From: Shia Date: Sat, 8 Feb 2025 07:59:37 +0900 Subject: [PATCH 4/4] Apply suggestions from code review Co-authored-by: Chayoung You --- ko/documentation/installation/index.md | 6 +++--- 1 file changed, 3 insertions(+), 3 deletions(-) diff --git a/ko/documentation/installation/index.md b/ko/documentation/installation/index.md index e2c529c51b..60998f0a07 100644 --- a/ko/documentation/installation/index.md +++ b/ko/documentation/installation/index.md @@ -75,7 +75,7 @@ Ruby 커뮤니티의 일부 회원들은 Ruby를 설치할 때 패키지 관리 말아야 하고, 대신 도구를 사용해야 한다고 느끼고 있습니다. 대부분의 패키지 관리자들은 최근 릴리스 대신 -오래된 버전의 Ruby를 설치합니다. 최신의 Ruby를 사용하고자 한다면, +오래된 버전의 Ruby를 설치합니다. 최신 버전의 Ruby를 사용하고자 한다면, 패키지의 버전 번호가 올바른지 확인하거나 특정 [인스톨러][installers]를 사용하세요. @@ -340,7 +340,7 @@ chruby는 [ruby-install](#ruby-install)로 설치된 Ruby뿐만 [mise-en-place][mise-en-place]는 추가 도구 없이 여러 Ruby 간의 전환을 할 수 있게 합니다. 설치를 자동으로 관리하며 Ruby로 작성된 CLI의 버전을 관리하기 위한 [gem 백엔드](https://mise.jdx.dev/dev-tools/backends/gem.html)를 포함합니다. -UNIX-계열 운영체제와 Windows 운영체제를 지원합니다. +UNIX 계열 운영체제와 Windows를 지원합니다. ### rbenv @@ -358,7 +358,7 @@ rbenv, ruby-build 모두 macOS, Linux나 다른 UNIX-계열 운영체제에서 [rbenv for Windows][rbenv-for-windows]는 Windows에서 여러 종류의 Ruby를 설치하고 관리할 수 있도록 합니다. 이는 PowerShell로 작성되었으므로 Windows에서 Ruby를 이용하는 사용자들에게 자연스러운 수단을 제공합니다. -또한 커맨드 라인 인터페이스는 UNIX-계열 +또한 커맨드 라인 인터페이스는 UNIX 계열 운영체제의 [rbenv][rbenv]와 호환됩니다.