From 2d04cfe990253c4fc749782eda7c1c58b788d49a Mon Sep 17 00:00:00 2001 From: Bear Su Date: Sun, 12 Jan 2025 20:34:44 +0800 Subject: [PATCH 1/2] Update document index page (zh_tw) --- zh_tw/documentation/index.md | 214 +++++++++++++++++++++++++++-------- 1 file changed, 167 insertions(+), 47 deletions(-) diff --git a/zh_tw/documentation/index.md b/zh_tw/documentation/index.md index f25d180b11..664e710769 100644 --- a/zh_tw/documentation/index.md +++ b/zh_tw/documentation/index.md @@ -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 基本特性支援良好的編輯器（如：語法高亮、檔案瀏覽）或是有更進階功能的整合開發環境（如：程式碼補全、重構、支持測試等。） @@ -75,16 +140,17 @@ 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] @@ -92,20 +158,44 @@ lang: zh_tw * 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 @@ -113,15 +203,12 @@ lang: zh_tw [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/ @@ -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 From 471235161eda7c30d57f9e150db1d73e0ac18646 Mon Sep 17 00:00:00 2001 From: Bear Su Date: Tue, 14 Jan 2025 10:00:58 +0800 Subject: [PATCH 2/2] Refine wording (zh_tw) --- zh_tw/documentation/index.md | 4 ++-- 1 file changed, 2 insertions(+), 2 deletions(-) diff --git a/zh_tw/documentation/index.md b/zh_tw/documentation/index.md index 664e710769..7300b3df55 100644 --- a/zh_tw/documentation/index.md +++ b/zh_tw/documentation/index.md @@ -33,7 +33,7 @@ lang: zh_tw : 由 Chris Pine 撰寫的程式語言入門。適合完全沒有程式設計經驗的朋友。 [Ruby in Twenty Minutes][rubyin20] -: 少於 20 分鐘就能完成的Ruby 小型教學。 +: 少於 20 分鐘就能完成的 Ruby 小型教學。 [The Odin Project][odin] : 開源的全端課程。 @@ -134,7 +134,7 @@ lang: zh_tw ### 編輯器與整合開發環境 -您可以用操作系統內建的編輯器來撰寫 Ruby。為了更有效的寫程式，值得選個 Ruby 基本特性支援良好的編輯器（如：語法高亮、檔案瀏覽）或是有更進階功能的整合開發環境（如：程式碼補全、重構、支持測試等。） +您可以用作業系統內建的編輯器來撰寫 Ruby。為了更有效的寫程式，值得選個 Ruby 基本特性支援良好的編輯器（如：語法高亮、檔案瀏覽）或是有更進階功能的整合開發環境（如：程式碼補齊、重構、支持測試等。） 以下是 Ruby 程式設計師（Rubyist）間流行使用的開發工具清單：