`premailer-rails` 使用指南

premailer-rails 使用指南

premailer-railsCSS styled emails without the hassle.项目地址:https://gitcode.com/gh_mirrors/pr/premailer-rails

1. 项目目录结构及介绍

premailer-rails 是一个RubyGem，它作为ActionMailer的一个适配器，使得在Rails应用程序中可以轻松地将CSS样式内联到HTML邮件中，无需额外的配置。由于这是一个gem，并不是传统意义上具有项目目录结构的应用程序，但安装并使用它时，有几个关键点涉及特定的配置文件或路径。

核心Gem文件结构（假设从源码角度）

• lib 目录：包含了gem的主要逻辑实现，比如premailer-rails.rb初始化文件等。
• rails 目录：可能包含与Rails集成相关的代码。
• Gemfile: 定义了gem依赖关系，用于开发过程中。
• README.md: 提供基本的项目描述和快速入门指导。
• LICENSE: 记录软件许可信息，本项目遵循MIT许可证。

实际在用户的Rails应用中，相关配置和交互主要发生在应用内部的特定文件，如：

• Gemfile: 引入premailer-rails宝石。
• config/initializers/premailer_rails.rb: 配置选项存放处。

2. 项目的启动文件介绍

对于premailer-rails，没有直接的“启动文件”让你运行，因为它的激活是在你的Rails应用启动并在配置阶段被加载的。关键在于你的Gemfile中的添加和config/initializers/premailer_rails.rb的配置。

• Gemfile 中通过以下命令添加premailer-rails来“启动”这个gem：

  gem 'premailer-rails'
  

  然后执行bundle install以安装依赖。

3. 项目的配置文件介绍

premailer-rails的核心配置位于你的Rails应用的config/initializers/premailer_rails.rb文件中。如果你的应用中不存在此文件，你需要手动创建它。该文件用来定制premailer-rails的行为。默认情况下，你可以设置如下的配置项：

Premailer::Rails.config do |config|
  config.merge!(
    preserve_styles: true,
    remove_ids: true
  )
end

这些配置允许你控制预处理HTML邮件时的一些行为，比如是否保持原始CSS样式不改变（preserve_styles），是否移除HTML元素的ID属性（remove_ids）等。更多可配置的选项，请参考Premailer文档。

请注意，如果不进行自定义配置，premailer-rails将会使用其内置的默认值。在进行高级调优时，确保了解每个配置选项的意义，并按需调整。

以上就是关于premailer-rails在Rails应用中的基础配置和使用的简要说明。记得，具体实施时，还需要结合Rails的环境设定和实际应用需求做适当调整。

premailer-railsCSS styled emails without the hassle.项目地址:https://gitcode.com/gh_mirrors/pr/premailer-rails