Skip to content

Commit

Permalink
Translate "First pass at updating en/documentation/index.md" (ko) (#3464
Browse files Browse the repository at this point in the history 
)

* Add diff from a17c89b

Ref: #3427

* Translate "First pass at updating en/documentation/index.md" (ko)

* Restore first section

* Remove old "Learn Ruby the Hard Way"

which is moved to "오래된 문서"

* Apply suggestions from code review

Co-authored-by: Chayoung You <[email protected]>

* Update ko/documentation/index.md

Co-authored-by: Chayoung You <[email protected]>

* Remove all "(영문)"

* Small update about ruby lsp supported editor link

---------

Co-authored-by: Chayoung You <[email protected]>
  • Loading branch information
@riseshia @yous
riseshia and yous authored Jan 17, 2025
1 parent d3e0f0f commit 59ca2c7
Showing 1 changed file with 181 additions and 87 deletions.
268 changes: 181 additions & 87 deletions ko/documentation/index.md
View file
Original file line number Diff line number Diff line change
Expand Up @@ -22,140 +22,234 @@ Ruby를 이해하고 싶다면, [docs.ruby-lang.org][docs-rlo-en]의 권위 있

### 초보자용 문서

[공식 FAQ](faq/)
: 자주 묻는 질문들을 모았습니다.
[Try Ruby][1]
: 브라우저에서 Ruby를 시험해 볼 수 있습니다.

[Ruby Koans][2] (영문)
: Koans는 Ruby를 배우는 깨달음의 길로 여러분을 안내합니다. Koans의 목표는
Ruby 언어, 문법, 구조, 일반적인 함수들과 라이브러리를 배우는 것입니다.
Koans에서는 문화도 가르칩니다.
[Learn to Program][8]
: Chris Pine 님이 작성한 초보자를 위한 작고 멋진 튜토리얼입니다.
프로그래밍을 모르신다면 여기서 시작하세요.

[Why’s (Poignant) Guide to Ruby][5] (영문)
: 이야기, 재치, 만화를 통해 Ruby를 가르쳐주는 틀에 얽매이지 않는 재미있는
책입니다. *Why the Lucky Stiff*의 저작물로 Ruby를 배우는 사람을 위한
고전입니다.
[Ruby in Twenty Minutes][rubyin20]
: 20분 이내에 끝낼 수 있는 작은 Ruby 튜토리얼입니다.

[Ruby Essentials][7] (영문)
: 간결하고 따라 하기 쉬운 Ruby 가이드를 제공하는 무료 온라인 책입니다.
[The Odin Project][odin]
: 오픈소스 풀스택 커리큘럼입니다.

[Learn to Program][8] (영문)
: Chris Pine 님이 작성한 초보자를 위한 작고 멋진 튜토리얼입니다.
프로그래밍을 모르신다면 여기서 시작하세요.
[excercism][exercism]
: 자동 분석과 개인 멘토링이 포함된 120개의 연습문제가 제공됩니다.

[Learn Ruby the Hard Way][38] (영문)
: 아주 기초적인 내용부터 OOP에서 웹 개발까지 다루는 매우 좋은 설명이
달린 예제들입니다.
[Codecademy][codecademy]
: 다양한 주제를 다루는 온라인 코드 부트캠프입니다. 무료입니다.

[Ruby For Impatient Nuby][ko-1]
: 서민구 님이 작성하신 Ruby 초보자를 위한 튜토리얼입니다.

[루비 프로그래밍 언어 FAQ][ko-2]
: 황대산 님이 정리하신 FAQ입니다.

### 매뉴얼
### 매뉴얼 / 책

[Programming Ruby][9] (영문)
: 영어로 된 독창적인 Ruby 책입니다. [Pragmatic Programmers의 책][10]
1판이 무료로 온라인에 공개되어 있습니다.
#### 초보자

[The Ruby Programming Wikibook][12] (영문)
: 초보자와 중급자를 위한 무료 온라인 매뉴얼과 전 언어 레퍼런스입니다.
[Programming Ruby 3.3][pickaxe]
: 영어로 된 독창적인 Ruby 책입니다. 최근에 Ruby 3.3으로 업데이트되었습니다.

