Name List Macro

...

Section

title	Properties

Section

title	Names

The comma-separated list of document names to reference.

Each name will be rendered as a link to the document, if a document with such a name (and doctype, see next section) exists.

projectdoc-content-marker

id	alsobodylist

projectdoc-section

title	Doctype

The doctype of the documents to select.

Note Box

The name of a document must be unique within its doctype for this macro to work property. It is not possible to reference several documents with the same name and document type.

It is allowed to specify more than one doctype. But keep in mind that the names must be unique for the set of selected doctypes.

Content Marker

id	Commons

Section

title	Empty Where Clause Handling

If unchecked treat an empty where clause as match any (i.e. no constraint) or treat it as no valid match exists (in which case the displayed result is always empty).

Tip Box
You may temporarily uncheck the box to display all possible values.

Section

title	Restrict to one Value

If checked only one value is allowed to be selected.

If more than one value is provided before projectdoc 1.16.0 only the first value is rendered. Since projectdoc 1.16.0 the whole content is regarded as one single value and will not be split up.

Available since version 1.11, changed since 1.16.0.

Section

title	Restrict to Range

If checked only values defined by the referenced doctype and constraints are allowed.

The range of valid values is defined by the doctype and the where parameter.

Tip Box
Refer to Define Status Tags for an example on how to define property value ranges.

If authors specify values not within the defined range, they are dropped.

Available since version 1.11.

Note Box
If in addition to the range restriction the one-value restriction is also enforced, only the first value will be taken into account. That is: if two values are specified, where the first is not in the range, but the second is, then no value will be rendered.

Section

title	Render List as comma-separated Values

If checked, the list is comma-separated, otherwise the rendering produces an unordered list. If rendered with commas, the names are always shown as text. Otherwise they may be rendered as boxes.

Please refer to Box Style for details.

Section

title	Property

The name of the property the values in this list are values for. This property is useful for template designers to associate the value with the name of a property.

This allows queries to reference the ancestors of a document referenced here. See Search Tips for details.

Section

title	Space Key

To limit the search on documents to the space with the given key. The editor allows to scan for space names. If you want to select more than one space, use the text field below in addition to this field. Only if no space is specified, the current and its delegate spaces are taken into account.

Section

title	Space Keys

To limit the search on documents to the spaces with the given keys. Use this if you want to search in several spaces. Leave blank, if you want to search in the current space only. Use "@all" to search in all spaces. Only if no spaces are specified, the current and its delegate spaces are taken into account.

Section

title	Where

A Lucene search expression to filter on the results.

For more information on queries, please refer to Search Tips.

Transclusion

document	Search Tips
ids	curly-braces

Section

title	Unique Property

The name of the property to select the document. The property has to be unique and defaults to the Name property.

Section

title	Display Template

Template to render instead of the plain property value.

Version Box

since	1.16

This parameter is supported since version 1.16.

Define property placeholders which will be replaced by the referenced property values. A property placeholder starts with ${, contains the name of the property it is a placeholder for, and ends with a curly brace.

Example Box

Use templates like this to refer to properties.

Code Block

language	text

The $[Name] is not ${Subject}.

The placeholders will be replaced by the values of the property Name and Subject.

The use of $[...] renders a link.

Version Box

Since version 3.1 the use of Deep Links is supported.

Code Block

language	text

The $[Name] is not ${Ref->Type}.

Section

title	Link Properties

Version Box

until	3.0
title	Removed since 3.1
since	1.16

If the Display Template Parameter is specified, name the properties here to render a link to the document the name value refers to.

If none is specified, the whole template value is considered to be the label for the link.

Section

title	Label

In case there is only one name in this list, this label overrides the name.

Version Box

since	2.3

The parameter is available since version 2.3 of the projectdoc Toolbox.

If this macro is used in a section body to reference a document, e.g. a glossary item, then the label being rendered may be different from the name or any other property of the document.

In these use cases, where there is only one name, the label will be rendered instead of the property. This is similar to Confluence links, where per default the title of the referenced document is renders, but the label of the link may be an arbitrary sting.

Section

title	CSS Classes

Set the Cascading Style Sheet (CSS) classes for the rendered reference.

Section

title	Autocomplete Sort

Transclusion

document	Display Document Property Macro
ids	Autocomplete Sort

Section

title	Details

Section

level	2
title	Box Style

Configure the Name List Macro to draws boxes around the referencing names. Per default boxes are drawn for categories and tags. This can be switched on or off by using the space property called name-list-(doctype)-box-style.

The default behavior is configured by the space property name-list-default-box-style.

The syntax for the space property's name is based on this naming scheme:

Code Block
name-list-(doctype)-boxstyle true/false

For example use the following to disable the rendering boxes for categories:

Code Block
name-list-category-boxstyle false

Change the style of the box - most commonly used to change the background color - by adding a document property to the document instance for which you want to change the style.

For instance, if you want to change the background color for the document Example of the doctype Category, add the document property CSS Style Information to the Example document (please refer to Document Properties Marker Macro for more information on document properties and how to add them to a document instance).

Note Box
Since version 1.14 of the projectdoc Toolbox the value for the `CSS Style Information` may not only contain verbatim text. Therefore from that version on you may use macros to construct the value.

Note Box
Since version 2.2.3 of the projectdoc Toolbox the value for the property `CSS Class Information` is supported to set values for the rendered HTML class attribute.

...

Space shortcuts

Page tree

Docs

Support

Free Blueprints

Tooling for Blueprints

Free Extensions

Spaces

Plugins for Maven

Incubator

Libraries for Java

Incubator

Add-ons for Confluence

Tools

Support

Team

Legal

Versions Compared

Old Version 13

New Version 14

Key

About

Keep up-to-date!

Powered by