Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.
Document Properties Marker
doctypemacro
overridefalse
Short DescriptionRenders a cite to a resource document. 
Doctypemacrohide
NameCite Macro 
Parent
Parent Property
property-nameName
 
Audience
Name List
doctyperole
render-no-hits-as-blanktrue
 
Categories
Tag List
doctypecategory
namesResource / Cite
propertyCategories
 
Tags
Tag List
namesQuote
 
Iteration
Iteration
valueproduction
hide
Sort Keyhide
Section
indextrue
titleDescription

The Cite Macro helps to render cites of resources in a standard manner. While it is easy within the Confluence wiki to add references to pages, a cite asks for more. You may want to add the title of a book, the authors and the page.

This is the template used by the macro to render cites:

Panel
  $[Name] (${Authors}, ${page})
Section
titleProperties

Document

The Resource document to reference. Leave blank, if the citation refers to current resource document.

Template

The template to render the values. If you do not specify a page (refer to 'Source Page'), remove the page from the template.

This is the format of the template:

Panel
  $[Name] (${Authors}, ${page})

Source Page

The page within the resource the citation points to. Usually this takes the form

  • p. 42
  • p. 23f
  • p. 23ff
  • p. 23-42.

Default Value

The default value to render, if the template resolves to a blank value.

Usually the default is a blank value. Set it to a non-blank to make sure that a template resolving to nothing is rendered with an alert message.

Section
titleDetails

Section
indextrue
titleRelated macros

The following macros help with citing or quoting resources:

Display Table
doctypemacro
render-no-hits-as-blanktrue
selectName, Short Description
sort-bySort Key, Name
whereCategories = "Resource / Cite"
exclude-selftrue
Section
indextrue
titleSub-Macros
Display Table
doctypemacro
render-no-hits-as-blanktrue
selectName, Short Description
restrict-to-immediate-childrentrue
sort-bySort Key, Name
Section
titleNotes

Section
titleReferences

Section
titleResources