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”
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”
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.
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)
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