Use the The Caption Reference Macro to link a Caption Item Macro that you have created to the section where you are working creates a link to the captioned item you created using the Caption Item macro.
| Info |
|---|
To work with Caption Reference, you must install Numbered Caption application. For more information, see Installation. |
| Panel |
|---|
| panelIconId | 2757 |
|---|
| panelIcon | :exclamation: |
|---|
| panelIconText | ❗ |
|---|
| bgColor | #FFEBE6 |
|---|
|
You must specify the Anchor name in the Caption Item macro to generate a link using the Caption Reference macro. |
This page provides you with information about the following articles:
| Panel |
|---|
| panelIconId | ca67b37b-d17a-40e7-8f28-b8fdae9705cf |
|---|
| panelIcon | :number_caption: |
|---|
panelIconText | :number_caption: |
|---|
|
Parameters |
The following table provides you with a description of the parameters:
Parameter Name | Default | Mandatory | Description |
|---|
Confluence page | Current page | ❌ No | Enter the name of the page containing the Caption Item macro. Leave the parameter blank if you want to refer to the caption item from the same page. |
Anchor name | ❌None | ✅ Yes | Enter the name of the anchor that you used when you captioned content using Caption Item macro. The list of Anchor names accessible on the page you selected is displayed, and you can select from the list. |
Show caption text | Unchecked | ❌ No | Check this box to display the caption text that you entered while captioning content. |
Override link text | ❌ | ❌ | To over the caption None | No | Enter the text to be displayed as a reference to link the content. | Note |
|---|
This option overrides all default formats, displaying only the text you specified as a reference link to the content. The Show caption text is disabled automatically if you enter the Override link text. |
|
| Info |
|---|
To change parameter configuration, refer to Configuration. |
| Panel |
|---|
| panelIconId | ca67b37b-d17a-40e7-8f28-b8fdae9705cf |
|---|
| panelIcon | :number_caption: |
|---|
| panelIconText | :number_caption: |
|---|
| bgColor | #EAE6FF |
|---|
|
Working With Parameters |
...
| Status |
|---|
| colour | Yellow |
|---|
| title | Example 1 |
|---|
|
| Expand |
|---|
| title | Confluence page: default; Anchor name: specified; Show caption text: default; Override link text: default. |
|---|
|
This will display the reference in the following format: Format: Caption (number)
 Image Added |
| Status |
|---|
| colour | Yellow |
|---|
| title | example 2 |
|---|
|
| Expand |
|---|
| title | Confluence page: default; Anchor name: specified; Show caption text: checked; Override link text: default. |
|---|
|
This will display the reference in the following format: Format: Caption (number): Caption text
 Image Added |
| Status |
|---|
| colour | Yellow |
|---|
| title | example 3 |
|---|
|
| Expand |
|---|
| title | Confluence page: default; Anchor name: specified; Show caption text: checked; Override link text: specified. |
|---|
|
This will display the reference in the following format: Format: Override link text
 Image Added |
| Status |
|---|
| colour | Yellow |
|---|
| title | Example 4 |
|---|
|
| Expand |
|---|
| title | Confluence page: specified; Anchor name: specified; Show caption text: unchecked; Override link text: default. |
|---|
|
This will display the reference in the following format: Format: Caption (number) ((page name))
 Image Added |
| Status |
|---|
| colour | Yellow |
|---|
| title | example 5 |
|---|
|
| Expand |
|---|
| title | Confluence page: specified; Anchor name: specified; Show caption text: checked; Override link text: default. |
|---|
|
This will display the reference in the following format: Format: Caption (number) Caption text ((page name))
 Image Added |
| Status |
|---|
| colour | Yellow |
|---|
| title | example 6 |
|---|
|
| Expand |
|---|
| title | Confluence page: specified; Anchor name: specified; Show caption text: checked; Override link text: specified. |
|---|
|
This will display the reference in the following format: Format: Override link text
 Image Added |
| Panel |
|---|
|
Creating ‘Caption Reference' Macro |
To create a LaTeX Math Block Caption Reference macro, Perform the following steps:
...
Click the
+ icon. Search for the
Caption Reference macro.
...
(or) you can type { caption, the list with caption macro suggestions is displayed, and you can select the Captioned Item macro.
...
Select
Caption Reference and click
Insert. The
Insert '
Caption Reference' Macro window is displayed.
...
Enter the following details and click
Insert.
(Optional)Confluence page Anchor name(Optional)Show caption text(Optional) Override link text| Info |
|---|
For more information, refer to Parameters. |
| Panel |
|---|
| panelIconId | ca67b37b-d17a-40e7-8f28-b8fdae9705cf |
|---|
| panelIcon | :number_caption: |
|---|
panelIconText |
|---|
| :number_caption: | bgColor | #EAE6FF#FFFFFF |
|---|
|
Editing ‘Caption Reference’ Macro |
To edit a Caption Reference perform the following:
...
You can change any of the parameters that you want to change and then click the
Save button.
| Panel |
|---|
| panelIconId | ca67b37b-d17a-40e7-8f28-b8fdae9705cf |
|---|
panelIcon |
|---|
| :number_caption: | | panelIconText | :number_caption: |
|---|
| bgColor | #EAE6FF#FFFFFF |
|---|
|
Deleting ‘Caption Reference’ Macro |
To delete a Caption Reference, select the block and click the Remove button. The block is deleted.
...