...
| Document Properties Marker | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
| ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
|
...
| Section | ||||
|---|---|---|---|---|
| ||||
The Wiki Link Macro allows to render links in different ways. When manually compiled in a list, the Table Merger Macro allowed to discard list items with certain properties. For instance blank or simple text. This tip shows how to use tools from the PDAC1 for Confluence to
|
| Section | ||
|---|---|---|
| ||
The Wiki Link Macro allows to control the rendering of links. Dependent on the existence of the target document, the link may be rendered differently, for instance empty or as plain text (without a link).
The reason to render a link to empty could be to not render a reference to an document that does not exist. If you choose to render the label as text, readers would see the link anticipate correctly where a link would be rendered as soon as the referenced document comes into existence. Different These are simply different rendering strategies for different use cases. |
...
| Section | ||
|---|---|---|
| ||
If you have such a link (using the Wiki Link Macro) in bullet list and choose to render a link to a not-yet existing page as empty, there will be a noisy empty bullet point. You could render the link as plain text, which may provide some guidance to users. It can indicate that a piece of information may exist in the future and that here is will be the location of a link in the future. to this piece of information. Doctype add-ons use this approach frequently on space homepages.
Above you see five bullet points, each has a Wiki Link Macro, but only three of them point to existing documents (Profiles, Tours, and Topics). FAQs (rendered as plain text) and Glossary (the last list item which is rendered as empty) point to documents that do not exist. |
| Section | ||
|---|---|---|
| ||
To get rid of the empty unwanted lines in a list of items, the Table Merger Macro – despite of its name – is a handy tool. Wrap the list within the body of the macro. In order to remove the empty line at the end of the list in the example above set the Discard parameter to  The result on discarding empty lines is that the last item is removed:
Discarding empty lines and lines without links by selecting
|
| Section | |||||
|---|---|---|---|---|---|
| |||||
In case you design templates use the Wiki Link and Table Merge Macro like this:
|
| Section | ||
|---|---|---|
| ||
This short tip has shown how to manually construct lists with line items to be rendered or not at request time. The combination of the Wiki Link Macro and the Table Merger Macro supports template authors to manually construct navigation links in lists. |
| Section | ||
|---|---|---|
| ||
...
