README

Sass Starterkit

以下是如何使用 Sass 预处理器创建 Bootstrap 子主题的说明。

• 先决条件
• 额外设置
• 覆盖

先决条件

• 阅读@link getting_started 开始使用 @endlink 和 @link sub_theming 子主题化 @endlink 文档主题。
• 你必须理解使用 Sass CSS 预处理器的基本概念。
• 你必须使用一个 本地 Sass 编译器。
• 你必须使用以 .scss 扩展名结尾的 Bootstrap 框架源文件，而不是以 .css 结尾的文件。

额外设置 {#setup}

下载并解压 最新 的 3.x.x 版本的 Bootstrap 框架源文件 到新子主题的根目录中。解压后，如果需要，应该重命名目录，使其读取 ./THEMENAME/bootstrap。

如果你出于某种原因有一个额外的 bootstrap 目录包裹第一个 bootstrap 目录（例如 ./THEMENAME/bootstrap/bootstrap），请删除包裹的 bootstrap 目录。你只有在升级 Bootstrap 框架 时才需要修改这些文件。

{.alert.alert-warning} 警告：不要直接修改 ./THEMENAME/bootstrap 内的文件。这样做可能会在未来升级 Bootstrap 框架 时导致问题。

覆盖 {#overrides}

./THEMENAME/scss/_default-variables.scss 文件通常是你会花费大部分时间提供任何应该由 Bootstrap 框架 而不是它自己的默认变量。

./THEMENAME/scss/overrides.scss 文件包含各种 Drupal 覆盖，以便正确集成到 Bootstrap 框架。它可能包含一些增强功能，您可以随意编辑此文件。

./THEMENAME/scss/style.scss 文件是将 _default-variables.scss、Bootstrap 框架源文件 和 overrides.scss 文件结合在一起的胶水。通常，除非您需要添加或删除要导入的文件，否则您通常不需要修改此文件。这是您应该编译为 ./THEMENAME/css/style.css（注意文件名相同，当然使用不同的扩展名）的文件。

另请参阅

• @link theme_settings 主题设置 @endlink
• @link templates 模板 @endlink
• @link plugins 插件系统 @endlink