# swiss-ai/www-apertus architecture

> Architecture diagram of the GitHub repository swiss-ai/www-apertus, generated by GitDiagram from its file tree, README and a sample of source files (last updated 2026-11-18). It is an AI-made overview: check details against the source.

- Interactive diagram: https://gitdiagram.com/swiss-ai/www-apertus
- Repository: https://github.com/swiss-ai/www-apertus

## Overview

This repository is the public Apertus website: a Hugo-powered static site presenting the models, research, documentation, and governance. The visitor-facing path is published site → visitor; the content and layouts are inputs to Hugo’s site generation, with GitHub Pages documented as the deployment destination. Content branches preserve the site’s major subject areas. Source excerpts were limited to go.mod, so internal template calls and other unsampled wiring are not shown; relationships below rely on the README’s descriptions.

Main entry points: [`content/pages`](https://github.com/swiss-ai/www-apertus/tree/main/content/pages) (Project pages), [`content/docs`](https://github.com/swiss-ai/www-apertus/tree/main/content/docs) (Documentation), [`content/articles`](https://github.com/swiss-ai/www-apertus/tree/main/content/articles) (News articles), [`content/news.md`](https://github.com/swiss-ai/www-apertus/blob/main/content/news.md) (News index)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_content["Editorial content"]
  node_pages["Project pages"]
  node_docs["Documentation"]
  node_articles["News articles"]
  node_news["News index<br/>[news.md]"]
  node_showcase["Model showcase<br/>[showcase.md]"]
  node_homepage["Homepage content<br/>[_index.md]"]
  node_authors["Author profiles"]
  node_feedback["Contact and feedback<br/>[contact.md]"]
end

subgraph group_presentation["Site presentation"]
  node_layout["Page templates"]
  node_home_layout["Homepage layout<br/>[index.html]"]
  node_partials["Reusable partials"]
  node_shortcodes["Content shortcodes"]
end

subgraph group_assets["Site assets"]
  node_static_assets["Static images"]
  node_source_assets["Processed assets"]
end

subgraph group_publishing["Publishing"]
  node_apertus["Apertus website"]
  node_hugo["Hugo generator"]
  node_github_pages["GitHub Pages"]
end

node_visitor(("Site visitor"))

node_hugo -->|"generates"| node_apertus
node_pages -->|"provides content"| node_hugo
node_docs -->|"provides content"| node_hugo
node_articles -->|"provides content"| node_hugo
node_news -->|"provides content"| node_hugo
node_showcase -->|"provides content"| node_hugo
node_homepage -->|"provides content"| node_hugo
node_authors -->|"provides content"| node_hugo
node_feedback -->|"provides content"| node_hugo
node_layout -->|"supplies templates"| node_hugo
node_home_layout -->|"supplies layout"| node_hugo
node_partials -->|"supplies components"| node_hugo
node_shortcodes -->|"supplies formatting"| node_hugo
node_static_assets -->|"supplies files"| node_hugo
node_source_assets -->|"processed by"| node_hugo
node_apertus -->|"deployed to"| node_github_pages
node_visitor -->|"views"| node_apertus

click node_pages "https://github.com/swiss-ai/www-apertus/tree/main/content/pages"
click node_docs "https://github.com/swiss-ai/www-apertus/tree/main/content/docs"
click node_articles "https://github.com/swiss-ai/www-apertus/tree/main/content/articles"
click node_news "https://github.com/swiss-ai/www-apertus/blob/main/content/news.md"
click node_showcase "https://github.com/swiss-ai/www-apertus/blob/main/content/showcase.md"
click node_homepage "https://github.com/swiss-ai/www-apertus/blob/main/content/_index.md"
click node_authors "https://github.com/swiss-ai/www-apertus/tree/main/content/authors"
click node_feedback "https://github.com/swiss-ai/www-apertus/blob/main/content/contact.md"
click node_layout "https://github.com/swiss-ai/www-apertus/tree/main/layouts/_default"
click node_home_layout "https://github.com/swiss-ai/www-apertus/blob/main/layouts/index.html"
click node_partials "https://github.com/swiss-ai/www-apertus/tree/main/layouts/partials"
click node_shortcodes "https://github.com/swiss-ai/www-apertus/tree/main/layouts/shortcodes"
click node_static_assets "https://github.com/swiss-ai/www-apertus/tree/main/static/images"
click node_source_assets "https://github.com/swiss-ai/www-apertus/tree/main/assets"

classDef toneNeutral fill:#f8fafc,stroke:#334155,stroke-width:1.5px,color:#0f172a
classDef toneBlue fill:#dbeafe,stroke:#2563eb,stroke-width:1.5px,color:#172554
classDef toneAmber fill:#fef3c7,stroke:#d97706,stroke-width:1.5px,color:#78350f
classDef toneMint fill:#dcfce7,stroke:#16a34a,stroke-width:1.5px,color:#14532d
classDef toneRose fill:#ffe4e6,stroke:#e11d48,stroke-width:1.5px,color:#881337
classDef toneIndigo fill:#e0e7ff,stroke:#4f46e5,stroke-width:1.5px,color:#312e81
classDef toneTeal fill:#ccfbf1,stroke:#0f766e,stroke-width:1.5px,color:#134e4a
class node_pages,node_docs,node_articles,node_news,node_showcase,node_homepage,node_authors,node_feedback toneBlue
class node_layout,node_home_layout,node_partials,node_shortcodes toneAmber
class node_static_assets,node_source_assets toneMint
class node_apertus,node_hugo,node_github_pages toneRose
class node_visitor toneIndigo
```

## Components

### Editorial content

- [Project pages](https://github.com/swiss-ai/www-apertus/tree/main/content/pages): `content/pages`
- [Documentation](https://github.com/swiss-ai/www-apertus/tree/main/content/docs): `content/docs`
- [News articles](https://github.com/swiss-ai/www-apertus/tree/main/content/articles): `content/articles`
- [News index](https://github.com/swiss-ai/www-apertus/blob/main/content/news.md): `content/news.md`
- [Model showcase](https://github.com/swiss-ai/www-apertus/blob/main/content/showcase.md): `content/showcase.md`
- [Homepage content](https://github.com/swiss-ai/www-apertus/blob/main/content/_index.md): `content/_index.md`
- [Author profiles](https://github.com/swiss-ai/www-apertus/tree/main/content/authors): `content/authors`
- [Contact and feedback](https://github.com/swiss-ai/www-apertus/blob/main/content/contact.md): `content/contact.md`

### Site presentation

- [Page templates](https://github.com/swiss-ai/www-apertus/tree/main/layouts/_default): `layouts/_default`
- [Homepage layout](https://github.com/swiss-ai/www-apertus/blob/main/layouts/index.html): `layouts/index.html`
- [Reusable partials](https://github.com/swiss-ai/www-apertus/tree/main/layouts/partials): `layouts/partials`
- [Content shortcodes](https://github.com/swiss-ai/www-apertus/tree/main/layouts/shortcodes): `layouts/shortcodes`

### Site assets

- [Static images](https://github.com/swiss-ai/www-apertus/tree/main/static/images): `static/images`
- [Processed assets](https://github.com/swiss-ai/www-apertus/tree/main/assets): `assets`

### Publishing

- **Apertus website**
- **Hugo generator**
- **GitHub Pages**

### Other components

- **Site visitor**

## Connections

- Hugo generator → Apertus website: generates (evidence: `README.md`)
- Project pages → Hugo generator: provides content (evidence: `README.md`)
- Documentation → Hugo generator: provides content (evidence: `README.md`)
- News articles → Hugo generator: provides content (evidence: `README.md`)
- News index → Hugo generator: provides content (evidence: `README.md`)
- Model showcase → Hugo generator: provides content (evidence: `README.md`)
- Homepage content → Hugo generator: provides content (evidence: `README.md`)
- Author profiles → Hugo generator: provides content (evidence: `README.md`)
- Contact and feedback → Hugo generator: provides content (evidence: `README.md`)
- Page templates → Hugo generator: supplies templates (evidence: `README.md`)
- Homepage layout → Hugo generator: supplies layout (evidence: `README.md`)
- Reusable partials → Hugo generator: supplies components (evidence: `README.md`)
- Content shortcodes → Hugo generator: supplies formatting (evidence: `README.md`)
- Static images → Hugo generator: supplies files (evidence: `README.md`)
- Processed assets → Hugo generator: processed by (evidence: `README.md`)
- Apertus website → GitHub Pages: deployed to (evidence: `README.md`)
- Site visitor → Apertus website: views (evidence: `README.md`)
