Skip to content

Commit 59ca2c7

Browse files
riseshiayous
andauthored
Translate "First pass at updating en/documentation/index.md" (ko) (#3464)
* 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]>
1 parent d3e0f0f commit 59ca2c7

File tree

1 file changed

+181
-87
lines changed

1 file changed

+181
-87
lines changed

ko/documentation/index.md

+181-87
Original file line numberDiff line numberDiff line change
@@ -22,140 +22,234 @@ Ruby를 이해하고 싶다면, [docs.ruby-lang.org][docs-rlo-en]의 권위 있
2222

2323
### 초보자용 문서
2424

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

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

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

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

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

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

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

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

55-
### 매뉴얼
50+
### 매뉴얼 / 책
5651

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

61-
[The Ruby Programming Wikibook][12] (영문)
62-
: 초보자와 중급자를 위한 무료 온라인 매뉴얼과 전 언어 레퍼런스입니다.
54+
[Programming Ruby 3.3][pickaxe]
55+
: 영어로 된 독창적인 Ruby 책입니다. 최근에 Ruby 3.3으로 업데이트되었습니다.
56+
57+
[The Well-Grounded Rubyist][grounded]
58+
: 첫 Ruby 프로그램부터 리플렉션, 스레딩, 재귀 등과 같은 고급 주제까지 다루는 튜토리얼입니다.
59+
60+
#### 중급자
61+
62+
[Practical OOD in Ruby (POODR)][poodr]
63+
: 객체지향 코드를 작성하는 방법에 대한 프로그래머의 이야기입니다.
64+
65+
#### 전문가
66+
67+
[Metaprogramming][meta]
68+
: 메타 프로그래밍을 실용적인 방식으로 설명합니다.
69+
70+
[Ruby Under a Microscope (RUM)][microscope]
71+
: Ruby 내부를 설명하는 그림이 포함된 가이드입니다.
6372

6473
### 참조
6574

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

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

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

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

89+
[ruby-doc.org][39]
90+
: 온라인 API 문서입니다.
91+
92+
[DevDocs.io][40]
93+
: 온라인 API 문서입니다.
94+
95+
[Ruby QuickRef][42]
96+
: 빠른 Ruby 참조 문서입니다.
97+
98+
[rubyreferences][43]
99+
: 완전한 언어 레퍼런스와 상세한 언어 변경 로그입니다. 훌륭합니다.
100+
101+
### 스타일 가이드
102+
103+
[rubystyle.guide][44]
104+
: RuboCop의 Ruby 스타일 가이드
105+
106+
[RuboCop][45]
107+
: RuboCop의 스타일 가이드를 자동으로 적용합니다.
108+
109+
[Shopify][46]
110+
: Shopify의 Ruby 스타일 가이드
111+
112+
[GitLab][47]
113+
: GitLab의 Ruby 스타일 가이드
114+
115+
[Airbnb][48]
116+
: Airbnb의 Ruby 스타일 가이드
117+
118+
[w3resource][49]
119+
: W3의 Ruby 스타일 가이드
120+
121+
# 도구
122+
123+
[IRB][50]
124+
: 대화형 Ruby 셸(Read-Eval-Print-Loop, REPL)입니다.
125+
126+
[Pry][51]
127+
: 또 다른 Ruby REPL입니다.
128+
129+
[Rake][52]
130+
: Ruby의 make와 비슷한 빌드 유틸리티입니다.
131+
132+
[RI][53]
133+
: RI(Ruby Information)는 Ruby의 명령줄 유틸리티로 Ruby 문서에 빠르고 쉽게 접근할 수 있습니다.
134+
135+
[RBS][54]
136+
: Ruby의 타입 시그니처입니다.
137+
138+
[TypeProf][55]
139+
: Ruby 코드를 테스트하고 이해하기 위한 실험적인 타입 수준의 Ruby 인터프리터입니다.
140+
141+
[Steep][56]
142+
: Ruby의 정적 타입 검사기입니다.
143+
80144
### 편집기와 IDE
81145

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

