In order to make full use of the plugin, it makes sense to have an account at http://www.bibsonomy.org. BibSonomy is a free social bookmark and publication sharing platform. You can register for free here:
Here you find a basic introduction what you can do with BibSonomy:
Please note that it is not required to have an account in order to use this extension. Bascially you can include all public content from BibSonomy without being registerd. However, when you want to add content (e.g. publications) which shall be displayed by this extension (e.g. in a publication list), then you need an account.
Install the extension with the extension manager. You can download the extension here: http://typo3.org/extensions/repository/view/ext_bibsonomy/current/
In order to set up a publication list, follow these steps:
Make sure the publication entries you want to include are present on www.bibsonomy.org. In this example we will consider the publications of user 'dbenz' which are tagged with 'myown'; these can be retrieved from BibSonomy via the URL http://www.bibsonomy.org/user/dbenz/myown. See http://www.bibsonomy.org/help/basic#semantics for a detailed description of the BibSonomy URL scheme.
Start to create the publication page by clicking “Create Page content”:
In the following dialogue, choose the BibSonomy Plugin:
In the following Pagecontent configuration dialogue, enter your BibSonomy username and API key (you find your API key after logging in to BibSonomy on http://www.bibsonomy.org/settings?seltab=2), the desired layout and the content. Make sure the checkbox “Include publications” is set; the other settings can be left untouched. Here's a summary of the settings you have to enter:
login-name / api-key: Your BibSonomy username and API-key. As described above, this is only necessary if you do have a BibSonomy account and if you want to display your own posts.
layout: 'mmsyear' is a din1505-like citation style, grouped by publicatio year
content: choose which items to display by the BibSonomy URL scheme; /user/dbenz/myown selects all publications of user 'dbenz' tagged with the tag 'myown'. The parameter 'items=1000' sets the number of items to be included to 1000.
include publications: make sure this checkbox is checked
- That's all! When done, click on 'save document' and your new page containing your personal publication list is done. It should look similar to this:
Enjoy your newly created publication page! It will update automatically as soon as new publications are added in BibSonomy to the account of 'dbenz', tagged with 'myown'.
Tagclouds present a nice way to display meta-information. BibSonomy as a social tagging platform allows the easy creation of these. When you want to include a tagcloud on your webpage to summarize e.g. your research interests, follow these steps:
Follow Step 1-3 from the section above (Quick Start: Include a publication list)
In the following Pagecontent configuration dialogue, enter the following settings:
login-name / api-key: Your BibSonomy username and API-key
content: choose which tags to display. When you want to display all tags used to annotate the publications of user 'dbenz' with the tag 'myown', enter /user/dbenz/myown
include publications: make sure this checkbox is un-checked
include tagcloud: make sure this checkbox is checked
tagcloud size: the number of tags to be displayed, e.g. 100
related tags: make sure this checkbox is checked (explanation below)
That's all! When clicking on 'save document', your new page with the tagcloud is done and will look similar to this:
Enjoy your newly created tagcloud page! It will update automatically as soon as new tags are added to publications in BibSonomy to the account of 'dbenz', tagged with 'myown'.
Q: I've included the plugin as described, but no publications are displayed. What am I doing wrong?A: There may be several reasons for that. Check the following:
Make sure the correct content has been selected in the plugin; e.g. when you've chosen the content '/user/dbenz/myown', then check on http://www.bibsonomy.org/user/dbenz/myown if there are matching publications.
If yes, check whether these publications are visible. If you've posted them as 'private', they won't show up on a public publication list.
Q: I would like to have a custom export format for my publications. Is this possible?A: Yes, that's possible. We are using JabRef layout filters to generate the output (see http://jabref.sourceforge.net/help/CustomExports.php). You can make yourself familiar with these and write your own, or search the web for existing layout filters (e.g. http://www.markschenk.com/tools/jabref/). Then you can upload your custom filter to your BibSonomy account (http://www.bibsonomy.org/settings?seltab=3); then you have to choose the layout 'custom' when setting up the BibSonomy plugin. Voilà :)
Q: How can I control the number of publications to be included in my publication list?A: You can append the parameter 'items=NUMBER' to the content selection field, e.g. /user/dbenz/myown?items=1000
Q: How can I eliminate duplicates in my publication list?A: You can append the parameter 'duplicates=no' to the content selection field, e.g. /user/dbenz/myown?duplicates=no.
Q: Can I group my entries by author, entry type, ...?A: Currently this is not yet possible, but we're working on that. See the section 'To-Do list'.
