castiron / webpackassets-plugin
October CMS中的Webpack哈希文件
Requires
- php: >=5.4
- october/rain: 1.*
This package is not auto-updated.
Last update: 2024-09-29 03:52:37 UTC
README
此插件与OctoberCMS配合使用,与node包webpack-assets-manifest
(https://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兼容