YAML 默认

添加对 YAML 的支持,用于存储数据和创建页面。

配置参数

extensions string[]

The list of extensions this plugin applies to

Default:
[ ".yaml", ".yml" ]
pageSubExtension string

Optional sub-extension for page files

描述

YAML 是一种用于保存序列化数据的文件格式。 它也适用于包含多段文本的页面,例如着陆页、指南、目录等。

安装

此插件默认安装。 🎉

配置

如果您想更改默认配置,请使用 lume() 函数的第二个参数,在您的 _config.ts 文件中进行配置。

import lume from "lume/mod.ts";

// YAML 插件配置
const yaml = {/* 在这里配置您的选项 */};

const site = lume({}, { yaml });

export default site;

创建 _data 文件

此格式适用于共享数据,因此您可以创建 _data.yml_data/*.yml 文件来保存通用变量。

使用 YAML 创建页面

此格式也可用于创建页面;只需在您的站点中添加一个扩展名为 .yml.yaml 的文件即可。 例如:

title: 欢迎来到我的页面
layout: layouts/main.vto
intro: |
  这是我使用 lume 的第一篇文章
  希望你喜欢!

sections:
  - title: 设计
    image: img/section1.jpg
    text: 我设计美观且易于访问的网站

  - title: 开发
    image: img/section2.jpg
    text: 并且可以编写 HTML  CSS 代码!

您将需要一个布局来渲染此页面并生成 HTML:

<html>
  <head>
    <title>{{ title }}</title>
  </head>
  <body>
    <header>
      <h1>{{ title }}</h1>
      <p>{{ intro }}</p>
    </header>

    {{ for section of sections }}
    <section>
      <h2>{{ section.title }}</h2>
      <img src="{{ section.image }}">
      <p>{{ section.text }}</p>
    </section>
    {{ /for }}
  </body>
</html>