castiron/webpackassets-plugin

October CMS中的Webpack哈希文件

安装次数: 4,805

依赖项: 0

建议者: 0

安全: 0

星标: 6

关注者: 11

分支: 1

开放问题: 1

类型:october-plugin

2.0.3 2023-04-18 23:45 UTC

README

此插件与OctoberCMS配合使用,与node包webpack-assets-manifesthttps://github.com/webdeveric/webpack-assets-manifest)协同工作,根据写入您的资产目录的JSON清单文件将CSS、JS和字体资产包含到您的网站中。这将允许您在构建文件中使用哈希文件名,让October轻松获取路径。

在非开发环境中(当APP_ENV环境变量不等于"dev"时),这些路径会被缓存,因此JSON文件不会在每次请求时读取。在部署过程中,通过运行php artisan cache:clear来清除此缓存。

安装

composer require castiron/webpackassets-plugin

快速开始

此插件提供了一个名为webpackAssets的组件。将组件包含到您的视图中,然后使用以下方法将js/css/fonts(仅限WOFF2)包含到您的模板中(例如在部分、布局等)

[webpackAssets]
==

<!-- include font <link rel="preload"> tags: -->
{{ webpackAssets.tag('unhashed_filename.woff2') | raw }}

<!-- include css <link> tags: -->
{{ webpackAssets.tag('unhashed_filename.css') | raw }}
[webpackAssets]
==

<!-- include js <script> tags: -->
{{ webpackAssets.tag('unhashed_filename.js') | raw }}
{{ webpackAssets.tag('webpack-dev-server.js') | raw }}

请注意,预加载过多的字体资产会影响性能,因此请仅对最高优先级的字体资产使用。同样,此插件将仅创建WOFF2字体格式的标签。(有关更多信息,请参阅“关键请求”“Web字体:预加载”。)

组件选项

publicFolder(默认:"www")

如果您正在使用OctoberCMS中的公开文件夹(您应该使用!),请在此处指定。例如:"www"或"public"

[webpackAssets]
publicFolder = public

assetsFolder(默认:"assets")

到webpack写入资产的文件夹的路径,相对于您的公开文件夹。这对应于webpack配置中的output.path

[webpackAssets]
assetsFolder = assets

manifestFilename(默认:"manifest.json",必须是相对于assetsFolder的)

[webpackAssets]
manifestFilename = files.json

变更日志

2.0.3

  • 与October 1.1兼容