docs.trr379.de/content/services/main-website/_index.md

87 lines
3.2 KiB
Markdown

---
title: Main website
weight: 10
---
[This](https://www.trr379.de) is the main website of the TRR379.
This website is not just a public-facing view on the consortium. It is
specifically built to be the core component of the metadata concept of TRR379.
It provides a collection of canonical definitions of entities essential for the
function of TRR379. Such entities include
- projects of the TRR
- contributors to the TRR
- publication from the TRR membership
- site of the consortium
- ...
## Semantics
Any such entity has a dedicated page on the website, with a stable URL that
serves as a [URI](https://en.wikipedia.org/wiki/Uniform_Resource_Identifier)
for that entity. As such, these URLs can be used in any TRR379-related metadata
to declare relationships to TRR379 entities, for example, the authorship of
a publication, the origin project of a data release, etc.
The website is built with the static site generator [Hugo](https://gohugo.io).
It capitalized on its [taxonomy
feature](https://gohugo.io/content-management/taxonomies/). Any page on the
site is built from a metadata record. For Hugo, this metadata is presented in
the form of a page's [front
matter](https://gohugo.io/content-management/front-matter). However, these metadata
may themselves be generated from the result of a database query.
Here is an example record for TRR379 spokesperson Ute Habel:
```yaml
title: Ute Habel
projects:
- a02
- a04
- q01
- q04
sites:
- Aachen
- Juelich
roles:
- pi
- spokesperson
layout: contributor
params:
orcid: 0000-0003-0703-7722
name-title: Prof. Dr. rer. soc.
affiliation: Department of Psychiatry, Psychotherapy and Psychosomatics, Faculty of Medicine, RWTH Aachen University
sortkey: "Habel, Ute"
<additional content on the page's subject>
```
From this information, [the page that identifies and describes Ute
Habel](https://www.trr379.de/contributors/ute-habel) as a spokesperson is
generated. It also links and references her record on the respective pages for
projects, sites, and roles she is associated with. Consequently, the URL
https://www.trr379.de/contributors/ute-habel/ can serve as a URI for Ute Habel
within the TRR379 metadata. Moreover, `ute-habel` is a unique identifier for her
as a contributor to TRR379.
While other special-purpose identification systems exist (e.g.,
https://orcid.org for academics), this approach is automatically applicable to
any concept and entity relevant to TRR379. Including roles, data acquisition
methods, instruments, etc. The domain root `trr379.de` represents a unique
namespace to define and reference any required entities. This enables a timely
and unencumbered development of a metadata concept for TRR379, without
hindering alignment with and mapping to more global efforts and initiatives.
## Look
Structured metadata is rendered to an HTML website with Hugo using a
[template](https://gohugo.io/templates/introduction/). This approach separates
the information from its presentation.
The look of the website can be altered by adjusting the template, or switching
to a different template entirely. This requires familiarity with Hugo and its
templating mechanism.
At present, the [congo template](https://github.com/jpanther/congo) is used.