History

Jason Crist 29ed9e9e94 add a script to build all BCB children		2021-05-18 16:23:51 -04:00
..
assets	removed color and border customizations from selects (#3866 )	2021-05-17 08:59:38 -07:00
block-template-parts	Bringing development work from working branch to trunk (#3608 )	2021-04-01 16:25:27 -04:00
block-templates	Bringing development work from working branch to trunk (#3608 )	2021-04-01 16:25:27 -04:00
inc	Fix color markup.	2021-04-21 09:11:55 -04:00
sass	removed color and border customizations from selects (#3866 )	2021-05-17 08:59:38 -07:00
build.js	Bringing development work from working branch to trunk (#3608 )	2021-04-01 16:25:27 -04:00
experimental-theme.json	Quadrat: Update Pullquote styles (#3780 )	2021-05-14 10:48:59 -07:00
functions.php	BCB: Only show patterns on the parent theme (#3775 )	2021-05-06 11:22:28 -07:00
index.php	First Build of Blank Canvas Blocks	2021-03-09 11:38:50 -05:00
package-lock.json	Blank Canvas Blocks: Update build script	2021-03-30 14:05:34 +01:00
package.json	add a script to build all BCB children	2021-05-18 16:23:51 -04:00
readme.md	updated readme with child theme instructions (#3689 )	2021-04-22 15:59:32 -04:00
rebuild-child-themes.sh	add a script to build all BCB children	2021-05-18 16:23:51 -04:00
screenshot.png	First Build of Blank Canvas Blocks	2021-03-09 11:38:50 -05:00
style.css	Add licensing information.	2021-04-12 14:42:28 -04:00

readme.md

=== Blank Canvas Blocks ===

Contributors: Automattic Requires at least: ? Tested up to: ? Requires PHP: ? License: GPLv2 or later License URI: http://www.gnu.org/licenses/gpl-2.0.html

An unopinionated 'Ponyfill' to fill the gaps between where Gutenberg IS and where Gutenberg is GOING.

== Description ==

The purpose of Blank Canvas Blocks is to provide a "ponyfill" that allows for 100% "configuration expression" of design. Any aspect of configurable design that Gutenberg does not yet take into account is expressed in theme.json 'custom' properties.

To use this theme assign it as the parent theme and then copy from this them to the child theme the theme.json file and fill out the details.

The goal is for the ponyfill styling to reflect what Gutenberg will style, from a given configuration, once that work is complete. But to offer that today, using simpler techniques that Gutenberg will use upon completion.

== Building a Block Child Theme ==

To build a BCB child theme follow these instructions:

Add a package.json, style.css and empty index.php files to your theme
Your child theme's theme.json file will be built by combining BCB's original theme.json file and your child's child-experimental-theme.json. That is the file where your configuration values live (you only want the values for variables that are different from the parent there). To generate the combined file, run npm run build from inside your theme's folder or run npm run build:child child-theme-slug from inside BCB's folder.
Extend the parent's templates that you want to customize or add new ones where needed following the template hierarchy.
Using npm run start will both watch changes inside the sass and assets folder and changes to the child-experimental-theme.json file.
Additionally, your child theme may want to unregister the block patterns and block styles defined by BCB.

== Building a Universal Child Theme ==

A Universal theme is a theme that works in Full Site Editing and in the Customizer. This is a concept that's still being explored so we don't have instructions to provide yet. If you are curious, you can visit the branch where we are developing Quadrat as a Universal Theme.