ukd8-subtheme-boilerplate

Boilerplate sub theme based off of UKD8 Base Theme.

Make subtheme boilerplate specific to your project

To make this subtheme boilerplate specific to your instance, you will need to change the subtheme machine name.

1. Rename these files to your specific subtheme name following the pattern of uky_ [subthemename]_theme (example: uky_studentsuccess_theme)

   • uky_subtheme_theme.info.yml
   • uky_subtheme_theme.libraries.yml
   • uky_subtheme_theme.theme

2. In your .theme file you will need to edit lines 5 and 9 to the renamed theme.

   • Line 5 - replace 'uky_subtheme_theme_' with your theme machine name (example: uky_studentsuccess_theme_suggestions_block_alter)
   • Line 9 - replace 'uky_subtheme_theme_' with your theme machine name (example: 'uky_studentsuccess_theme_')

3. In your info.yml file you will need to edit lines 1, 3 and 12 to rename the subtheme, the description and set the path to the subtheme specific libraries.

   • Line 1 - Rename to a human readable name such as 'UKY Student Success'
   • Line 3 - update the name in the description to a human readable name such as 'UKY Student Success'
   • Line 12 - uncomment this line and replace [subthemename] (example: uky_studentsuccess_theme/global)

4. In css/style.css you will need to uncomment lines 6-23, and update lines 7, 15, 19 with your theme name. (example: #block-uky-studentsuccess-theme-utilitynav-mobile)

You are now ready to start subtheming!

Inheriting block layout

For a subtheme to inherit the block layout of a base theme, the base theme must be the current default theme at the time the sub-theme is installed and set as default. See this issue for discussion. NOTE: If an uninstalled subtheme is required by feature modules (via dependencies defined in configuration), the subtheme will be installed with the module, but it may not inherit the block layout of the current default theme. This will cause the blocks to have no placement in the newly activated subtheme.