在Heroku上运行Yard Server

Question

有没有办法在heroku上安装Yard（http://yardoc.org/guides/index.html）服务器？ 我在文档中找不到任何解释如何操作的内容。

非常感谢

Answer 1

这可能有我尚未发现的陷阱（例如Yard在某处缓存其输出文件，因为Heroku可能经常擦除文件系统并重新插入它，你将丢失缓存文件并且必须重新生成），但它通常是有效的，非常简单。

1. 在硬盘上创建一个新文件夹（我使用〜/ Sites / yard-on-heroku）

2. 在那里创建一个新的Gemfile，列出你想要可用的gem（如果它们不在标准的Heroku安装中）。我使用了以下内容：

   source 'https://rubygems.org'
   gem 'sinatra'
   gem 'rails'
   gem 'yard'
   

3. 运行bundle install安装宝石。

4. 创建一个名为Procfile的文件，并在其中加入以下内容：

   web: yard server -p $PORT -g
   

5. 使用git init

创建新的git存储库
6. 将文件提交给它（Gemfile *，Procfile）
7. 使用heroku create
创建一个Heroku应用
8. 使用git push heroku master
将您的回购推送到Heroku

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

（我在StackOverflow上的第一个答案，所以希望它没关系 - 任何关于改进的建议，感激不尽）。

Answer 2

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