Skip to content

feat(theme): align the wiki with the redesigned de.NBI Cloud website - #597

Draft
nilshoffmann wants to merge 20 commits into
feat/website-stylesfrom
feat/redesign
Draft

nilshoffmann wants to merge 20 commits into
feat/website-stylesfrom
feat/redesign

Conversation

@nilshoffmann

Copy link
Copy Markdown
Member

Aligns the wiki's look with the redesigned de.NBI Cloud website (deNBI/landing_page, branch feat/cloud-redesign), so moving between the two feels like one site.

Important

Stacked on #595 (navigation and home page). This PR's base is feat/website-styles, so the diff shows only the redesign. After #595 is merged, change the base to dev.

Release: the wiki and the website redesign are reviewed internally and go live together. Don't promote this to main before the website redesign ships.

What changes

Theme: the website's fonts (Raleway, Source Sans 3), colours, content boxes and callouts in wiki/assets/css/denbi.css, and Mermaid diagrams in the same colours.

Header

  • The website's dark quick access bar: "← de.NBI Cloud website", Portal login, Wiki (current), Status with the live status badge from Uptime Kuma, Facility news and Support.
  • A website-style menu row: the de.NBI Cloud logo (links to the website), a "Wiki" wordmark, the wiki's 7 sections in place of Material's tabs, search, the light/dark toggle with the website's icons, and Apply for a project.

Footer

  • Brand column, three link columns (Use, de.NBI Cloud, Legal), a compact row of funder and partner logos, and a legal line with "Edit this page on GitHub".
  • The funder logos are BMFTR and EU NextGenerationEU; the partner logos are ELIXIR and LS Login. All are official artwork, with sources in wiki/assets/images/partners/SOURCE.txt.
  • "Edit this page on GitHub" now opens the editor on dev, not the stale master.

Dark mode: a light version of the de.NBI logo, the official negative EU and ELIXIR logos, and BMFTR on a white panel.

Security page: the six full-width AI illustrations are replaced by an "At a glance" overview and small icon tiles in the de.NBI colours. Heading anchors are unchanged.

Build: the raw theme templates are no longer published under /wiki/overrides/. overrides/main.html was already leaking in production.

Design and plan: docs/superpowers/specs/2026-10-18-wiki-website-chrome-design.md, docs/superpowers/plans/2026-10-18-wiki-website-chrome.md.

How it was checked

  • 70 tests pass (uv run --locked pytest -q): page URLs, header and footer links (including on deep pages and 404.html), logos, accessibility names and the security page.
  • Browser checks with Playwright:
    • 5 pages, in light and dark mode, at 1280px and 360px: no horizontal overflow and no console errors.
    • Search, the theme toggle, anchor links, the phone drawer, cookie settings and print view all work.
  • htmlproofer finds 7 broken external links. All were already there, on content pages this PR doesn't touch.

Notes for reviewers

  • Header and footer links are copied by hand from the website's Wagtail navigation into config.yml → extra: (see README → "Header and footer").

Checklist

  • Please create your PR against the dev branch. (Stacked on feat(wiki): regroup the navigation into seven sections and add the task-based home page #595 for now; retarget to dev once it is merged.)
  • Please wait for all tests to finish.
  • All tests relevant to the changes introduced by this PR must pass. If a test fails due to an issue unrelated to this PR, it does not block this PR and should be handled separately.
  • When adding new documentation or a tutorial, make sure the corresponding Markdown file is linked in config.yml.
  • Once all the above points have been successfully completed, the PR can be merged.

🤖 Generated with Claude Code

nilshoffmann and others added 20 commits November 9, 2026 18:25
…site

- colours: the website's tokens (de.NBI navy, blue and cyan, magenta for
  goals) as a custom Material palette, with a dark-mode version of each;
  bright cyan is only ever a fill with navy text
- type: self-hosted Raleway 600/700 for headings and Source Sans 3
  400/600 for text (latin subsets from @fontsource 5.3.0, OFL), lining
  and tabular numerals; replaces the old Raleway files
- components: white header with navy text, admonitions styled like the
  website's callouts, 8px buttons, borders instead of shadows, and no
  uppercase labels, so de.NBI never renders as DE.NBI
- Mermaid diagrams get the website's figure style through a small
  theme script, because Material renders them in a closed shadow root

Co-Authored-By: Claude Opus 5.5 (1M context) <noreply@anthropic.com>
…website

Design for a two-row header (the website's quick access bar with a link
back to cloud.denbi.de, then logo, "Wiki" wordmark, the wiki sections as
menu, search, theme toggle and Apply), a trimmed website-style footer
with funder and partner logos, and dark-mode treatment. The wiki and
the website redesign go live together after internal review.

Also keeps the brainstorming mockups (.superpowers/) out of git.

Co-Authored-By: Claude Opus 5.5 (1M context) <noreply@anthropic.com>
… footer

