缺少Ruby 2.4.4文档

时间:2018-07-04 01:14:37

标签: ruby documentation ri

我的问题是关于ruby-doc.org文档,但也涉及ruby内部的ri文档查找。

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

这很奇怪,因为rubyinstaller网站专门说如果我是Ruby的新手,我应该安装2.4.4。您会认为,如果有任何版本的文档很好,那就是那个。相反,它似乎完全丢失了。

这一切都开始了,因为我试图学习Ruby,并且正在观看Kevin Skoglund编写的关于Ruby的Lynda.com课程,该课程在许多版本中都有记录,因此他指的是shell中的ri命令。版本不起作用。见下文:

  

红宝石-版本   红宝石2.4.4p296(2018-03-28修订版63013)[x64-mingw32]

     

ri --version   ri.cmd 5.0.0

     

ri字符串   关于字符串一无所知

现在,如果使用ri在ruby中不可用,并且我必须使用在线文档,并且我的版本(恰好是为新用户推荐的版本)不见了,…您会感到沮丧。

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

感谢您的帮助。如果涉及安装任何东西,也请告诉我如何做。如前所述,我是新手。

1 个答案:

答案 0 :(得分:0)

由于您使用的是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

然后设置YARD以使用CMD生成我的文档:

yard config --gem-install-yri

如果您决定采用此路线,则可以here学到更多。

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