@@ -11,62 +11,127 @@ lang: zh_tw
11
11
12
12
儘管可以輕鬆的[ 在瀏覽器試玩 Ruby ] [ 1 ] ,你還是可以閱讀[ 安裝指南] ( installation/ ) 來幫助你安裝 Ruby。
13
13
14
+ ### 官方 Ruby 文件
15
+
16
+ [ docs.ruby-lang.org/en] [ docs-rlo ] : 包含所有 Ruby 2.1 版本之後的文件。
17
+
18
+ [ docs.ruby-lang.org/en/3.4] [ docs-rlo-3.4 ] : Ruby 3.4 版本文件。
19
+
20
+ [ docs.ruby-lang.org/en/master] [ docs-rlo-master ] : Ruby master 分支版本文件。
21
+
22
+ [ C Extension Guide] [ docs-rlo-extension ] : 為 Ruby 建立 C 延伸套件的深度指南。
23
+
14
24
### 入門
15
25
16
26
[ 官方 FAQ] ( /en/documentation/faq/ )
17
27
: 官方常見問題與解答。
18
28
19
- [ Ruby Koans] [ 2 ]
20
- : Ruby Koans 導引你走上學習 Ruby 的啟蒙之路。可以學到 Ruby 語言、語法、結構、常用函數與函式庫。
21
- 當然也少不了 Ruby 的文化。
22
-
23
- [ Why’s (Poignant) Guide to Ruby] [ 5 ]
24
- : 非比尋常但玩味無窮的書,透過故事、幽默與漫畫來教會你 Ruby。由 * why the lucky
25
- stiff* 創作,本書是學習 Ruby 的經典大作。
26
-
27
- [ Ruby Essentials] [ 7 ]
28
- : 免費的線上電子書,讓你可以一步步地學習 Ruby。
29
+ [ Try Ruby] [ 1 ]
30
+ : 您可以在您的瀏覽器上體驗 Ruby。
29
31
30
32
[ Learn to Program] [ 8 ]
31
33
: 由 Chris Pine 撰寫的程式語言入門。適合完全沒有程式設計經驗的朋友。
32
34
33
- [ Learn Ruby the Hard Way ] [ 38 ]
34
- : 一系列說明完善的練習,導引你從完全零基礎一直介紹到物件導向程式設計與 Web 開發,
35
+ [ Ruby in Twenty Minutes ] [ rubyin20 ]
36
+ : 少於 20 分鐘就能完成的Ruby 小型教學。
35
37
36
- ### 學習手冊
38
+ [ The Odin Project] [ odin ]
39
+ : 開源的全端課程。
37
40
38
- [ Programming Ruby ] [ 9 ]
39
- : 這是 Ruby 的第一本英文書,第一版開放線上免費閱讀 [ Pragmatic Programmers' book ] [ 10 ] 。
41
+ [ excercism ] [ exercism ]
42
+ : 包含 120 個題目、自動分析與個人指導 。
40
43
41
- [ The Ruby Programming Wikibook ] [ 12 ]
42
- : 給初學者到中等程度的線上手冊以及語言參考 。
44
+ [ Codecademy ] [ codecademy ]
45
+ : 包含多種主題的線上教學網站 。
43
46
44
- ### 參考文件
47
+ ### 手冊 / 書籍
45
48
46
- [ Official API Documentation] [ docs-rlo-en ]
47
- : 各種版本的 Ruby 官方 API 文件,包含當前未釋出的版本(trunk)。
49
+ #### 初學者
48
50
49
- [ Ruby Core Reference ] [ 13 ]
50
- : 直接從原始碼拉出來的 [ RDoc ] [ 14 ] 文件,包括所有的核心類別和模組(例如 String、Array、Symbol 等) 。
51
+ [ Programming Ruby 3.3 ] [ pickaxe ]
52
+ : 這是 Ruby 的第一本英文書,最近更新到了 Ruby 3.3 。
51
53
52
- [ Ruby Standard Library Reference ] [ 15 ]
53
- : 也是從從原始碼拉出來的 RDoc 文件,記載了 Ruby 的標準函式庫 。
54
+ [ The Well-Grounded Rubyist ] [ grounded ]
55
+ : 本教學從您的第一個 Ruby 程式開始,並帶您逐步了解反射、執行緒和遞迴等複雜主題 。
54
56
55
- [ Ruby C API Reference] [ extensions ]
56
- : 官方 Ruby 的 C API 介紹文件,有助於你撰寫 C 擴充程式或是貢獻到 Ruby 的開發。
57
+ #### 進階者
57
58
58
- [ RubyDoc.info ] [ 16 ]
59
- : 一站式站點,擁有 RubyGems 與 GitHub 上托管的 Ruby 專案的文件 。
59
+ [ Practical OOD in Ruby (POODR) ] [ poodr ]
60
+ : 關於一個程式設計師如何撰寫物件導向程式碼的故事 。
60
61
61
- [ Ruby & Rails Searchable API Docs] [ 17 ]
62
- : 可以聰明搜索 Ruby 與 Rails 的文件。
62
+ #### 專家
63
63
64
- [ APIdock] [ 18 ]
65
- : Ruby、Rails 與 RSpec 的文件,具有使用者的評論。
64
+ [ Metaprogramming] [ meta ]
65
+ : 用簡單易懂的方式解釋 metaprogramming。
66
+
67
+ [ Ruby Under a Microscope (RUM)] [ microscope ]
68
+ : Ruby 內部結構的圖解指南。
69
+
70
+ ### 社群文件
71
+
72
+ 這些文件網站由 Ruby 社群維護。
73
+
74
+ [ RubyDoc.info] [ 16 ]
75
+ : 一站式站點,擁有 RubyGems 與 GitHub 上托管的 Ruby 專案的文件。
66
76
67
77
[ RubyAPI.org] [ rubyapi-org ]
68
78
: 簡單搜尋瀏覽 Ruby 類別、模組及方法。
69
79
80
+ [ ruby-doc.org] [ 39 ]
81
+ : 線上 API 文件。
82
+
83
+ [ DevDocs.io] [ 40 ]
84
+ : 線上 API 文件。
85
+
86
+ [ Ruby QuickRef] [ 42 ]
87
+ : Ruby 快速參考文件。
88
+
89
+ [ rubyreferences] [ 43 ]
90
+ : 參考文件 + 版本變更細節。
91
+
92
+ ### 程式碼風格指南
93
+
94
+ [ rubystyle.guide] [ 44 ]
95
+ : RuboCop 的 Ruby 程式碼風格指南。
96
+
97
+ [ RuboCop] [ 45 ]
98
+ : 自動化檢查與執行程式碼風格指南。
99
+
100
+ [ Shopify] [ 46 ]
101
+ : Shopify 的 Ruby 程式碼風格指南。
102
+
103
+ [ GitLab] [ 47 ]
104
+ : GitLab 的 Ruby 程式碼風格指南。
105
+
106
+ [ Airbnb] [ 48 ]
107
+ : Airbnb 的 Ruby 程式碼風格指南。
108
+
109
+ [ w3resource] [ 49 ]
110
+ : W3 的 Ruby 程式碼風格指南。
111
+
112
+ # 工具
113
+
114
+ [ IRB] [ 50 ]
115
+ : 互動式 Ruby Read-Eval-Print-Loop (REPL)。
116
+
117
+ [ Pry] [ 51 ]
118
+ : Ruby REPL 的替代方案。
119
+
120
+ [ Rake] [ 52 ]
121
+ : make-like 的 Ruby 建置工具。
122
+
123
+ [ RI] [ 53 ]
124
+ : (Ruby Information) 是 Ruby 命令列工具,可以快速、輕鬆地線上存取 Ruby 文件。
125
+
126
+ [ RBS] [ 54 ]
127
+ : Ruby 的類型簽名。
128
+
129
+ [ TypeProf] [ 55 ]
130
+ : 一種實驗性的類型級 Ruby 解釋器,用於測試和理解 Ruby 程式碼。
131
+
132
+ [ Steep] [ 56 ]
133
+ : Ruby 靜態類型檢查器。
134
+
70
135
### 編輯器與整合開發環境
71
136
72
137
您可以用操作系統內建的編輯器來撰寫 Ruby。為了更有效的寫程式,值得選個 Ruby 基本特性支援良好的編輯器(如:語法高亮、檔案瀏覽)或是有更進階功能的整合開發環境(如:程式碼補全、重構、支持測試等。)
@@ -75,53 +140,75 @@ lang: zh_tw
75
140
76
141
* Linux 與跨平台:
77
142
* [ Aptana Studio] [ 19 ]
78
- * [ Emacs] [ 20 ] 用 [ Ruby mode] [ 21 ] 配 [ Rsense ] [ 22 ]
143
+ * [ Emacs] [ 20 ] 用 [ Ruby mode] [ 21 ] 或 [ Enhanced Ruby mode ] [ enh-ruby-mode ]
79
144
* [ Geany] [ 23 ]
80
145
* [ gedit] [ 24 ]
81
- * [ Vim] [ 25 ] 用 [ vim-ruby] [ 26 ] 插件與 [ Rsense] [ 22 ]
146
+ * [ Vim] [ 25 ] 用 [ vim-ruby] [ 26 ] 插件
147
+ * [ NeoVim] [ neovim ]
82
148
* [ RubyMine] [ 27 ]
83
149
* [ SciTe] [ 28 ]
84
150
* [ NetBeans] [ 36 ]
85
151
* [ Sublime Text] [ 37 ]
86
- * [ Atom] [ atom ]
87
152
* [ Visual Studio Code] [ vscode ]
153
+ * [ Zed] [ zed ]
88
154
89
155
* Windows 作業系統:
90
156
* [ Notepad++] [ 29 ]
91
157
92
158
* macOS 作業系統:
93
159
* [ TextMate] [ 32 ]
94
160
* [ BBEdit] [ 33 ]
95
- * [ Dash] [ 39 ] (瀏覽文件用)
161
+ * [ Dash] [ dash ] (瀏覽文件用)
162
+
163
+ 部分編輯器支援 Language Server Protocol (LSP),Shopify 的 [ ruby-lsp] [ ruby-lsp ] 是最受歡的的 Ruby LSP 之一。
96
164
97
165
### 進階閱讀
98
166
99
167
[ Ruby-Doc.org] [ 34 ] 維護了一份簡單易懂的英文文件列表。如有任何 Ruby 相關的問題,[ 郵件論壇] ( /en/community/mailing-lists/ ) 是個問問題的好地方。
100
168
169
+ ### 較舊的閱讀資源
101
170
171
+ 這些連結內容也很突出,但已經很久沒有更新了。
172
+
173
+ [ Ruby Koans] [ 2 ]
174
+ : Ruby Koans 導引你走上學習 Ruby 的啟蒙之路。可以學到 Ruby 語言、語法、結構、常用函數與函式庫。
175
+ 當然也少不了 Ruby 的文化。
176
+
177
+ [ Ruby Essentials] [ 7 ]
178
+ : 免費的線上電子書,讓你可以一步步地學習 Ruby。
179
+
180
+ [ Why’s (Poignant) Guide to Ruby] [ 5 ]
181
+ : 非比尋常但玩味無窮的書,透過故事、幽默與漫畫來教會你 Ruby。由 * why the lucky
182
+ stiff* 創作,本書是學習 Ruby 的經典大作。
183
+
184
+ [ Learn Ruby the Hard Way] [ 38 ]
185
+ : 一系列說明完善的練習,導引你從完全零基礎一直介紹到物件導向程式設計與 Web 開發,
186
+
187
+ [ Programming Ruby] [ 9 ]
188
+ : 這是 Ruby 的第一本英文書,第一版開放線上免費閱讀 [ Pragmatic Programmers' book] [ 10 ] 。
189
+
190
+ [ The Ruby Programming Wikibook] [ 12 ]
191
+ : 給初學者到中等程度的線上手冊以及語言參考。
102
192
103
193
[ 1 ] : https://try.ruby-lang.org/
104
194
[ 2 ] : https://rubykoans.com/
105
195
[ 5 ] : https://poignant.guide
106
196
[ 7 ] : http://www.techotopia.com/index.php/Ruby_Essentials
107
197
[ 8 ] : http://pine.fm/LearnToProgram/
108
- [ 9 ] : http ://www.ruby-doc.org/docs/ProgrammingRuby/
198
+ [ 9 ] : https ://www.ruby-doc.org/docs/ProgrammingRuby/
109
199
[ 10 ] : https://pragprog.com/titles/ruby5/programming-ruby-3-3-5th-edition/
110
200
[ 12 ] : http://en.wikibooks.org/wiki/Ruby_programming_language
111
201
[ 13 ] : http://www.ruby-doc.org/core
112
202
[ 14 ] : https://ruby.github.io/rdoc/
113
203
[ 15 ] : http://www.ruby-doc.org/stdlib
114
204
[ extensions ] : https://docs.ruby-lang.org/en/master/extension_rdoc.html
115
205
[ 16 ] : http://www.rubydoc.info/
116
- [ 17 ] : http://rubydocs.org/
117
- [ 18 ] : http://apidock.com/
118
206
[ rubyapi-org ] : https://rubyapi.org/
119
207
[ 19 ] : http://www.aptana.com/
120
208
[ 20 ] : http://www.gnu.org/software/emacs/
121
209
[ 21 ] : http://www.emacswiki.org/emacs/RubyMode
122
- [ 22 ] : http://rsense.github.io/
123
210
[ 23 ] : http://www.geany.org/
124
- [ 24 ] : http ://projects.gnome. org/gedit/screenshots.html
211
+ [ 24 ] : https ://gedit-text-editor. org/
125
212
[ 25 ] : http://www.vim.org/
126
213
[ 26 ] : https://github.com/vim-ruby/vim-ruby
127
214
[ 27 ] : http://www.jetbrains.com/ruby/
@@ -133,10 +220,43 @@ lang: zh_tw
133
220
[ 36 ] : https://netbeans.org/
134
221
[ 37 ] : http://www.sublimetext.com/
135
222
[ 38 ] : https://learncodethehardway.org/ruby/
136
- [ 39 ] : http://kapeli.com/dash
137
- [ docs-rlo-en ] : https://docs.ruby-lang.org/en/
138
- [ atom ] : https://atom.io/
223
+ [ 39 ] : https://www.ruby-doc.org/
224
+ [ 40 ] : https://devdocs.io/ruby/
225
+ [ 42 ] : https://www.zenspider.com/ruby/quickref.html
226
+ [ 43 ] : https://rubyreferences.github.io/
227
+ [ 44 ] : https://rubystyle.guide/
228
+ [ 45 ] : https://github.com/rubocop/ruby-style-guide
229
+ [ 46 ] : https://ruby-style-guide.shopify.dev/
230
+ [ 47 ] : https://docs.gitlab.com/ee/development/backend/ruby_style_guide.html
231
+ [ 48 ] : https://github.com/airbnb/ruby
232
+ [ 49 ] : https://www.w3resource.com/ruby/ruby-style-guide.php
233
+ [ 50 ] : https://github.com/ruby/irb
234
+ [ 51 ] : https://github.com/pry/pry
235
+ [ 52 ] : https://github.com/ruby/rake
236
+ [ 53 ] : https://ruby.github.io/rdoc/RI_md.html
237
+ [ 54 ] : https://github.com/ruby/rbs
238
+ [ 55 ] : https://github.com/ruby/typeprof
239
+ [ 56 ] : https://github.com/soutaro/steep
240
+
241
+ [ docs-rlo ] : https://docs.ruby-lang.org/en/
242
+ [ docs-rlo-3.4 ] : https://docs.ruby-lang.org/en/3.4
243
+ [ docs-rlo-master ] : https://docs.ruby-lang.org/en/master
244
+ [ docs-rlo-extension ] : https://docs.ruby-lang.org/en/master/extension_rdoc.html
245
+
246
+ [ rubyin20 ] : https://www.ruby-lang.org/en/documentation/quickstart/
247
+ [ odin ] : https://www.theodinproject.com/paths/full-stack-ruby-on-rails/courses/ruby
248
+ [ exercism ] : https://exercism.org/tracks/ruby
249
+ [ codecademy ] : https://www.codecademy.com/learn/learn-ruby
250
+
251
+ [ pickaxe ] : https://pragprog.com/titles/ruby5/programming-ruby-3-3-5th-edition/
252
+ [ grounded ] : https://www.manning.com/books/the-well-grounded-rubyist-third-edition
253
+ [ poodr ] : https://www.poodr.com/
254
+ [ meta ] : https://pragprog.com/titles/ppmetr2/metaprogramming-ruby-2/
255
+ [ microscope ] : https://patshaughnessy.net/ruby-under-a-microscope
256
+
257
+ [ enh-ruby-mode ] : https://github.com/zenspider/enhanced-ruby-mode/
258
+ [ neovim ] : https://neovim.io/
139
259
[ vscode ] : https://code.visualstudio.com/
140
-
141
- [ rubytw ] : http://ruby.tw
142
- [ ruby-user-guide-zh_tw ] : http ://guides.ruby.tw/ruby/
260
+ [ zed ] : https://zed.dev/
261
+ [ dash ] : http://kapeli.com/dash
262
+ [ ruby-lsp ] : https ://github.com/Shopify/ruby-lsp
0 commit comments