Metalsmith-pagination 是一款基于 Metalsmith 的分页插件，可用于生成简单的静态博客网站或类似文章分页的应用程序。在本文中，我们将详细讲解如何使用 metalsmith-pagination。
安装
首先，你需要已安装 Node.js 和 Metalsmith。如果你还没有安装过它们，建议先安装。
安装 metalsmith-pagination:
npm install --save metalsmith-pagination
配置
在使用 metalsmith-pagination 之前，需要在 Metalsmith 配置文件中进行相关配置。一个最小的配置如下：
-- -------------------- ---- -------
----- ---------- - ----------------------
----- ---------- - ---------------------------------
---------------------
-----------------
-------------------- -
-------- --
------- ------------
------ -------------
----- ----------------------
-
---
------------ -- -
-- ----- ----- ----
---上面的代码配置了一个 collections.posts 的集合，每页显示 5 篇文章，并将文章页面的模板设置为 post.html。第一页的访问地址为 /index.html，其他页的格式为 /page/:num/index.html。
使用
在 Metalsmith 的处理流程中，有一个 collections() 方法，用于将一组文件与指定的集合相关联。例如，在 metalsmith-markdown 中将 Markdown 文件转换为 HTML 文件时，我们可以将其与 collections() 相结合，将 HTML 文件添加到指定的集合中。
在示例中，我们将所有 Markdown 文件作为一个集合（collection.posts），并将其分页展示。
如果需要在页面中显示分页导航，只需在页面中添加一些简单的代码即可：
-- -------------------- ---- -------
------------- -------------------
----- ---------------
-- ---------------- ----------------------------------
--------
---------------------
-------
------- ------------
----- --------------
-------------------------
--------
-- ---------------- -----------------------------
-------
---------
----- -----------
-- ---------------- --------------------------
--------
-----------------
-------
---------------上面的代码使用了 Handlebars 模板语言，并通过 metalsmith-templates 插件渲染为 HTML。
结语
metalsmith-pagination 可以说是一个轻巧、易于使用的插件，但也有一些局限性。例如，它只支持基于文件的分页，无法支持基于时间或标签的分页。尽管如此，metalsmith-pagination 仍然是处理扁平静态网站的一个不错的选择。
来源：JavaScript中文网 ，转载请注明来源 https://www.javascriptcn.com/post/5eedb60db5cbfe1ea06114cc