【翻译】Scriban README 文本模板语言和.NET引擎
scriban
Scriban是一种快速、强大、安全和轻量级的文本模板语言和.NET引擎,具有解析liquid
模板的兼容模式
Github
目录
- 【翻译】Scriban是一种快速、强大、安全和轻量级的文本模板语言和.NET引擎,具有解析liquid模板的兼容模式
- 【翻译】 Scriban language
- 【翻译】Scriban runtime
// Parse a scriban template
var template = Template.Parse("Hello {{name}}!");
var result = template.Render(new { Name = "World" }); // => "Hello World!"
使用Liquid语言解析Liquid模板:
// Parse a liquid template
var template = Template.ParseLiquid("Hello {{name}}!");
var result = template.Render(new { Name = "World" }); // => "Hello World!"
语言非常通用,易于阅读和使用,类似于liquid 模板:
var template = Template.Parse(@"
<ul id='products'>
{{ for product in products }}
<li>
<h2>{{ product.name }}</h2>
Price: {{ product.price }}
{{ product.description | string.truncate 15 }}
</li>
{{ end }}
</ul>
");
var result = template.Render(new { Products = this.ProductList });
注意
默认情况下, .NET对象的属性和方法会自动以小写和
_
命名,这意味着像MyMethodIsNice
这样的属性将被公开为my_method_is_nice
.这是默认约定,最初是为了匹配liquid
模板的行为。
如果要改变此行为,则需要使用MemberRenamer
委托
特性
- 非常高效,快速 解析器和轻量级的运行时. 对CPU和垃圾收集器友好. 查看 benchmarks获取更多细节.
- 由Lexer / Parser提供一个完整的抽象语法树,fast, versatile and robust(快速,通用且强大), 比基于regex的解析器更高效
- 错误报告:能提供精确的源代码位置 ,包括(path, column and line)
- 将AST写入脚本文本的形式, 使用
Template.ToText
, 可以操作内存中的脚本并将其重新保存到磁盘, 对于 roundtrip(往返)的脚本更新方案是有用的
- 兼容
liquid
模板 可使用Template.ParseLiquid
方法- 虽然
liquid
语言不如scriban
强大, 但该模式从liquid
则更容易地迁移至scriban
- 在 AST to text 模式下,将对模板
Template.ParseLiquid
进行解析,替换成Template.ToText
,即可将liquid
脚本 转换成scriban
脚本 - 由于 liquid 语言没有严格定义 并且它有着不同版本的liquid语法,在使用scriban的liquid模板时会有一些限制, 查看此文档了解详情 liquid support in scriban
- 虽然
- 可扩展的运行时 提供许多扩展点
- 支持
async
/await
的脚本支持 (e.gTemplate.RenderAsync
) - 精确控制空白文本输出
- 完整的语言特性 包括
if
/else
/for
/while
, expressions (x = 1 + 2
), conditions... etc. - 函数调用和管道 (
myvar | string.capitalize
) - Complex objects (复杂对象) (javascript/json like objects
x = {mymember: 1}
) and arrays (e.gx = [1,2,3,4]
) - 通常由
wrap
语句使用可以将 a block of statements (语句块) 传递给函数, - 一些内置函数:
- Multi-line statements(多行语句) 不必在每行都使用
{{...}}
- Safe parser and safe runtime, 使您可以控制公开哪些对象和功能
Syntax Coloring(语法着色)
您可以安装 Scriban Extension for Visual Studio Code 获取 scriban 脚本 (without HTML) 和 scriban html文件的语法颜色提示
文档
- 有关语言语法的说明,请参阅语言文档。
- 内置函数见文档内置函数列表。
- 有关编译和运行模板的.NET运行时API的说明,请参阅运行时文档。
- 有关支持liquid模板的更多详细信息,请参阅[Liquid support]文档。
- 请参阅我的博客文章"实现.NET的文本模板引擎",了解一些幕后细节。
二进制包
Scriban提供一个可获取的 NuGet 包:
兼容以下 .NET framework 版本:
- .NET Framework 3.5
- .NET Framework 4.0
- .NET Framework 4.5+ (supports asynchronous code and timeouts for regular expressions)
- .NET Standard1.1+ (some features are not available)
- .NET Standard1.3+ (which means .NET Core, Xamarin, UWP, Unity etc.)
还有提供签名的NuGet包 Scriban.Signed
Benchmarks(基准测试)
Scriban 速度极快! 更多细节, 你可以查看此文档 benchmarks(基准测试) 文档.
License
该软件是在BSD-Clause 2 license协议下发布的
相关项目
- dotliquid: Liquid模板语言的.NET端口。
- Fluid .NET liquid 模板引擎
- Nustache: .NET 无逻辑模板(Logic-less templates for .NET)
- Handlebars.Net: .NET port of handlebars.js
在线示例
- (https://scribanonline.azurewebsites.net/): ASP.NET Core Sample.
Credits
Adapted logo Puzzle
by Andrew Doane from the Noun Project
作者
Alexandre Mutel aka xoofx.
【翻译】Scriban README 文本模板语言和.NET引擎的更多相关文章
- 使用DOT语言和Graphviz绘图(翻译)
Casa Taloyum About Me Blog Archives 使用DOT语言和Graphviz绘图(翻译) Date Wed 26 November 2014 Tags graphviz / ...
- C语言和C++篇
C语言和C++篇 基本上所有主流的编程语言都有String的标准库,因为字符串操作是我们每个程序员几乎每天都要遇到的.想想我们至今的代码,到底生成和使用了多少String!标题上所罗列的语言,可以看成 ...
- 从C,C++,JAVA和C#看String库的发展(一)----C语言和C++篇
转自: http://www.cnblogs.com/wenjiang/p/3266305.html 基本上所有主流的编程语言都有String的标准库,因为字符串操作是我们每个程序员几乎每天都要遇到的 ...
- CHENGDU1-Python编程语言和PEP8规范
CHENGDU1-Python编程语言和PEP8规范 PEP8规范6条? 答:PEP8规范说白了就是一种规范,可以遵守,也可以不遵守,遵守PEP8可以让代码的可读性更高. 代码编排:---缩进,4个空 ...
- 聊聊C语言和ABAP
这个公众号之前的文章,分享的都是Jerry和SAP成都研究院的同事在工作中学到的一些知识和感受.而今天这篇文章,写作的由来是因为最近我又参与了SAP成都数字创新空间应聘者的面试,和一些朋友聊了一些关于 ...
- 关于C#中文本模板(.tt)的简单应用
这两天做项目突遇 .tt文件,之前没有接触过,so查询学习做笔记,帮助记忆和后来者. 在项目添加中点击选择文本模板 下面贴出代码,做了简单的注释 <#@ template debug=" ...
- T4 文本模板编写准则
如果要在 Visual Studio 中生成程序代码或其他应用程序资源,遵守以下一般准则可能非常有帮助. 它们并不是一成不变的规则. 设计时 T4 模板准则 设计时 T4 模板是在设计时在 Visua ...
- 使用 T4 文本模板生成设计时代码
使用设计时 T4 文本模板,您可以在 Visual Studio 项目中生成程序代码和其他文件. 通常,您编写一些模板,以便它们根据来自模型的数据来改变所生成的代码. 模型是包含有关应用程序要求的 ...
- C语言和C++中动态申请内存
在C语言和C++的动态内存的使用方法是不同的,在C语言中要使用动态内存要包含一个头文件即 #include<malloc.h> 或者是#include<stdlib.h> ...
随机推荐
- tomcat中AJP协议和HTTP协议的区别
tomcat的server.xml中的AJP和HTTP连接器区别 HTTP协议:连接器监听8080端口,负责建立HTTP连接.在通过浏览器访问Tomcat服务器的Web应用时,使用的就是这个连接器. ...
- 尚学堂 215 在java中执行JavaScript代码
package com.bjsxt.test; import java.io.FileReader; import java.net.URL; import java.util.List; impor ...
- jni不通过线程c回调java的函数 --总结
1.JNIEnv类型是一个指向全部JNI方法的指针.该指针只在创建它的线程有效,不能跨线程传递 2.JavaVM是虚拟机在JNI中的表示,一个JVM中只有一个JavaVM对象,这个对象是线程共享的. ...
- Python函数参数详解
Python函数参数详解 形参与实参 什么是形参 在定义函数阶段定义的参数称之为形式参数,简称形参,相当于变量名. 什么是实参 在调用函数阶段传入的值称为实际参数,简称实参.相当于"变量值& ...
- 原生PHP连接MySQL数据库
<?php //1.连接数据库 // mysqli_connect('主机名','用户名','密码'); $link = @mysqli_connect('localhost','usernam ...
- java-递归(文件查找)
import java.io.File; /** * @Author: heq * @Date: 2020/6/23 20:51 */ public class Test { public stati ...
- 暑假集训Day2 互不侵犯(状压dp)
这又是个状压dp (大型自闭现场) 题目大意: 在N*N的棋盘里面放K个国王,使他们互不攻击,共有多少种摆放方案.国王能攻击到它上下左右,以及左上左下右上右下八个方向上附近的各一个格子,共8个格子. ...
- 入门大数据---Hive分区表和分桶表
一.分区表 1.1 概念 Hive 中的表对应为 HDFS 上的指定目录,在查询数据时候,默认会对全表进行扫描,这样时间和性能的消耗都非常大. 分区为 HDFS 上表目录的子目录,数据按照分区存储在子 ...
- 搭建hadoop伪集群
基础设置:jdk.ssh. 1.操作系统.环境.网络.必须软件 2.关闭防火墙 3.设置hosts映射 4.时间同步 5.安装jdk 6.设置ssh免秘钥部署配置:初始化运行:命令行使用:
- React-Native WebView使用本地js,css渲染html
前言 最近在使用React-Native开发一个App,遇见一个问题,Webview组件根据url来加载页面,但是这样导致的一个问题页面加载的时间有点长,我想优化一下,因为页面只要是一些内容展示,我想 ...