Research Software Directory

What is it?

The Research Software Directory is a content management system that is tailored to research software.

The idea is that institutes for whom research software is an important output, can run their own instance of the Research Software Directory. The system is designed to be flexible enough to allow for different data sources, database schemas, and so on. By default, the Research Software Directory is set up to collect data from GitHub, Zenodo, Zotero, as well as Medium blogs.

For each software package, a product page can be created on the Research Software Directory if the software is deemed useful to others.

What the Research Software Directory can do for you

The Research Software Directory:

presents software packages alongside the context necessary for visitors to understand how the software can help them
makes scientific impact of research software visible in a qualitative way
provides automatically generated citation metadata in a variety of reference manager file formats, for easy citation
improves findability of software packages by applying Search Engine Optimization techniques such as schema.org metadata. This helps search engines understand what a given software package is about, thus improving ranking of search results
provides aggregated insights through a metrics dashboard, helping to make more accurate and more timely business decisions
provides metadata about its software packages via OAI-PMH, the standard protocol for metadata harvesting. Digital libraries and other services can use this feature to automatically update their records with data about the software packages published in the Research Software Directory.
provides all of its data via a JSON API
integrates with third-party services such as Zotero (reference manager), Zenodo (archiving), GitHub (code development platform)

Examples

Try it out

Requirements

You'll need a minimum of about 3 GB free disk space to store the images, containers and volumes that we will be making.
Linux OS (we use Ubuntu 18.04)
docker (v19.03 or later)
docker-compose (v1.26 or later)
git (v2.21 or later)

Instructions

To quickly get a running Research Software Directory up and running on your local machine do the following

Fork this repo to your own GitHub organization or GitHub profile and clone it

Start the complete stack using

cp rsd-secrets.env.example .env
docker-compose build
docker-compose up

Go to http://localhost (disregard certificate warning) to see the Research Software Directory website. You should be able to see all non-authenticated pages, but editing data or harvesting data from external sources won't work. To bring up the website with all bells and whistles, refer to selected resources from the list below.

bramlankhorst / research-software-directory Goto Github PK