messageagency/ma_bootstrap

There is no license information available for the latest version (1.12) of this package.

Bootstrap sub-theme, middle layer. Site-specific themes should inherit from this.

1.12 2023-08-17 20:17 UTC

Requires

• messageagency/ma_sprout_helpers: ^1.0

Unknown License

• Aaron Bauman

README

MA Bootstrap is a subtheme of the Bootstrap theme (https://www.drupal.org/project/bootstrap). It is intended to act as the base for Message Agency drupal 8 sites. Anything in this theme should be broad enough to apply to multiple sites; Each individual site should create it's own subtheme for site-specific overrides.

RECOMMENDED

• Bootstrap Layouts (https://www.drupal.org/project/bootstrap_layouts)
  • This module needs a module which consumes layouts; We recommend Display Suite (https://www.drupal.org/project/ds)

Less Starterkit

Below are instructions on how to create a Bootstrap sub-theme using a Less preprocessor.

• Prerequisites
• Additional Setup
• Overrides

Prerequisites

• Read the @link getting_started Getting Started @endlink and @link sub_theming Sub-theming @endlink documentation topics.
• You must understand the basic concept of using the Less CSS pre-processor.
• You must use a local Less compiler.
• You must use the Bootstrap Framework Source Files ending in the .less extension, not files ending in .css.

Additional Setup {#setup}

Download and extract the latest 3.x.x version of Bootstrap Framework Source Files into the root of your new sub-theme. After it has been extracted, the directory should be renamed (if needed) so it reads ./THEMENAME/bootstrap.

If for whatever reason you have an additional bootstrap directory wrapping the first bootstrap directory (e.g. ./THEMENAME/bootstrap/bootstrap), remove the wrapping bootstrap directory. You will only ever need to touch these files if or when you upgrade your version of the Bootstrap Framework.

{.alert.alert-warning} WARNING: Do not modify the files inside of ./THEMENAME/bootstrap directly. Doing so may cause issues when upgrading the Bootstrap Framework in the future.

Overrides {#overrides}

The ./THEMENAME/less/variable-overrides.less file is generally where you will the majority of your time overriding the variables provided by the Bootstrap Framework.

The ./THEMENAME/less/bootstrap.less file is nearly an exact copy from the Bootstrap Framework Source Files. The only difference is that it injects the variable-overrides.less file directly after it has imported the Bootstrap Framework's variables.less file. This allows you to easily override variables without having to constantly keep up with newer or missing variables during an upgrade.

The ./THEMENAME/less/overrides.less file contains various Drupal overrides to properly integrate with the Bootstrap Framework. It may contain a few enhancements, feel free to edit this file as you see fit.

The ./THEMENAME/less/style.less file is the glue that combines the Bootstrap Framework Source Files and overrides.less files together. Generally, you will not need to modify this file unless you need to add or remove files to be imported. This is the file that you should compile to ./THEMENAME/css/styles.css (note the same file name, using a different extension of course).

See also:

• @link theme_settings Theme Settings @endlink
• @link templates Templates @endlink
• @link plugins Plugin System @endlink