87-
루비스트들이 주로 사용하는 도구들의 목록입니다.
88-
89-
* Linux, 크로스 플랫폼
90-
* [Aptana Studio][19]
91-
* [Atom][atom]
92-
* [Emacs][20], [Ruby mode][21], [Rsense][22]
93-
* [Eric][eric]
94-
* [Geany][23]
95-
* [gedit][24]
96-
* [Kate][kate]
97-
* [KDevelop][kdevelop]
98-
* [NetBeans][36]
99-
* [RubyMine][27]
100-
* [SciTe][28]
101-
* [Sublime Text][37]
102-
* [Vim][25], [vim-ruby][26] 플러그인, [Rsense][22]
151+
루비스트가 사용하는 인기 있는 편집기 목록을
152+
학습 곡선에 따라 나누어 놓았습니다.
153+
* 며칠 안에 익힐 수 있는 편집기
154+
* [Sublime Text][37] (유료)
103155
* [Visual Studio Code][vscode]
156+
* [Zed][zed]
157+
* 몇 개월 정도 걸리는 편집기
158+
* [RubyMine][27] (유료)
159+
* "몇 년" (즉, 몇 년 동안 새로운 것을 계속 배울 수 있는 에디터)
160+
* [Ruby 모드][21][향상된 Ruby 모드][enh-ruby-mode]를 사용하는 [Emacs][20]
161+
* [vim-ruby][26] 플러그인을 사용하는 [Vim][25]
162+
* [NeoVim][neovim]
163+
164+
위에서 언급한 모든 편집기는 기본으로 또는 LSP 플러그인을 통해
165+
언어 서버 프로토콜(LSP)을 지원합니다. Shopify의 [ruby-lsp][ruby-lsp]
166+
Ruby를 위한 가장 인기 있는 언어 서버 중 하나이며,
167+
[위에서 언급한 모든 편집기를 지원합니다][ruby-lsp-supported-editors].
168+
169+
### 오래된 문서 / 리소스
170+
171+
다음 링크들은 한때 더 주목받았지만 오랫동안 업데이트되지 않았습니다.
104172

105-
* Windows
106-
* [Notepad++][29]
173+
[Ruby Koans][2]
174+
: Koans는 Ruby를 배우는 깨달음의 길로 여러분을 안내합니다. Koans의 목표는
175+
Ruby 언어, 문법, 구조, 일반적인 함수들과 라이브러리를 배우는 것입니다.
176+
Koans에서는 문화도 가르칩니다.
177+
178+
[Ruby Essentials][7]
179+
: 간결하고 따라 하기 쉬운 Ruby 가이드를 제공하는
180+
무료 온라인 책입니다.
181+
182+
[Why’s (Poignant) Guide to Ruby][5]
183+
: 이야기, 재치, 만화를 통해 Ruby를 가르쳐주는 틀에 얽매이지 않는 재미있는
184+
책입니다. *Why the Lucky Stiff*의 저작물로 Ruby를 배우는 사람을 위한
185+
고전입니다.
107186

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

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

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

