Versions Compared

Key

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

Please consider opening a support ticket prior to migration so that we can assists you.

Scope

This guidance explains the migration from Simple Cite Server/Data Center to Cloud.

Feature differences

Due to technical limitations the Cloud version of Simple Cite has some notable differences to the Server/DC version:

Element

Major differences

CSL styles (DOI and BibTeX cites)

In the Server/DC version you define the CSL styles in the Cite Summary. They are then applied to all citations covered by the Cite Summary.

In the Cloud version you must specify the CSL style in each DOI or BibTeX cite.

Single Cite macro

The Single Cite macro exists in Cloud as well but suffers from the in-line rendering issue when used in the new editor.

BibTeX listing macro

This macro does not exist in the Cloud version.

Override citation (DOI and BibTeX cites)

In the Server/DC version you define the citation override in the Cite Summary. It is then applied to all citations covered by the Cite Summary.

In the Cloud version you must specify it in each DOI or BibTeX cite.

Show cites as tooltip

Currently not supported in the Cloud version.

Status after the using Atlassian’s migration assistant

After you have used Atlassian’s migration assistant you should see that the following cites are shown properly:

...

  1. Imported cites

  2. DOI cites

  3. BibTeX cites

Using Simple Cite’s migration support

Note

Before the migration support works you must accept the new app scope (including a write permission). You can do so starting 2022-05-10.

Open the migration support page

Please navigate to

Code Block
<<your url>>/plugins/servlet/ac/de.edrup.confluence.plugins.simple-cite/simple-cite-migration

...

Code Block
https://example.atlassian.net/wiki/plugins/servlet/ac/de.edrup.confluence.plugins.simple-cite/simple-cite-migration

Configure your migration and execute it

...

Please define all space keys of the spaces for which you want to migrate the citations. In the example above two spaces will be migrated (space with space key HR and SWD). You can now simulate the migration or execute it. During the migration the app will create a new page version of all pages containing cites which need to be migrated. It performs the change under your name. Therefore please ensure that you have to corresponding permissions.