我一直在尝试从源代码添加一个vagrant插件(https://github.com/schisamo/vagrant-omnibus)。我下载了它，进行了“捆绑安装”，一切顺利。但是当我执行“rakeinstall”时，它显示了以下错误:rakeaborted!cannotloadsuchfile--yard这是带有跟踪的完整错误日志:rakeaborted!cannotloadsuchfile--yard/root/chef-solo-example/vagrant-omnibus-master/Rakefile:5:in`require'/root/chef-solo-examp

我有一些如下所示的Ruby代码:#some_string="{really?}"大括号需要是字符串的一部分。这一行是注释掉的代码，我想保留在那里。我还使用YARD来记录代码，所以当我运行yarddoc时，它(自然地)会发出无法“真正”链接的警告。有没有办法让YARD忽略注释掉的代码？ 最佳答案 IsthereawayIcantellYARDtoignorecommentedoutcode?一方面，YARD记录支持Rdoc标记。并且Rdoc被记录为支持几种隐藏部件的方法。RDocstopsprocessingcommentsifitf

YARD允许我指定方法参数和返回值的类型。因为我真的很喜欢躲避类型，所以很高兴看到YARD还支持通过指定它们必须支持的方法来定义类型。如你所见here,像#first_method,#second_method这样的表达被解释为逻辑析取。这意味着对象需要支持#first_method或#second_method或两者。这不是我需要的。我希望能够指定一个对象需要同时支持我的参数的#first_method和#second_method。有办法指定吗？ 最佳答案 没有用于指定复合鸭子类型接口(interface)的惯用语法。也就是说，

我有一个函数，它接受可变数量的参数，如下所示:defmyfun(*args)#...end所有参数都是同一类型(Symbol)，所以现在我记录函数就像只有一个参数一样，说它可以接受多个参数，例如:#thisfunctiondoesn’tdoanything#@param[Symbol]:thisargumentdoessomething,youcanaddmoresymbols#ifyouwantdefmyfun(*args)#...end是否有内置方法来处理这种情况？ 最佳答案 以下是有道理的，因为args是方法内部的一个Arra

我有这样的方法defself.import(file_name,opts={})我正在尝试用YARD记录下来。然而，这是一种100%副作用的方法(我知道，我知道，副作用，呃!)。但是对于此方法的用户，实际上没有任何类型的返回对象，但是YARD生成如下签名:+(Object)import(file_name,opts={})有什么办法可以告诉yardimport方法什么都不返回吗？我可以告诉它返回nil，但这不是一回事 最佳答案 所有方法都会返回一些东西，void关键字可能就是您要查找的内容。#@return[void]defmeth

我正在将我维护的ruby​​gem从RDoc切换到YARD文档。但是，代码中有一些关键注释只需要保留在代码中，不应出现在文档中。例如:###SomeClassdocumentationhere.#--#CRITICALcommentthatshouldbeinthecodebutnotinthedocumentation,#andmustbeatthisparticularspotinthecode.#++#moredocumentationthatfollowsthecriticalcommentblock,butthispart#shouldbeinthegenerateddocu

我想在yard-genereted文档中包含图像，但无法在任何地方找到如何执行此操作...有人知道如何执行此操作吗？ 最佳答案 您可以只添加标记到您的文档:#Blah-blah###@param[String]blah#@return[String]blahdeffoo(bar)end 关于ruby-yard，如何将图像包含到文档中？，我们在StackOverflow上找到一个类似的问题： https://stackoverflow.com/questions

我有一个从工厂函数创建的类，如下所示:Cake=MyProject.Struct(:type,:price)在Yard中，它只是与我的常量一起显示:Cake=Struct(:type,:price)Iwantittoshowupinthe"Classes:"list.Afterreadinguponthedocs,Iwasleadtobelievethatthiswouldwork:#@!parseclassCake;endCake=MyProject.Struct(:type,:price)但它确实没有任何改变。是否可以让Yard将动态创建的类记录为类？

关闭。这个问题是opinion-based.它目前不接受答案。想要改进这个问题？更新问题，以便editingthispost可以用事实和引用来回答它.关闭4年前。Improvethisquestion我有一个方法应该接受任何类的1+个参数，类似于Array#push:defmy_push(*objects)raiseArgumentError,'Needs1+arguments'ifobjects.empty?objects.eachdo|obj|puts"Anobjectwaspushed:#{obj.inspect}"@my_array.pushobjendend使用YARD语法记

如何使用YARD创建指向ruby​​类方法的链接？这是yarddocumentation关于链接。链接到同一命名空间内的实例方法:{#my_instance_method}效果很好。但是，使用类方法遵循相同的方法并不能编译，修改它:{#self.my_class_method}生成以下纯文本(不是链接):ObjectName#self#self.my_class_method 最佳答案 只用名字，裸:{class_method}或者如果它在不同的命名空间中{Object.class_method}