我已经用HelpNDoc帮助创作工具完成了rails页面帮助文档。它生成了一个包含一些HTML页面和4个文件夹(js、img、css和lib)的文件夹。我正在寻找向我的rails应用程序添加此功能的最佳方法。
到目前为止,我已经尝试创建一个名为“帮助”的新控制器,并将文件添加到视图文件夹中。之后,我更改了application.js和application.css.scss文件,以添加js和css文件。原来HTML文件包含脚本,所以我将它们放在help.js文件中。这看起来是最难的解决方案,因为我必须查看文件以更改引用和其他内容。
有没有其他不涉及改变很多事情的解决方案?
任何帮助都是非常感谢的。
我的解决方案
我用了发动机(http://guides.rubyonrails.org/engines.html)。我必须编辑html文件来修复路由,但这是最干净的解决方案。
发布于 2016-01-14 11:13:09
HelpNDoc和其他帮助创作工具将生成静态的HTML内容,包括: HTML、Javascript、CSS和可能的媒体元素。最好的解决方案是在静态服务器或子域(如help.yourapp.com )上托管您的文档,而不是Rails应用程序。
下面的教程可能会帮助您在Rails应用程序旁边设置一个带有静态内容的子域:http://www.yearofmoo.com/2011/09/serve-precompiled-rails-assets-from-a-static-domain.html
发布于 2016-01-14 11:22:50
我建议将HTML粘贴为视图,然后通过路由和应用程序将其链接起来
https://stackoverflow.com/questions/34733571
复制相似问题