Versions Compared

Key

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

Scenario

Linking can add identifier identifiers to your page titles. With this, you can name your catalogue catalog pages or series of assets, projects, components, ideas, or configuration pages with an ID as a prefix or postfix.

By using the Using the Child Counter Supplier, you can make use of the number of children pages as ID.

Check this in action in on our demo site!

Result

...

Recipe

Apps

Linking for Confluence Server

Platform

Server and Data Center

Level

Intermediate

Estimated time

10 minutes

Macros

Add Page

Suppliers

Child Counter Supplier

Storage format

You can copy and paste this code into the Confluence Source Editor:

Code Block
breakoutModewide
<h2>Assets</h2>
<hr/>
<p>
  <ac:structured-macro ac:macro-id="77455a8b-7630-4234-a312-4cbb39c4e516" ac:name="children" ac:schema-version="2">
    <ac:parameter ac:name="sort">title</ac:parameter>
  </ac:structured-macro>
</p>
<p>
  <ac:structured-macro ac:macro-id="45601cb2-e628-4967-8e21-941f97cdeff8" ac:name="add-page" ac:schema-version="1">
    <ac:parameter ac:name="prefix">Asset #%child-counter:next &gt; number:000% - </ac:parameter>
    <ac:parameter ac:name="linkText">Document new Asset</ac:parameter>
  </ac:structured-macro>
</p>

...

  1. Add an Add Page macro.

  2. Add a title for the Create link text field, e.g., 'Document new Asset.'.

  3. Since we want to automatically add an ID at the beginning of the pages (created by the link), fill out the Prefix parameter:

    Code Block
    Asset #%child-counter:next > number:000% - 

    What this means:

    1. Every page title will have the text 'Asset #' text at the beginning.

    2. Followed They are followed by the number of children on the page (as an ID). Here, we use an 'injection' notation with a key from the Child Counter Supplier. The notation 'number:000' defines the format of the number, e.g., '001', '002', and so on.

    3. When clicked, users will be prompted to complete the title of the page, e.g., 'Asset #054 - Laptop'.

  4. Add a Children Display macro to display the children pages created by the Add Page macro.

  5. You can alter or reset the counter provided by the Child Counter Supplier. See Child Counter Status for more information.

...