如何在本地无需启动Rails服务器，单独渲染Gem中的HAML页面？

方案1：用独立HAML工具+模拟Rails上下文 #

1. 安装独立的haml gem：

   gem install haml
   

2. 编写Ruby脚本（比如render_haml.rb），模拟Rails的翻译、链接助手并加载YAML文件：

   require 'haml'
   require 'yaml'
   require 'action_view'
   
   # 加载项目中的YAML翻译文件，路径按需修改
   translations = YAML.load_file('./config/locales/zh-CN.yml')['zh-CN']
   
   # 模拟视图上下文，实现HAML中用到的助手方法
   class MockView
     include ActionView::Helpers::UrlHelper
     include ActionView::Helpers::TranslationHelper
   
     def initialize(translations)
       @translations = translations
     end
   
     # 适配YAML层级的简化翻译方法
     def t(key)
       key.split('.').inject(@translations) { |val, part| val[part] } || key
     end
   
     # 模拟link_to生成静态HTML链接
     def link_to(text, url, opts = {})
       attr_str = opts.map { |k, v| "#{k}=\"#{v}\"" }.join(' ')
       "<a #{attr_str} href=\"#{url}\">#{text}</a>"
     end
   end
   
   # 读取HAML文件并渲染为HTML
   haml_content = File.read('./path/to/your/target.haml')
   view = MockView.new(translations)
   renderer = Haml::Engine.new(haml_content)
   File.write('rendered.html', renderer.render(view))
   

3. 运行脚本生成HTML文件：

   ruby render_haml.rb
   

4. 直接打开生成的rendered.html，用浏览器开发者工具检查可访问性。

方案2：用本地Rails控制台快速渲染 #

1. 在项目根目录启动Rails控制台：

   rails c
   

2. 执行以下代码将HAML渲染为HTML文件：

   require 'haml'
   # 替换为目标HAML文件的实际路径
   haml_engine = Haml::Engine.new(File.read('./vendor/gems/your-public-gem/app/views/target_page.haml'))
   # 借助Rails自带视图上下文渲染
   html_output = haml_engine.render(ActionView::Base.new)
   File.write('local_render.html', html_output)
   

3. 退出控制台后打开local_render.html即可查看效果。

方案3：本地绑定公共库Gem，缩短测试周期 #

如果需要频繁修改公共库的HAML文件，可跳过PR流程直接本地关联：

1. 将公共库代码克隆到本地目录。
2. 修改项目Gemfile，将公共库Gem指向本地路径：

   gem 'your-public-library-gem', path: '/Users/your-name/local-repos/public-gem'
   

3. 运行bundle install，之后修改本地公共库的HAML文件后，重启Rails服务器即可看到效果，无需等待PR审核合并。

注意事项：

• 模拟助手方法时，需根据实际YAML结构和HAML中用到的方法调整脚本，确保变量、翻译能正确解析。
• 如果HAML中使用了其他Rails助手（如form_for），需在MockView类中添加对应的模拟实现。

内容的提问来源于stack exchange，提问作者BasMan