|
@@ -1,22 +1,26 @@
|
|
-# === Blank Canvas Blocks ===
|
|
|
|
|
|
+=== Blockbase ===
|
|
Contributors: Automattic
|
|
Contributors: Automattic
|
|
-Requires at least: ?
|
|
|
|
-Tested up to: ?
|
|
|
|
-Requires PHP: ?
|
|
|
|
|
|
+Requires at least: 5.7
|
|
|
|
+Tested up to: 5.7.2
|
|
|
|
+Requires PHP: 5.6.2
|
|
License: GPLv2 or later
|
|
License: GPLv2 or later
|
|
License URI: http://www.gnu.org/licenses/gpl-2.0.html
|
|
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.
|
|
|
|
|
|
+A starting point for building your block-based site.
|
|
|
|
|
|
-## == Description ==
|
|
|
|
|
|
+== 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.
|
|
|
|
|
|
+Blockbase is a simple theme that supports full-site editing. It comes with a set of minimal templates and design settings that can be manipulated through Global Styles. Use it to build something beautiful.
|
|
|
|
+
|
|
|
|
+== About Blockbase ==
|
|
|
|
+
|
|
|
|
+The purpose of Blockbase 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.
|
|
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.
|
|
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 ==
|
|
|
|
|
|
+== Building a Block Child Theme ==
|
|
|
|
|
|
To build a Blockbase child theme follow these instructions:
|
|
To build a Blockbase child theme follow these instructions:
|
|
|
|
|
|
@@ -24,8 +28,27 @@ To build a Blockbase child theme follow these instructions:
|
|
- Your child theme's theme.json file will be built by combining Blockbase'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 Blockbase's folder.
|
|
- Your child theme's theme.json file will be built by combining Blockbase'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 Blockbase's folder.
|
|
- Extend the parent's templates that you want to customize or add new ones where needed following the [template hierarchy](https://themeshaper.com/2020/12/18/getting-started-with-block-themes-templates/).
|
|
- Extend the parent's templates that you want to customize or add new ones where needed following the [template hierarchy](https://themeshaper.com/2020/12/18/getting-started-with-block-themes-templates/).
|
|
- Using `npm run start` will both watch changes inside the `sass` and `assets` folder and changes to the `child-experimental-theme.json` file.
|
|
- 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 Blockbase.
|
|
|
|
|
|
|
|
-## == Building a Universal Child Theme ==
|
|
|
|
|
|
+== 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](https://github.com/Automattic/themes/tree/make/quadrat) where we are developing Quadrat as a Universal 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](https://github.com/Automattic/themes/tree/make/quadrat) where we are developing Quadrat as a Universal Theme.
|
|
|
|
+
|
|
|
|
+== Changelog ==
|
|
|
|
+
|
|
|
|
+= 1.0 =
|
|
|
|
+* Initial release
|
|
|
|
+
|
|
|
|
+== Copyright ==
|
|
|
|
+
|
|
|
|
+Blockbase WordPress Theme, (C) 2021 Automattic, Inc.
|
|
|
|
+Blockbase is distributed under the terms of the GNU GPL.
|
|
|
|
+
|
|
|
|
+This program is free software: you can redistribute it and/or modify
|
|
|
|
+it under the terms of the GNU General Public License as published by
|
|
|
|
+the Free Software Foundation, either version 2 of the License, or
|
|
|
|
+(at your option) any later version.
|
|
|
|
+
|
|
|
|
+This program is distributed in the hope that it will be useful,
|
|
|
|
+but WITHOUT ANY WARRANTY; without even the implied warranty of
|
|
|
|
+MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
|
|
|
|
+GNU General Public License for more details.
|