Technical information; Installation, Reference of TypoScript, configuration options on system level, how to extend it, the technical details, how to debug it.
language should be technical, assuming developer knowledge of TYPO3. Small examples/visuals are always encouraged.
Target group: Developers
Your username at http://www.bibsonomy.org. If you don't have a username yet, you can register for free here http://www.bibsonomy.org/register. Please note that it is not mandatory to have an account in order to use this extension; however, if you do not have an account, you can only display publications or tags from other people (who have an account) with this extension. For a typical scenario, we recommend that you create an account so that you have full control over the data to be displayed in your publication list or tag cloud.
This setting is optional, you can use the plugin without a BibSonomy account; but if you would like to include your own publications or tags, you have to register an account.
The API-key is a replacement for your BibSonomy password, which you shouldn't tell anyone. You can find your API key (being logged in to BibSonomy) here http://www.bibsonomy.org/settings?seltab=2.
This setting is optional, you can use the plugin without a BibSonomy account; but if you would like to include your own publications or tags, you have to register an account.
Here our server (http://www.bibsonomy.org) is preselected and can't be changed. If you have a special setting where you want to change this setting, contact us via email: webmaster@bibsonomy.org.
This setting controls the citation style of your publication list. We support some standard formats (e.g. harvard, din1505), but you can also upload a custom layout (in the format of a JabRef export filter, see here http://jabref.sourceforge.net/help/CustomExports.php) and create a custom export format. Layout which end with 'year' are grouped by year. See the next section ('Available Layouts') for details on which layouts are available. This setting is only relevant when the checkbox 'include publications' below is checked.
With this setting you control which content is to be displayed in your publicatio list and / or your tagcloud. Suppose you want to include all publications of the user 'dbenz', tagged with the tag 'myown'. On BibSonomy, you would use the URL http://www.bibsonomy.org/user/dbenz/myown. For the content field of this extension, you would use the same, but without the host – so you would enter '/user/dbenz/myown'. A full description of the BibSonomy URL scheme is found here http://www.bibsonomy.org/help/basic/semantics.
The content from BibSonomy is encoded by default in UTF-8. This should be appropriate in most cases. If you have a system running with ISO-8859-1, then you can check this checkbox in order to convert the content to the correct encoding. In any case, if you have trouble with the display of special characters (e.g. ä, ö, ...), then contact your system adiminstrator to find out on which encoding your typo3-installation is based.
If you want to include a tagcloud, check this checkbox. Which tags are to be displayed is controlled by the 'content' field. If you have chosen '/user/dbenz/myown' as content, then your tagcloud will contain all tags (or all related tags, this is controlled by the 'related tags' checkbox, see below) from http://www.bibsonomy.org/user/dbenz/myown. The number of tags to be displayed is controlled by the 'tagcloud size' parameter (see below).
Choose whether to include a publication list. If this checkbox is checked, all publications as selected by the 'content' field (see above) will be displayed in a list, formatted according to the chosen layout (see above). Please note that it is possible to display both publications AND a tagcloud at the same time.
The number of tags to be displayed in the tagcloud. This is only relevant when the checkbox 'include tagcloud' (see above) is checked. When you choose e.g. '100', then the top 100 tags (i.e, the most often used ones) will be included in the tagcloud.
Controls which kind tags are displayed. For some contents (e.g. /user/dbenz/myown), two types of tags are available: First, all tags of user 'dbenz', and second all tags related to the tag 'myown'. Related tags are hereby all tags which co-occur at least once with the tag 'myown'. As you will have noticed, related tags are only available when the content selector contains another tag (here 'myown'). In such a case, when checking this checkbox, the related tags will be displayed instead of all tags.
The layouts control the citation style of your publication list, e.g. the formatting of the author(s), the order of display (e.g. first title, then year, or the other way round) and the general formatting rules for each entry (e.g. put brackets around the year, ...). We offer some standard layouts like Harvard or DIN1505; each layout can be grouped by year (e.g. 'din1505year'). We also support custom layouts.
Output formatted in an author-date style. See http://library.canterbury.ac.nz/services/ref/harvard.shtml for some explanation.
Output formatted according to DIN-1505-2 (see http://de.wikipedia.org/wiki/DIN_1505-2).
An adaption of the din1505 layout, with additional links to BibTex and further information resources.
BibSonomy allows the upload of a custom layout filter for each user. You can upload your own custom filter here http://www.bibsonomy.org/settings?seltab=3 (being logged in); the filter has to be in the JabRef export filte format (see here for a detailed description: http://jabref.sourceforge.net/help/CustomExports.php). When choosing the 'custom' layout, then your personal uploaded custom filter will be used to create your publication list. Please note that it is in this case necessary that you spedify your BibSonomy username and API key when setting up the extension (see above).
