projectdoc Toolbox

List of macros provided by the projectdoc Toolbox.

Macros of the projectdoc Toolbox

The projectdoc Toolbox provides a large number macros that help teams to create and maintain their project documentation.

Especially important are the display and transclusion macros. These macros help to reuse information from other pages to create a modular documentation. There are also macros to fetch information from remote information systems and macros to support template designers creating their own templates.

The video (about 3,5 minutes) is based on a Prezi presentation: projectdoc Macros

It shows a short listing of all projectdoc macros. This overview provides brief visual clues on how to use these macros. For detailed information, please follow the links on this page.

 

For more videos, please refer to Screencasts for projectdoc or jump to the projectdoc playlist at YouTube.

Or step through at your own pace with with our Prezi Presentation!

Related Documentation

The following links direct you to related documentation within this wiki.

 

Note that many projectdoc macros only work with projectdoc documents!

A projectdoc document is a Confluence page using the projectdoc Document Properties Marker Macro.

This macro contains a table with document properties.

 

The Macros Introduction helps you to learn about the projectdoc macros in different usage scenarios.

# Name Short Description Categories
1
Renders an action button to link to a projectdoc document, Confluence page, or external resource.
Visual
2
Render the property value of an ancestor of this document, for the first ancestor that matches the specified document type.
3
Renders apanel with title and body, layouted with a custom CSS configuration.
Visual
4
Access properties from aspect documents.
5
Autoconnect to aspect documents.
6
Access sections from aspect documents.
7
Renders a document graph in a graph language allowing the body to contain arbitrary content (including transclusions).
Graph
8
Renders a breadcrumb for the current page.
9
Renders a box containing a caution message.
Box / Reader
10
Renders document history information.
11
Renders the list of child documents, matching the given filter criteria.
12
Renders a cite to a resource document.
Resource / Cite
13
Passes a text containing placeholders to the Code Block Macro. The placeholders are replaced by the properties of a document and/or the space properties.
Visual
14
Renders wiki syntax as a definition list. Does allow HTML tags and therefore is vulnerable to XSS attacks.
Visual
15
Renders wiki syntax as a definition list. Does not allow any HTML tags.
Visual
16
Marks a piece of content within a document. This content can be referenced for transclusion.
Transclusion / Marker
17
Renders the count of rows, list items, or definition terms.
Visual
18
Renders template button to create a page. After the page is created, the macro renders a link to this page. 
Creation
19
Renders term and definition information as a definition list. Currently Conflucene does not easily support authors to write definition lists. But definition lists allow to render this form of information efficiently.
Visual
20
Renders a box containing a deprecation warning for the reader.
Box / Reader
21
Displays all properties of a document as a writing tool for authors.
Development
22
Renders all properties referenced by the current space.
Development
23
Renders a template with property references.
Display / Property
24
Renders the value of a document property as an image. The property value is required to an URL that points to an image.
Display / Property
25
Renders the value of a property of a document.
Display / Property
26
Displays a single property of a document that is referred by a property of another document and concatenates it with the value of a local property.
Display / Property
27
Displays a document property from a referenced document.
Display / Property
28
Lists references to projectdoc documents in a list. List contain names and optional short descriptions.
Display / Query
29
Lists references to projectdoc documents in a list. List items are defined by templates referencing properties.
Display / Query
30
Renders a space attribute value.
Display / Property
31
Renders a space property value.
Display / Property
32
Lists references to projectdoc documents in a table. Allows to select document properties for columns. Also non-list representations are provided.
Display / Query
33
A table containing document properties. Three columns: name, value and meta data (aka controls) to a property.
Transclusion / Marker
34
A table supplying additional document properties from an attached file.
Transclusion / Marker
35
Import properties from another projectdoc document.
Transclusion / Marker
36
A table containing additional document properties. Three columns: name, value and meta data (aka controls) to a property.
Transclusion / Marker
37
Renders an image generated from an Enterprise Architect diagram, transcluded from a server.
38
Renders an example within a box.
Box / Reader
39
Renders a locale dependent link to an external resource. The body of the macro contains the link label.
40
Renders a quote to an external resource with author and source.
Resource / Quote
41
Renders a box containing a fault message reported by a team member for the author.
Box / Collaboration
42
Renders a box containing a feedback message from a reader with write privilege.
Box / Collaboration
43
Generic boxes help to easily define one's own boxes to apply certain CSS styles to them.
Box
44
Renders a document graph in a graph language.
Graph
45
Hides a text fragment from an anonymous user.
Hide
46
Hides a page fragment from a user with read-only permissions.
Hide
47
Hides a text fragment from a user that has no edit permissions.
Hide
48
Transclude HTML content from a remote server.
49
Renders simple HTML span elements into a page.
Visual
50
51
Renders an image with an overlay text.
Visual
52
Renders transcluded content fetched from documents of a result set.
Display / Query
53
Renders a table of index entries.
Display / Query
54
Renders a box containing an info message.
Box / Reader
55
Selects an iteration phase from a fixed set of stages.
  • Document / Development
  • Selection
