Read the Getting Started topic.
Below are instructions on how to create a Drupal Bootstrap based sub-theme. There are several different variations on how to accomplish this task, but this topic will focus on the two primarily and most common ways.
Choose an Existing Starterkit
- Less Starterkit - uses the Bootstrap Framework source files and a local Less preprocessor.
- Sass Starterkit - uses the Bootstrap Framework source files and a local Sass preprocessor.
Create a New Sub-theme
- Copy over one of the starterkits you have chosen from the
sites/all/themesor a respective
- Rename the folder to a unique machine readable name. This will be your
sub-theme's "name". For this example and future examples we'll use
./subtheme/cdn.starterkitor, if using the LESS Starterkit,
./subtheme/less.starterkitto match the folder name and append
./subtheme/subtheme.infoand change the name, description and any other properties to suite your needs.
WARNING: Ensure that the
.starterkit suffix is
not present on your sub-theme's
.info filename. This suffix is simply a stop
gap measure to ensure that the bundled starter kit sub-theme cannot be enabled
or used directly. This helps people unfamiliar with Drupal avoid modifying the
starter kit sub-theme directly and instead forces them to create a new sub-theme
Enable Your New Sub-theme
In your Drupal site, navigate to
admin/appearance and click the
Enable and set default link next to your newly created sub-theme.
Please refer to Choose an Existing Starterkit for additional documentation pertaining to the chosen Starterkit.
subtheme/ README.md (line 3)
|Theme Settings||Overview of theme settings for Drupal Bootstrap based themes.|
|Sass Starterkit||Instructions for subtheming using the Sass Starterkit.|
|Less Starterkit||Instructions for subtheming using the Less Starterkit.|
|Helper Functions||List of common helper functions for use in Drupal Bootstrap based themes.|
|CDN Starterkit||Instructions for subtheming using the CDN Starterkit.|