This is the Relaton project site, part of Ribose Open Project network, located at

It is a Jekyll-based site created with the Open Project Jekyll theme.

Refer to their respective docs for details.

Content management

Adding new bibliography type

Supported bibliography types are configured in the main _config.yml under relaton.supported_bibliographies, and adding a new type is as easy as inserting an item into that YAML array.

Array item format is described below:

  - id: iso
    # This must be CSS class name compliant, no spaces or non-ASCII characters

    label: ISO
    # Human-readable label, usually organization or standard type

    gem: relaton-iso
    # Name of the corresponding Ruby gem, exactly as listed under `_software/{gem name}.adoc`

      - { url: "", label: " website" }
    # List of sources used by the gem for fetching bibliographies.
    # `url` and `label` are optional, but at least one of those must be present for each source


Getting started

  • Ensure you have reasonable Ruby version

  • Run bundle from within site directory to install Ruby dependencies

Serving site preview

  • Run jekyll serve from within site directory


  1. Ensure tests pass

  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. Make a pull request