Page Comparison

Single

Cite

A single cite (e.g. the reference to a book) is reflected by

this macro.

You have to specify a unique ID, an optional

location (like a page number) and can select some options:

• Use superscript: If checked the number will be displayed as superscript

• Define only: If checked a hidden cite definition is generated that can be referenced later

• Bibliography output: If checked output the output will be in the format citeID: cite. This option is suitable when building bibliography pages. This option overrides other output options.

The actual citation must be entered in the macro body - you can define any markup Confluence allows.

Single

Cite Basic

This macro offers

a similar functionality as the one above but only allows

limited formatting. This macro was introduced to mitigate the inline-rendering issue mentioned above.

You can add internal and external links to a plain cite.

Single

Cite Short

Once a cite has been fully qualified by the single cite macro it is possible to use that macro to refer to the same reference again just using the unique ID and the page-range if needed.

DOI Cite

With the DOI cite macro you can refer to a DOI (Digital Object Identifier) which automatically gets rendered in the specified CSL style (e.g. apa).

The DOI 10.1109/VETECS.2010.5493979 requested in apa CSL style results in:

Kusume, K., Dietl, G., Abe, T., Taoka, H., & Nagata, S. (2010). System Level Performance of Downlink MU-MIMO Transmission for 3GPP LTE-Advanced. 2010 IEEE 71st Vehicular Technology Conference. doi:10.1109/vetecs.2010.5493979

BibTeX File Cite

BibTeX Direct Cite

The BibTeX File Cite macro allows you to reference to a cite provided in a BibTeX file (*.bib). Simply specify the bib-file and provide the cite ID from the bib-file. You also have to define the CSL style (e.g. apa).

You can select bib-files attached to any Confluence page or specify an URL. When using an URL please note that only https-connections are accepted.

The BibTeX Direct Cite macro allows you to enter a single BibTeX cite directly.

Single

Cite Import

You may use this macro to refer to a cite you defined on another Confluence page. Simply select the page you want to import the cite from and specify the ID of the cite.

Cite Summary

At the end of a page containing cites you will probably want to have a reference section which shows you all the references you made in the article. This is achieved by the Cite Summary Macro.

Space

Cite Summary

The space cite summary macro allows you to specify a list of spaces (comma-separated list of space keys) and then shows all cites used in these spaces. The table generated allows to get an overview of e.g. which pages refer to a certain reference like a standard.

BibTeX

Listing

Show a listing of all BibTeX cites of the given bib-file.

Please note that the BibTeX listing is rendered when you insert it. Subsequent changes of the bib file to not change the listing unless you update the macro-

PDF/Word export times out

In case you have many cites (> 100) on a page it might happen that the generation of a PDF or Word document times out. The reason is that Confluence Cloud requests each cite in a row not parallel. There is currently no mitigation.

Migration from Server or Data Center

Please refer to migration guide for further details.