缺少 Ruby 2.4.4 文档

Question

我的问题是关于 ruby​​-doc.org 文档，但也与 ruby​​ 中的 ri 文档查找有关。

我已经阅读了几十个关于 ri 无法正常工作并给出“未知”消息的类似问题/答案，并且我已经尝试遵循一些旧建议。似乎那些旧答案不适用于我。 一种是从 ruby​​ 根目录安装 rdoc --all --ri。我试过了，但失败了（无法转换为 UTF8 或类似的东西）。 另一个建议 Windows 安装程序的 ruby​​installer 不再包含该信息，我应该使用在线文档，当我转到 http://ruby-doc.org/downloads/ 时，我发现我使用的版本 (2.4.4) 不存在。

这很奇怪，因为 ruby​​installer 网站明确表示，如果我是 Ruby 新手（我是），我应该安装 2.4.4。您会认为，如果任何版本都有良好的文档，那就是那个版本。相反，它似乎完全丢失了。

这一切都开始了，因为我正在尝试学习 Ruby，并且正在观看 Kevin Skoglund 的 Lynda.com Ruby 课程，该课程在许多版本之前录制，在该课程中他提到了 shell 中的 ri 命令，在我的版本不起作用。见下文：

红宝石--版本 ruby 2.4.4p296（2018-03-28 修订版 63013）[x64-mingw32]

ri --version ri.cmd 5.0.0

ri 字符串 对字符串一无所知

现在，如果在使用 ri 的 ruby​​ 中它不可用，而我必须使用在线文档，而我的版本缺少它，而我的版本恰好是推荐给新用户的版本，……你会看到我的沮丧。

这就是我真正想要的... 1. 我想使用 ri 并让它工作。 2. 如果这不可能，我想知道我的版本的文档在哪里在线，因为它不是应该在的地方。

感谢任何帮助。如果它涉及安装任何东西，让我知道如何做到这一点也很感激。正如我所提到的，我是新人。

Answer 1

由于您使用的是 RubyInstaller，我假设您使用的是 Windows。

我会说我不是 100% 的，但我对这个答案非常有信心。

• “使用 2.4，而不是 2.5”是由于在 Ruby 2.5 时 Ruby Gem 出现错误 首次发布，因为我碰巧在 Windows 机器上安装 Ruby 在那个确切的时间，这就是当时的推理不是 使用最新的 2.5 版本。
• 上述原因已得到纠正。

实际上，如果您是初学者，只要您使用与您的版本（2.0+ - 2.4-ish）接近的文档，就可以了。现在显然，我不应该提供此免责声明，尽管如果我不这样做，我会避免不可避免的否决票，这不是 100% 完美的解决方案，并且会有非常小的差异。作为初学者，您遇到任何这些差异的可能性非常低，低到不必担心。每种语言都有缺失且文档记录不佳的部分，Ruby 也不例外。通常这些是较少使用的类（尽管 Ruby Fiddle 是一个例外，我讨厌它的文档记录如此糟糕），并且在您学习语言的基础和核心时不会对您的学习过程产生影响。

在我的记忆中，“核心”是相当有据可查的，只要你使用 2.0+ 的文档（越接近 2.4 越好），你应该完全没问题，而且完全一样。 “标准库”可能会更受欢迎或失败，您的里程可能会有所不同，但仍然没有太极端。

因此，为了解决您问题的第二部分，不要太担心找到您正在使用的文档的确切版本。它甚至可能不存在在线，尽管安装程序应该提供了一个 CHM 帮助文件（会有一个快捷方式，其中包含 Ruby、IRB 等的快捷方式。

至于“为什么” ri 不起作用，我又不是 100% 确定。我在 ArchLinux 上，甚至没有构建 RDoc。老实说，RDoc 被更新的（和 IMO 更好的）文档引擎（即 YARD）搁置了。我做的并且更喜欢的一个可能的解决方案是在我安装 Ruby 之后立即安装 YARD gem：

gem install yard

然后在 CMD 中设置 YARD 以生成我的文档：

yard config --gem-install-yri

如果您决定走这条路，可以了解更多信息here。

它的好处是它还支持 RDoc 并且向后兼容。