请注意:本文档非官方文件。内容基于我的个人经验及与他人(包括曾参与Fluid项目的人员)的交流整理而成。该文档既非权威指南,也未必获得Fluid项目官方认可。
Deane Barker
这是针对 Fluid 模板库 的示例和教程合集。
Fluid 是 Liquid 的 C# 实现,Liquid 最初由 Shopify 开发。目前存在多种不同编程语言的 Liquid 实现版本。
大多数 Liquid 语法在 Fluid 中同样适用。如果本指南未提及某些内容,但在其他 Liquid 文档中可以找到,那么这些内容在 Fluid 中大概率也能以相同方式工作。
我已尽量明确区分 “Liquid” 和 “Fluid” 的表述。若某特性标注为 “Liquid”,则意味着它可能在所有语言实现中都通用;而标注为 “Fluid” 的特性则专指本实现。
本指南默认读者不具备 Liquid 相关知识基础。在编写示例代码时,我假设不存在 Liquid 文档——即把 Fluid 当作一个原创的独立库——所有测试都基于 “纯净版” Fluid(当前版本为 2.2.6)。
无论原始 Liquid 文档如何描述,本指南内容就是 Fluid 的权威标准。所有代码示例均在 Fluid 环境中执行。
另请注意,本指南主要面向 C# 开发人员。如果您是模板层面的 Liquid 使用者,这里也有大量适用内容,但本指南会深入探讨实现层面的代码细节。
关于如何区分不同类型的开发者需求,请参阅 《引言:Fluid 开发的四个层级》。