Quick start

Here's a quick start guide to working with Scaffolding.

In this example, we're going to build a knowledge base system consisting a set of knowledge base articles that would look like this:

Follow these steps:

Step 1 - Set up the template

  1. Go to Space Settings, Content ToolsTemplates.

    You need to be a space administrator to view all the features in the Space Settings menu. Non-space admin users will only see a limited feature set.
  2. Click Create New Template. Name it "Knowledge Base Article Template".



  3. In the template editor, add a Field Group macro.
    In the sidebar, click Field Group Settings. Give it a name "kb".



  4. Add a Paragraph field into the editor area for the summary section. 
    Add any other necessary fields like systemversiondiagnosiscause and solution.



  5. Save the template.

Step 2 - Create a page

  1. Create a new page.

  2. Add a Live Template macro.



  3. Specify the template name "Knowledge Base Article Template".



  4. Save the macro and publish the page.

Step 3 - Add content

  1. On the page, click Edit Content button.

  2. Populate the fields accordingly.



  3. Click Save Content.

Step 4 - Update template

  1. Go back to the template you created and edit it.

  2. Edit the Field Group macro.

  3. Try adding a new field, change some text format, etc.



  4. Click Save.

  5. Go back to the page and refresh the page.

    You should now see the changes you make to template is now reflected on the page automatically, without you having to edit the page. This allows you to manage tens or even hundreds of pages easily by just applying changes to the template.