This repository contains the website of the Digital Humanities at the University of Bern. The data in this repository is openly available to everyone and is intended to support reproducible research.
The structure of this repository follows the Advanced Structure for Data Analysis of The Turing Way and is organized as follows:
.github/- GitHub configuration files (issue templates, workflows)..venv/- Python virtual environment for website build.assets/- Images, stylesheets, JavaScript files.docs/- Documentation assets for README.md.content/- Website content: projects, services, events, news posts.teaching/- Teaching pages: programme overview, semester pages, planner, application.intro-lecture/- The online lecture Digital Humanities β Introductions; its source material (transcripts, lecture overviews, quiz sources) is inintro-lecture/_src/, which Quarto does not publish.renv/- R environment for website build.
- Teaching is linked directly under
dhbern.github.io/, for example dhbern.github.io/introduction-to-dh/, dhbern.github.io/dh-lab/, dhbern.github.io/teaching/ and dhbern.github.io/intro-lecture/. A course is either its own DHBern repository with GitHub Pages (introduction-to-dh,dh-lab,dh-lecture-series) or a top-level folder in this repository (teaching/,intro-lecture/). - Projects, services, events and news are under
dhbern.github.io/content/, for exampledhbern.github.io/content/projects/β¦ordhbern.github.io/content/events/β¦.
When you add a top-level teaching folder to this repository:
- Pick a name that no DHBern repository uses: a repository with GitHub Pages is served at the same path and the two would collide.
- Add the folder to
link-external-filterin_quarto.yml; otherwise links to it get the external-link icon (see #133). - When a page moves, keep its old URL working with
aliases:in the front matter.
The site is available under two main domains:
graph TD
A["dhbern.github.io"] --> A1["News Blog"]
A --> A2["Events"]
A --> A3["Projects"]
A --> A4["Services"]
A --> A5["Teaching (top level)"]
B["dh.unibe.ch"] --> B1["Studies (official regulations)"]
B --> B2["Team"]
Diagram: Overview of content domains for the public site and official university site.
-
Content at https://dhbern.github.io/ includes:
- π° News and blog posts
- π Events
- π§ͺ Projects
- π Services
- π Teaching: programme overview, course sites and the online lecture
-
The official DH Bern university pages at https://www.dh.unibe.ch/ cover:
- π Study programmes (official pages and regulations)
- π₯ Team information
- β€ Changes to the team page are made via this Office form (contact: Dominik Kilchmann).
graph TD
root(content/)
sub1[projects/] --> pj1[project-shortname/]
pj1 --> pjindex[index.qmd]
pj1 --> pjpost[YYYYMMDD-shortname-post/index.qmd]
pj1 --> pjevent[YYYYMMDD-shortname-event/index.qmd]
sub2[services/] --> sv1[service-shortname/]
sv1 --> svindex[index.qmd]
sv1 --> svpost[YYYYMMDD-shortname-post/index.qmd]
sv1 --> svevent[YYYYMMDD-shortname-event/index.qmd]
sub3[posts/] --> pst1[YYYYMMDD-shortname/]
pst1 --> pstindex[index.qmd]
sub4[events/] --> ev1[YYYYMMDD-shortname/]
ev1 --> evindex[index.qmd]
root --> sub1
root --> sub2
root --> sub3
root --> sub4
Diagram: Folder layout for the content/ directory, reflecting the siteβs hierarchical structure.
-
content/projects/project-shortname/index.qmdProjects live here and can contain nested posts or events. -
content/services/service-shortname/index.qmdServices must includecategories: [Services]in the YAML header. -
content/posts/YYYYMMDD-shortname/index.qmdNews/blog posts requirecategories: [Post]. -
content/events/YYYYMMDD-shortname/index.qmdEvent entries requirecategories: [Event].
- π· News posts:
categories: [Post] - π Events:
categories: [Event] - π Services:
categories: [Services]
All must be named index.qmd and reside in correctly named folders.
We recommend using GitHub Codespaces for a quick and reproducible setup.
-
Fork this repository to your GitHub account (if needed).
-
Click the green
<> Codebutton at the top right of this repository. -
Select the βCodespacesβ tab and click βCreate codespace on
mainβ. GitHub will now build a container that includes:- β
Node.js (via
npm) - β
Python with
uv - β
R with
renv - β Quarto
- β
Node.js (via
-
Once the Codespace is ready, open a terminal and preview the documentation:
uv run quarto preview
π©βπ» Setup Locally (Advanced Users)
- Node.js
- R and Rtools (on Windows)
- uv (Python manager)
- Quarto
Note:
uvinstalls and manages the correct Python version automatically.
# 1. Install Node.js dependencies
npm install
# 2. Setup Python environment
uv sync
# 3. Setup R environment
Rscript -e 'install.packages("renv"); renv::restore()'
# 4. Preview documentation
uv run quarto previewLint files (Prettier check):
npm run checkFormat all files (Prettier):
npm run formatGenerate CHANGELOG.md:
npm run changelogPreview the documentation:
uv run quarto previewThis project is maintained by @DHBern. We encourage open support channels, so others can benefit.
| Type | Platforms |
|---|---|
| π¨ Bug Reports | GitHub Issues |
| π Report Bad Data | GitHub Issues |
| π Docs Issues | GitHub Issues |
| π Feature Requests | GitHub Issues |
| π‘ Security Vulnerabilities | See SECURITY.md |
| π¬ General Questions | GitHub Discussions |
Upcoming priorities are tracked through the issue tracker and ongoing site development work.
Contributions are welcome! Report problems, propose changes, or submit new features via issues or pull requests. See CONTRIBUTING.md for details.
We use SemVer. See tags for available versions.
- Moritz MΓ€hr β Initial work β @maehr
See also the list of contributors.
- Data: Creative Commons Attribution 4.0 International (CC BY 4.0) β see LICENSE-CCBY.
- Code: GNU Affero General Public License v3.0 β see LICENSE-AGPL.


