projectdoc Toolbox

Shows what to expect when using variables in 'User Created Templates' or 'Global Templates'.

Audience
Type
Level of Experience
Contents

In Confluence, there are two categories of page templates (see Create a Template):

  • Space templates: These page templates are available in a specific space only.
  • Global templates: These page templates are available in every space on your site.

Confluence's template editor can be used to insert variables into your template that will be queried later - when creating a page based on that template.


Use Variables With Care

 

Variables can be inserted directly into a page, into the body of a macro or - using the source code editor - into macro definitions.

Please note that the source editor often corrupts the template source, so its use is not recommended.

A damaged source of a page often cannot be repaired. You may have to delete the template and start over.

The free projectdoc blueprints typically use variables inside macro definitions. This does not cause any problems when used outside the template editor. The template editor does not allow placeholders inside macro definitions, so it will corrupt templates that use them. Therefore: do not edit blueprint templates that use placeholders with the template editor!

The Source Code Editor

Allows users to view and edit the underlying storage format. When the plugin is installed and enabled on your Confluence site, users will see the new source editor button <> in the editor toolbar.

For more information, see the Atlassian Marketplace entry for the Source Editor.

Summary

Consider the following:

Use Variables With Care

 

Please note that the source code editor often corrupts the template source code, so its use is not recommended in connection with the projectdoc Toolbox.

A damaged source of a page often cannot be repaired. You may have to delete the template and start over.

Resources

Here are more resources related to the topic of this article.

Create a Template
This page explains the following:  Add a template, The template editor, Template variables, Labels, Images and other  ttachments, Instructional text, Add a description to your template, Edit or delete a template.
Atlassian Marketplace entry for the Source Editor
Allows users to view and edit the underlying storage format.