Skip to content

For Developers

Sarah Carney edited this page Mar 27, 2019 · 6 revisions

Subtheme

It is not recommended to modify this theme directly, because changes from theme updates may conflict with your customizations. Therefore, it's best to customize Drupal 8 themes with subthemes. How to work with Drupal 8 Subthemes: https://www.drupal.org/docs/8/theming-drupal-8/creating-a-drupal-8-sub-theme-or-sub-theme-of-sub-theme.

Subtheme Accessibility

This theme is built to align as closely as possible with WCAG AA digital accessibility standards. It is the subtheme developer's responsibility to ensure any customizations with the subtheme are also WCAG AA compliant. Learn more about digital accessibility at ISU's Digital Accessibility website.

CSS

Whenever possible, this theme complies with Drupal 8 CSS development standards: https://www.drupal.org/docs/develop/standards/css

The first layer of CSS is Bootstrap 4:

  • bootstrap-grid.min.css
  • bootstrap-reboot.min.css
  • bootstrap-min.css

The next layers are theme CSS files

  • isu-navbar.css - Self-contained CSS to style the black ISU Navbar
  • base.css - HTML element styling and CSS overrides
  • layout.css - A few styles for larger scope layout/positioning
  • theme.css - Styles for most of the theme
  • isu-social.css - CSS to add icons to social media links

All theme-specific classes are prefixed with isu-, so it is safe to assume that classes without this prefix are either Bootstrap 4 or generated by Drupal 8. Only in rare cases are Bootstrap 4 or Drupal 8 classes styled directly, and they are commented.