介绍
Metalsmith 是一个简单且灵活的静态站点生成器，在前端开发中应用广泛。Metalsmith 使用了许多插件（即 npm 包），可以通过组合使用这些插件来实现各种各样的功能。其中一个非常实用的插件就是 metalsmith-collections-limit。
metalsmith-collections-limit 插件的作用是对 metalsmith-collections 插件所生成的 collections 数据进行限制。通过使用此插件，可以很方便地对站点内容进行筛选和限制，使站点的呈现更加灵活和易于管理。
安装和配置
在使用 metalsmith-collections-limit 之前，需要确保当前项目已经安装了 metalsmith 和 metalsmith-collections。
通过以下命令安装插件：
npm install metalsmith-collections-limit --save-dev
在 metalsmith 的配置文件中引入插件：
-- -------------------- ---- ------- ----- ----------- - ---------------------------------- ----- ---------------- - ---------------------------------------- ---------------------------- -- -- ---------------------- -- ---- --------------------------------- -- -- ---------------------------- -- ----
使用说明
请注意，metalsmith-collections-limit 插件只能用于限制 metalsmith-collections 所生成的 collections 数据，不能单独使用。
在配置 metalsmith-collections-limit 插件时，需要通过传递一个配置对象来对其进行配置。这个配置对象可以包含以下内容：
key: 必选项，指定要限制的 collection 的名称。limit: 必选项，指定要限制的 collection 的长度。可以为数字，也可以为一个带有数字属性的对象。reverse: 可选项，默认为 false，如果设置为 true，则将限制应用于 collection 的末尾而不是开头。sortBy: 可选项，指定一个要用来排序的属性名称。
以 sort 为例，下面是一个简单的示例配置：
metalsmith.use(collectionsLimit({
key: "posts",
limit: 3,
sortBy: "date"
}));在这个示例中，posts 是要限制的 collection 的名称，limit 是要限制的长度，sortBy 是要用来排序的属性名称。
示例代码
下面是一个完整的示例，展示了如何使用 metalsmith-collections 和 metalsmith-collections-limit 生成一个包含文章和标签的博客：
-- -------------------- ---- -------
----- ---------- - ----------------------
----- -------- - -------------------------------
----- ----------- - ----------------------------------
----- ---------------- - ----------------------------------------
---------------------
----------------
------------------------
----------------
------------------
------ -
-------- -------------
------- -------
-------- ----
--
----- -
-------- -------------
------- -------
-
---
-----------------------
---- --------
------ -
------ --
------- ------
-
---
--------------- ----- -
-- ----- -
----- ----
-
---在这个示例中，我们首先使用 metalsmith-markdown 将 markdown 文件转换为 HTML，然后使用 metalsmith-collections 将文章和标签分组。最后，我们使用 metalsmith-collections-limit 限制文章数量，只呈现日期最近的前五篇文章。
总之，通过 metalsmith-collections-limit 插件，可以实现对站点内容的灵活控制和 "只呈现最好的"。任何使用 Metalsmith 的前端开发人员都应该了解并使用这个实用的工具。
来源：JavaScript中文网 ，转载请注明来源 https://www.javascriptcn.com/post/600557ae81e8991b448d4b52