56
57
Renders an block or inline element of a page.
Visual
58
Renders the level of the document within its hierarchy. The level is derived from a parent document's level of the same document type.
59
Lists references to projectdoc documents. The rendering will add a link to a document, if there is a document with the given name hat is added to the body.
60
Lists references to projectdoc documents. The rendering will add a link to a document, if there is a document with the given name.
61
62
Renders something to note by the reader.
Box / Reader
63
Supports page inclusion dependent on the space of the primary page.
Visual
64
Renders the property of the parent document, if it has the same doctype.
65
Renders a box containing a pending message to be handled later by the author.
Box / Collaboration
66
Renders the value of a document property from the primary page.
Visual
67
Renders a box containing an open question.
Box / Reader
68
Renders a quote from a resource with author and source.
Resource / Quote
69
Transcludes random content from a document marked with the content marker macro.
Transclusion / Reference
70
Renders a box with references to further information.
Box / Reader
71
Renders a name list while taking care of special role semantics. Confluence names of groups with view permissions are added to the list of values.
72
Renders a section, if the body is not empty. Supports authors to create content, clutter-free rendering without empty sections. Allows to transclude the content.
Transclusion / Marker
73
Lists macros that allow to select from a fixed set of values. These macros are used to define the range of document property values. So they are a tool for template authors.
74
75
76
Renders spaces with their attributes in a table or list.
Space
77
Renders the stakeholder rating that is based on the power and interest of a stakeholder in the project.
78
Present a step-by-step guide. Use the Section Macro to define each step with a section inside the steps macro.
Visual
79
80
Transcludes a snippet from a project on a Subversion (SVN) server.
81
Renders an image transcluded from a remote server.
82
83
Transclude content from a resource from a remote system.
84
Merges tables (and lists) into one table (or list).
Visual
85
Applies a simple set operation on tables in its body.
Visual
86
Lists references to projectdoc documents. The rendering will add a link to a document, if there is a document with the given name hat is added to the body.
87
Renders a name list while taking care of special tag semantics. Confluence labels are added virtually to this list and displayed in the tags table row of the document properties table.
88
Transclude text content from a remote server.
89
Renders a box with a tip for the reader.
Box / Reader
90
Renders a predefined list of documents in a table . Documents are selected by a document property. Allows to select document properties for columns. Also non-list representations are provided.
Display / Query
91
Renders a predefined list of documents in a table.
Display / Property
92
Renders transcluded content fetched from documents of a result set.
Display / Query
93
Transcludes content from a document marked with the content marker macro.
Transclusion / Reference
94
Transcludes content via a reference from a document marked with the content marker macro.
Transclusion / Reference
95
Transcludes content from a document marked with the content marker macro and renders it as plain text.
Transclusion / Reference
96
Renders a user story of a user story doctype.
Visual
97
Renders a hint to warn the reader about something.
Box / Reader
98

Resources

More information on macros from the projectdoc Toolbox.

Macros Introduction
This is a gentle introduction to the core macros. The macros are grouped semantically to make it easier for users to build a conceptual mind map for them.
Categories of Information System Macros
Overview over the different categories of macros that are part of the Information Systems Extension.