Determine your use-caseLive 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 change that source form, from time to time, and ensure that these updates changes occur wherever the blueprint Blueprint is referenced.
Create a source blueprint Blueprint with your content 'form'This page will act as the 'single source of truth' for the form of the blueprintBlueprint. Any changes to this page will 'persist' to wherever this blueprint Blueprint is referenced on the site. ThereforeWith this in mind, design the page accordingly and with an eye a mind towards how it will be used and reused in different places. ( Tip: Brikit typically recommends containing putting all of your site's live blueprint Live Blueprint pages in a space called Live Blueprintsone dedicated space (e.g. with space key of LIVEBLUEPRINTS). This makes it easy to find them again and also to manage permissions for the appropriate editors).
Add substitution fieldsAs with Page Blueprints and Space Blueprints, Live Blueprints can use any use substitution fields, including built-in substitution fields. Simply in places where content will be different in each use of the blueprint. Simply add them wherever it makes sense to do so. Remember that part of the power of live blueprints 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.
<SCREENSHOT of the Live Blueprint Page. There is an example here (on Confluence 72 with some wonky styling though...): https://confluence72.brikit.com/display/BlueprintPages/Expert+Profile+Plus+Live+Blueprint>
Navigate to the Blueprint Definitions PageNow that the source blueprint Blueprint has been drafted, it is time to 'define' it as a blueprintBlueprint. This is done on the Blueprint Definitions Page. To access this page, do the following:
HTML Wrap |
---|
tag | span |
---|
class | product-navigation |
---|
| Confluence header → Gear icon → General Configuration → Blueprint Definitions |
Edit and save the JSON fileOn the Blueprint Definitions Page, click the 'download blueprintsDownload Blueprints' button to retrieve the JSON file. Under the "PageBlueprints" array, add an a new object to define your blueprintBlueprint. The fields are all the same for defining page blueprints Page Blueprints as they are for defining live blueprintsLive Blueprints, except for one: this is the "type" field. Be sure to set the value of "type" to "live" (note: the default value is "page"). For example: Code Block |
---|
| {
"name" : "Expert Profile",
"description" : "A liveLive blueprintBlueprint for generating a common-form Expert Profile.",
"spaceKey" : "LIVEBLUEPRINTS",
"pageTitle" : "Expert Profile Live Blueprint",
"blueprintFieldsBlueprintFields" : [ "expert-name", "username", "pillar-name", "phone-number", "geographic-location", "building-name", "expert-title" ],
"type" : "live"
}, |
Learn more about Accessing and Editing the JSON File.
Upload the JSON fileOn the Blueprints Definition Page, click the "upload blueprintsUpload Blueprints" button and upload your JSON File. Unless there is an error (common errors include missing a comma or quote), then you should receive a success message. The Blueprint Definitions Page will refresh to show that the a new page blueprint Page Blueprint of type 'Live' has been added.
Reference the live blueprintLive BlueprintNow that the Blueprint has been created and defined, it's time to use it. Navigate Now navigate to, or create, a page where you want to use (AKA 'reference' or 'activate') this live blueprintLive Blueprint. Edit the page and insert the Live Blueprints Macro.
Set the macro parametersClick the Live Blueprint Macro and select "Edit". In the first parameter, include the name of the live blueprint Live Blueprint (this is the "name" field in your JSON file). You may also skip this parameter and point to the page title of the live blueprintLive Blueprint, but it is more precise to use the blueprint Blueprint name. For example, the "name" of the live blueprint Live Blueprint in the code above is "Expert Profile" and the "page title" is "Expert Profile Live Blueprint". You may also add or change other parameter values now too. To learn more about these parameters, read about the Live Blueprint Macro Parameters and Key. Save the macro edit screen and then save the edit page screen.
Add substitution field values in the Live Blueprint Macro body
If you have Theme Press installed, "Edit the Blueprint" and add values on the pageBack on your
Repeat as you see fitYou 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
|