Ruby-yard-doc不显示任何文件
这是我的设置:Ruby-yard-doc不显示任何文件,ruby,gem,rdoc,yard,Ruby,Gem,Rdoc,Yard,这是我的设置: Ruby 1.9.2 p290 0.8.1码 文件夹结构不是gem,只是简单的旧Ruby代码: . ├── classes │ ├── crawl.rb │ └── page.rb └── run.rb 问题是yard没有看到任何文件 yard doc生成此输出: Files: 0 Modules: 0 ( 0 undocumented) Classes: 0 ( 0 undocumented)
- Ruby 1.9.2 p290
- 0.8.1码
.
├── classes
│ ├── crawl.rb
│ └── page.rb
└── run.rb
问题是yard没有看到任何文件
yard doc
生成此输出:
Files: 0
Modules: 0 ( 0 undocumented)
Classes: 0 ( 0 undocumented)
Constants: 0 ( 0 undocumented)
Methods: 0 ( 0 undocumented)
0.00% documented
你知道为什么它看不到我的任何文件吗
编辑(其他信息): Yard没有创建文件的权限 运行
yard doc
命令后,我的目录显示yard文件:
. .. .yardoc classes doc run.rb
编辑(回复关于rdoc的评论) 一旦我删除yard创建的文档文件夹(rdoc对此抱怨)
rm-rf doc
,rdoc将生成文档并提供此输出
Files: 7
Classes: 6 ( 4 undocumented)
Modules: 0 ( 0 undocumented)
Constants: 2 ( 2 undocumented)
Attributes: 18 (18 undocumented)
Methods: 24 (20 undocumented)
Total: 50 (44 undocumented)
12.00% documented
编辑(其他信息)
Yard不适用于其他ruby构建,包括MRI 1.8.7和jRuby 1.6.4。它的行为与上面描述的相同Yard不会自动记录目录结构中的所有ruby文件。它在
/lib
目录中查找文件。如果要记录其他文件,必须在命令或.yardopts文件中指定
范例
yard classes/*.rb*.rb
发出该命令时,您的工作目录是什么?工作目录与我的文件所在的目录相同。这与我为上面的示例文件夹结构发出tree命令时相同。当您尝试使用rdoc而不是yard时会发生什么?这将有助于三角确定这到底是一个场地问题,还是一个系统/配置问题。rdoc有效,我编辑了上面的帖子,以便我可以在一个长块中发布输出。见上文“编辑(对rdoc评论的回应)”