Go pongo2 教程展示了如何使用 pongo2 模板引擎在 Golang 中使用模板。


模板引擎是一个库，旨在将模板与数据结合起来以生成文档。模板引擎用于生成大量电子邮件、源代码预处理或生成动态 HTML 页面。


模板由静态数据和动态区域组成。动态区域稍后被数据替换。渲染函数稍后将模板与数据结合起来。模板引擎用于将模板与数据模型相结合以生成文档。


pongo2 库是一个受 Django 模板引擎启发的 Go 模板引擎。


下载 pongo2 函数库

使用如下命令：

go get -u github.com/flosch/pongo2/v4

安装成功后可以看到如下输出：

go: downloading github.com/flosch/pongo2 v0.0.0-20200913210552-0d938eb266f3
go: downloading github.com/flosch/pongo2/v4 v4.0.2
go: downloading gopkg.in/check.v1 v1.0.0-20200902074654-038fdea0a05b
go: downloading github.com/niemeyer/pretty v0.0.0-20200227124842-a10e7caefd8e
go: downloading github.com/kr/text v0.1.0
go: added github.com/flosch/pongo2/v4 v4.0.2


pongo2 在模板字符串中使用了各种分隔符：


{% %}{{ }}{# #}# ##


pongo2.FromStringpongo2.FromFilepongo2.FromBytes


ExecuteExecuteWriterExecuteBytes


从字符串中读取模板

pongo2.FromString
package main

import (
    "fmt"
    "github.com/flosch/pongo2/v4"
    "log"
)

func main() {

    tpl, err := pongo2.FromString("Hello {{ name }}~")

    if err != nil {
        log.Fatal(err)
    }

    res, err := tpl.Execute(pongo2.Context{"name": "宇宙之一粟"})

    if err != nil {
        log.Fatal(err)
    }

    fmt.Println(res)
}



{{ }}
tpl, err := pongo2.FromString("Hello {{ name }}!")


  1. 接着，我们使用 Execute 渲染最终的字符串。在上下文中，我们为 name 变量传递一个值 “宇宙之一粟”：
res, err := tpl.Execute(pongo2.Context{"name": "宇宙之一粟"})


  1. 最后，运行该代码：
$ go run main.go         
Hello 宇宙之一粟~

如下图：

再来看一个例子，我们可以传递两个文本：

package main

import (
    "fmt"
    "github.com/flosch/pongo2/v4"
    "log"
)

func main() {

    tpl, err := pongo2.FromString("{{ name }}是{{ occupation }}")

    if err != nil {
        log.Fatal(err)
    }

    name, occupation := "宇宙之一粟", "程序猿👨💻"
    ctx := pongo2.Context{"name": name, "occupation": occupation}

    res, err := tpl.Execute(ctx)

    if err != nil {
        log.Fatal(err)
    }

    fmt.Println(res)
}

运行该代码：

$ go run main.go
宇宙之一粟是程序猿👨💻

从文件中读取文本

pongo2.FromFile
test.tpl
{{ name }}是{{ occupation }}
main.go
package main

import (
    "fmt"
    "github.com/flosch/pongo2/v4"
    "log"
)

func main() {

    tpl, err := pongo2.FromFile("test.tpl")

    if err != nil {
        log.Fatal(err)
    }

    name, occupation := "宇宙之一粟", "不掉发的程序猿"
    ctx := pongo2.Context{"name": name, "occupation": occupation}

    res, err := tpl.Execute(ctx)

    if err != nil {
        log.Fatal(err)
    }

    fmt.Println(res)
}

运行该程序：

$ go run main.go
宇宙之一粟是不掉发的程序猿