MangoFanFanw
f06de85257
docs 目录包含一个 VitePress 构建的静态文档站点。 mjml 目录包含 HTML 邮件模板。这些模板将被编译为 Jinja2 模板，然后由 NyaHome 动态渲染后发送。
1.0 KiB
1.0 KiB
邮件模板
NyaHome 希望发送 HTML 邮件，但是用于邮件的 HTML 在 2026 年依然是重灾区。因此，NyaHome 决定采用 mjml 配合 Jinja2 制作并渲染邮件模板。
有关工作流程
项目根目录下的 mjml 内是 mjml 源文件。这是一种类 xaml 格式的文件，采用独特的语法像编写 HTML 一样编写用于邮件的……也是
HTML。
通过以下命令，这些 mjml 源文件将会被编译为 j2 源文件，也就是 Jinja2 的模板文件。
pnpm mjml mjml/filename.mjml -o public/templates/filename.j2
Jinja2 在 NyaHome 进程中读取模板，渲染变量，然后由 aiosmptplib 发送渲染好的 HTML 邮件。
在 PyCharm 中预览 mjml 源文件
使用 MJML Support 插件以支持 mjml 源文件的语法高亮、智能补全和实时预览。
:::warning MJML Support 插件不支持 JetBrains 远程开发。在远程开发（包括使用 Gateway 进行 WSL 开发）中，IDE client 无法对 mjml 源文件进行实时预览。 :::