@@ -11,62 +11,127 @@ lang: zh_tw
1111
1212儘管可以輕鬆的[ 在瀏覽器試玩 Ruby ] [ 1 ] ,你還是可以閱讀[ 安裝指南] ( installation/ ) 來幫助你安裝 Ruby。
1313
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+
1424### 入門
1525
1626[ 官方 FAQ] ( /en/documentation/faq/ )
1727: 官方常見問題與解答。
1828
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。
2931
3032[ Learn to Program] [ 8 ]
3133: 由 Chris Pine 撰寫的程式語言入門。適合完全沒有程式設計經驗的朋友。
3234
33- [ Learn Ruby the Hard Way ] [ 38 ]
34- : 一系列說明完善的練習,導引你從完全零基礎一直介紹到物件導向程式設計與 Web 開發,
35+ [ Ruby in Twenty Minutes ] [ rubyin20 ]
36+ : 少於 20 分鐘就能完成的Ruby 小型教學。
3537
36- ### 學習手冊
38+ [ The Odin Project] [ odin ]
39+ : 開源的全端課程。
3740
38- [ Programming Ruby ] [ 9 ]
39- : 這是 Ruby 的第一本英文書,第一版開放線上免費閱讀 [ Pragmatic Programmers' book ] [ 10 ] 。
41+ [ excercism ] [ exercism ]
42+ : 包含 120 個題目、自動分析與個人指導 。
4043
41- [ The Ruby Programming Wikibook ] [ 12 ]
42- : 給初學者到中等程度的線上手冊以及語言參考 。
44+ [ Codecademy ] [ codecademy ]
45+ : 包含多種主題的線上教學網站 。
4346
44- ### 參考文件
47+ ### 手冊 / 書籍
4548
46- [ Official API Documentation] [ docs-rlo-en ]
47- : 各種版本的 Ruby 官方 API 文件,包含當前未釋出的版本(trunk)。
49+ #### 初學者
4850
49- [ Ruby Core Reference ] [ 13 ]
50- : 直接從原始碼拉出來的 [ RDoc ] [ 14 ] 文件,包括所有的核心類別和模組(例如 String、Array、Symbol 等) 。
51+ [ Programming Ruby 3.3 ] [ pickaxe ]
52+ : 這是 Ruby 的第一本英文書,最近更新到了 Ruby 3.3 。
5153
52- [ Ruby Standard Library Reference ] [ 15 ]
53- : 也是從從原始碼拉出來的 RDoc 文件,記載了 Ruby 的標準函式庫 。
54+ [ The Well-Grounded Rubyist ] [ grounded ]
55+ : 本教學從您的第一個 Ruby 程式開始,並帶您逐步了解反射、執行緒和遞迴等複雜主題 。
5456
55- [ Ruby C API Reference] [ extensions ]
56- : 官方 Ruby 的 C API 介紹文件,有助於你撰寫 C 擴充程式或是貢獻到 Ruby 的開發。
57+ #### 進階者
5758
58- [ RubyDoc.info ] [ 16 ]
59- : 一站式站點,擁有 RubyGems 與 GitHub 上托管的 Ruby 專案的文件 。
59+ [ Practical OOD in Ruby (POODR) ] [ poodr ]
60+ : 關於一個程式設計師如何撰寫物件導向程式碼的故事 。
6061
61- [ Ruby & Rails Searchable API Docs] [ 17 ]
62- : 可以聰明搜索 Ruby 與 Rails 的文件。
62+ #### 專家
6363
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 專案的文件。
6676
6777[ RubyAPI.org] [ rubyapi-org ]
6878: 簡單搜尋瀏覽 Ruby 類別、模組及方法。
6979
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+
70135### 編輯器與整合開發環境
71136
72137您可以用操作系統內建的編輯器來撰寫 Ruby。為了更有效的寫程式,值得選個 Ruby 基本特性支援良好的編輯器(如:語法高亮、檔案瀏覽)或是有更進階功能的整合開發環境(如:程式碼補全、重構、支持測試等。)
@@ -75,53 +140,75 @@ lang: zh_tw
75140
76141* Linux 與跨平台:
77142 * [ Aptana Studio] [ 19 ]
78- * [ Emacs] [ 20 ] 用 [ Ruby mode] [ 21 ] 配 [ Rsense ] [ 22 ]
143+ * [ Emacs] [ 20 ] 用 [ Ruby mode] [ 21 ] 或 [ Enhanced Ruby mode ] [ enh-ruby-mode ]
79144 * [ Geany] [ 23 ]
80145 * [ gedit] [ 24 ]
81- * [ Vim] [ 25 ] 用 [ vim-ruby] [ 26 ] 插件與 [ Rsense] [ 22 ]
146+ * [ Vim] [ 25 ] 用 [ vim-ruby] [ 26 ] 插件
147+ * [ NeoVim] [ neovim ]
82148 * [ RubyMine] [ 27 ]
83149 * [ SciTe] [ 28 ]
84150 * [ NetBeans] [ 36 ]
85151 * [ Sublime Text] [ 37 ]
86- * [ Atom] [ atom ]
87152 * [ Visual Studio Code] [ vscode ]
153+ * [ Zed] [ zed ]
88154
89155* Windows 作業系統:
90156 * [ Notepad++] [ 29 ]
91157
92158* macOS 作業系統:
93159 * [ TextMate] [ 32 ]
94160 * [ BBEdit] [ 33 ]
95- * [ Dash] [ 39 ] (瀏覽文件用)
161+ * [ Dash] [ dash ] (瀏覽文件用)
162+
163+ 部分編輯器支援 Language Server Protocol (LSP),Shopify 的 [ ruby-lsp] [ ruby-lsp ] 是最受歡的的 Ruby LSP 之一。
96164
97165### 進階閱讀
98166
99167[ Ruby-Doc.org] [ 34 ] 維護了一份簡單易懂的英文文件列表。如有任何 Ruby 相關的問題,[ 郵件論壇] ( /en/community/mailing-lists/ ) 是個問問題的好地方。
100168
169+ ### 較舊的閱讀資源
101170
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+ : 給初學者到中等程度的線上手冊以及語言參考。
102192
103193[ 1 ] : https://try.ruby-lang.org/
104194[ 2 ] : https://rubykoans.com/
105195[ 5 ] : https://poignant.guide
106196[ 7 ] : http://www.techotopia.com/index.php/Ruby_Essentials
107197[ 8 ] : http://pine.fm/LearnToProgram/
108- [ 9 ] : http ://www.ruby-doc.org/docs/ProgrammingRuby/
198+ [ 9 ] : https ://www.ruby-doc.org/docs/ProgrammingRuby/
109199[ 10 ] : https://pragprog.com/titles/ruby5/programming-ruby-3-3-5th-edition/
110200[ 12 ] : http://en.wikibooks.org/wiki/Ruby_programming_language
111201[ 13 ] : http://www.ruby-doc.org/core
112202[ 14 ] : https://ruby.github.io/rdoc/
113203[ 15 ] : http://www.ruby-doc.org/stdlib
114204[ extensions ] : https://docs.ruby-lang.org/en/master/extension_rdoc.html
115205[ 16 ] : http://www.rubydoc.info/
116- [ 17 ] : http://rubydocs.org/
117- [ 18 ] : http://apidock.com/
118206[ rubyapi-org ] : https://rubyapi.org/
119207[ 19 ] : http://www.aptana.com/
120208[ 20 ] : http://www.gnu.org/software/emacs/
121209[ 21 ] : http://www.emacswiki.org/emacs/RubyMode
122- [ 22 ] : http://rsense.github.io/
123210[ 23 ] : http://www.geany.org/
124- [ 24 ] : http ://projects.gnome. org/gedit/screenshots.html
211+ [ 24 ] : https ://gedit-text-editor. org/
125212[ 25 ] : http://www.vim.org/
126213[ 26 ] : https://github.com/vim-ruby/vim-ruby
127214[ 27 ] : http://www.jetbrains.com/ruby/
@@ -133,10 +220,43 @@ lang: zh_tw
133220[ 36 ] : https://netbeans.org/
134221[ 37 ] : http://www.sublimetext.com/
135222[ 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/
139259[ 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