praxisnetau/silverstripe-webpack2-starter

适用于SilverStripe 4、Webpack 2和Bootstrap 4的启动套件。

dev-master 2017-03-08 00:11 UTC

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 4Webpack 2Bootstrap 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-loadermodernizr-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

归属