Jekyll项目中的Liquid模板语言详解

郑眉允Well-Born

于 2025-05-30 09:07:11 发布

阅读量221

点赞数 4

本文链接：https://blog.csdn.net/gitblog_01174/article/details/148324839

版权

Jekyll项目中的Liquid模板语言详解

jekyll 项目地址: https://gitcode.com/gh_mirrors/jek/jekyll

什么是Liquid模板语言

Liquid是Jekyll静态网站生成器中的核心模板语言，它为静态网站注入了动态处理能力。作为一种安全、灵活的模板语言，Liquid允许开发者在静态文件中嵌入逻辑处理和内容动态展示功能，而无需担心安全问题。

Liquid的三大核心组件

1. 对象(Objects)

对象是Liquid中最基础的组成部分，用于输出预定义的变量内容。在模板中使用双大括号{{ }}包裹变量名即可输出该变量的值。

技术要点：

语法格式：{{ variable_name }}
示例：{{ page.title }}会输出当前页面的标题
对象可以访问Jekyll提供的各种全局变量和页面特定变量

实际应用场景： 当需要展示文章标题、作者信息或发布日期等内容时，使用对象是最直接的方式。

2. 标签(Tags)

标签为模板提供了逻辑控制和流程处理能力。使用{% %}语法可以插入各种控制语句。

技术要点：

语法格式：{% tag_name %}...{% endtag_name %}
支持条件判断、循环、包含等逻辑控制
示例代码：

{% if user.is_admin %}
  <div class="admin-panel">管理面板</div>
{% endif %}

常见标签类型：

条件判断：if/unless/else/elsif
循环迭代：for/break/continue
模板包含：include
变量赋值：assign/capture

3. 过滤器(Filters)

过滤器用于对对象输出的内容进行格式化处理，通过管道符|连接多个过滤器。

技术要点：

语法格式：{{ variable | filter1 | filter2 }}
支持链式调用多个过滤器
示例代码：

{{ "hello world" | capitalize | prepend: "Greeting: " }}

输出结果为："Greeting: Hello world"

常用内置过滤器：

字符串处理：capitalize, downcase, upcase, strip
数组处理：join, sort, first, last
日期格式化：date: "%Y-%m-%d"

实战示例：改造Hello World页面

让我们通过一个完整示例展示如何在Jekyll中使用Liquid：

首先创建一个基本的HTML文件
添加Front Matter使Jekyll处理Liquid
使用Liquid对象和过滤器修改内容

---
# 这个Front Matter告诉Jekyll处理此文件中的Liquid代码
---

<!DOCTYPE html>
<html>
  <head>
    <meta charset="utf-8">
    <title>{{ page.title | default: "默认标题" }}</title>
  </head>
  <body>
    <h1>{{ "Hello World!" | downcase }}</h1>
    <p>当前时间: {{ "now" | date: "%Y-%m-%d %H:%M" }}</p>
    
    {% assign colors = "red,green,blue" | split: "," %}
    <ul>
    {% for color in colors %}
      <li>{{ color | capitalize }}</li>
    {% endfor %}
    </ul>
  </body>
</html>

代码解析：