cloudstek / grav-plugin-webpack-manifest
Grav 插件,用于从 webpack manifest 文件中获取资源。
Requires
- php: >=7.1.3
This package is auto-updated.
Last update: 2024-08-27 20:27:26 UTC
README
Webpack Manifest 插件是 Grav CMS 的扩展。它允许您开发使用 Webpack(例如)等工具生成版本化资源(CSS/JS)的主题。
由于这些生成的文件每次生成时都有唯一的名称,因此您无法直接在模板中引用它们。Webpack 输出一个包含未版本化文件名和版本化文件名之间映射的 manifest 文件,该文件由该插件用于替换正确的文件。
安装
安装 Webpack Manifest 插件可以通过三种方式之一完成:GPM(Grav 包管理器)安装方法允许您通过简单的终端命令快速安装插件,手动方法允许您通过 zip 文件进行安装,而管理员方法允许您通过管理员插件进行安装。
GPM 安装(首选)
要使用 GPM 安装插件,请通过您的系统终端(也称为命令行),导航到 Grav 安装的根目录,然后输入
bin/gpm install webpack-manifest
这将安装 Webpack Manifest 插件到 Grav 的 /user/plugins 目录中。其文件位于 /your/site/grav/user/plugins/webpack-manifest 下。
手动安装
要手动安装插件,请下载此存储库的 zip 版本,并将其解压到 /your/site/grav/user/plugins 下。然后将文件夹重命名为 webpack-manifest。您可以在 GitHub 或通过 GetGrav.org 找到这些文件。
现在,您应该已经在以下位置拥有了所有插件文件:
/your/site/grav/user/plugins/webpack-manifest
注意:此插件是 Grav 的模块化组件,可能需要其他插件才能运行,请参阅其在 GitHub 上的 blueprints.yaml 文件。
管理员插件
如果您使用管理员插件,可以通过浏览 插件 菜单并点击 添加 按钮直接安装插件。
配置
在配置此插件之前,您应将 user/plugins/webpack-manifest/webpack-manifest.yaml 复制到 user/config/plugins/webpack-manifest.yaml,并仅编辑此副本。
以下是默认配置和可用选项的说明
# Enable/disable the plugin enabled: true # Path to manifest.json relative to your active theme # For webpack use manifest.json. For Laravel Mix use mix-manifest.json. filepath: manifest.json
注意,如果您使用管理员插件,则在管理员中保存配置后,将在 user/config/plugins/ 文件夹中保存一个名为 webpack-manifest.yaml 的配置文件。
用法
用法很简单,在大多数情况下,您可以直接将 {% do asset.css( ... 替换为 {% do manifest.css( ...,API 大多相同,并作为一些资源管理器功能包装,请参阅 https://learn.getgrav.org/16/themes/asset-manager。
支持: add(),addCss(),addJs()