cloudstek/grav-plugin-webpack-manifest

Grav 插件,用于从 webpack manifest 文件中获取资源。

v1.0.1 2020-04-27 11:24 UTC

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()