Skip to content

XRobot Style conformance for the docs, Onboarding and the robot arm - #30

Merged
Jiu-xiao merged 5 commits into
devfrom
style/xrstyle-conformance-20261014
Oct 14, 2026
Merged

Jiu-xiao merged 5 commits into
devfrom
style/xrstyle-conformance-20261014

Conversation

@Jiu-xiao

Copy link
Copy Markdown
Member

Brings the documentation pages, the Onboarding page and the robot arm widget in line with XRobot Style.

  • Reading layer (xrstyle-reading.css): tables, inline code, blockquotes and figures use square corners; hr and the long-code fold use solid fills instead of gradients; active sidebar, TOC and breadcrumb items use weight 700 instead of 650; the fold toggle and the back-to-top label use the label type size; tables use tabular figures and their frame follows the columns.
  • Onboarding: reads and writes the Docusaurus theme key (the old xrobot_onboarding_theme key is still read as a fallback) and applies the theme from an inline script in <head>, so the page opens in the theme picked on the site. Button labels and the footer note lose their emoji.
  • Favicon: the square mark (static/img/favicon.svg), ink on light and paper on dark browser chrome, instead of the 2000x1500 wordmark PNG. The intro page shows the wordmark through ThemedImage.
  • Robot arm: the animated part takes its colours from the page's CSS variables when a frame is drawn; the copy of the colour tokens in armRig.js is removed. The drawing output is unchanged for every key pose in both themes.
  • Removes five HPM setup screenshots that no page references.

static/img/XRobot.png stays because libxr's doc/header.html loads it from xrobot.work as the API docs favicon.

… Style requires

Tables, inline code, blockquotes and figures lose their 2-4px radius; the hr
and the long-code fold use solid fills instead of gradients; the active
sidebar, TOC and breadcrumb items use weight 700 instead of 650; the fold
toggle and the back-to-top label use the label type size. Tables get tabular
figures so the perf columns line up.
The page stored its theme under its own key, so a reader who picked a theme
on the site got the other one here, and the theme was applied only after the
page scripts ran. It now reads and writes the Docusaurus key "theme" (the
old key is still read as a fallback) and applies the theme from an inline
script in <head>. Button labels and the footer note lose their emoji.
…creenshots

The favicon is the square mark (static/img/favicon.svg), ink on light and paper
on dark browser chrome, instead of the 2000x1500 wordmark PNG. The intro page
shows the wordmark through ThemedImage (ink file on light, paper file on
dark), so the invert filter for the PNG goes away. The five HPM setup
screenshots are not referenced by any page.

static/img/XRobot.png stays: libxr's doc/header.html still loads it from
xrobot.work as the API docs favicon.
The moving part of the arm was drawn with a copy of the colour tokens of both
themes in armRig.js, so a change to xrstyle-tokens.css or
xrstyle-materials.css reached the still frame but not the animated one. arm.ts
now reads the resolved values from <html> when a frame is drawn, and the copy
is gone. The drawing output is unchanged for every key pose in both themes.
The beat's hero accent, which XRobot Style does not have and the teach motion
does not draw, maps to ink.
Infima displays tables as blocks so wide ones scroll; the frame then ran to
the full text width while narrow tables ended halfway, leaving an empty framed
area. fit-content with max-width: 100% keeps the frame on the columns and the
scrolling for wide tables.
@Jiu-xiao
Jiu-xiao merged commit c9384ae into dev Oct 14, 2026
2 checks passed
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