-
Notifications
You must be signed in to change notification settings - Fork 623
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
+168
−48
Merged
Changes from 1 commit
Commits
Show all changes
2 commits
Select commit
Hold shift + click to select a range
File filter
Filter by extension
Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
There are no files selected for viewing
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Original file line number | Diff line number | Diff line change |
---|---|---|
|
@@ -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 基本特性支援良好的編輯器(如:語法高亮、檔案瀏覽)或是有更進階功能的整合開發環境(如:程式碼補全、重構、支持測試等。) | ||
There was a problem hiding this comment. Choose a reason for hiding this commentThe reason will be displayed to describe this comment to others. Learn more. Hey 👋, could you help us fix this There was a problem hiding this comment. Choose a reason for hiding this commentThe reason will be displayed to describe this comment to others. Learn more. Sure, thank you! |
||
|
@@ -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/ | ||
|
@@ -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 |
Oops, something went wrong.
Add this suggestion to a batch that can be applied as a single commit.
This suggestion is invalid because no changes were made to the code.
Suggestions cannot be applied while the pull request is closed.
Suggestions cannot be applied while viewing a subset of changes.
Only one suggestion per line can be applied in a batch.
Add this suggestion to a batch that can be applied as a single commit.
Applying suggestions on deleted lines is not supported.
You must change the existing code in this line in order to create a valid suggestion.
Outdated suggestions cannot be applied.
This suggestion has been applied or marked resolved.
Suggestions cannot be applied from pending reviews.
Suggestions cannot be applied on multi-line comments.
Suggestions cannot be applied while the pull request is queued to merge.
Suggestion cannot be applied right now. Please check back later.
There was a problem hiding this comment.
Choose a reason for hiding this comment
The reason will be displayed to describe this comment to others. Learn more.
A space missing here 👆