Page tree

Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.

Content Layer
namePage Info
id278129461
classwatermark-layer
Content Column
namePage Body
width100.00001%
id278129463
Content Block
background-colortransparent
namePrompt
id494677873
classtight manual-prompt-flex

Steps for creating a blueprint that maintains a persistent connection wherever it is used.

Content Block
nameOutcome
rich-link-hoverstrue
id1042866408
classtight manual-outcome-flex

Live Blueprints were introduced with Blueprint Maker 2.0+ and can be a sophisticated way to present similarly-formed content while maintaining a connection to the source form. Use the steps below to create a blueprint, designate it as 'live' in the JSON file, and then use the Live Blueprint Macro to embed or activate it where you see fit.

Content Block
nameSteps
rich-link-hoverstrue
id494842117
classsteps-block numbered manual-steps-flex

Determine your use-case

Live Blueprints are particularly useful if you have a case where:

a. You want to re-use a common 'form' of content, such as a table with similar headings but different values.

and

b. You want to be able to update that source form, from time to time, and ensure that these updates occur wherever the blueprint is referenced.

Create a source blueprint with your content 'form'

This page will act as the 'single source of truth' for the form of the blueprint. Any changes to this page will 'persist' to wherever this blueprint is referenced on the site. Therefore, design the page accordingly and with an eye towards how it will be used and reused in different places.

(Tip: Brikit typically recommends containing all of your site's live blueprint pages in a space called Live Blueprints. This makes it easy to find them again and also to manage permissions for the appropriate editors).

Add substitution fields

Live Blueprints can use any substitution fields, including built-in substitution fields. Simply add them wherever it makes sense to do so. Remember that part of the power of live blueprints is that they allow content to maintain an identical form while having their individual instances include different on-page content (or data). Substitution fields facilitate this possibility.

Navigate to the Blueprint Definitions Page

Now that the source blueprint has been drafted, it is time to 'define' it as a blueprint. This is done on the Blueprint Definitions Page

HTML Wrap
tagspan
classproduct-navigation

Confluence header Gear icon Image Added→ General Configuration → Blueprint Definitions

Edit the JSON file

On the Blueprint Definitions Page, click the 'download blueprints' button to retrieve the JSON file

Code Block
languagejs
		{
			"name"				: "Expert Profile Live Blueprint",
			"description"		: "A Live Blueprint for the Expert Profile.",
			"spaceKey"			: "BlueprintPages",
			"pageTitle"			: "Expert Profile Live Blueprint",
			"blueprintFields"	: [ "expert-name", "username", "pillar-name", "phone-number", "geographic-location", "building-name", "expert-title" ],
			"type"				: "live"
		},



Reference the live blueprint

Now navigate to, or create, the page where you want to use (or 'reference' or 'activate') this live blueprint. Edit the page and insert the Live Blueprints Macro.

Set the macro parameters

Point to the live blueprint in the macro parameters. 

"Edit the Blueprint" and add values


Repeat as you see fit

You can insert the Live Blueprint Macro on the page as many times and in as many places as you see fit, each will have their own


Content Block
nameNote
rich-link-hoverstrue
id495965127
classmanual-note-flex
collapsiblecollapse
Note

If using:

  1. Replace me with something to note about this how-to entry that falls outside the scope of all other sections; and
  2. Add the tight-bottom class to the Steps block above to narrow the gap between the two blocks.
Content Block
nameTip
rich-link-hoverstrue
id894522670
classmanual-tip-flex
collapsiblecollapse
Tip

If using:

  1. Replace me with something to note about this how-to entry that falls outside the scope of all other sections; and
  2. Add the tight-bottom class to the next visible/non-collapsed block above this one to narrow the gap between the two blocks.
Content Block
nameWarning
rich-link-hoverstrue
id894530759
classmanual-warning-flex
collapsiblecollapse
Warning

If using:

  1. Replace me with something to note about this how-to entry that falls outside the scope of all other sections; and
  2. Add the tight-bottom class to the next visible/non-collapsed block above this one to narrow the gap between the two blocks.
Content Block
nameInfo
rich-link-hoverstrue
id894537203
classmanual-info-flex
collapsiblecollapse
Info

If using:

  1. Replace me with something to note about this how-to entry that falls outside the scope of all other sections; and
  2. Add the tight-bottom class to the next visible/non-collapsed block above this one to narrow the gap between the two blocks.
Content Layer
background-color$lightGrayColor
nameRelated
id888168050
Content Column
nameRelated
width100%
id888168051
Content Block
rich-links-hide-descriptiontrue
rich-link-hoverstrue
rich-links-columns4
rich-links-verticaltrue
rich-links-image-height100px
rich-links-hide-site-icontrue
rich-links-details-padding10px
nameRelated
rich-links-enabletrue
border-width0
rich-links-details-alignmentleft
rich-links-margin20px 30px 0 0
id496234544
classrelated-block clean manual-related-flex