Page Comparison

...

Table of Contents

minLevel	1
maxLevel	6
outline	false
type	flat
separator	pipe
printable	false

Overview

In your knowledge base space, create a new template for a How-to article template.

We want to build This article is a form like this one:Image Removedsimilar to this example.

...

Template elements

System dropdown menu options

To build the drop-down menu for systemSystem, we will use use the following Scaffolding Forms and Templates macros

the list-data macro

...

some list-option blocks

...

Info
A tutorial on

...

list-data and list-option

...

macro use can be found in our technical documentation.

Image Removed

Next, we will use To the template

add a list-data macro
- name this System
- set type to select

...

Info
When creating a field with predefined options, choose select for drop-down menus, check for checklist, or autocomplete for input field with live search.

nest one list-option block for each of the dropdown menu options
- add a value to each list-option
- set the label the same as the value for each list-option

...

Objective field

Use the text-data macro for the objective and step-by-step guide fields.

Image Removed

Note that there is a Objective field.

add the text-data macro
- add the name Objective
- set type to line
- set content to text
- set required to true

...

Info
The `type=line` parameter in

...

Objective means the required input is a single line

...

Finally, learn how you can a create a new article with this template in this tutorial.

Click here for the source code...

Expand
title

Step-by-step Guide field

Use the text-data macro for the Step-by-step Guide field.

add the text-data macro
- add the name Objective

...

Info
A `type` parameter value is not added in Step-by-step Guide. This means the input text area is a longer text area than the Objective field.

A later step in this use case is a tutorial to create a knowledge base template with the live-template macro for the creating a new article.

Code

Expand

title	How-to article template source code

Code Block

language	xml	title	How to article template

<h2>System: </h2>
<p> <ac:structured-macro ac:macro-id="43a9faaf-591e-4cde-9058-c186a4e564e9" ac:name="list-data" ac:schema-version="1">
    <ac:parameter ac:name="blank">false</ac:parameter>
    <ac:parameter ac:name="name">System</ac:parameter>
    <ac:parameter ac:name="separator">newline</ac:parameter>
    <ac:parameter ac:name="atlassian-macro-output-type">INLINE</ac:parameter>
    <ac:rich-text-body>
      <ac:structured-macro ac:macro-id="b9a4259d-8c70-4247-9a23-329789e56a62" ac:name="list-option" ac:schema-version="1">
        <ac:parameter ac:name="label">Confluence</ac:parameter>
        <ac:parameter ac:name="value">Confluence</ac:parameter>
        <ac:rich-text-body>
          <p>Confluence</p>
        </ac:rich-text-body>
      </ac:structured-macro>
      <ac:structured-macro ac:macro-id="a0c8f803-20fd-4e2f-a41a-11df6f417c09" ac:name="list-option" ac:schema-version="1">
        <ac:parameter ac:name="label">Gmail</ac:parameter>
        <ac:parameter ac:name="value">Gmail</ac:parameter>
        <ac:rich-text-body>
          <p>Gmail</p>
        </ac:rich-text-body>
      </ac:structured-macro>
      <ac:structured-macro ac:macro-id="8a5a5429-5ed6-4d23-a676-1f85b77386e0" ac:name="list-option" ac:schema-version="1">
        <ac:parameter ac:name="label">HipChat</ac:parameter>
        <ac:parameter ac:name="value">HipChat</ac:parameter>
        <ac:rich-text-body>
          <p>HipChat</p>
        </ac:rich-text-body>
      </ac:structured-macro>
      <ac:structured-macro ac:macro-id="f8846c20-c0fc-40bd-8b93-9d81dd908671" ac:name="list-option" ac:schema-version="1">
        <ac:parameter ac:name="label">JIRA</ac:parameter>
        <ac:parameter ac:name="value">JIRA</ac:parameter>
        <ac:rich-text-body>
          <p>JIRA</p>
        </ac:rich-text-body>
      </ac:structured-macro>
      <ac:structured-macro ac:macro-id="38695d17-a425-4317-8c90-5e8be4e1e4ec" ac:name="list-option" ac:schema-version="1">
        <ac:parameter ac:name="label">Not applicable</ac:parameter>
        <ac:parameter ac:name="value">Not applicable</ac:parameter>
        <ac:rich-text-body>
          <p>Not applicable</p>
        </ac:rich-text-body>
      </ac:structured-macro>
    </ac:rich-text-body>
  </ac:structured-macro> </p>
<h2>Objective: </h2>
<p> <ac:structured-macro ac:macro-id="5543e227-181e-4bb7-85ee-38edb100ffed" ac:name="text-data" ac:schema-version="1">
    <ac:parameter ac:name="name">Objective</ac:parameter>
    <ac:parameter ac:name="type">line</ac:parameter>
    <ac:parameter ac:name="content">text</ac:parameter>
    <ac:parameter ac:name="required">true</ac:parameter>
    <ac:parameter ac:name="atlassian-macro-output-type">INLINE</ac:parameter>
    <ac:rich-text-body>
      <p> </p>
    </ac:rich-text-body>
  </ac:structured-macro> </p>
<h2>Step-by-step Guide: </h2>
<p>
  <ac:structured-macro ac:macro-id="6e1a4d21-fb53-4d4e-8411-5db68b23beae" ac:name="text-data" ac:schema-version="1">
    <ac:parameter ac:name="name">Guide</ac:parameter>
    <ac:parameter ac:name="atlassian-macro-output-type">INLINE</ac:parameter>
    <ac:rich-text-body>
      <p> </p>
    </ac:rich-text-body>
  </ac:structured-macro>
</p>

Panel

titleColor	white
titleBGColor	green
title	Pro tip

Image Removed

When creating a field with predefined options, choose select for drop-down menus, check for checklist, or autocomplete for input field with live search.

...

Versions Compared

Old Version 2

New Version Current

Key

Overview

Template elements

System dropdown menu options

Objective field

Step-by-step Guide field

Code

Next