Skip to content
This commit does not belong to any branch on this repository, and may belong to a fork outside of the repository.

Commit f6302b9

Browse files
timfanda35bugtender
authored andcommittedJan 14, 2025
Update document index page (zh_tw)
1 parent 03bde32 commit f6302b9

File tree

1 file changed

+167
-47
lines changed

1 file changed

+167
-47
lines changed
 

‎zh_tw/documentation/index.md

Lines changed: 167 additions & 47 deletions
Original file line numberDiff line numberDiff line change
@@ -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

Comments
 (0)
Please sign in to comment.