The bibliography lists the bibliographic references that you have added to your article. To add your references, click on [Manage] in the left side panel, to the right of the Bibliography tab. The Bibliography Manager tool opens and offers you several options:
- Zotero: you can synchronize a bibliography by connecting Stylo to your Zotero account (public or private groups/collections). We reccomend this method. See below for more details.
- Zotero: you can import your bibliography from a Zotero collection of a public gropu by entering the collection’s URL.
- Citations : you can fill in your bibliography manually in BibTeX format.
- Raw bibtex : you can correct the BibTeX directly.
You can directly structure your references in BibTeX, or export your references in bibtex thanks to your bibliography management tool:
Synchronize a Zotero collection #
It is possible to synchronize the references of an article with a collection or sub-collection of your Zotero account or a Zotero group (public or private). Here are the steps to follow:
- In the left panel select the Bibliography tab, then click [Manage].
- Connect your Zotero account with the option “Connect my Zotero Account”.
- A window will open entitled “New Private Key” asking you to validate your connection between Stylo and Zotero. Click on “Accept Defaults”.
- By activating the drop-down list, you can now choose a collection (or sub-collection) from your Zotero account.
- Click on the button [Replace bibliography with this account collection] so that the bibliographic references (these will appear in the left side panel under the bibliography tab)
Here are some important remarks concerning synchronization with a Zotero collection:
- This feature also allows for the importation of collections from public or private groups.
- You cannot import more than one collection.
- Each synchronization or import overwrites your bibliographic data. If you use the synchronization option, we advise that you change your references in Zotero and then re-import them, and so on until you obtain the expected result.
- There is no automatic synchronization. You must re-import each change made in Zotero.
Insert a bibliographic reference #
The insertion of bibliographic references in the text in Markdown must respect a precise syntax to be dynamic. The advantage of integrating bibliographic references in the BibTeX format lies in the possibility of generating dynamic bibliographies and managing several parameters to obtain renderings in line with the editorial line to be adopted.
More information on the BibTeX format here.
In this configuration, a particular syntax is necessary to indicate a reference in the text which we call a citation key whose form is the following:
A citation key is surrounded by brackets
[ ], then is called with the symbol
These are the keys which will then be transformed during export according to the desired standards.
There are several methods for quickly writing these citation keys in Stylo:
An autocomplete feature has been added. Just start by typing
[@ or simply
@ and the text editor will suggest all of your references assocaited with the article. If you wish to refine the autocompletioon, just add the first letter of the author name to reduce suggestions provided:
- You can also click on the icon associated with the reference in the left pane, then paste (Ctrl+V) the reference into the text at the desired location. It will then appear as
[shirky_here_2008]. To explain, one click is equivalent to “copying” the bibtex key of the reference in the clipboard.
Inserting a bibtex key in the body text has two effects:
- The key is automatically replaced by the correct formatted quote call in the body text, for example: (Shirky 2008).
- The complete bibliographic reference is automatically added at the end of the document.
General scenarios #
The Markdown syntax allows you to finely structure your bibliographical references. Depending on your needs, here are different cases to produce the citation call:
[@shirky_here_2008]will produce: (Shirky 2008)
[@shirky_here_2008, p194]will produce: (Shirky 2008, p194)
@shirky_here_2008will produce: Shirky (2008)
[-@shirky_here_2008]will produce: (2008)
For example :
- If you want to quote the author + the year and the page in parentheses:
|In the editor||In the preview|
- If the author’s name already appears, and you just want to add the year of publication in brackets :
|In the publisher||In the preview|
- To avoid repetition of a name, and to indicate only the year, put a
-in front of the key.
|In the editor||In the preview|
Careful: Do not use Markdown syntax to accompany a citation. For example, do not use markings like this:
[shirky_here2008, [link to a website](https://sens-public.org)]