跳转到内容
Wippy

Template Engine

Template Engine

Section titled “Template Engine”

使用 CloudyKit Jet 的模板渲染。

Entry 类型

Section titled “Entry 类型”
Kind描述
template.set带共享配置的模板集
template.jet单个模板

模板集

Section titled “模板集”

模板集是包含相关模板的命名空间。集合中的模板共享配置，可以通过名称相互引用。

- name: views
  kind: template.set

所有配置都是可选的，有合理的默认值：

字段类型默认值描述
engine.development_modeboolfalse禁用模板缓存
engine.delimiters.leftstring{{变量左分隔符
engine.delimiters.rightstring}}变量右分隔符
engine.globalsmap-所有模板可用的变量

模板

Section titled “模板”

模板属于一个集合，通过名称进行内部解析标识。

- name: layout
  kind: template.jet
  set: app.views:views
  source: |
    <html>
    <body>{{ yield content() }}</body>
    </html>


- name: home
  kind: template.jet
  set: app.views:views
  source: |
    {{ extends "layout" }}
    {{ block content() }}
      <h1>Welcome, {{ name }}</h1>
    {{ end }}
字段类型必需描述
setreference是父模板集
sourcestring是模板内容

模板解析

Section titled “模板解析”

模板使用名称相互引用，而不是 registry ID。解析像集合内的虚拟文件系统一样工作：

  1. 默认情况下，registry entry 名称（entry.ID.Name）成为模板名称
  2. 使用 meta.name 覆盖自定义命名：
- name: email-welcome-v2
  kind: template.jet
  set: app.emails:templates
  meta:
    name: welcome
  source: |
    {{ include "header" }}
    Hello {{ user }}!

此模板在集合中注册为 welcome，因此其他模板使用 {{ include "welcome" }} 或 {{ extends "welcome" }}。

继承

Section titled “继承”

模板可以扩展父模板并覆盖块：

# Parent defines yield points
- name: base
  kind: template.jet
  set: app.views:views
  source: |
    <html>
    <head><title>{{ yield title() }}</title></head>
    <body>{{ yield body() }}</body>
    </html>


# Child extends and fills blocks
- name: page
  kind: template.jet
  set: app.views:views
  source: |
    {{ extends "base" }}
    {{ block title() }}My Page{{ end }}
    {{ block body() }}<p>Content here</p>{{ end }}

Lua API

Section titled “Lua API”

参见 Template 模块 了解渲染操作。

另请参阅

Section titled “另请参阅”