ruby-on-rails - 链接到命名空间中的模型的 yardoc 语法是什么？

Question

我在他们的网站上的任何地方都找不到。

这是我所拥有的：

# {Page::Section}

但是当我运行 yardoc 生成时，我得到了这个错误：

[warn]: In file `app/controllers/pages_controller.rb':2: Cannot resolve link to Page::Section from text:
[warn]: ...{Page::Section}...

当我转到编写上述文档的 api 页面时，它只显示纯文本，而不是指向该对象页面的链接。

我怀疑，上述错误是因为它从未找到这个类：

class Page::Section < ActiveRecord::Base

（但如果我将其更改为 PageSection，则文档呈现得很好）。

也许它与我正在使用的yard-rest-plugin版本有关？我不确定

Answer 1

我在命名空间控制器上遇到了这个问题。我很沮丧，但最终成为用户错误。

假设class Inherited::ResourceController < InheritedController

{Inherited::ResourceController#show}会工作，但{InheritedController::ResourceController#show}不会。（看，我告诉过你这是用户错误）