npm 是 Node.js 的包管理器，我们可以在其中搜索并下载别人已经封装好的包来帮助我们更快捷地开发项目。metalsmith-assets 是一个 Node.js 模块，它可以帮助我们更方便地管理静态资源，如图片、CSS、JavaScript 等。
本篇文章介绍了如何使用 metalsmith-assets 这个 npm 包，并提供了详细的学习和指导意义，包括配置、代码示例和使用技巧。
安装
首先，需要在终端中执行以下命令，安装 metalsmith 和 metalsmith-assets 这两个 npm 包：
npm install --save metalsmith metalsmith-assets
配置
当我们启动 metalsmith 时，需要在配置对象中添加一个名为 'metalsmith-assets' 的属性，以便让 metalsmith-assets 能够识别资源文件所在的文件夹的位置以及输出文件的位置。
以下是一个基本的配置示例：
-- -------------------- ---- -------
----- ---------- - ----------------------
----- ------ - -----------------------------
---------------------
----------------
----------------------
-----
--------
------- -----------
------------ ----------
--
-
---------- -- -
-- ----- -
----- ----
-
----------------------- ----- ------------
---在这个例子中，我们设置生成文件的源文件夹为 './src'，生成文件的目标文件夹为 './dest'。我们给 metalsmith-assets 配置了两个参数：source 和 destination，它们表示要复制资源的源目录和目标目录。
通过上面的配置，metalsmith-assets 会自动在第一个参数 source 指定的路径下寻找静态资源，然后拷贝到第二个参数 destination 指定的路径下。这样，当我们生成静态资源时，metalsmith-assets 会自动将静态资源输出到 'dest/assets' 文件夹。
代码示例
假设我们在 'src' 文件夹中有一个 'index.html' 文件，它需要引入一张名为 'img.png' 的图片，同时我们还需要为网站添加一个名为 'style.css' 的样式文件和一个名为 'script.js' 的脚本文件。
在以上配置的前提下，我们可以这样引用静态资源：
-- -------------------- ---- -------
--------- -----
----- ----------
------
----- --------------- --
------------------------ ---------------
----- ---------------- --------------------------- --
-------
------
-------- -- - ---- ---------
---- ------------------------ ------- ------- ------ --
------- -----------------------------------
-------
-------这里我们分别使用了相对路径的引用方式进行引用，并标识了静态资源所在的目录位置（assets）。
实用技巧
下面提供一些实用的技巧，可以帮助更好的使用 metalsmith-assets。
在部署时压缩静态资源
一般来说，Web 应用程序中的静态资源都是可以压缩的。metalsmith-assets 也因此可以通过使用另一个名为 'metalsmith-uglify' 的 npm 包来压缩静态资源文件。
下面是一个配置示例：
-- -------------------- ---- -------
----- ------ - -----------------------------
---------------------
----------------
----------------------
-----
--------
------- -----------
------------ ----------
--
-
-----
--------
--------------- -----
-------- ------
------- --------------
--
-
---------- -- -
-- ----- -
----- ----
-
----------------------- ----- ------------
---在这个配置中，我们增加了一个新的版本：在 gulp 链的结尾，我们添加了一个 metalsmith-uglify 插件来压缩 JavaScript 文件。此插件会将未压缩的文件替换为相应的压缩版，并将原始文件删除掉，以减小生成（deploy）环境中静态资源文件的大小。
使用 metalsmith-assets 预处理源文件
metalsmith-assets 还可用于预处理我们的源文件。通过 metalsmith-assets，我们可以实现不同的处理过程，使代码更加干净，轻量且易于修改。
例如，在以下示例代码中，我们没有将 CSS 和 JavaScript 引入 index.html，反而在'./assets/js/main.js' 中合并和 Uglify 它们，并输出到 "./assets/js/main.min.js" 中，然后从 index.html 中引用这个文件。
-- -------------------- ---- -------
--------- -----
----- ----------
------
----- --------------- --
------------------------ ------- - -------------- -------------
-------
------
-------- -- - ---- ---------
---- ------------------------ ------- ------- ------ --
------- -------------------------------------
-------
-------下面是插件的配置：
-- -------------------- ---- -------
----- -- - --------------
----- ---- - ----------------
----- ------ - ---------------------
---------------------
----------------
----------------------
-----
--------
------- -----------
------------ ----------
--
-
------------ ----------- ----- -- -
-- -- ----------
----- ------- - ---------------------------------- --
--------------------------
--
-- -------
----- ------ - -----------
----- ------ - ----------------------------------
----- ------------- - --------------------- -
--------- ----
--------
----- ------- - ---------------------
----- ----------- - ------------------
--------
------ - -------
----
------------------ - -
--------- -------------------------- -------
--
-- -- ---
----- -------- - ---------------------------------- --
---------------------------
--
----- ------- - --------
------------ -- -----------------------------------
------------
----- ----------- -
--------------- - ---------------------------------------- ----------
------------------ - -
--------- -------------------- -------
--
------------------------- --------- -- -------- - ----- -----------------
------ --------------
-------
--
---------- -- -
-- ----- -
----- ----
-
----------------------- ----- ------------
---在这个示例中，我们新增了一个链任务对象，这个链任务对象用到了两个方法: path.extname(url) 获取文件扩展名。还有 uglify-js 的 minify 方法把压缩版代码生成给压缩版的目标文件，verbose 选项用于打印更多日志信息。
总结
本文深入介绍了 Node.js 模块 metalsmith-assets 的使用。我们提供了详细的学习和指导意义，包括配置、代码示例和使用技巧，它们应该对你管理静态资源，提高项目开发速度以及代码重用都有所帮助。希望这篇文章能为你带来价值！
来源：JavaScript中文网 ，转载请注明来源 https://www.javascriptcn.com/post/60066f431d8e776d08040e40