WordPress/create-block-theme
1
0
Fork 0
mirror of https://github.com/WordPress/create-block-theme.git synced 2025-10-03 16:11:13 +08:00
Code Issues Projects Packages Wiki Activity Actions
create-block-theme/README.md

2.4 KiB
Raw Blame History

Create Block Theme

A WordPress plugin to create block themes.

This plugin allows you to:

  • Create a new theme, blank theme, child theme or style variation.
  • Embed Google Fonts in your theme
  • Embed local font assets in your theme

The plugin is development only — not intended for use on production websites, but used as a tool to create new themes.

Create Block Theme

This feature can be used in six ways:

1.Export

Export the activated theme including the user changes.

2. Create a child theme

Creates a new child theme with the currently active theme as a parent.

3. Clone the active theme

Creates a new theme by cloning the activated theme. The resulting theme will have all of the assets of the activated theme combined with the user's changes.

4. Overwrite theme files

Saves user's changes to the theme files and deletes the user's changes.

5. Generate blank theme

Generate a boilerplate "empty" theme inside of current site's themes directory.

6. Create a style variation

Saves user's changes as a style variation of the currently active theme.

Embed Google Fonts or local font files

This feature allows you to embed fonts into your active theme. You can embed Google Fonts and local font assets.

When you add a font the plugin will add to your theme:

  • The font files to your theme's file structure under this path ./assets/fonts.
  • The font face definitions to the theme.json file.

You can continue using your modified theme or you can export it as a new theme containing the new fonts.

How to use the plugin

Step 1 – Setup

Install and activate the Create Block Theme plugin.

In the WordPress Admin Dashboard, under Appearance there will be three new pages called:

  • Create Block Theme
  • Embed Google font in your active theme
  • Embed local font file assets

Step 2 – Fonts, styles and templates customizations

Make changes to your site styles and templates using the Site Editor. You can also include new fonts using the plugin options.

Step 3 – Save

Still in the WordPress dashboard, navigate to "Appearance" -> "Create Block Theme" section. Select one of the available options and then, if necessary, add the details for the theme here. These details will be used in the style.css file. Click "Generate” button, to save the theme.