Skip to content

Adopt skainet-docs-ui v1.1.1 (SKaiNET-branded Antora UI) #53

@michalharakal

Description

@michalharakal

Visual alignment with mainline SKaiNET. Bump `ui.bundle.url` in
`docs/antora-playbook.yml` to the new shared SKaiNET-branded Antora
UI bundle from
`SKaiNET-developers/skainet-docs-ui`.

Mainline SKaiNET adopted the same bundle in
SKaiNET#502.
This issue is the matching change for the transformers docs site.

What changes for the docs site

The bundle ships a complete visual rebrand on top of the upstream
`antora/antora-ui-default` bundle the playbook currently points at:

  • SKaiNET red palette (`#dc2626`) replaces upstream Antora blue
  • Orbitron (display) / Inter (body) / Fira Code (mono) replace Roboto
  • Light + dark theme toggle in the navbar (FOUC-safe via inline head
    bootstrap, persisted via `localStorage`, respects
    `prefers-color-scheme` on first visit)
  • 6px thin custom scrollbar
  • Rounded code blocks with GitHub-light / GitHub-dark backgrounds
    (`#f6f8fa` / `#0d1117`)
  • Primary-red focus glow on interactive elements
  • New SKaiNET footer with cross-repo links to mainline +
    skainet-docs-ui (replaces the upstream "Antora default UI / MPL-2.0"
    boilerplate)
  • `.card-grid` CSS for landing-page card grids (unused on this site
    in this PR — the existing index.adoc with the Key Features /
    Supported Model Families content stays untouched)
  • Mobile responsive (hamburger menu from upstream preserved)

The change in this repo

One line in `docs/antora-playbook.yml`:

```diff
ui:
bundle:

Pinned to `v1.1.1` (not floating on `latest`) so transformers builds
are reproducible. Bumping the pin is a one-line follow-up PR whenever
`skainet-docs-ui` ships a new minor.

Out of scope for this PR

  • Rewriting the landing page with a Diátaxis card-grid. The transformers
    landing has substantial real content (Key Features table, Supported
    Model Families table) and shouldn't be replaced. A future PR could
    add a card-grid SECTION above or below the existing content.
  • Self-hosted fonts. v1.1.1 still loads Orbitron / Inter / Fira Code
    from Google Fonts; can move to bundled @font-face files when
    skainet-docs-ui v1.2 ships.
  • Search wiring.

Metadata

Metadata

Assignees

No one assigned

    Labels

    No labels
    No labels

    Type

    No type
    No fields configured for issues without a type.

    Projects

    No projects

    Milestone

    No milestone

    Relationships

    None yet

    Development

    No branches or pull requests

    Issue actions