Skip to content
New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Update document index page (zh_tw) #3469

Merged
merged 2 commits into from
Jan 14, 2025
Merged
Changes from 1 commit
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
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 小型教學。
Copy link
Member

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

A space missing here 👆


### 學習手冊
[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 基本特性支援良好的編輯器(如:語法高亮、檔案瀏覽)或是有更進階功能的整合開發環境(如:程式碼補全、重構、支持測試等。)
Copy link
Member

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Hey 👋, could you help us fix this 作業系統 as well? Thanks!

Copy link
Contributor Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Sure, thank you!

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
Loading