How to use the "Bibliography - Literature Management"-Macro?
Using the spacewide Literature Management
Apart from adding individual Literature Lists to Confluence Pages, you can also use the spacewide Literature Management:
In the respective space, you will find the spacewide Literature Management in the left navigation panel at “Apps”
Once there, it is the same as it is for Literature Management Lists on pages.
You will find the list settings to choose a name and displayed properties at “Settings”
CAUTION
Currently it is not possible to add attachments in the spacewide Literature Management.
Adding the macro to a page
To add the literature management macro to a page:
Go into the edit mode of the respective page
Open the macro browser and select the “Bibliography - Literature Management”-Macro
Tip
You can also type “/Bib” and insert the macro.
Configuring the macro
After adding the macro to your page, you can configure it:
Click on the macro and then on the edit-icon
Set a list name to find your list later
Set the maximum number of entries, which will be displayed without paginating the list
Choose the attributes you want to be displayed in your list (make sure they are in the correct order)
Publish the Confluence page
CAUTION
Currently the attributes have to be added in the order you want them to be displayed in the table.
Ordering the table columns is currently restricted by Atlassian Forge UI.
As soon as Atlassian releases this feature, we will implement a more convient configuration of the table.
Adding entries to the list
You can add entries in three different ways to your list. Either by pasting a BibTex, citing a DOI or adding them manually.
To add a new entry, click “Add new”.
Import by BibTex
To import an entry with its BibTex file:
Open the BibTex file and copy the text.
Paste the text into the textfield in the import window
Click on “Import”
Tip
You can also add multiple entries by pasting a BibTex with multiple entries into the textfield.
The maximum size of BibTex entries is 10kB. If your bib-file is larger than that, then please split your entries during copy and pasting.
Import by DOI
To import an entry with its DOI:
Copy the DOI of the article you want to add into the DOI field
Click on “Import”
Let Bibliography do the rest
Add manually
You can also add entries manually, e.g. when something isn’t published yet or you want to add custom entries
Fill out all the necessary fields (keep in mind to choose an unique ID)
Choose a type
Scroll down
Click on “Add”
After importing/adding your entries you can add missing information or correct erros by editing them (see next section)
Editing entries
You can always edit entries and their data:
Click on the edit-icon of the entry you want to edit/change
Do the changes or add new information in empty fields
Don’t forget to click on “Save”
Tip
Add tags to your entries to categorize them further.
Attaching files to an entry and watching them
To complete your bibliography you can link (multiple) files to the entries:
Attach the files you want to link to an entry to the confluence page where the
“Bibliography - Literature Management”-Macro is locatedClick on the attachment-icon of the corresponding entry
In the window you will see which files are already linked to this entry and which files are attached to the page
Remove files by clicking on the “x” or add files from the list below
When you finished kinking attachments, click on “Save”
If you want to open an already attached file, also click on the attachment-icon and then on “Open” of the attached file you want to read. The file will open in a new tab.
CAUTION
You can only link files to an entry which are already attached to the Confluence page,
where your Literature Management-macro is placed on.
Exporting an entry
If you need to use your collected literature somewhere else, you can easily export it to a BibTex file:
Click on the “export”-button of the file you want to have as a BibTex.
Copy the text to your clipboard and paste it into an empty textfile. Save the file as Bibtex-file (.bib)
CAUTION
Currently it is not possible to provide a copy to clipboard button or a download button.
These features are currently restricted by Atlassian Forge UI. As soon as Atlassian releases these features we will implement them.
Also notice that tags won’t be exported to the BibTex file.
Bulk operations
If you want to perform actions on multipe entries of a list, you can do a bulk operation e.g. deleting or exporting multiple items:
Select all the entries you want to perform a bulk operation on by clicking their selection button
or, if you want to perform the operation on all items in the list, click on the “Select all”-button on top of the list.After that either click on “Export” or “Remove” to export all selected entries to a Bibtex file or remove all the entries from the list