Skip to content

Update translation for libraries page (zh_tw) #3631

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.

Sign up for GitHub

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

Merged
merged 1 commit into from
Sep 30, 2025
+11 −15
Merged

Update translation for libraries page (zh_tw) #3631

Changes from all commits
Commits
Show all changes
1 commit
Select commit
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
26 changes: 11 additions & 15 deletions zh_tw/libraries/index.md
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -4,11 +4,12 @@ title: "函式庫"
lang: zh_tw
---

多數程式語言有著許多廣泛的第三方函式庫，Ruby 也受益於許多第三方函式庫。
和多數程式語言一樣，Ruby 也仰賴大量第三方函式庫。
{: .summary}

多數函式庫以 **Gem** 格式發佈。 [**RubyGems**][1] 是 Ruby 函式庫打包系統，特別針對新建、分享、
安裝函式庫而設計（某種程度上與套件管理系統 `apt-get` 很相似，但針對的是 Ruby 軟體的發佈）。從 Ruby 1.9 起，Ruby 內建 RubyGems，1.9 以前的 Ruby 得[手動安裝][2]。
這些函式庫幾乎所有都會以 **Gem** 的形式發佈，**Gem** 是可安裝的函式庫或應用程式的封裝格式，透過名為 [**RubyGems**][1] 的工具進行管理。

RubyGems 是為了簡化函式庫的建立、分享與安裝而設計的 Ruby 專屬套件管理系統（某種程度上類似 apt-get，但專門針對 Ruby 軟體）。從 Ruby 1.9 起，Ruby 內建 RubyGems，1.9 以前的 Ruby 得[手動安裝][2]。

有些其他的函式庫透過把**原始碼**壓縮成 .zip 或 .tar.gz 的形式發佈。通常可以透過
閱讀 `README` 或 `INSTALL` 檔案，根據步驟來安裝。
Expand All @@ -21,17 +22,17 @@ lang: zh_tw

使用 `gem search -r`，可以對 RubyGems 的 Repository 做查詢。比如要找 rails，輸入 `gem search -r rails` 會返回與 Rails 相關的 Gem。`--local` (`-l`) 選項可搜索本機與 Rails 有關，已安裝的 Gem。要安裝一個 Gem，使用 `gem install [gem]`。瀏覽已安裝的 Gem 可輸入 `gem list`。更多關於 `gem` 命令的說明，請參考下文，或直接查 [RubyGems 的文件][3]。

除了 RubyGems.org 之外，也有其它的站點可查找函式庫。[RubyForge][4] 曾經是 Ruby 函式庫的家，但近年來 [**GitHub**][5] 的興起，GitHub 成為了 Ruby 相關資源的主要 Repository。現在，通常 Gem 的原始碼會放在 GitHub，而 Gem 會發佈到 RubyGems.org。
除了 RubyGems.org 之外，還有其他來源可以找到函式庫。[**GitHub**][5] 是目前 Ruby 相關內容的主要原始碼儲存庫。多數情況下，Gem 的原始碼會託管在 GitHub 上，同時發佈為完整的 Gem 至 RubyGems.org。

[**The Ruby Toolbox**][6] 使得尋找開源 Ruby 專案非常簡單。按照許多常見的開發任務分類，蒐集專案許多的相關資訊，像是版本發佈歷史、提交活躍度、函式庫相依的軟體、與其它類似專案的流行程度比較（在 GitHub 與 RubyGems.org 上的流行程度），讓你輕鬆找到想找到的函式庫。
[**The Ruby Toolbox**][6] 使得尋找開源 Ruby 專案非常簡單。它依據各種常見開發任務進行分類，並整理出專案的豐富資訊，包括版本更新歷史、提交活躍度、相依函式庫，以及在 GitHub 和 RubyGems.org 上的受歡迎程度。這讓你可以更輕鬆地找到合適的函式庫。

### 更多關於 RubyGems 的說明

以下是 `gem` 命令的快速回顧。關於 `gem` 命令的所有使用方式，請查閱[更詳細的文件][7]。

#### 搜索可用的 Gem

`search` 命令可用來搜尋 Gem，根據傳入的關鍵字。比如輸入 `html` 會返回與 `html` 相關的 Gem（按字母排序）：
**search** 命令可用來搜尋 Gem，根據傳入的關鍵字。比如輸入 `html`，會列出所有名稱以 `html` 開頭的 Gem：

{% highlight sh %}
$ gem search -r html
Expand All @@ -46,7 +47,7 @@ html-sample (1.0, 1.1)

#### 安裝 Gem

找到 Gem，就可以安裝。安裝最流行的 Rails 看看：
確定要安裝的 Gem 之後，例如最受歡迎的 Rails，可以這樣安裝：

{% highlight sh %}
$ gem install rails
Expand All @@ -58,8 +59,6 @@ $ gem install rails
$ gem install rails --version 5.0
{% endhighlight %}

RubyGems 提倡語義化版本，請參考 [Semantic Versioning 2.0.0][semver]。

#### 列出所有的 Gem

列出本機安裝的所有 Gem：
Expand All @@ -76,27 +75,24 @@ $ gem list -r

#### 尋求幫助

輸入 `gem help` 可查看 `gem` 命令的說明文件terminal:
輸入 `gem help` 可在終端機中查看 `gem` 指令的說明文件：

{% highlight sh %}
$ gem help
{% endhighlight %}

`gem help commands` 可查看特定子命令的說明，如 `gem help install`。
例如輸入 `gem help commands` 可列出所有子指令；輸入 `gem help install` 則可查詢安裝指令說明。

#### 打造自己的 Gem

RubyGems.org 上有關於[多篇教學文件][3]，推薦使用 [Bundler][9] 來將函式庫打包成 Gem。Bundler 是管理 application 軟體相依的工具，同時可搭配 RubyGems 一起使用。
RubyGems.org 上有關於[多篇教學文件][3]，推薦使用 [Bundler][9] 來將函式庫打包成 Gem。Bundler 是用來管理應用程式相依函式庫的工具，同時可搭配 RubyGems 一起使用。



[1]: https://rubygems.org/
[2]: https://rubygems.org/pages/download/
[3]: http://guides.rubygems.org/
[4]: http://rubyforge.org/
[5]: https://github.com/
[6]: https://www.ruby-toolbox.com/
[7]: http://guides.rubygems.org/command-reference/
[9]: http://bundler.io/

[semver]: http://semver.org/
Loading