diff --git a/ko/documentation/index.md b/ko/documentation/index.md index 13a7e22409..d1698f572c 100644 --- a/ko/documentation/index.md +++ b/ko/documentation/index.md @@ -11,6 +11,21 @@ lang: ko 도움이 됩니다. 여기 언급되지 않은 좋은 문서가 있다면 알려주시기 바랍니다. {: .summary} +### 루비 설치하기 + +브라우저에서만 루비를 시험해 보려는게 아니라면 (밑의 링크 참조) +컴퓨터에 루비를 설치할 필요가 있습니다. +루비가 이미 설치되어있는지 확인하려면 터미널을 열고 다음 명령어를 +입력하세요. + +{% highlight sh %} +ruby -v +{% endhighlight %} + +이 명령은 설치된 루비에 대한 정보를 알려줄 것 입니다. +설치되어 있지 않다면, [설치 페이지][installation]에 있는 많은 옵션을 +참조하세요. + ### 초보자용 문서 [Try Ruby!][1] (영문) @@ -55,13 +70,13 @@ lang: ko : 아주 기초적인 내용부터 OOP에서 웹 개발까지 다루는 매우 좋은 설명이 달린 예제들입니다. -[Ruby For Impatient Nuby][40] -: [서민구][41] 님이 작성하신 루비 초보자를 위한 튜토리얼입니다. +[Ruby For Impatient Nuby][ko-1] +: 서민구 님이 작성하신 루비 초보자를 위한 튜토리얼입니다. -[루비 FAQ][42] +[루비 FAQ][ko-2] : 황대산 님이 정리하신 FAQ입니다. -[다른 언어로 부터의 루비](/en/documentation/ruby-from-other-languages/) (영문) +[다른 언어로 부터의 루비](/ko/documentation/ruby-from-other-languages/) : 다른 언어를 하시다 루비로 오셨나요? C, C++, Java, Perl, PHP, Python에 상관없이 이 글이면 충분합니다. @@ -133,10 +148,13 @@ lang: ko [Ruby-Doc.org][34]은 루비에 관한 문서를 관리하는 사이트입니다. 주로 영문이기는 하지만 잘 정리된 참조 매뉴얼은 도움이 됩니다. -루비에 대한 [책](books)도 출판되어 있습니다. 원서들은[여기][35]에서 확인하세요. - +루비에 대한 [책들][ko-5]도 출판되어 있습니다. 원서들은 [여기][35]에서 확인하세요. +루비에 관한 질문이 있다면, [유저 그룹][ko-3]이나 [페이스북 그룹][ko-4]에서 하실 수 있고 +영어가 되신다면 [메일링 리스트](/ko/community/mailing-lists/)를 사용하셔도 +됩니다. +[installation]: /ko/documentation/installation/ [1]: http://tryruby.org/ [2]: http://rubykoans.com/ [3]: http://rubymonk.com/ @@ -176,6 +194,8 @@ lang: ko [37]: http://www.sublimetext.com/ [38]: http://ruby.learncodethehardway.org/ [39]: http://kapeli.com/dash -[40]: http://docs.google.com/View?docid=ajb44wcvmjj8_2fg33f2 -[41]: http://mkseo.pe.kr/ -[42]: http://beyond.daesan.com/pages/ruby-faq +[ko-1]: http://docs.google.com/View?docid=ajb44wcvmjj8_2fg33f2 +[ko-2]: http://beyond.daesan.com/pages/ruby-faq +[ko-3]: https://groups.google.com/forum/#!forum/rubykr +[ko-4]: https://www.facebook.com/groups/rubykr/ +[ko-5]: http://ruby-korea.github.io/#book diff --git a/ko/documentation/installation/index.md b/ko/documentation/installation/index.md index 136db3dc20..ab6fc6accc 100644 --- a/ko/documentation/installation/index.md +++ b/ko/documentation/installation/index.md @@ -6,95 +6,59 @@ lang: ko 루비를 설치할때 몇가지 도구를 사용할 수 있습니다. 이 페이지에서는 루비를 설치하고 관리하는 주요 패키지 -관리 시스템들과 서드파티 도구들의 사용법을 설명합니다. +관리 시스템들과 서드파티 도구들의 사용법과 +소스에서 루비를 빌드하는 법을 설명합니다. {: .summary} ## 설치 방법 선택하기 -이 목록은 각 플렛폼에서 가능한 주요 설치방법입니다. -편한 방법을 고르세요. - -* OS X - +루비를 설치하는 방법은 여럿 있습니다. + +* UNIX-계열의 운영체제를 사용하신다면, 운영체제의 + **패키지 관리자**를 사용하는 게 가장 쉽습니다. + 하지만, 패키지의 루비는 보통 최신 버전이 아닙니다. +* **인스톨러** 는 특정 버전이나 여러 버전을 설치하는데 + 사용할 수 있습니다. Windows용 인스톨러도 있습니다. +* **관리자** 는 시스템에 설치된 여러 루비 버전 간의 + 전환을 도와줍니다. +* 마지막으로 **소스에서 빌드** 하실 수도 있습니다. + +이 목록은 각 다른 요구사항과 플렛폼을 위한 주요 설치방법입니다. + +* [패키지 관리 시스템](#package-management-systems) + * [Debian, Ubuntu](#apt) + * [CentOS, Fedora, RHEL](#yum) + * [Gentoo](#portage) + * [Arch Linux](#pacman) + * [OS X](#homebrew) + * [Solaris, OpenIndiana](#solaris) + * [다른 배포판](#other-systems) +* [인스톨러](#installers) + * [ruby-build](#ruby-build) + * [ruby-install](#ruby-install) + * [RubyInstaller](#rubyinstaller) (Windows) + * [RailsInstaller and Ruby Stack](#railsinstaller) +* [관리자](#managers) + * [chruby](#chruby) * [rbenv](#rbenv) * [RVM](#rvm) - * [Homebrew](#homebrew) - * [소스에서 빌드하기](#building-from-source) - -* Linux/UNIX - - * [rbenv](#rbenv) - * [RVM](#rvm) - * [패키지 관리 시스템](#package-management-systems) - * [소스에서 빌드하기](#building-from-source) - -* Windows - - * [RubyInstaller](#rubyinstaller) - * [pik][pik] - - -## 서드파티 도구 - -많은 루비 사용자들이 루비를 설치할 때 서드파티 도구들을 이용하고 있습니다. -그들은 다양한 장점을 부여하지만, 공식적으로 지원되는 것은 아닙니다. -하지만, 그들 각각의 커뮤니티는 매우 유용합니다. + * [pik][pik] (Windows) +* [소스에서 빌드하기](#building-from-source) -### rbenv -{: #rbenv} - -[rbenv][rbenv]는 여러 종류의 루비를 설치할 수 있게 합니다. -rbenv 자체는 루비 설치를 지원하지 않습니다만, ruby-build라는 -유명한 플러그인에서 루비를 설치할 수 있습니다. - -rbenv, ruby-build 모두 맥 OS X, Linux나 다른 UNIX-계열 운영체제에서 사용가능합니다. - -### RVM ("Ruby Version Manager") -{: #rvm} - -[RVM][rvm]은 시스템에 여러 종류의 루비를 설치하고 관리할 수 있게 해줍니다. -RVM은 맥 OS X, Linux나 다른 UNIX-계열 운영체제에서만 사용 가능합니다. - - -### RubyInstaller -{: #rubyinstaller} - -Windows를 사용하고 있다면, 루비 설치를 도와줄 훌륭한 프로젝트 [RubyInstaller][rubyinstaller] -가 있습니다. RubyInstaller는 Windows 환경에서 전체 루비 개발 환경을 설정하는데 필요한 모든 -것을 제공합니다. - -다운로드 받으시고 인스톨러를 실행하기만 하면, 모든 작업은 완료됩니다! - -### RailsInstaller와 Ruby Stack - -루비온레일즈를 사용하기 위해 루비를 설치하신다면 다음 인스톨러를 사용할 수 있습니다. - -* [RailsInstaller][railsinstaller]는 RubyInstaller를 사용하지만, 레일즈 개발을 - 도와줄 추가 도구들을 제공합니다. - OS X, Windows를 지원합니다. -* [Bitnami Ruby Stack][rubystack]는 루비온레일즈를 위한 완전한 개발환경을 제공합니다. - OS X, Linux, Windows, 가상머신, 클라우드 이미지를 지원합니다. - ## 패키지 관리 시스템(Package Management Systems) {: #package-management-systems} -자신의 루비를 컴파일할 수 없고, 서드파티 도구를 사용하고 싶지 않다면, 루비를 설치하기 위해 자신의 시스템의 -패키지 매니저를 사용할 수 있습니다. +자신의 루비를 컴파일할 수 없고, 서드 파티 도구를 사용하고 싶지 않다면, +루비를 설치하기 위해 자신의 시스템의 패키지 관리자를 사용할 수 있습니다. -루비 커뮤니티의 일부 회원들은 루비를 설치할 때 패키지 매니저를 사용하지 말아야 하고, 대신 도구를 사용해야 한다고 강하게 느끼고 있습니다. -장점과 단점의 전체 목록은 본 페이지의 범위 밖에 있는 것이지만, 가장 기본적인 이유는 대부분의 패키지 매니저들이 저장소에 오래된 버전의 루비를 보유하고 있기 때문입니다. -만약 최신의 루비를 사용하고자 한다면, 올바른 패키지 명을 사용했는지 확인하거나 대신 위에 기술된 도구를 사용하십시오. - -밑에서 다음 패키지 관리자에 대해 기술합니다. - -* [apt (Debian or Ubuntu)](#apt) -* [yum (CentOS, Fedora, or RHEL)](#yum) -* [portage (Gentoo)](#gentoo) -* [pacman (Arch Linux)](#pacman) -* [Homebrew (OS X)](#homebrew) -* [Solaris, OpenIndiana](#solaris) +루비 커뮤니티의 일부 회원들은 루비를 설치할 때 패키지 관리자를 사용하지 +말아야 하고, 대신 도구를 사용해야 한다고 강하게 느끼고 있습니다. +장단점의 전체 목록은 이 페이지에서 설명할 내용이 아니지만, 가장 기본적인 +이유는 대부분의 패키지 관리자들의 공식 저장소에는 오래된 버전의 루비가 있기 때문입니다. +최신의 루비를 사용하고자 한다면, 올바른 패키지 명을 사용했는지 확인하거나 +밑에 설명할 도구를 사용하십시오. ### apt (Debian 이나 Ubuntu) @@ -104,11 +68,12 @@ Debian GNU/Linux와 Ubuntu는 apt 패키지 관리 시스템을 사용합니다. 다음과 같이 사용할 수 있습니다. {% highlight sh %} -$ sudo apt-get install ruby +$ sudo apt-get install ruby-full {% endhighlight %} -만약 `ruby` 패키지를 설치하면, Debian이나 Ubuntu의 배포본에 따라 -오래된 루비 1.9.3을 얻게 될 수 있습니다. +글을 쓰는 시점에서, `ruby-full` 패키지는 루비 1.9.3를 설치합니다. +이 버전은 Debian이나 Ubuntu의 오래된 안정 버전입니다. + ### yum (CentOS, Fedora, RHEL) {: #yum} @@ -120,19 +85,20 @@ CentOS, Fedora, RHEL은 yum 패키지 관리 시스템을 사용합니다. $ sudo yum install ruby {% endhighlight %} -설치된 버전은 보통 그 Fedora의 릴리즈 시기의 최신 버전의 루비입니다. +설치된 버전은 보통 그 특정 배포 버전 릴리즈 시기의 최신 버전의 루비입니다. ### portage (Gentoo) {: #portage} -Gentoo는 portage 패키지 메니저를 사용합니다. +Gentoo는 portage 패키지 관리자를 사용합니다. {% highlight sh %} $ sudo emerge dev-lang/ruby {% endhighlight %} -기본적으로, 이 명령어는 모든 가능한 버전(1.8, 1.9, 2.0)을 설치하려 합니다. +기본적으로, 이 명령어는 1.9와 2.0 버전을 설치하려 하지만, 더 많은 버전도 +사용할 수 있습니다. 특정 버전을 설치하려면, `make.conf`에 `RUBY_TARGETS`를 설정하세요. 더 자세한 정보는 [Gentoo 루비 프로젝트 웹사이트][gentoo-ruby]를 확인하세요. @@ -140,8 +106,8 @@ $ sudo emerge dev-lang/ruby ### pacman (Arch Linux) {: #pacman} -Arch Linux는 pacman이라는 이름의 패키지 매니저를 사용합니다. -루비를 얻으려면, 다음과 같이 하면 됩니다. +Arch Linux는 pacman이라는 이름의 패키지 관리자를 사용합니다. +루비를 받으려면, 다음과 같이 하면 됩니다. {% highlight sh %} $ sudo pacman -S ruby @@ -151,33 +117,18 @@ $ sudo pacman -S ruby ### Homebrew (OS X) {: #homebrew} -OS X 매버릭스에는 루비 2.0.0이 포함되어 있습니다. +OS X 매버릭스에는 루비 2.0이 포함되어 있습니다. OS X 마운틴 라이언, 라이언, 스노 레퍼드는 루비 1.8.7을 탑재하여 출시되었습니다. -여기에 최신 버전의 루비를 설치할 수 있는 몇 가지 -옵션이 있습니다. - -대부분의 루비 커뮤니티의 OS X 유저는 서드파티 도구를 -사용합니다. 하지만 몇 가지의 루비를 지원하는 패키지 -관리자가 있습니다. - -Mac OS X 타이거는 루비 1.8.2를 탑재하여 패키징되었고 -레퍼드는 1.8.6를 탑재하여 출시되었습니다. -하지만, 레퍼드로 업그레이드 하지 않은 사용자들을 위해, -최신 버전의 루비를 설치할 수 있는 몇 가지 옵션이 있습니다. - -많은 OS X 사용자들은 패키지 매니저로 [Homebrew][homebrew]를 사용합니다. -루비를 얻는 방법은 정말로 쉽습니다. +많은 OS X 사용자들은 패키지 관리자로 [Homebrew][homebrew]를 사용합니다. +Homebrew를 사용해 새로운 버전의 루비를 얻는 방법은 정말로 쉽습니다. {% highlight sh %} $ brew install ruby {% endhighlight %} -또한, OS X는 Unix 기반이기 때문에, 소스를 다운로드 받고 -설치하는 것은 다른 솔루션들과 마찬가지로 손쉽고 효과적입니다. -OS X에서 새로운 루비 버전을 설치하는 것을 돕기 위해, 서드파티 -도구를 사용하는 것은 좋은 아이디어일 것입니다. +이 명령어는 최신 루비 버전을 설치할 것입니다. ### Solaris와 OpenIndiana 에서의 루비 @@ -185,7 +136,7 @@ OS X에서 새로운 루비 버전을 설치하는 것을 돕기 위해, 서드 Solaris 8에서 Solaris 10까지 [Sunfreeware][sunfreeware]에서 루비 1.8.7을 사용 가능하며 [Blastwave][blastwave]에서 루비 1.8.7을 사용 가능합니다. -[Sunfreeware][sunfreeware]에서 루비 1.9.2p0를 사용 가능하지만, 이것은 구버전입니다. +[Sunfreeware][sunfreeware]에서 루비 1.9.2p0를 사용 가능하지만, 이는 구 버전입니다. 서드파티 도구를 사용하면 최신 버전의 루비를 얻을 수 있습니다. [OpenIndiana][openindiana]에서 루비를 설치하려면, @@ -197,20 +148,103 @@ Solaris 8에서 Solaris 10까지 [Sunfreeware][sunfreeware]에서 루비 1.8.7 $ pkg install runtime/ruby-18 {% endhighlight %} -이전과 마찬가지로, 서드파티 도구는 최신 버전의 루비를 얻는 좋은 방법입니다. +하지만, 서드파티 도구를 사용하는 것이 최신 버전의 루비를 얻는 더 좋은 방법입니다. ### 다른 배포판 -다른 시스템에서는 자신의 Linux 배포 매니저를 위한 패키지 저장소를 검색할 수 있습니다. +다른 시스템에서는 자신의 Linux 배포 관리자를 위한 패키지 저장소를 검색할 수 있습니다. 아니면 서드파티 도구가 당신을 위한 올바른 선택일 수 있습니다. +## 인스톨러 +{: #installers} + +시스템이나 패키지 관리자에서 제공하는 루비가 구 버전이라면, 서드 파티 인스톨러를 +사용해 새로운 버전의 루비를 설치할 수 있습니다. +어떤 인스톨러는 여러 버전의 루비를 같은 시스템에 설치하게 합니다. +관련된 관리자는 다른 루비간의 전환을 도와줍니다. +[RVM](#rvm)을 버전 관리자로 사용할 계획이라면 포함되어 있으므로 별도의 인스톨러는 +필요 없습니다. + + +### ruby-build +{: #ruby-build} + +[ruby-build][ruby-build]는 다른 버전의 루비를 임의의 디렉토리에 +컴파일하고 설치할 수 있게 하는 [rbenv](#rbenv)의 플러그인입니다. +ruby-build는 rbenv없이 독자적으로 사용 할 수도 있습니다. +맥 OS X, Linux나 다른 UNIX-계열 운영체제에서만 사용 가능합니다. + + +### ruby-install +{: #ruby-install} + +[ruby-install][ruby-install]은 다른 버전의 루비를 임의의 디렉토리에 +컴파일하고 설치할 수 있게 합니다. +루비 버전을 전환하는 [chruby](#chruby)와 형제 관계입니다. +맥 OS X, Linux나 다른 UNIX-계열 운영체제에서만 사용 가능합니다. + + +### RubyInstaller +{: #rubyinstaller} + +Windows를 사용하고 있다면, 루비 설치를 도와줄 훌륭한 프로젝트 [RubyInstaller][rubyinstaller] +가 있습니다. RubyInstaller는 Windows 환경에서 전체 루비 개발 환경을 설정하는데 필요한 모든 +것을 제공합니다. + +다운로드 받으시고 인스톨러를 실행하기만 하면 끝입니다! + + +### RailsInstaller와 Ruby Stack +{: #railsinstaller} + +루비온레일즈를 사용하기 위해 루비를 설치하신다면 다음 인스톨러를 사용할 수 있습니다. + +* [RailsInstaller][railsinstaller]는 RubyInstaller를 사용하지만, 레일즈 개발을 + 도와줄 추가 도구들을 제공합니다. + OS X, Windows를 지원합니다. +* [Bitnami Ruby Stack][rubystack]는 루비온레일즈를 위한 완전한 개발환경을 제공합니다. + OS X, Linux, Windows, 가상머신, 클라우드 이미지를 지원합니다. + + +## 관리자 + +많은 루비스트들이 여러 버전의 루비를 관리하기 위해 루비 관리자를 사용합니다. +그들은 다양한 장점을 부여하지만, 공식적으로 지원되는 것은 아닙니다. +하지만, 그들 각각의 커뮤니티는 매우 유용합니다. + + +### chruby +{: #chruby} + +[chruby][chruby] 는 여러 루비들 간의 전환을 하게 합니다. +chruby는 [ruby-install](#ruby-install)로 설치된 루비 뿐만 +아니라 소스에서 빌드 된 루비도 관리할 수 있습니다. + + +### rbenv +{: #rbenv} + +[rbenv][rbenv]는 여러 종류의 루비를 설치할 수 있게 합니다. +rbenv 자체는 루비 설치를 지원하지 않습니다만, [ruby-build](#ruby-build)라는 +유명한 플러그인에서 루비를 설치할 수 있습니다. +rbenv, ruby-build 모두 맥 OS X, Linux나 다른 UNIX-계열 운영체제에서 사용가능합니다. + + +### RVM ("Ruby Version Manager") +{: #rvm} + +[RVM][rvm]은 시스템에 여러 종류의 루비를 설치하고 관리할 수 있게 해줍니다. +RVM은 다른 gemsets도 관리 해 줍니다. +맥 OS X, Linux나 다른 UNIX-계열 운영체제에서만 사용 가능합니다. + + ## 소스에서 빌드하기 {: #building-from-source} 물론, 소스로부터 루비를 설치할 수도 있습니다. -타르볼을 [다운로드](/ko/downloads/), 압축해제하고 이 명령어를 입력하세요. +타르볼을 [다운로드](/ko/downloads/), 압축을 풀고 이 명령어를 입력하세요. {% highlight sh %} $ ./configure @@ -226,11 +260,14 @@ $ sudo make install [rvm]: http://rvm.io/ -[rbenv]: https://github.com/sstephenson/rbenv +[rbenv]: https://github.com/sstephenson/rbenv#readme +[ruby-build]: https://github.com/sstephenson/ruby-build#readme +[ruby-install]: https://github.com/postmodern/ruby-install#readme +[chruby]: https://github.com/postmodern/chruby#readme [rubyinstaller]: http://rubyinstaller.org/ [railsinstaller]: http://railsinstaller.org/ [rubystack]: http://bitnami.com/stack/ruby/installer -[pik]: https://github.com/vertiginous/pik +[pik]: https://github.com/vertiginous/pik#readme [sunfreeware]: http://www.sunfreeware.com [blastwave]: http://www.blastwave.org [openindiana]: http://openindiana.org/ diff --git a/ko/documentation/quickstart/index.md b/ko/documentation/quickstart/index.md index 171188a231..1919941940 100644 --- a/ko/documentation/quickstart/index.md +++ b/ko/documentation/quickstart/index.md @@ -21,8 +21,8 @@ header: | 이 문서는 20분 정도면 따라 해볼 수 있는 간단한 루비 튜토리얼입니다. 이 튜토리얼을 따라 하기 위해서는 컴퓨터에 루비가 설치되어 있어야 -합니다. (아직 루비가 설치되어 있지 않다면, [이곳](/ko/downloads/)에서 -다운로드 받아 설치하시기 바랍니다.) +합니다. (아직 루비가 설치되어 있지 않다면, 시작하기 전에 +[설치][installation]하시기 바랍니다.) ## 대화형 루비 셸(irb) @@ -133,3 +133,4 @@ irb(main):009:0> Math.sqrt(a+b) 물론 계산기만으로도 유용하겠지만, 이제 다시 전통적인 `Hello World` 프로그램을 만드는 초심자 튜토리얼으로 [돌아가 보겠습니다.](2/) +[installation]: /ko/documentation/installation/