Home

Integration with your own website

There are several ways to incorporate BibSonomy content or links to BibSonomy into your own website.

Bookmark Links

Many websites provide links or buttons on their web pages to allow visitors to share it easily in social networks or bookmarking services. You can add such a link for BibSonomy on your own website or blog using a short JavaScript snippet that can be found on the Browser Add-ons & Bookmarklets page and on the JavaScript codesnippet page.

Tag Clouds

BibSonomy offers the possibility to integrate its tag clouds, for example for your publications, into your private website. For this purpose BibSonomy provides a JSON feed for tags which is processed by JavaScript snippets. At the moment this feature is only available for the BibTeX page, but will be extended to all pages offering tag clouds in the near future.
Have a look at the example and test the different arguments in the form. The tag cloud belongs to the following publication:

Andreas Hotho and Robert Jäschke and Christoph Schmitz and Gerd Stumme. BibSonomy: A Social Bookmark and Publication Sharing System. Proceedings of the Conceptual Structures Tool Interoperability Workshop, 2006.

Proceed as follows to integrate a tag cloud into your page:

  • Insert these lines into your HTML code where the tag cloud shall be shown:

    <div id="tags"> 
    <div class="title">${project.name} Tags</div> 
    <ul id="tagbox" class="tagcloud"></ul> 
    </div>
    
  • Include a reference to the processing JavaScript file (The JavaScript file can be found here):

    <script type="text/javascript" src="tagCloud.js"> 
    </script>
    
  • If you want to format your tag cloud like in the example above, use this CSS file and include it as follows. If you do not like this particular style or it just does not fit to your existing website style, you can of course use your own stylesheets.

    <link rel="stylesheet" type="text/css" href="tagCloud.css" />
    
  • Finally, you need to activate the JavaScript function getTags(). You have to enter three arguments.

    • First, the URL providing the JSON feed. For example /json/tags/bibtex/1d28c9f535d0f24eadb9d342168836199 for all tags related to that publication.

    • The second argument is the limit of tags to retrieve.

    • Finally, the order of the tags. You can choose between an alphabetic order using the keyword alpha or a tagcount order using the keyword frequency.

      The following example retrieves 25 tags related to that publication in alphabetic order. The tag cloud will be filled in dynamically with the retrieved tags.
      getTags(/json/tags/bibtex/1d28c9f535d0f24eadb9d342168836199, 25, "alpha")

You can find another tutorial on how to integrate tag clouds into your website on this page.

Post Lists

Embed a list of posts (e.g. your own publications) on your own website in the same way they look in BibSonomy. Just include an iframe in your HTML code that looks like this:

<iframe name='my publications' 
    src='<URL>' 
    height='400' 
    width='100%' 
    style='border: none;'>
<p>
  Unfortunately, your browser is not capable of showing embedded frames (iframes).
</p>
</iframe>

The URL can be any BibSonomy page, e.g. your user page or the page of your group. It is important to add the URL parameter format=embed. For example, http://www.bibsonomy.org/user/jaeschke/myown?items=1000&resourcetype=publication&sortPage=year&sortPageOrder=desc&format=embed displays all (up to 1000) publication posts of the user jaeschke that are tagged with "myown", sorted by year descending.

JSON feed

For every BibSonomy page you can get a JSON feed of it by prepending json/ to the path part of the URL, e.g., to get the JSON feed for /tag/json, use the page /json/tag/json.

This gives you an Exhibit compatible JSON feed including all bookmark and publication posts of the respective page. To include the JSON feed into your Exhibit, add a link to it into the header of your Exhibit HTML code.

<link href="http://www.bibsonomy.org/tag/json?callback=cb" type="application/jsonp" rel="exhibit/data" ex:jsonp-callback="cb" />

Have a look at this list of publications to see what is possible using JSON and Exhibit with only some lines of HTML.

Users of our existing JSON feed should note that the format was slightly changed:

  • The tags are now contained in the list with the key items and not tags.
  • The name of the tag is expressed using the key label and not name.
  • There are two more lists (types and properties) to allow easier Exhibit integration.

TYPO3

Our TYPO3 extension BibSonomy CSL allows you to create publication lists containing bibliographic references stored at BibSonomy or tag clouds from your BibSonomy tags. The extension helps researchers to easily organize publication lists in TYPO3, both for personal home pages or to list publications of a research group or project. With BibSonomy CSL you can display publication lists/tag clouds choosing one of many available bibliographic styles from the Citation Style Language (CSL). Individual styles can easily be added. Furthermore, you may choose to make documents (attached to the BibSonomy posts) available for download, to provide preview images and to reference BibTeX or Endnote. To install the extension please visit the official BibSonomy CSL page in the TYPO3 extension repository. The TYPO3 extension is an open source project.
For more information, read the tutorial about TYPO3 integration.

WordPress

For WordPress there is a plugin to create publication lists from posts stored in BibSonomy. To render the list, you can choose one of many available bibliographic styles from the Citation Style Language (CSL). Individual styles can easily be added. The plugin allows the direct integration with BibSonomy: You can integrate publication lists into your blog posts or pages. It allows you to offer your documents (attached to your posts) for download and to render preview images.
For further information and download, read our WordPress tutorial.

XWiki

To integrate BibSonomy into a XWiki page, proceed as follows:

  1. Make sure the XWiki RSS Feed Plugin is installed in your XWiki instance by editing your xwiki.cfg file (it is installed by default).
  2. Edit the wiki page where you want to display BibSonomy data.
  3. Enter the following code activating the XWiki RSS macro
    rss:feed=/publrssN/user/username?items=1000
    where the feed parameter is linked to the RSS data you want to get displayed on that page.
  4. Save the page.

The BibSonomy data should then be displayed on your page.

If you want to customize the way each feed item gets displayed, you can use XWiki Velocity or Groovy Scripting features as shown in this Groovy example:

feed =}} 
{{xwiki.feed.getFeeds("http://www.bibsonomy.org/publrssN/user/username?items=1000")}} 
{{for (entry in feed.entries) {}} \\ {{desc = entry.getDescription().value}} 
{{println("{pre}")}} 
{{println(desc)}} 
{{println("{/pre}")}} 
{{ } 

Example: Nepomuk publications

Zope

You can integrate BibSonomy content into the content management system of Zope.

Posts
Lists of posts can be displayed using the BibSonomy RSS feed on your Zope page. Have a look at the detailed description of the RDF Summary product of Zope.

Tag clouds
In Zope, tag clouds can be created following our tutorial.