ruby-on-rails - 如何在生产服务器上运行 Yard 服务器？

Question

如何在生产服务器上运行 Yard 服务器？也许使用一些任务？从 capistrano 加载，使用 passenger 和 nginx，Jenkins(Hudson)。

Answer 1

我发现最简单的选择是在我的 Rails 应用程序中从/public 符号链接(symbolic link)生成的文档文件夹。您只需要确保可以通过相同的路径访问 js/css 资源。

例如:

$ cd <railsapp>
$ ls
Gemfile
app/
..
public/
doc/ <- Folder that contains the html files generated by yard
$ cd public/
$ ln -s ../doc/ docs

这将在/docs/index.html 为您的文档提供服务

基于 javascript 的类/方法/文件搜索仍然有效，因为它是基于 javascript 的。但是，出现在顶部的搜索不会出现在此方法中。但是我发现基于 javascript 的搜索就足够了。