npm 包 metalsmith-hierarchy 使用教程

阅读时长 4 分钟读完

简介

metalsmith-hierarchy 是一个基于 metalsmith 构建的 npm 包,它提供了一种建立网页目录结构的方法。它在打包时通过文件名前缀的方式,将文件组织成层级结构。

安装

在安装 metalsmith-hierarchy 之前,需要先安装 metalsmith。

然后,安装 metalsmith-hierarchy。

使用方法

配置

在构建你的 metalsmith 静态站点时,你需要在 metalsmith 的 build.js 文件中添加配置。这个配置文件需要引入 metalsmith 和 metalsmith-hierarchy 两个包,并且需要通过 use() 方法将 metalsmith-hierarchy 加入 middleware 链。

-- -------------------- ---- -------
----- ---------- - ----------------------
----- --------- - --------------------------------

---------------------
  ----------------
  -----------------------
  ----------------
    --------------- ----- -- ------ ---------- ------
    -------------- ------------- -- -------
    ----------- ----- ------- -- ------
    --------- ---------- -- ------------------------- -- ------
  ---
  ------------ -- -
    -- ----- ----- ----
    ------------------ ------------
  ---

配置项

  • directoryIndex:是否默认使用 index.html 作为目录索引,类型为布尔值,缺省值为 true。
  • indexTemplate:目录索引模板名,类型为字符串,缺省值为 index.html。
  • indexTitle:目录索引标题,类型为字符串,缺省值为 Site Index。
  • getLabel:获取标签函数,可以自定义标签名的生成规则,类型为函数。默认情况下,标签名为文件路径的最后一部分。

示例

假如你的文件夹结构如下:

-- -------------------- ---- -------
----
--- ----------
--- ------------
--- ---------
-   --- ----------
-   --- ----------
--- ---------
    --- ------------
    --- ----------------
    --- ------------------------

通过使用 metalsmith-hierarchy,可以将它转换为层级结构:

-- -------------------- ---- -------
--- ----------
--- ------------
--- ---------
-   --- ------------
-   --- ----------------
-   --- ------------------------
--- ---------
-   --- ----------
-   --- ----------
--- ----------

在转换后的目录结构中,index.html 文件是目录索引文件,对应的是源文件夹中的 products/ 和 services/ 文件夹。在这个示例中,我们以默认配置进行了转换,导致 index 文件被插入到了目录结构中。

总结

metalsmith-hierarchy 提供了一种方便易用的方式来建立网页目录结构,使得网站的文件结构更加清晰易懂。它为前端开发者提供了一种新的选择,特别适用于需要大量管理模板文件的应用程序。

来源:JavaScript中文网 ,转载请注明来源 https://www.javascriptcn.com/post/60066f3f1d8e776d08040bd6

纠错
反馈