Skip to content

Commit f1f0075

Browse files
authored
Merge pull request #565 from TheThingsNetwork/docs/brand-alignment-2026-10
Theme: brand harmonization with www (page header, tokens, Poppins 600, links)
2 parents 3d69270 + 0cad15d commit f1f0075

53 files changed

Lines changed: 1466 additions & 398 deletions

File tree

Some content is hidden

Large Commits have some content hidden by default. Use the searchbox below for content that may be hidden.

‎README.md‎

Lines changed: 17 additions & 3 deletions
Original file line numberDiff line numberDiff line change
@@ -27,9 +27,23 @@ Nav hrefs are root-relative and prefixed with `params.ttnOrigin` (default
2727
`https://www.thethingsnetwork.org`); for a local all-in-one preview run Hugo with
2828
`HUGO_PARAMS_TTNORIGIN=http://localhost:3000`.
2929

30-
Section landing pages can use the `lead`, `actions`/`button`, `chapters`, `feature` and `topics`
31-
shortcodes (see `doc/content/lorawan/_index.md`); a section's numbered course is its `chapters`
32-
front matter and its topic index the `topics` front matter.
30+
Fonts, brand tokens and the page header (`tn-ph`) come from `doc/assets/css/ttn-tokens.css` and
31+
`doc/static/fonts/ttn/`, also **generated** by the platform repo (contract: its
32+
`docs/brand-page-header.md`). Re-export them after a token, font or page-header change there:
33+
34+
```
35+
node scripts/export-brand-tokens.mjs <path to this repo>/doc/assets/css/ttn-tokens.css <path to this repo>/doc/static/fonts/ttn ../fonts/ttn
36+
```
37+
38+
`doc/assets/css/docs.css` holds only the docs' own components; it uses the shared tokens and keeps
39+
the header/footer rules identical to the website's `site.css`.
40+
41+
Every page with the left navigation opens with the page header (`layouts/partials/docs/page-header.html`):
42+
breadcrumb, an eyebrow (the page's sidebar group), the title, a lede (the `lead` front matter, else
43+
`description`) and buttons (`actions` front matter: `label`, `ref` or `href`, `style`, `icon`,
44+
`icon_before`). Section landing pages can also use the `chapters`, `feature` and `topics` shortcodes
45+
(see `doc/content/lorawan/_index.md`); a section's numbered course is its `chapters` front matter and
46+
its topic index the `topics` front matter.
3347

3448
## Getting Started
3549

‎doc/assets/css/docs.css‎

Lines changed: 236 additions & 212 deletions
Large diffs are not rendered by default.

0 commit comments

Comments
 (0)