Aldine

Aldine is the new root theme for Pressbooks, based on Sage.

Features

• Sass for stylesheets
• ES6 for JavaScript
• Webpack for compiling assets, optimizing images, and concatenating and minifying files
• Browsersync for synchronized browser testing
• Laravel Blade as a templating engine
• Controller for passing data to Blade templates

Requirements

Make sure all dependencies have been installed before moving on:

• PHP >= 7.0
• Composer
• WordPress >= 4.8.1
• Pressbooks >= 4.3
• Node.js >= 6.9.x
• Yarn

Theme installation

Download the latest zipped release to your Pressbooks themes directory (wp-content/themes or app/themes) and unzip the theme folder.

Theme structure

themes/pressbooks-aldine/  # → Theme root
├── app/                  # → Theme PHP
│   ├── controllers/      # → Controller files
│   ├── widgets/          # → Custom widget classes
│   ├── admin.php         # → Theme customizer setup
│   ├── filters.php       # → Theme filters
│   ├── helpers.php       # → Helper functions
│   └── setup.php         # → Theme setup
│   └── widgets.php       # → Widget initialization
├── composer.json         # → Autoloading for `app/` files
├── composer.lock         # → Composer lock file (never edit)
├── dist/                 # → Built theme assets (never edit)
├── functions.php         # → Composer autoloader, theme includes
├── index.php             # → Never manually edit
├── node_modules/         # → Node.js packages (never edit)
├── package.json          # → Node.js dependencies and scripts
├── resources/            # → Theme assets and templates
│   ├── assets/           # → Front-end assets
│   │   ├── config.json   # → Settings for compiled assets
│   │   ├── build/        # → Webpack and ESLint config
│   │   ├── fonts/        # → Theme fonts
│   │   ├── images/       # → Theme images
│   │   ├── scripts/      # → Theme JS
│   │   └── styles/       # → Theme stylesheets
│   └── views/            # → Theme templates
│       ├── layouts/      # → Base templates
│       └── partials/     # → Partial templates
├── screenshot.png        # → Theme screenshot for WP admin
├── style.css             # → Theme meta information
└── vendor/               # → Composer packages (never edit)

Theme development

• Run yarn from the theme directory to install dependencies

Build commands

• yarn run start — Compile assets when file changes are made, start Browsersync session
• yarn run build — Compile and optimize the files in your assets directory
• yarn run build:production — Compile assets for production