Merge pull request #330 from Peefy/builtin-template-function

docs: add builtin template function

Author: Peefy

docs/reference/model/overview.md

@@ -54,4 +54,7 @@ For relatively complex general logic, it is provided through the system modules.
    <DocsCard header="file" href="file">
     <p>Provides filesystem functions.</p>
   </DocsCard>
+   <DocsCard header="template" href="template">
+    <p>Provides template functions.</p>
+  </DocsCard>
 </DocsCards>

docs/reference/model/template.md

@@ -0,0 +1,48 @@
+---
+title: "template"
+linkTitle: "template"
+type: "docs"
+description: template functions
+weight: 100
+---
+
+## execute
+
+`execute(template: str, data: {str:any} = {}) -> str`
+
+Applies a parsed template to the specified data object and returns the string output. See https://handlebarsjs.com/ for more documents and examples.
+
+```python3
+import template
+
+content = template.execute("""\
+<div class="entry">
+{{#if author}}
+<h1>{{firstName}} {{lastName}}</h1>
+{{/if}}
+</div>
+""", {
+  author: True,
+  firstName: "Yehuda",
+  lastName: "Katz",
+})
+```
+
+## html_escape
+
+`html_escape(data: str) -> str`
+
+Replaces the characters `&"<>` with the equivalent html / xml entities.
+
+```python3
+
+import template
+
+content = template.html_escape("""\
+<div class="entry">
+{{#if author}}
+<h1>{{firstName}} {{lastName}}</h1>
+{{/if}}
+</div>
+""")
+```

i18n/zh-CN/docusaurus-plugin-content-docs/current/reference/model/overview.md

@@ -51,7 +51,10 @@ KCL 通过内置模块、系统库模块和插件模块提供工程化的扩展
   <DocsCard header="yaml" href="yaml">
     <p>提供了与 YAML 相关的编码/解码函数。</p>
   </DocsCard>
-  <DocsCard header="file" href="yaml">
+  <DocsCard header="file" href="file">
     <p>提供了与文件系统相关的函数。</p>
   </DocsCard>
+  <DocsCard header="template" href="template">
+    <p>提供了与模版相关的函数。</p>
+  </DocsCard>
 </DocsCards>

i18n/zh-CN/docusaurus-plugin-content-docs/current/reference/model/template.md

@@ -0,0 +1,48 @@
+---
+title: "template"
+linkTitle: "template"
+type: "docs"
+description: 模版操作
+weight: 100
+---
+
+## execute
+
+`execute(template: str, data: {str:any} = {}) -> str`
+
+将解析过的模板应用于指定的数据对象，并返回字符串输出。查看 https://handlebarsjs.com/ 获取更多文档和示例。
+
+```python3
+import template
+
+content = template.execute("""\
+<div class="entry">
+{{#if author}}
+<h1>{{firstName}} {{lastName}}</h1>
+{{/if}}
+</div>
+""", {
+  author: True,
+  firstName: "Yehuda",
+  lastName: "Katz",
+})
+```
+
+## html_escape
+
+`html_escape(data: str) -> str`
+
+将字符 `&"<>` 替换为等效的 html / xml实体。
+
+```python3
+
+import template
+
+content = template.html_escape("""\
+<div class="entry">
+{{#if author}}
+<h1>{{firstName}} {{lastName}}</h1>
+{{/if}}
+</div>
+""")
+```

i18n/zh-CN/docusaurus-plugin-content-docs/version-0.8/reference/model/overview.md

@@ -51,7 +51,7 @@ KCL 通过内置模块、系统库模块和插件模块提供工程化的扩展
   <DocsCard header="yaml" href="yaml">
     <p>提供了与 YAML 相关的编码/解码函数。</p>
   </DocsCard>
-  <DocsCard header="file" href="yaml">
+  <DocsCard header="file" href="file">
     <p>提供了与文件系统相关的函数。</p>
   </DocsCard>
 </DocsCards>