[The Well-Grounded Rubyist][grounded]
: 첫 Ruby 프로그램부터 리플렉션, 스레딩, 재귀 등과 같은 고급 주제까지 다루는 튜토리얼입니다.

#### 중급자

[Practical OOD in Ruby (POODR)][poodr]
: 객체지향 코드를 작성하는 방법에 대한 프로그래머의 이야기입니다.

#### 전문가

[Metaprogramming][meta]
: 메타 프로그래밍을 실용적인 방식으로 설명합니다.

[Ruby Under a Microscope (RUM)][microscope]
: Ruby 내부를 설명하는 그림이 포함된 가이드입니다.

### 참조

[공식 API 문서][docs-rlo-en]
[공식 API 문서][docs-rlo-en] [(JP)][docs-rlo-jp]
: 아직 릴리스되지 않은 트렁크를 포함한 여러 Ruby 버전의 공식 언어 문서입니다.

[Ruby C API 레퍼런스][extensions] (영문)
[Ruby C API 레퍼런스][extensions] [(JP)][extensions-jp]
: Ruby의 공식 C API 문서입니다.
Ruby 개발에 참여하거나, C 확장을 개발할 때 도움이 될 것입니다.

[RubyDoc.info][16] (영문)
[RubyDoc.info][16]
: Ruby gem과 GitHub에서 호스팅 되는 Ruby 프로젝트의 레퍼런스 문서들을
모아놓은 사이트입니다.

[Ruby API][40] (영문)
[Ruby API][40]
: Ruby 클래스, 모듈, 메서드를 편하게 찾고 탐색하세요.

[ruby-doc.org][39]
: 온라인 API 문서입니다.

[DevDocs.io][40]
: 온라인 API 문서입니다.

[Ruby QuickRef][42]
: 빠른 Ruby 참조 문서입니다.

[rubyreferences][43]
: 완전한 언어 레퍼런스와 상세한 언어 변경 로그입니다. 훌륭합니다.

### 스타일 가이드

[rubystyle.guide][44]
: RuboCop의 Ruby 스타일 가이드

[RuboCop][45]
: RuboCop의 스타일 가이드를 자동으로 적용합니다.

[Shopify][46]
: Shopify의 Ruby 스타일 가이드

[GitLab][47]
: GitLab의 Ruby 스타일 가이드

[Airbnb][48]
: Airbnb의 Ruby 스타일 가이드

[w3resource][49]
: W3의 Ruby 스타일 가이드

# 도구

[IRB][50]
: 대화형 Ruby 셸(Read-Eval-Print-Loop, REPL)입니다.

[Pry][51]
: 또 다른 Ruby REPL입니다.

[Rake][52]
: Ruby의 make와 비슷한 빌드 유틸리티입니다.

[RI][53]
: RI(Ruby Information)는 Ruby의 명령줄 유틸리티로 Ruby 문서에 빠르고 쉽게 접근할 수 있습니다.

[RBS][54]
: Ruby의 타입 시그니처입니다.

[TypeProf][55]
: Ruby 코드를 테스트하고 이해하기 위한 실험적인 타입 수준의 Ruby 인터프리터입니다.

[Steep][56]
: Ruby의 정적 타입 검사기입니다.

### 편집기와 IDE

Ruby를 코딩할 때 운영체제의 기본 편집기를 사용할 수 있습니다. 하지만,
더욱 효율적인 코딩을 위해, 기본적으로 Ruby를 지원하는(신택스 하이라이팅,
파일 브라우징 등등) 편집기나 고급 기능(자동완성, 리팩토링, 테스트
지원 등등)이 있는 통합 개발 환경도 생각해 볼 만합니다.

루비스트들이 주로 사용하는 도구들의 목록입니다.

