Website of the ABCD-J Project

This is a hugo project, meaning that the online website is built from the content of this repository using a static website generator.

This repository is also a DataLad dataset, meaning it is version-controlled with auditable changes.

Edit and test the website locally

In order to work on the website locally and independently clone this dataset and run hugo to serve a website draft on your own computer. The following command achieve that.

With DataLad installed, do the following:

datalad clone ssh://git@hub.datalad.org/ABCD-J/www

# and enter the directory for any of the following commands to work
cd www

This created a clone of the dataset in the directory www. Now obtain the website theme. It provides the website "looks" and is only needed for actually rendering the site, but not for making edits. The next command downloads the theme and all media files. This requires an SSH account on the datalad hub webserver. Contact m.hanke@fz-juelich.de to obtain one.

datalad get -r .

Now you are ready to run hugo. It will build the site and output a URL to open in a browser to test it.

hugo server

Make any edits, test them out locally, then save and push them with datalad push

Adding media files

Media files (images, videos, etc) should not be added directly to the Git repository to avoid bloat and the resulting technical difficulties of maintaining the website.

Instead, media files are added to the repository's annex with DataLad or git-annex. A datalad save -m "<message>" to save an update will do the right thing automatically. If you are using Git directly, instead of using git add <file> use git annex add <file> and afterwards commit normally.

Image properties

Each page can have images. Images should be placed into the directory that contains the _index.md file with the content of that page.

Images should be scaled to a meaningful size to avoid bloat.

• Contributor portraits should be no wider than 400 pixels.
• Page thumbnails should be a minimum of 320x240 pixels. Importantly, they should have an aspect ratio of 4:3.

Contributor pages can declare a particular image to be used as a portrait with the portrait page parameter in the front matter.

It is also possible to use one and the same image as portrait and thumbnail (see page of Michael Hanke). For that to work, the face needs to be centered in the thumbnail image.

Function as a taxonomy

This website is not just a public-facing view on the consortium. It also serves as a collection of canonical definitions of entities essential for the function of ABCD-J. Such entities include

• technologies
• contributors
• sites of the consortium
• ...

Any such entity has a dedicated page on the website, with a stable URL that serve as a IRI for that entity. As such, these URLs can be used in any ABCD-J related metadata to declare relationships to ABCD-J entities.