MJML-Go 安装与配置指南

1. 项目基础介绍

MJML-Go 是一个开源项目，它可以将 MJML (Mailchimp Template Language) 代码编译成 HTML，使得 Go 应用程序能够直接处理 MJML 模板。这样，开发者就无需依赖外部的 Node.js 服务器来转换 MJML，从而简化了部署流程。该项目主要使用 Go 语言编写。

2. 关键技术与框架

• Go 语言：项目的主体语言，用于实现 MJML 到 HTML 的转换逻辑。
• WebAssembly (Wasm)：通过将 MJML 的 JavaScript 库编译为 Wasm 模块，使得 Go 应用能够直接执行 MJML 的转换。
• Webpack：用于打包 JavaScript 代码和生成 Wasm 模块。
• Javy：一个 JavaScript 到 WebAssembly 的编译器，用于将 MJML 的 JavaScript 库转换为 Wasm。

3. 安装和配置

准备工作

在开始安装之前，请确保您的系统中已安装以下软件：

• Go 语言环境（至少 1.16 版本）
• Docker（用于运行测试）

安装步骤

步骤 1：克隆项目仓库

打开终端或命令提示符，执行以下命令以克隆项目仓库：

git clone https://github.com/Boostport/mjml-go.git
cd mjml-go

步骤 2：安装依赖

在项目根目录下，运行以下命令安装项目依赖：

go mod tidy

步骤 3：构建项目

安装依赖后，使用以下命令构建项目：

go build

构建完成后，将在项目根目录生成一个可执行文件 mjml-go。

步骤 4：运行测试（可选）

如果需要运行测试以验证安装的正确性，请先构建 Docker 镜像，然后运行测试容器：

docker-compose run test

测试将执行一系列的单元测试，以确保项目的各个部分都能正常工作。

步骤 5：使用 MJML-Go

现在，您已经成功安装了 MJML-Go，可以直接在您的 Go 应用程序中使用它来转换 MJML 模板了。以下是一个简单的示例：

package main

import (
	"context"
	"fmt"
	"github.com/Boostport/mjml-go"
)

func main() {
	input := `<mjml><mj-body>...</mj-body></mjml>`
	output, err := mjml.ToHTML(context.Background(), input, mjml.WithMinify(true))
	if err != nil {
		fmt.Println("Error:", err)
		return
	}
	fmt.Println(output)
}

请替换 <mjml><mj-body>...</mj-body></mjml> 为您的 MJML 代码。

以上就是 MJML-Go 的详细安装和配置指南。如果您在安装过程中遇到任何问题，请查看项目的 GitHub 仓库页面上的 README.md 文件，或者向维护者提出问题。