Wikimedia::Commoner

A Wikimedia Commons page holds more details than the api provides, e.g. the name of the copyright holder. This can be scraped from the html as a standard format is encouraged with mediawiki templates. It is not foolproof, but will work for most of the images.

This gem is used by OpenPlaques.org to get hold of image links and appropriate copyright holder details so that an image can be legally displayed on a web page.

The idea is that users can copy and paste any Wikimedia filename to your system and you can get the details. It looks for anything with 'File:' in the url, so can cope with different formats coming from preview urls, etc.:

• https://commons.wikimedia.org/wiki/File:Ciconia_ciconia_-_01.jpg
• https://commons.wikimedia.org/wiki/Main_Page#/media/File:Ciconia_ciconia_-_01.jpg
• File:Ciconia_ciconia_-_01.jpg
• https://commons.wikimedia.org/wiki/File:Plaque_in_Fortune_Street.jpg#.7B.7Bint:filedesc.7D.7D

Installation

Add this line to your application's Gemfile:

gem 'wikimedia-commoner'

And then execute:

$ bundle

Or install it yourself as:

$ gem install wikimedia-commoner

Usage

require 'wikimedia/commoner'

wikimedia = Wikimedia::Commoner.details(wikimedia_url) wikimedia[:categories] wikimedia[:url] wikimedia[:page_url] wikimedia[:description] wikimedia[:author] wikimedia[:author_url] wikimedia[:licence] wikimedia[:licence_url])

Wikimedia::Commoner.search 'term'

Wikimedia::Commoner.images 'term'

Wikimedia::Commoner.categorised_images 'category'

Contributing

1. Fork it ( https://github.com/jnicho02/wikimedia-commoner/fork )
2. Create your feature branch (git checkout -b my-new-feature)
3. Commit your changes (git commit -am 'Add some feature')
4. Push to the branch (git push origin my-new-feature)
5. Create a new Pull Request

With thanks to Ross Cooperman for the inspiration with his 2013 commoner gem. I did try a pull request.