Metalsmith：如何使用run（）？

Question

文档显示了方法run(files, fn)：

  

在files字典上运行所有中间件函数，并使用fn(err, files)回调，其中files是更改后的字典。

https://www.npmjs.com/package/metalsmith#runfiles-fn

如何/何时使用？我找不到更详细的信息或示例。

感谢任何提示：）