sghoweri / shila-drupal-theme

An Atomic Design and Pattern Lab friendly starting point for new Drupal 8 themes

Shila theme for Drupal 8

An Atomic Design and Pattern Lab friendly starting point for new Drupal 8 themes.

A Pattern Lab generated style guide can be found here (online style guide might not be up to date).

Please note that this theme is in early stages of development.

Background

This theme is not meant to be usable as is. It is meant to be a starting point for development of new themes.

It is also meant to demonstrate Drupal template compatibility and Pattern Lab integration made possible by the Drupal Edition of Pattern Lab and Data Transform Plugin. For this reason most of the templates are actually unmodified Drupal Stable base theme templates.

Installing development dependencies

While it is possible to use Shila theme on its own, Shila Drupal Theme StarterKit is required for development.

Prerequisites: npm and Bower installed.

In the theme root directory run:

git clone http://github.com/aleksip/starterkit-shila-drupal-theme starterkit

In the starterkit directory run:

npm install
bower install

Files copied from the StarterKit

Please note that the contents of the css, images and templates/patterns directories are copied from the StarterKit and should not be edited. Copies are included in the theme repository to make it possible to try out and use the theme without installing development dependencies.

Integrating with Pattern Lab

Prerequisites: Shila Drupal Theme StarterKit and Composer installed.

In the theme root directory run:

git clone https://github.com/pattern-lab/edition-php-drupal-standard pattern-lab

In the pattern-lab directory run:

composer install

In the file pattern-lab/config/config.yml change sourceDir and twigAutoescape like so:

sourceDir: ../starterkit/dist
twigAutoescape: false

If everything went well you should now be able to generate the static Pattern Lab site. In the pattern-lab directory run:

php core/console --generate