dof-dss/nicsdru_origins_theme

DoF Origins base theme

10.1.5 2024-09-04 10:04 UTC

Requires

• php: >=8.0

MIT

• David Corbett

• theme
• drupal

README

nicsdru_origins_theme

This repository contains code for a Drupal 8 theme from which NICS sites could be sub-themed from.

Table of contents

• Quick start
• What's included
• Bugs and feature requests
• Using the NPM scripts
• Sub-theming
• Documentation

Quick start

• Download the latest release or clone the repo: git clone https://github.com/dof-dss/nicsdru_origins_theme.git.
• npm install NB: you encounter issues with the image optimisation libraries if you don't have libjpeg library available on the host machine. To fix this brew install libjpeg.

What's included

The theme uses NPM scripts and packages to create tooling to:

• write and compile scss to css
• apply appropriate prefixing for css rules
• write and uglify js
• detect features the user’s browser has to offer (via Modernizr)
• code linting
• optimise and compress images for the web

Within the download you'll find the following directories and files, logically grouping common assets, you'll see something like this:

nicsdru_origins_theme/
└── config/
│   ├── install/
│   ├── .sass-lint.yml
│   ├── modernizr-config.json
│   ├── postcss.config.js
└── css/
└── images/
└── js/
└── src/
│   ├── images/
│   ├── js/
│   ├── scss/
│   ├── styleguide/
└── templates/
│   ├── block/
│   ├── content/
│   ├── field/
│   ├── layout/
│   ├── misc/
│   ├── navigation/
│   ├── user/
└── .gitignore
└── composer.json
└── imagemin.js
└── nicsdru-origins-theme.breakpoints.yml
└── nicsdru-origins-theme.info.yml
└── nicsdru-origins-theme.layouts.yml
└── nicsdru-origins-theme.libraries.yml
└── nicsdru-origins-theme.theme
└── package.json
└── README.md
└── screenshot.png

Using the NPM scripts

The package.json includes the following commands and tasks:

Run npm run to see all the npm scripts.

Sub-theming

TODO: add in how to sub-theme from this theme.

Documentation

TODO: add documentation.