messageagency / ma_bootstrap
Bootstrap 子主题,中间层。特定站点主题应继承自该主题。
Requires
This package is auto-updated.
Last update: 2024-09-17 22:44:51 UTC
README
MA Bootstrap 是 Bootstrap 主题(https://www.drupal.org/project/bootstrap)的子主题。它旨在作为 Message Agency Drupal 8 网站的基座。此主题中的任何内容都应足够广泛,适用于多个网站;每个单独的网站应创建自己的子主题以覆盖特定内容。
推荐
- Bootstrap Layouts (https://www.drupal.org/project/bootstrap_layouts)
- 此模块需要一个消费布局的模块;我们推荐使用 Display Suite (https://www.drupal.org/project/ds)
Less Starterkit
以下是如何使用 Less 预处理器创建 Bootstrap 子主题的说明。
先决条件
- 阅读 @link getting_started 开始 @endlink 和 @link sub_theming 子主题 @endlink 文档主题。
- 您必须了解使用 Less CSS 预处理程序的基本概念。
- 您必须使用 本地 Less 编译器。
- 您必须使用以
.less
扩展名结尾的 Bootstrap 框架源文件,而不是以.css
扩展名结尾的文件。
额外设置 {#setup}
下载并解压缩 最新 的 3.x.x 版本的 Bootstrap 框架源文件 到您新子主题的根目录。解压缩后,如果需要,应将目录重命名为 ./THEMENAME/bootstrap
。
如果由于某种原因您有一个额外的 bootstrap
目录包裹第一个 bootstrap
目录(例如 ./THEMENAME/bootstrap/bootstrap
),请删除包裹的 bootstrap
目录。您只需在升级 Bootstrap 框架 时或需要时才需要触摸这些文件。
{.alert.alert-warning} 警告:不要直接修改 ./THEMENAME/bootstrap
内的文件。这样做可能会在未来升级 Bootstrap 框架 时引起问题。
覆盖 {#overrides}
./THEMENAME/less/variable-overrides.less
文件通常是您将花费大量时间覆盖 Bootstrap 框架 提供的变量的地方。
./THEMENAME/less/bootstrap.less
文件几乎与 Bootstrap 框架源文件 完全相同。唯一的区别是它在导入 Bootstrap 框架 的 variables.less
文件后直接注入了 variable-overrides.less
文件。这允许您轻松覆盖变量,而无需在升级时不断跟踪新变量或缺失的变量。
./THEMENAME/less/overrides.less
文件包含各种 Drupal 重写,以便正确集成到 Bootstrap 框架。它可能包含一些增强功能,您可以根据需要自由编辑此文件。
./THEMENAME/less/style.less
文件是将 Bootstrap 框架源文件 和 overrides.less
文件结合在一起的关键。通常,除非您需要添加或删除要导入的文件,否则您不需要修改此文件。这是您应该编译成 ./THEMENAME/css/styles.css
的文件(注意文件名相同,当然使用不同的扩展名)。
另请参阅
- @link 主题设置 主题设置 @endlink
- @link 模板 模板 @endlink
- @link 插件 插件系统 @endlink