Overview
One of the best ways to make use of Carbon Editor's cross embedding linking feature is to set up a document of commonly used content, then configure all pages, sections, and fields it contains for cross embeddinglinking.
This document can then be quickly referred to when embedding linking commonly used content in to another document.
This type of workflow is referred to as using a 'Content Bank'.
Creating the content bank
- Create a new document, making sure to set its embedding Linking ID to something that clearly represents its purpose.
- Create your commonly used content, either by using The Page Editor, or by creating content in Carbon Editor XML Format and importing it.
- If you create your own XML and import it, ensure you have set up embedding IDs Linking IDs for all relevant fields, sections, and pages, as per Cross Linking in Imported Content.
Using the content bank
- Create a new Document as per Creating a New Document.
- Embed Link content from your content bank as per Cross Linking Content in the Page Editor (Embeds) or Cross Linking in Imported Content.
Replacing the content bank with a new version
You can continue to edit the content in your content bank just like any other document.
In addition to the standard editing workflow, you can also programatically programmatically replace your entire content bank at once, replacing your old content but retaining the embedding Linking IDs of pages, sections, and fields.
To do so:
- Create a new document with the same embedding ID Linking ID as the old content bank document.
- Create a new .zip of the new/updated content in Carbon Editor XML Format. Ensure that any embedding Linking IDs that existed in the old content bank are added to the correct pages, sections, and fields in the new content bank.
- Add new embedding Linking IDs to new content, as necessary.
- Import this .zip of XML content into the new content bank document.
- Verify that pages that contained embedded content linked content from the old content bank now embed the link the relevant content from the new content bank.
- Optionally, delete the old content bank document. This is not required, but will help to keep your Space clean and minimise incorrect use of the old content bank.