简介
metalsmith-all-the-things 是一个为 metalsmith 提供插件依赖管理的 npm 包。通过 metalsmith-all-the-things,您可以轻松管理 metalsmith 插件,将插件配置在一个地方,并统一进行加载和运行。
安装
通过 npm 安装 metalsmith-all-the-things 。
npm install metalsmith-all-the-things --save-dev
使用
基本用法
在 metalsmith 配置文件中引入并使用 metalsmith-all-the-things 。
-- -------------------- ---- ------- ----- ---------- - --------------------- ----- ------------ - ------------------------------------ --------------------- -------------------- ------------ -- - -- ----- ----- --- ------------------ ----------- --
这样,metalsmith-all-the-things 将自动查找项目中所有的 metalsmith 插件,并将其应用于 metalsmith 的构建流程中。
高级用法
metalsmith-all-the-things 还支持多种高级用法,让您可以更加灵活地管理插件依赖。
使用与排除插件
如果您只需要使用项目中的部分插件,可以使用 only
选项来指定插件列表。
Metalsmith(__dirname) .use(allTheThings({ only: ['metalsmith-foo', 'metalsmith-bar'] })) .build((err) => { if (err) throw err console.log('Build complete!') })
类似地,如果您需要排除项目中某些插件,可以使用 except
选项来指定插件列表。
Metalsmith(__dirname) .use(allTheThings({ except: ['metalsmith-foo', 'metalsmith-bar'] })) .build((err) => { if (err) throw err console.log('Build complete!') })
指定插件配置
metalsmith-all-the-things 支持为每个插件指定配置参数。您可以将配置参数指定为对象或函数,并将其传递给 metalsmith-all-the-things 。
-- -------------------- ---- ------- --------------------- ------------------- ------- - ----------------- - ---- ----- -- ----------------- ------- ----------- ----- -- - -- -- ---- ------------- ---- ------ - - --- ------------ -- - -- ----- ----- --- ------------------ ----------- --
指定插件顺序
metalsmith-all-the-things 还支持为插件指定运行顺序。您可以通过在插件名称前添加 @ position
来指定插件的运行顺序。位置数值越小,插件越先执行。如果两个插件位置相同,则按照字母顺序排列。
-- -------------------- ---- ------- --------------------- ------------------- ------- - ------------------- - ---- ------- -- ------------------- - ------ ------- - - --- ------------ -- - -- ----- ----- --- ------------------ ----------- --
示例代码
下面的示例展示了 metalsmith-all-the-things 如何管理 metalsmith 插件。
-- -------------------- ---- ------- ----- ---------- - --------------------- ----- ------------ - ------------------------------------ ----- -------- - ------------------------------ ----- ------- - ----------------------------- --------------------- ------------------- ----- ----------------------- ---------------------- ------- - ---------------------- - ---- ----- ------- ---- -- --------------------- - ------- ------------ - - --- ------------ -- - -- ----- ----- --- ------------------ ----------- --
这个示例中,只有 metalsmith-markdown
和 metalsmith-layouts
插件被加载。metalsmith-markdown
插件被配置为启用 GFM 和表格,而 metalsmith-layouts
插件使用 Handlebars 作为模板引擎。
总结
使用 metalsmith-all-the-things,可以方便地管理 metalsmith 插件,避免手动管理插件依赖带来的麻烦。通过详细的学习与实践,你可以轻松使用 metalsmith-all-the-things,提升自己的前端开发水平。
来源:JavaScript中文网 ,转载请注明来源 https://www.javascriptcn.com/post/60055ea981e8991b448dc136