Thursday, July 20, 2017

Feature of the Week: Smart bibliographies for Jekyll web pages

If you like Jekyll for rendering web pages then check out the new Jekyll plugin for BibSonomy. If you do not know Jekyll, yet, you might check out its web site and then test the plugin.

What it is

Jekyll is an easy-to-use but powerful generator for static web pages which is used to render HTML pages on GitHub and GitHub pages. It is also quite flexible, since its functionality can be extended by plugins that, for instance, create tag clouds, embed maps, or generate a sitemap.
Recently, we have released the first version of a Jekyll plugin for BibSonomy which renders bibliographies (publication lists) in Jekyll-generated web pages using data from BibSonomy. Every time the site is built, the plugin retrieves the latest posts from BibSonomy and renders them in one of the many thousand available CSL styles. Optionally, the plugin can download and link documents associated with a post and render an Altmetric badge for each publication with a DOI. For instance, my publication list is rendered using a slightly adapted Springer LNCS stylesheet with some CSS that colourises the item bullets in the list using the DBLP color coding scheme for different publication types.

How it looks



The color of the bullets indicates the publication type: conference papers are blue, journal articles are magenta. An entry with an Altmetric badge looks as follows:



How to use

Using the plugin is quite simple: just add some lines of configuration to your site’s _config.yml file and then place the bibsonomy tag into the page where you want the bibliography to be rendered.
  1. First, add the dependency to the plugin to your Gemfile:

    source "https://rubygems.org"
    
    gem 'bibsonomy-jekyll'
    

  2. The most basic configuration just enables the plugin and provides your user name and API key:

    gems:
      - bibsonomy-jekyll
    
    bibsonomy:
      user: yourusername
      apikey: yourapikey
    

    You can get your BibSonomy API key from the settings page.
  3. Options for customization in the bibsonomy section include:

    document_directory: pdf
    style: acm-sig-proceedings
    altmetric_badge_type: 4
    

    where:
    • the document_directory specifies a directory where documents attached to posts shall be downloaded from BibSonomy and linked on the page. If empty, no documents are downloaded.
    • style specifies the name of a CSL style which should be contained in the Ruby CSL library or provided as a file with the same name and the file name extension .csl.
    • altmetric_badge_type adds a HTML <span> element to each publication with a DOI that renders the Altmetric badge with the corresponding id, when the required JavaScript is included on the page.
  4. Now a bibliography can be rendered on any page by including the bibsonomy tag:

    {% bibsonomy user yourusername myown 3 %}
    

    This would render the latest three posts of the user “yourusername” which have the tag “myown”. A variable number of tags can be provided (separated by space) and instead of a user’s posts the posts of a group can be rendered by exchanging user with group followed by the corresponding group name.

That’s it. More details can be found in the plugin’s documentation.

Happy bookmarking!

Saturday, July 15, 2017

Yesterday's Downtime

Dear BibSonomy users,

yesterday, we experienced a short downtime of our servers. This was due to a large number of documents being uploaded at once which made one of our servers freeze.

However, we fixed that issue and made sure that it won't happen again. If you still encounter any bugs or unexpected behavior, let us know by either posting an issue in our issue tracker or by dropping us an email at webmaster@bibsonomy.org :)

Happy tagging
Thomas

Friday, June 23, 2017

Feature of the week: BibSonomy Scholar with seamless posting

We previously posted about our BibSonomy Scholar Chrome extension here and here. We have further improved it and are now scraping the BibTex from Google Scholar itself in order to support more a hassle-free posting experience. It works a lot faster now and always works. Previously the posting process often broke due to unknown publisher pages or broken scraping programs. One downside of this is that Google Scholar often provides rather incomplete or plainly wrong BibTex entries. To cope with this we added a BibTex-preview button so that you can check the posted information beforehand. Overall the extension works a lot smoother now and we hope you like it. Let us know if you find any issues.

Happy posting
Martin

Wednesday, June 7, 2017

Typo3 Plugin: New Version Released!

Hi community,

we just released a new version of our Typo3 plugin for BibSonomy! We fixed some issues and added some features:

  • Capitalization issues fixed
  • Improved 'notes' placement
  • PDFs are now opened in a new tab
  • completed DBLP-like sort
Have fun with using BibSonomy :)
Best
Thomas

Saturday, May 27, 2017

HTTP access will be disabled in September 2017

From September 2017 on access to BibSonomy will only be possible via TLS encrypted connections (that is, HTTPS). BibSonomy’s REST API support HTTPS for some time and in September 2016 we had introduced SSL support for the BibSonomy web pages. This ensures that all your data is encrypted on the way to your browser to protect your privacy. In September we will disable unencrypted access to BibSonomy, that is, all non-encrypted (HTTP) requests to BibSonomy will be redirected using HTTP 301 responses to the corresponding HTTPS (SSL) pages. For browser-based access this should not make any difference, however, some plugins and extensions that are using the REST API might be affected by this.

BibSonomy integrates well with other services and tools but the underlying source code might not be able to properly resolve the HTTP redirects, yet. Therefore, in case your service or tool is relying on a connection to BibSonomy, please check whether it properly supports HTTP redirects or migrate it directly to use HTTPS (which is our suggestion). We have already migrated the PHP client library as well as the Typo3 extension. The Python and Ruby clients also already support HTTPS. The source code of other extensions is available on BitBucket and we appreciate any help in the migration effort. Please submit pull requests for the libraries and tools you are using.

We hope that our move towards encrypted-only access does not cause any problems and that you will have enough time until September to migrate your code.

Popular Posts