Skip to content

Commit

Permalink
Update glossary (#20934)
Browse files Browse the repository at this point in the history
* Update glossary

Added "Block patterns" and "Template parts". Also updated the Block Inserter to Block Library.

* Fixed spacing issue after period.
  • Loading branch information
mapk authored Mar 18, 2020
1 parent b72b41e commit b2b16ba
Showing 1 changed file with 9 additions and 3 deletions.
12 changes: 9 additions & 3 deletions docs/designers-developers/glossary.md
Original file line number Diff line number Diff line change
Expand Up @@ -10,15 +10,18 @@
<dt>Block</dt>
<dd>The abstract term used to describe units of markup that, composed together, form the content or layout of a webpage. The idea combines concepts of what in WordPress today we achieve with shortcodes, custom HTML, and embed discovery into a single consistent API and user experience.</dd>

<dt>Block Categories</dt>
<dd>These are not a WordPress taxonomy, but instead used internally to sort blocks in the Block Inserter.</dd>
<dt>Block categories</dt>
<dd>These are not a WordPress taxonomy, but instead used internally to sort blocks in the Block Library.</dd>

<dt>Block Inserter</dt>
<dt>Block ~Inserter~ Library</dt>
<dd>Primary interface for selecting from the available blocks, triggered by plus icon buttons on Blocks or in the top-left of the editor interface.</dd>

<dt>Block name</dt>
<dd>A unique identifier for a block type, consisting of a plugin-specific namespace and a short label describing the block's intent. e.g. <code>core/image</code></dd>

<dt>Block patterns</dt>
<dd>Block patterns are predefined layouts of blocks that can be inserted as starter content that are meant to be changed by the user every time. Once inserted, they exist as a local save and are not global.</dd>

<dt>Block type</dt>
<dd>In contrast with the blocks composing a particular post, a block type describes the blueprint by which any block of that type should behave. So while there may be many images within a post, each behaves consistent with a unified image block type definition.</dd>

Expand Down Expand Up @@ -58,4 +61,7 @@
<dt>Template</dt>
<dd> A template is a pre-defined arrangement of blocks, possibly with predefined attributes or placeholder content. You can provide a template for a post type, to give users a starting point when creating a new piece of content, or inside a custom block with the <code>InnerBlocks</code> component. See the templates documentation for more information. See <a href="../../developers/block-api/block-templates/">templates documentation</a> for more information.</dd>

<dt>Template part</dt>
<dd>Template parts are equivalent – in blocks – of theme template parts. They are generally defined by a theme first. They carry some semantic meaning (could be swapped between themes such as a header) and can only be inserted in the site editor context (within “templates”). They are primarily site structure and are never to be mixed with the post content editor. </dd>

</dl>

0 comments on commit b2b16ba

Please sign in to comment.