praxisnetau / silverstripe-webpack2-starter
适用于SilverStripe 4、Webpack 2和Bootstrap 4的启动套件。
Requires
- php: >=5.5.0
- gdmedia/ss-auto-git-ignore: ~1.0
- silverstripe/asset-admin: 1.0.x-dev
- silverstripe/cms: 4.0.x-dev
- silverstripe/framework: 4.0.x-dev
- silverstripe/graphql: 0.2.x-dev
- silverstripe/reports: 4.0.x-dev
- silverstripe/siteconfig: 4.0.x-dev
Requires (Dev)
- phpunit/phpunit: ~4.8
This package is not auto-updated.
Last update: 2024-09-14 19:58:51 UTC
README
SilverStripe 4 + Webpack 2 + Bootstrap 4 = 精彩!😎
此启动套件基于silverstripe-webpack-starter,并已修订以支持SilverStripe 4、Webpack 2和Bootstrap 4。还包括Modernizr,以便轻松检测浏览器功能。
安装
通过Composer进行安装。
通过运行以下命令创建基于此存储库的新项目:
$ composer create-project praxisnetau/silverstripe-webpack2-starter /path/to/project dev-master
或者,克隆存储库,然后运行
$ composer install
Composer下载完包后,您需要创建一个位于项目根目录或父目录的.env
文件。存储库中包含一个示例文件.env.example
,以帮助您开始。该.env
文件配置了SilverStripe 4的环境和数据库设置。请确保不要将包含敏感信息(如密码)的任何.env
文件提交到版本控制中!
您还需要在themes/app
文件夹中安装前端依赖项。您可以使用Yarn或NPM进行安装
Yarn
$ cd themes/app
$ yarn install
NPM
$ cd themes/app
$ npm install
开发
将前端依赖项安装到node_modules
后,您需要启动Webpack开发服务器
Yarn
$ yarn run start
NPM
$ npm run start
如果一切顺利,Webpack开发服务器应该会在http://localhost:8080
上运行,并且Webpack将编译主题源文件。
现在您可以通过浏览器访问您的应用程序主机。SilverStripe将构建其数据库,Webpack将热加载CSS更改。
配置
主题使用bootstrap-loader
和modernizr-loader
,通过配置文件轻松自定义主题
themes/app/.bootstraprc
- Bootstrap的YAML配置themes/app/.modernizrrc
- Modernizr的YAML配置
使用这些文件,您可以针对自定义应用程序构建选择性地启用或禁用Bootstrap和Modernizr的功能。
生产
要准备用于生产服务器分发的文件,您可以通过使用以下命令以生产模式运行Webpack:
Yarn
$ yarn run build
NPM
$ npm run build
Webpack将清除您的themes/app/production
文件夹,并输出优化和压缩的CSS和JavaScript。
部署
在将项目部署到实时服务器时,您不需要部署themes/app/source
文件夹。只需部署themes/app/production
。
归属
- 感谢Aaron Carlino和Stevie Mayhew为此存储库的建设奠定了基础。