* Linux, 크로스 플랫폼
* [Aptana Studio][19]
* [Atom][atom]
* [Emacs][20], [Ruby mode][21], [Rsense][22]
* [Eric][eric]
* [Geany][23]
* [gedit][24]
* [Kate][kate]
* [KDevelop][kdevelop]
* [NetBeans][36]
* [RubyMine][27]
* [SciTe][28]
* [Sublime Text][37]
* [Vim][25], [vim-ruby][26] 플러그인, [Rsense][22]
루비스트가 사용하는 인기 있는 편집기 목록을
학습 곡선에 따라 나누어 놓았습니다.
* 며칠 안에 익힐 수 있는 편집기
* [Sublime Text][37] (유료)
* [Visual Studio Code][vscode]
* [Zed][zed]
* 몇 개월 정도 걸리는 편집기
* [RubyMine][27] (유료)
* "몇 년" (즉, 몇 년 동안 새로운 것을 계속 배울 수 있는 에디터)
* [Ruby 모드][21]나 [향상된 Ruby 모드][enh-ruby-mode]를 사용하는 [Emacs][20]
* [vim-ruby][26] 플러그인을 사용하는 [Vim][25]
* [NeoVim][neovim]

위에서 언급한 모든 편집기는 기본으로 또는 LSP 플러그인을 통해
언어 서버 프로토콜(LSP)을 지원합니다. Shopify의 [ruby-lsp][ruby-lsp]는
Ruby를 위한 가장 인기 있는 언어 서버 중 하나이며,
[위에서 언급한 모든 편집기를 지원합니다][ruby-lsp-supported-editors].

### 오래된 문서 / 리소스

다음 링크들은 한때 더 주목받았지만 오랫동안 업데이트되지 않았습니다.

* Windows
* [Notepad++][29]
[Ruby Koans][2]
: Koans는 Ruby를 배우는 깨달음의 길로 여러분을 안내합니다. Koans의 목표는
Ruby 언어, 문법, 구조, 일반적인 함수들과 라이브러리를 배우는 것입니다.
Koans에서는 문화도 가르칩니다.

[Ruby Essentials][7]
: 간결하고 따라 하기 쉬운 Ruby 가이드를 제공하는
무료 온라인 책입니다.

[Why’s (Poignant) Guide to Ruby][5]
: 이야기, 재치, 만화를 통해 Ruby를 가르쳐주는 틀에 얽매이지 않는 재미있는
책입니다. *Why the Lucky Stiff*의 저작물로 Ruby를 배우는 사람을 위한
고전입니다.

* macOS
* [TextMate][32]
* [BBEdit][33]
* [Dash][39] (문서 브라우저)
[Learn Ruby the Hard Way][38]
: 아주 기초적인 내용부터 OOP에서 웹 개발까지 다루는 매우 좋은 설명이
달린 예제들입니다.

### 더 읽을거리
[Programming Ruby][9]
: 영어로 된 독창적인 Ruby 책입니다. [Pragmatic Programmers의 책][10]
1판이 무료로 온라인에 공개되어 있습니다.

[Ruby-Doc.org][34]는 Ruby 영문 문서를 포괄적으로 관리하는 사이트입니다. Ruby
[책들][ko-5]도 출판되어 있습니다. Ruby에
관한 질문이 있다면, [유저 그룹][ko-3]이나 [페이스북 그룹][ko-4]에서 하실 수 있고
영어가 되신다면 [메일링 리스트](/ko/community/mailing-lists/)를 사용하실 수도
있습니다.
[The Ruby Programming Wikibook][12]
: 초보자와 중급자를 위한 무료 온라인 매뉴얼과
언어 전체 레퍼런스입니다.

