Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.

...

Section
titleParameters


Section
titleDocument

The title of the document to link to.


Section
titleAnchor

The Anchor allows to define a document fragment to reference on the target document.

The anchor value may have one of two forms:

  1. If the first character is a hashmark (#), then the anchor is used verbatim as fragment part of the generated URL
  2. If the first character is not a hashmark (#), then the anchor is a section title and a proper anchor is derived

So if the reference is to a section using the Section Macro, simply add the title of the section. If the user knows the identifier or anchor in the HTML code, use that identifier an put a hashmark (#) in front. In case the content is part of a Confluence page then the generated anchor typically includes the title of the page as a prefix (separated by a single dash '-').

Example Box
titleValid values: Section Titles and Identifiers
  • My Section Title
  • #my#Pagetitle-my-element-id
  • #myAnchorName

There is an 

Static Document Link
documentArtificial Properties
labelartificial property
named 
Static Document Link
documentprojectdoc Anchor IDs in Document Part References
 that lists all anchor identifiers used in a document.

Info Box
titleLimitations on Drafts

The macro checks the page contents on the server. If users need to reference to a new section on a document and the draft has not already been saved automatically, the macro does not yet have access to the new section. The workaround here is to save the page and open it again. Sometimes it works to change to the preview of the page.



Section
titleLabel

The label to render instead of the document name.

It may contain property placeholders (like ${Title})  of the referenced document.


Transclusion
taget-heading-level*
documentWiki Link Macro
idsLower Case



Section
titleTooltip

Allows to override the tooltip which defaults to the short description provided by the referenced document

It may contain property placeholders (like ${Name} ${Short Name})  of the referenced document.


Section
titleCSS Classes

The optional CSS classes to add to the link.

Version Box
since4.10

The default class 

Static Document Link
documentprojectdoc-intra-site-link
is added per default.



Section
titleLink Render Control

Control how the link is rendered if the target document does not exist.

Valid values are:

Definition List


create-linkRender a link to create a document (default)
emptyRender nothing
plain-textRender the link label.




Transclusion
taget-heading-level*
documentWiki Link Macro
idsAbbreviation Mode, Blueprint



Section
titleRequest Parameters

Request parameters allow to call a Remote Controlled Document (e.g. using the Display Table Macro).

The left side (value) of the parameter assignments will be URL encoded. The expected pattern is

Code Block
id-x:name1=value A, value B&id-y:$<name2>=[some value]


Note Box
titleRemote Controller

This macro passes the Remote Controls via HTTP request parameters. Other Remote Controllers do this via macro parameters set in the rendering context.



Section
titleRequest Toggle Label

In case the macro adds request parameters it is able to react to a request that contains these request parameters with matching values. In case the macro is called on a page with its request parameters it will render the provided label and will not add its request parameter. This effectively allows the macro to toggle between two states: one in which the macro applies the request parameters and uses its standard label and one in which the request parameters are not applied and the toggle label is used.


Section
titleRequest Toggle Tooltip

Set the tooltip for the link when in the toggled state. This tooltip is only shown withe the 139101337 Request Toggle Label.

If the toggle state for Remote Control is not in use, this parameter has no effect. To enforce this feature the 139101337 Request Parameters and the 139101337Request Toggle Label must be specified. Whenever the macro recognizes that its request parameters are set, it enters the toggle state.


...