使用 Ruby Gem 入門
inky-rb 是一個 gem,讓您可以在 Rails 應用程式中使用 Foundation for Emails 的功能。它可以嵌入至 Asset Pipeline,與 CSS inliner 結合,讓您產生超棒的回應式 HTML 電子郵件,可以在各種客戶端上使用。
運作方式
inky-rb 是 Inky 範本語言的純 Ruby 實作,它會將簡單的客製 HTML 標籤(例如 <row>
和 <column>
)轉換為電子郵件所需的複雜表格式 HTML。
使用 CSS inliner(例如 premailer-rails
或 roadie
),您可以避免在標記中手動嵌入樣式,讓電子郵件範本精簡。透過剖析電子郵件範本,inliner 可以找出您參考的樣式表,並檢視其中指定的所有選取器,將樣式指定給文件中相符的元素。
這種方法的結果是 HTML 電子郵件,樣式或回應性可依您的需求調整,而且程式碼量遠少於使用舊式方法撰寫電子郵件。
入門
在 Rails 應用程式中安裝 inky-rb 只需要幾個簡單的步驟。先將以下內容新增至應用程式的 Gemfile
gem 'inky-rb', require: 'inky'
# Stylesheet inlining for email
gem 'premailer-rails'
然後執行
bundle install
執行以下指令設定所需的樣式和郵件版面
rails g inky:install
(您可以指定產生的郵件版面檔名,例如:rails g inky:install some_name
)
將電子郵件範本重新命名,使用 .inky
檔案副檔名。請注意,您仍然可以在 .inky
範本中使用 ERB
welcome.html => welcome.html.inky
pw_reset.html.erb => pw_reset.html.inky
完成!現在您已準備好開始在 Rails 應用程式中撰寫回應式電子郵件。
獨立資產
若要將 Foundation for Emails 樣式包含在您的資產管線中,但不包含 Inky 範本語言,請使用 foundation_emails 寶石。