Also updates the design with the maintainer's review: aria-current="true"
for the current section and the Wiki quick link, sections in the menu
row from 1220px, and the edit link pointing at main instead of the stale
master branch.

Co-Authored-By: Claude Opus 5.5 (1M context) <noreply@anthropic.com>
The EU NextGenerationEU logo is the official English horizontal version
from the European Commission's download centre, with its official
negative version for dark backgrounds. Sources are in
wiki/assets/images/partners/SOURCE.txt.

Co-Authored-By: Claude Opus 5.5 (1M context) <noreply@anthropic.com>
Co-Authored-By: Claude Opus 5.5 (1M context) <noreply@anthropic.com>
Also stops publishing the raw theme templates under /wiki/overrides/:
the theme folder lives inside docs_dir, so MkDocs copied main.html (and
would copy every new partial) into the site.

Co-Authored-By: Claude Opus 5.5 (1M context) <noreply@anthropic.com>
Logo (links to cloud.denbi.de), "Wiki" wordmark, the seven wiki sections
in place of Material's tabs, palette toggle, search and the Apply button.
The quick access bar scrolls away; the menu row stays sticky, and anchor
links land below it.

Co-Authored-By: Claude Opus 5.5 (1M context) <noreply@anthropic.com>
Brand column and three link columns (Use, de.NBI Cloud, Legal), a
compact logo row (Funded by: BMFTR, EU NextGenerationEU; In
collaboration with: ELIXIR, LS Login) and the legal line. Replaces the
old footer links and social icons.

"Edit this page on GitHub" now opens the editor on dev, the branch pull
requests target, instead of the stale master branch.

Co-Authored-By: Claude Opus 5.5 (1M context) <noreply@anthropic.com>
Darker quick access bar, light de.NBI logo, official negative EU and
ELIXIR logos, and a light panel behind the BMFTR logo. Logos without a
dark-mode variant stay visible in dark mode.

Co-Authored-By: Claude Opus 5.5 (1M context) <noreply@anthropic.com>
… access bar

The Status link carries the same status-page badge as the website's
quick access bar, with state colours that keep 4.5:1 contrast to the
badge's white text. The badge URL is the link's "badge" key in config.yml.

Co-Authored-By: Claude Opus 5.5 (1M context) <noreply@anthropic.com>
Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
Co-Authored-By: Claude Opus 5.5 (1M context) <noreply@anthropic.com>
Co-Authored-By: Claude Opus 5.5 (1M context) <noreply@anthropic.com>
The dark-mode logo twins had empty alt texts while their light twins are
display: none, so in dark mode screen readers lost the names of the logo
links and the EU funding notice. Both twins now carry the name; only one
is rendered per colour scheme.

The drawer title on phones and tablets showed the colour logo on
Material's blue bar, where it was illegible. It now uses the menu row's
colours and the same light/dark logo pair, from one shared partial.

Co-Authored-By: Claude Opus 5.5 (1M context) <noreply@anthropic.com>
Co-Authored-By: Claude Opus 5.5 (1M context) <noreply@anthropic.com>
…r SVG check

The status badge is loaded with referrerpolicy="no-referrer".

The SVG check now also catches event handlers, foreignObject and
references to anything but #ids or embedded raster images. Diagrams in
pages may keep foreignObject, which draw.io uses for labels.

Co-Authored-By: Claude Opus 5.5 (1M context) <noreply@anthropic.com>
…, tidy CSS

- Anchors land the usual 1.2rem below the 72px menu row, using Material's
  own --md-scroll-margin, instead of 83px below it.
- The quick access bar no longer prints; Material already hides the
  header, footer and sidebars.
- Header and search styles now live only in chrome.css: removed rules for
  elements the new header no longer has, gave the search field the
  website's 8px radius and its hover tint, and dropped two !important.

Co-Authored-By: Claude Opus 5.5 (1M context) <noreply@anthropic.com>
…and icons

The six full-width AI illustrations (orange and teal pop-art) did not
match the wiki's colours, filled most of the page and stayed bright in
dark mode. The workplace section now opens with an "At a glance" grid
of six cards, one rule each, and each section heading carries a small
icon tile in the de.NBI colours (from the same icon set as the home
page). Heading anchors are unchanged.

Co-Authored-By: Claude Opus 5.5 (1M context) <noreply@anthropic.com>
…te switch

The switch shows the Material Symbols light_mode (sun) and dark_mode
(moon) icons, the same files as the de.NBI Cloud website's switch,
instead of Material Design Icons' weather-sunny and weather-night.

Co-Authored-By: Claude Opus 5.5 (1M context) <noreply@anthropic.com>
The button uses the colour tokens of the primary buttons in the pages:
blue with white text in light mode, light blue with navy text in dark
mode, like the website. The light and dark mode icons now inherit the
text colour like the other symbol icons, and the icon test covers them.

Co-Authored-By: Claude Opus 5.5 (1M context) <noreply@anthropic.com>
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant