Skip to content

Commit

Permalink
Update document index page (zh_tw)
Browse files Browse the repository at this point in the history
  • Loading branch information
timfanda35 authored and bugtender committed Jan 14, 2025
1 parent 03bde32 commit f6302b9
Showing 1 changed file with 167 additions and 47 deletions.
214 changes: 167 additions & 47 deletions zh_tw/documentation/index.md
Original file line number Diff line number Diff line change
Expand Up @@ -11,62 +11,127 @@ lang: zh_tw

儘管可以輕鬆的[在瀏覽器試玩 Ruby ][1],你還是可以閱讀[安裝指南](installation/)來幫助你安裝 Ruby。

### 官方 Ruby 文件

[docs.ruby-lang.org/en][docs-rlo]: 包含所有 Ruby 2.1 版本之後的文件。

[docs.ruby-lang.org/en/3.4][docs-rlo-3.4]: Ruby 3.4 版本文件。

[docs.ruby-lang.org/en/master][docs-rlo-master]: Ruby master 分支版本文件。

[C Extension Guide][docs-rlo-extension]: 為 Ruby 建立 C 延伸套件的深度指南。

### 入門

[官方 FAQ](/en/documentation/faq/)
: 官方常見問題與解答。

[Ruby Koans][2]
: Ruby Koans 導引你走上學習 Ruby 的啟蒙之路。可以學到 Ruby 語言、語法、結構、常用函數與函式庫。
當然也少不了 Ruby 的文化。

[Why’s (Poignant) Guide to Ruby][5]
: 非比尋常但玩味無窮的書,透過故事、幽默與漫畫來教會你 Ruby。由 *why the lucky
stiff* 創作,本書是學習 Ruby 的經典大作。

[Ruby Essentials][7]
: 免費的線上電子書,讓你可以一步步地學習 Ruby。
[Try Ruby][1]
: 您可以在您的瀏覽器上體驗 Ruby。

[Learn to Program][8]
: 由 Chris Pine 撰寫的程式語言入門。適合完全沒有程式設計經驗的朋友。

[Learn Ruby the Hard Way][38]
: 一系列說明完善的練習,導引你從完全零基礎一直介紹到物件導向程式設計與 Web 開發,
[Ruby in Twenty Minutes][rubyin20]
: 少於 20 分鐘就能完成的Ruby 小型教學。

### 學習手冊
[The Odin Project][odin]
: 開源的全端課程。

[Programming Ruby][9]
: 這是 Ruby 的第一本英文書,第一版開放線上免費閱讀 [Pragmatic Programmers' book][10]
[excercism][exercism]
: 包含 120 個題目、自動分析與個人指導

[The Ruby Programming Wikibook][12]
: 給初學者到中等程度的線上手冊以及語言參考
[Codecademy][codecademy]
: 包含多種主題的線上教學網站

### 參考文件
### 手冊 / 書籍

[Official API Documentation][docs-rlo-en]
: 各種版本的 Ruby 官方 API 文件,包含當前未釋出的版本(trunk)。
#### 初學者

[Ruby Core Reference][13]
: 直接從原始碼拉出來的 [RDoc][14] 文件,包括所有的核心類別和模組(例如 String、Array、Symbol 等)
[Programming Ruby 3.3][pickaxe]
: 這是 Ruby 的第一本英文書,最近更新到了 Ruby 3.3

[Ruby Standard Library Reference][15]
: 也是從從原始碼拉出來的 RDoc 文件,記載了 Ruby 的標準函式庫
[The Well-Grounded Rubyist][grounded]
: 本教學從您的第一個 Ruby 程式開始,並帶您逐步了解反射、執行緒和遞迴等複雜主題

[Ruby C API Reference][extensions]
: 官方 Ruby 的 C API 介紹文件,有助於你撰寫 C 擴充程式或是貢獻到 Ruby 的開發。
#### 進階者

[RubyDoc.info][16]
: 一站式站點,擁有 RubyGems 與 GitHub 上托管的 Ruby 專案的文件
[Practical OOD in Ruby (POODR)][poodr]
: 關於一個程式設計師如何撰寫物件導向程式碼的故事

[Ruby & Rails Searchable API Docs][17]
: 可以聰明搜索 Ruby 與 Rails 的文件。
#### 專家

[APIdock][18]
: Ruby、Rails 與 RSpec 的文件,具有使用者的評論。
[Metaprogramming][meta]
: 用簡單易懂的方式解釋 metaprogramming。

[Ruby Under a Microscope (RUM)][microscope]
: Ruby 內部結構的圖解指南。

### 社群文件

這些文件網站由 Ruby 社群維護。

[RubyDoc.info][16]
: 一站式站點,擁有 RubyGems 與 GitHub 上托管的 Ruby 專案的文件。

[RubyAPI.org][rubyapi-org]
: 簡單搜尋瀏覽 Ruby 類別、模組及方法。

[ruby-doc.org][39]
: 線上 API 文件。

[DevDocs.io][40]
: 線上 API 文件。

[Ruby QuickRef][42]
: Ruby 快速參考文件。

[rubyreferences][43]
: 參考文件 + 版本變更細節。

### 程式碼風格指南

[rubystyle.guide][44]
: RuboCop 的 Ruby 程式碼風格指南。

[RuboCop][45]
: 自動化檢查與執行程式碼風格指南。

[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]
: make-like 的 Ruby 建置工具。

[RI][53]
: (Ruby Information) 是 Ruby 命令列工具,可以快速、輕鬆地線上存取 Ruby 文件。

[RBS][54]
: Ruby 的類型簽名。

[TypeProf][55]
: 一種實驗性的類型級 Ruby 解釋器,用於測試和理解 Ruby 程式碼。

[Steep][56]
: Ruby 靜態類型檢查器。

### 編輯器與整合開發環境

您可以用操作系統內建的編輯器來撰寫 Ruby。為了更有效的寫程式,值得選個 Ruby 基本特性支援良好的編輯器(如:語法高亮、檔案瀏覽)或是有更進階功能的整合開發環境(如:程式碼補全、重構、支持測試等。)
Expand All @@ -75,53 +140,75 @@ lang: zh_tw

* Linux 與跨平台:
* [Aptana Studio][19]
* [Emacs][20][Ruby mode][21] [Rsense][22]
* [Emacs][20][Ruby mode][21] [Enhanced Ruby mode][enh-ruby-mode]
* [Geany][23]
* [gedit][24]
* [Vim][25][vim-ruby][26] 插件與 [Rsense][22]
* [Vim][25][vim-ruby][26] 插件
* [NeoVim][neovim]
* [RubyMine][27]
* [SciTe][28]
* [NetBeans][36]
* [Sublime Text][37]
* [Atom][atom]
* [Visual Studio Code][vscode]
* [Zed][zed]

* Windows 作業系統:
* [Notepad++][29]

* macOS 作業系統:
* [TextMate][32]
* [BBEdit][33]
* [Dash][39] (瀏覽文件用)
* [Dash][dash] (瀏覽文件用)

部分編輯器支援 Language Server Protocol (LSP),Shopify 的 [ruby-lsp][ruby-lsp] 是最受歡的的 Ruby LSP 之一。

### 進階閱讀

[Ruby-Doc.org][34] 維護了一份簡單易懂的英文文件列表。如有任何 Ruby 相關的問題,[郵件論壇](/en/community/mailing-lists/)是個問問題的好地方。

### 較舊的閱讀資源

這些連結內容也很突出,但已經很久沒有更新了。

[Ruby Koans][2]
: Ruby Koans 導引你走上學習 Ruby 的啟蒙之路。可以學到 Ruby 語言、語法、結構、常用函數與函式庫。
當然也少不了 Ruby 的文化。

[Ruby Essentials][7]
: 免費的線上電子書,讓你可以一步步地學習 Ruby。

[Why’s (Poignant) Guide to Ruby][5]
: 非比尋常但玩味無窮的書,透過故事、幽默與漫畫來教會你 Ruby。由 *why the lucky
stiff* 創作,本書是學習 Ruby 的經典大作。

[Learn Ruby the Hard Way][38]
: 一系列說明完善的練習,導引你從完全零基礎一直介紹到物件導向程式設計與 Web 開發,

[Programming Ruby][9]
: 這是 Ruby 的第一本英文書,第一版開放線上免費閱讀 [Pragmatic Programmers' book][10]

[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/
[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
[13]: http://www.ruby-doc.org/core
[14]: https://ruby.github.io/rdoc/
[15]: http://www.ruby-doc.org/stdlib
[extensions]: https://docs.ruby-lang.org/en/master/extension_rdoc.html
[16]: http://www.rubydoc.info/
[17]: http://rubydocs.org/
[18]: http://apidock.com/
[rubyapi-org]: https://rubyapi.org/
[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
[24]: https://gedit-text-editor.org/
[25]: http://www.vim.org/
[26]: https://github.com/vim-ruby/vim-ruby
[27]: http://www.jetbrains.com/ruby/
Expand All @@ -133,10 +220,43 @@ lang: zh_tw
[36]: https://netbeans.org/
[37]: http://www.sublimetext.com/
[38]: https://learncodethehardway.org/ruby/
[39]: http://kapeli.com/dash
[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

[docs-rlo]: https://docs.ruby-lang.org/en/
[docs-rlo-3.4]: https://docs.ruby-lang.org/en/3.4
[docs-rlo-master]: https://docs.ruby-lang.org/en/master
[docs-rlo-extension]: https://docs.ruby-lang.org/en/master/extension_rdoc.html

[rubyin20]: https://www.ruby-lang.org/en/documentation/quickstart/
[odin]: https://www.theodinproject.com/paths/full-stack-ruby-on-rails/courses/ruby
[exercism]: https://exercism.org/tracks/ruby
[codecademy]: https://www.codecademy.com/learn/learn-ruby

[pickaxe]: https://pragprog.com/titles/ruby5/programming-ruby-3-3-5th-edition/
[grounded]: https://www.manning.com/books/the-well-grounded-rubyist-third-edition
[poodr]: https://www.poodr.com/
[meta]: https://pragprog.com/titles/ppmetr2/metaprogramming-ruby-2/
[microscope]: https://patshaughnessy.net/ruby-under-a-microscope

[enh-ruby-mode]: https://github.com/zenspider/enhanced-ruby-mode/
[neovim]: https://neovim.io/
[vscode]: https://code.visualstudio.com/

[rubytw]: http://ruby.tw
[ruby-user-guide-zh_tw]: http://guides.ruby.tw/ruby/
[zed]: https://zed.dev/
[dash]: http://kapeli.com/dash
[ruby-lsp]: https://github.com/Shopify/ruby-lsp

0 comments on commit f6302b9

Please sign in to comment.