Fatal编程技术网
  • ruby/
  • 如何安装Ruby ri文档？

如何安装Ruby ri文档？

ruby

如何安装Ruby ri文档？,ruby,Ruby,我最近在Windows7上安装了Ruby 1.9.1，显然它没有标准的ri文档。因此，当我使用“ri数组”时，我得到： C:\>ri Array Nothing known about Array 有没有一种方法可以安装此文档以使上述功能正常工作？所有Ruby文档都位于 因此，阵列文档位于： 从未在windows上尝试过它，但因为它说对X一无所知，并不是说它没有安装，只是没有得到任何东西 尝试安装一个gem，然后ri gem_CLASS，因为它应该提供防御，让我们看看它是否丢失了文档

我最近在Windows7上安装了Ruby 1.9.1，显然它没有标准的ri文档。因此，当我使用“ri数组”时，我得到：

C:\>ri Array

Nothing known about Array
有没有一种方法可以安装此文档以使上述功能正常工作？

所有Ruby文档都位于

因此，阵列文档位于：

从未在windows上尝试过它，但因为它说对X一无所知，并不是说它没有安装，只是没有得到任何东西

尝试安装一个gem，然后
ri gem_CLASS
，因为它应该提供防御，让我们看看它是否丢失了文档，或者ri是否找不到正确的位置

你似乎有RubyInstaller项目发布的安装程序Ruby 1.9.1

您可以使用安装程序附带的Windows帮助文件（CHM），而不是ri文档

RI文档的问题在于，RDoc的某些版本在生成它时遇到问题，并且生成了超过10000个文件，这大大降低了安装程序的速度。

以防其他平台上的用户需要安装他们的RI文档（就像我做的那样）。本文给出了原因和方法：

命令是：

gem rdoc --all --ri --no-rdoc
如果您使用的是rvm，您应该
rvm文档生成
（或者只是
rvm文档生成ri
）

请参见关于rvm和ri的内容

建议的解决方案中没有一个适合我。最后，我找到的解决方案非常简单，所以我把它留在这里。（我正在win7 x64上运行ruby 2.2.4，以防万一）

（机长明显警告：必须安装ruby并在您的路径中）

-打开命令

-$ gem install rdoc-data

-$ rdoc-data --install
你准备好了！通过运行以下命令测试它是否工作：

-$ri Array
它应该会为您提供该课程的所有可爱文档

希望这有帮助

另外，我注意到这是一条评论中提出的解决方案，但他的评论我不清楚，所以我继续搜索。基本上，这是相同的解决方案，但解释得更清楚，这样就不会发生在其他任何人身上：）

干杯

RVM不会自动生成和安装每个Ruby的ri/rdoc文档。可以使用以下命令生成：
rvm文档生成的内容与Ruby Installer 2.4.1.2（2017年）基本相同。如果我运行
ri-Array
，它将显示
Array
，而不显示其他内容。如果我运行
ri“Array#each”
，我会得到熟悉的“未知…”消息。简而言之，关于Ruby核心和标准库的ri格式文档缺失

下面是我如何获得core/stdlib ri文档副本的。当然，在此之前必须安装Ruby

  • 从中获取与我的版本最匹配的ruby源代码
  • 将.zip或.tar.gz存档解压缩到某个文件夹
  • 打开cmd.exe/Powershell，
    cd
    到该文件夹并运行
    rdoc--all--ri
    • 此命令递归地解析当前目录中的.c文件、.rb文件和一些其他文件类型，并生成到
      ~/.rdoc
      目录的ri文档
    • 在配备i7-3520M处理器的笔记本电脑上花了大约5分钟完成，没有出现任何错误
  • 删除存档和包含源代码的目录，因为我们不再需要它们
    • 现在，如果您尝试运行
    ri-Array
    或
    ri“Array#each”
    ，您将获得非常出色的文档

    tl；博士 在包含与已安装版本相同的ruby版本的源代码的目录上运行
    rdoc--all--ri

    附录Z：对其他答案的评论 
  • rvm文档生成ri
    可以工作，但您必须在Windows上使用Cygwin或Ubuntu（如果在Windows 10上）才能使用
    rvm
  • gemrdoc--all--ri--no-rdoc
    为所有gems安装ri文档。它不安装core/stdlib文档
  • gem安装rdoc数据
    后接
    rdoc数据--install
    仅适用于2.3.0之前的Ruby版本
    • 您可能会在Docker下遇到此问题。官方的
    docker
    图像附带，并且显然禁止安装gem文档

    如果映像和系统的ruby版本相匹配（特别是，
    RbConfig:：CONFIG[“ruby\u version”]
    ，例如，ruby-2.6.1的
    2.6.0
    ），您可以：

    # apk add ruby-doc
# cp -r /usr/share/ri /usr/local/share/ri
    我刚刚安装了Rake（我把它缩短了一点），我得到了如下信息：C:\>ri Rake------------------Class:Rake------------------这篇文章讨论了没有包括的ri文档：它不太重要，但是我正在读的那本书谈到了它，所以我想去看看。所以没有办法单独下载这些文件？这不是问题的答案。你可能应该改为发表评论。谢谢。这正是我所需要的。我相信它不会为Ruby core安装文档，但有了gems（已安装，也许还有），它就可以了。该网站已经不存在了。仅供参考：
    rvm docs generate
    在我的系统上花了很长时间才完成。所以请注意，或者耐心等待。链接答案不再像@Snowcrash指出的那样有效。下面是关于这个主题的官方rvm文档的链接：在我的情况下（Windows 10，Ruby 2.6.5），我必须使用
    --op
    选项来指定目录，例如
    rdoc--all--ri--no-rdoc--op-tmp/.rdoc
    （否则命令会抱怨
    doc
    目录已经存在，但它不是rdoc目录）。然后，我将生成的
    .rdoc
    目录移动到我的主目录中。在这之后，
    ri阵列
    为我工作了所有的荣耀！