[1]: https://try.ruby-lang.org/
[2]: https://rubykoans.com/
[5]: https://poignant.guide
[7]: http://www.techotopia.com/index.php/Ruby_Essentials
[8]: http://pine.fm/LearnToProgram/
[9]: http://www.ruby-doc.org/docs/ProgrammingRuby/
[7]: https://www.techotopia.com/index.php/Ruby_Essentials
[8]: https://pine.fm/LearnToProgram/
[9]: https://www.ruby-doc.org/docs/ProgrammingRuby/
[10]: https://pragprog.com/titles/ruby5/programming-ruby-3-3-5th-edition/
[12]: http://en.wikibooks.org/wiki/Ruby_programming_language
[extensions]: https://docs.ruby-lang.org/en/master/extension_rdoc.html
[16]: http://www.rubydoc.info/
[19]: http://www.aptana.com/
[20]: http://www.gnu.org/software/emacs/
[21]: http://www.emacswiki.org/emacs/RubyMode
[22]: http://rsense.github.io/
[23]: http://www.geany.org/
[24]: http://projects.gnome.org/gedit/screenshots.html
[25]: http://www.vim.org/
[12]: https://en.wikibooks.org/wiki/Ruby_programming_language
[16]: https://www.rubydoc.info/
[20]: https://www.gnu.org/software/emacs/
[21]: https://www.emacswiki.org/emacs/RubyMode
[25]: https://www.vim.org/
[26]: https://github.com/vim-ruby/vim-ruby
[27]: http://www.jetbrains.com/ruby/
[28]: http://www.scintilla.org/SciTE.html
[29]: http://notepad-plus-plus.org/
[32]: http://macromates.com/
[33]: https://www.barebones.com/products/bbedit/
[34]: http://ruby-doc.org
[36]: https://netbeans.org/
[37]: http://www.sublimetext.com/
[27]: https://www.jetbrains.com/ruby/
[34]: https://ruby-doc.org/
[37]: https://www.sublimetext.com/
[38]: https://learncodethehardway.org/ruby/
[39]: http://kapeli.com/dash
[40]: https://rubyapi.org/
[docs-rlo-en]: https://docs.ruby-lang.org/en/
[atom]: https://atom.io/
[39]: https://www.ruby-doc.org/
[40]: https://devdocs.io/ruby/
[42]: https://www.zenspider.com/ruby/quickref.html
[43]: https://rubyreferences.github.io/
[44]: https://rubystyle.guide/
[45]: https://github.com/rubocop/ruby-style-guide
[46]: https://ruby-style-guide.shopify.dev/
[47]: https://docs.gitlab.com/ee/development/backend/ruby_style_guide.html
[48]: https://github.com/airbnb/ruby
[49]: https://www.w3resource.com/ruby/ruby-style-guide.php
[50]: https://github.com/ruby/irb
[51]: https://github.com/pry/pry
[52]: https://github.com/ruby/rake
[53]: https://ruby.github.io/rdoc/RI_md.html
[54]: https://github.com/ruby/rbs
[55]: https://github.com/ruby/typeprof
[56]: https://github.com/soutaro/steep
[codecademy]: https://www.codecademy.com/learn/learn-ruby
[docs-rlo-en]: https://docs.ruby-lang.org/en/latest
[docs-rlo-jp]: https://docs.ruby-lang.org/ja/latest
[enh-ruby-mode]: https://github.com/zenspider/enhanced-ruby-mode/
[exercism]: https://exercism.org/tracks/ruby
[extensions-jp]: https://docs.ruby-lang.org/jp/master/extension_rdoc.html
[extensions]: https://docs.ruby-lang.org/en/master/extension_rdoc.html
[grounded]: https://www.manning.com/books/the-well-grounded-rubyist-third-edition
[meta]: https://pragprog.com/titles/ppmetr2/metaprogramming-ruby-2/
[microscope]: https://patshaughnessy.net/ruby-under-a-microscope
[neovim]: https://neovim.io/
[odin]: https://www.theodinproject.com/paths/full-stack-ruby-on-rails/courses/ruby
[pickaxe]: https://pragprog.com/titles/ruby5/programming-ruby-3-3-5th-edition/
[poodr]: https://www.poodr.com/
[ruby-lsp]: https://github.com/Shopify/ruby-lsp
[ruby-lsp-supported-editors]: https://shopify.github.io/ruby-lsp/editors.html
[rubyapi-org]: https://rubyapi.org/
[rubyin20]: https://www.ruby-lang.org/ko/documentation/quickstart/
[vscode]: https://code.visualstudio.com/docs/languages/ruby
[eric]: https://eric-ide.python-projects.org/
[kdevelop]: https://www.kdevelop.org/
[kate]: https://kate-editor.org/
[zed]: https://zed.dev/

[ko-1]: https://docs.google.com/document/d/15yEpi2ZMB2Lld5lA1TANt13SJ_cKygP314cqyKhELwQ/preview
[ko-2]: https://web.archive.org/web/20190521035426/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

0 comments on commit 59ca2c7

Please sign in to comment.