121199
[1]: https://try.ruby-lang.org/
122200
[2]: https://rubykoans.com/
123201
[5]: https://poignant.guide
124-
[7]: http://www.techotopia.com/index.php/Ruby_Essentials
125-
[8]: http://pine.fm/LearnToProgram/
126-
[9]: http://www.ruby-doc.org/docs/ProgrammingRuby/
202+
[7]: https://www.techotopia.com/index.php/Ruby_Essentials
203+
[8]: https://pine.fm/LearnToProgram/
204+
[9]: https://www.ruby-doc.org/docs/ProgrammingRuby/
127205
[10]: https://pragprog.com/titles/ruby5/programming-ruby-3-3-5th-edition/
128-
[12]: http://en.wikibooks.org/wiki/Ruby_programming_language
129-
[extensions]: https://docs.ruby-lang.org/en/master/extension_rdoc.html
130-
[16]: http://www.rubydoc.info/
131-
[19]: http://www.aptana.com/
132-
[20]: http://www.gnu.org/software/emacs/
133-
[21]: http://www.emacswiki.org/emacs/RubyMode
134-
[22]: http://rsense.github.io/
135-
[23]: http://www.geany.org/
136-
[24]: http://projects.gnome.org/gedit/screenshots.html
137-
[25]: http://www.vim.org/
206+
[12]: https://en.wikibooks.org/wiki/Ruby_programming_language
207+
[16]: https://www.rubydoc.info/
208+
[20]: https://www.gnu.org/software/emacs/
209+
[21]: https://www.emacswiki.org/emacs/RubyMode
210+
[25]: https://www.vim.org/
138211
[26]: https://github.com/vim-ruby/vim-ruby
139-
[27]: http://www.jetbrains.com/ruby/
140-
[28]: http://www.scintilla.org/SciTE.html
141-
[29]: http://notepad-plus-plus.org/
142-
[32]: http://macromates.com/
143-
[33]: https://www.barebones.com/products/bbedit/
144-
[34]: http://ruby-doc.org
145-
[36]: https://netbeans.org/
146-
[37]: http://www.sublimetext.com/
212+
[27]: https://www.jetbrains.com/ruby/
213+
[34]: https://ruby-doc.org/
214+
[37]: https://www.sublimetext.com/
147215
[38]: https://learncodethehardway.org/ruby/
148-
[39]: http://kapeli.com/dash
149-
[40]: https://rubyapi.org/
150-
[docs-rlo-en]: https://docs.ruby-lang.org/en/
151-
[atom]: https://atom.io/
216+
[39]: https://www.ruby-doc.org/
217+
[40]: https://devdocs.io/ruby/
218+
[42]: https://www.zenspider.com/ruby/quickref.html
219+
[43]: https://rubyreferences.github.io/
220+
[44]: https://rubystyle.guide/
221+
[45]: https://github.com/rubocop/ruby-style-guide
222+
[46]: https://ruby-style-guide.shopify.dev/
223+
[47]: https://docs.gitlab.com/ee/development/backend/ruby_style_guide.html
224+
[48]: https://github.com/airbnb/ruby
225+
[49]: https://www.w3resource.com/ruby/ruby-style-guide.php
226+
[50]: https://github.com/ruby/irb
227+
[51]: https://github.com/pry/pry
228+
[52]: https://github.com/ruby/rake
229+
[53]: https://ruby.github.io/rdoc/RI_md.html
230+
[54]: https://github.com/ruby/rbs
231+
[55]: https://github.com/ruby/typeprof
232+
[56]: https://github.com/soutaro/steep
233+
[codecademy]: https://www.codecademy.com/learn/learn-ruby
234+
[docs-rlo-en]: https://docs.ruby-lang.org/en/latest
235+
[docs-rlo-jp]: https://docs.ruby-lang.org/ja/latest
236+
[enh-ruby-mode]: https://github.com/zenspider/enhanced-ruby-mode/
237+
[exercism]: https://exercism.org/tracks/ruby
238+
[extensions-jp]: https://docs.ruby-lang.org/jp/master/extension_rdoc.html
239+
[extensions]: https://docs.ruby-lang.org/en/master/extension_rdoc.html
240+
[grounded]: https://www.manning.com/books/the-well-grounded-rubyist-third-edition
241+
[meta]: https://pragprog.com/titles/ppmetr2/metaprogramming-ruby-2/
242+
[microscope]: https://patshaughnessy.net/ruby-under-a-microscope
243+
[neovim]: https://neovim.io/
244+
[odin]: https://www.theodinproject.com/paths/full-stack-ruby-on-rails/courses/ruby
245+
[pickaxe]: https://pragprog.com/titles/ruby5/programming-ruby-3-3-5th-edition/
246+
[poodr]: https://www.poodr.com/
247+
[ruby-lsp]: https://github.com/Shopify/ruby-lsp
248+
[ruby-lsp-supported-editors]: https://shopify.github.io/ruby-lsp/editors.html
249+
[rubyapi-org]: https://rubyapi.org/
250+
[rubyin20]: https://www.ruby-lang.org/ko/documentation/quickstart/
152251
[vscode]: https://code.visualstudio.com/docs/languages/ruby
153-
[eric]: https://eric-ide.python-projects.org/
154-
[kdevelop]: https://www.kdevelop.org/
155-
[kate]: https://kate-editor.org/
252+
[zed]: https://zed.dev/
156253

157254
[ko-1]: https://docs.google.com/document/d/15yEpi2ZMB2Lld5lA1TANt13SJ_cKygP314cqyKhELwQ/preview
158255
[ko-2]: https://web.archive.org/web/20190521035426/http://beyond.daesan.com/pages/ruby-faq
159-
[ko-3]: https://groups.google.com/forum/#!forum/rubykr
160-
[ko-4]: https://www.facebook.com/groups/rubykr/
161-
[ko-5]: http://ruby-korea.github.io/#book

0 commit comments

Comments
 (0)