在Heroku上运行Yard Server

Question

有没有办法在heroku上挂载Yard (http://yardoc.org/guides/index.html)服务器？我在文档中没有找到任何解释如何做的东西。

非常感谢

Answer 1

这可能有我还没有发现的缺陷(例如，Yard将其输出文件缓存到某个地方，考虑到Heroku可能经常擦除文件系统并重新阻塞它，您将丢失缓存文件并重新生成)，但它通常是有效的，并且非常简单。

Heroku在硬盘上的某个地方创建一个新的文件夹(我使用了~/Sites/yard-on-heroku)

• Create a new Gemfile，列出了你想要使用的gem(如果它们不在标准的安装中))。我使用了以下代码：

源'https://rubygems.org‘gem 'sinatra’gem 'rails‘gem’yard‘

• 运行bundle install安装gem。

• 创建一个名为Procfile的文件，并将以下内容放入其中：

git init

• Commit : yard server -p $PORT -g

• 创建一个新的git存储库，并将您的文件保存到该存储库(Gemfile*，Procfile)

• Create a Heroku app with heroku create

• Push your repo to Heroku with git push heroku master

)

就是这样。如果您转到在步骤7中创建站点时给出的Heroku URL，您将看到Yard运行着所有可用的gem。如果您只想显示Gemfile中列出的gems，而不是默认情况下包括Gems文件中的所有Gems，那么可以在show文件中使用-G而不是-g。

(我在StackOverflow上的第一个回答，所以希望它是OK的-任何关于改进的建议，非常感谢)。

Answer 2

我在这里用我对这个问题的解决方案写了一个很好的教程：http://benradler.com/blog/2014/05/27/deploy-yard-documentation-server-to-heroku/