4

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

非常感谢

4

2 回答 2

3

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

  1. 在硬盘上的某个地方创建一个新文件夹（我使用了 ~/Sites/yard-on-heroku）

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

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

  3. 运行bundle install以安装 gem。

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

    web: yard server -p $PORT -g

  5. 创建一个新的 git 存储库git init

  6. 将您的文件提交给它（Gemfile*、Procfile）
  7. 创建一个 Heroku 应用程序heroku create
  8. 将你的 repo 推送到 Herokugit push heroku master

就是这样。如果您转到在第 7 步中创建站点时提供的 Heroku URL，您会看到 Yard 正在运行所有可用的 gem。如果您希望仅显示 Gemfile 中列出的 gem，而不是默认情况下所有可用的 Gem，包括 Gemfile 中的 Gem，那么您可以使用-G而不是-gProcfile 中的 Gem。

（我第一次在 StackOverflow 上回答，所以希望没问题 - 任何关于改进的建议，感激不尽）。

于 2013-08-02T13:07:39.923 回答
2

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

于 2014-05-27T18:46:15.883 回答