README

水平 SilverStripe 配方

基于 SilverStripe 网站安装的基本网站，包含我们常用到的所有模块。

创建新项目

可以将配方引入任何现有项目（即使不是在 SilverStripe 基础项目上创建的）

$ composer init
$ composer require i-lateral/ss4-recipe

或者，您可以根据现有配方创建新项目

$ composer create-project i-lateral/ss4-recipe ./myssproject ^1.0@dev

内联配方

您可以将先前安装的配方或需要将依赖项包含在主项目中的新配方“内联”。通过内联配方，您将其需求以及项目文件提升到主项目，并从依赖项中删除配方本身。

这可以通过 update-recipe 完成，它将更新配方，或者通过 require-recipe 安装新配方。

请注意，如果您想运行此命令，您必须首先通过常规 composer 命令安装配方或安装配方插件

$ composer init
$ composer require i-lateral/ss4-recipe ^0.1
$ composer require-recipe i-lateral/ss4-recipe ^1.0@dev

或

$ composer init
$ composer require i-lateral/ss4-recipe ^1.0@dev
$ composer update-recipe i-lateral/ss4-recipe

更多文档

更全面的文档可以在 recipe 插件 GitHub 页面 找到

主题

此配方安装了多个可能的基主题，但也构建了一个“自定义”主题，可以用来自定义默认选定的主题。

如果您想将默认基主题切换到替代方案，建议您将 bootstrap 在 theme.yml 中更改为您的替代方案，例如

SilverStripe\View\SSViewer:
  themes:
    - 'custom'
    - 'deferedimages'
    - 'bootstrap' # Change this to your base theme
    - '$default'

Webpack

自定义主题（及其父主题）旨在使用 webpack 帮助打包和管理 CSS 和 JS 需求。

或者，您也可以使用默认的 SilverStripe 方法（将您的文件添加到 dist/css 或 dist/js），但您将必须自行管理合并和压缩。

这可以通过 webpack 自动处理。

入门

要开始使用 webpack 管理您的 JS 和 CSS 需求，首先您必须安装 yarn

安装 yarn 后，导航到您的主题目录

# cd /path/to/my/project/themes/custom

现在安装节点模块（可能需要一些时间）

# yarn install

添加自定义 CSS/JS

接下来，将您的自定义 JS 或 CSS（SASS）添加到相应的文件夹（themes/custom/src/javascript 或 themes/custom/src/scss 分别），如果您添加了任何新文件，您需要在以下位置导入它们

• SCSS 文件添加到 themes/custom/src/scss/bundle.scss
• JS 文件需要在 themes/custom/webpack.common.js 中直接映射

最后，运行以下命令之一来转换/压缩您的文件

• yarn dev：转换所有文件以进行开发目的（不压缩）
• yarn build：转换并压缩以进行生产

代码检查

包含一些代码检查功能，以帮助保持代码整洁。如果您想检查/整理 CSS/JS，可以运行以下命令

• yarn lint:styles 或 yarn lint:styles:fix 检查或尝试修复 SCSS 问题
• yarn lint:scripts 或 yarn lint:scripts:fix 检查或尝试修复 JS 问题