Repository navigation
Restyle the guide with a swappable ND Studio-inspired preset - #1
Merged
Merged
Conversation
Layer a token-driven stylesheet over Just the Docs, inspired by ndstudio.gov: white page, near-black ink, square corners, hairline rules, tight tracking, one blue link colour, plus a dark theme. No logos, images or font files are copied from that site. - Theme presets in docs/_data/themes (ndstudio, classic). A preset is a flat list of tokens; head_custom.html emits them as --nd-* CSS variables for light and dark, and all site CSS in docs/_sass/custom/nd reads only those variables. - Light/dark button at the top right of the side menu (assets/js/theme-toggle.js); the choice is saved in this browser, otherwise the site follows the device setting. - GSA emblem, small and centred above the site name at every screen width (title.html; `seal`, `seal_alt` in _config.yml and the `seal-size` token); note in the sidebar footer saying the guide is a GSA open source project under the GSA Open Source Policy. - Dark-mode treatment for code, callouts and the copy button; the pipeline figure keeps its own light background. - Home page headline and lede use the display style. - New page contributing/styling.md explains how to make a preset; .github/scripts/ check_theme.py checks WCAG AA contrast in both themes, token parity across presets, and that the stylesheet holds no literal colours. Linked from Contributing and Tooling. The stylesheet stays plain old-style SCSS (no @use, no mixins) because the Pages build uses an old Sass. site check: unchanged (23 R11 errors about missing generated slide images were already present); tests: unchanged (1788 of 1789 pass, 1 skipped).
This branch was successfully deployed
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Sign up for free
to join this conversation on GitHub.
Already have an account?
Sign in to comment
1 participant
Add this suggestion to a batch that can be applied as a single commit.This suggestion is invalid because no changes were made to the code.Suggestions cannot be applied while the pull request is closed.Suggestions cannot be applied while viewing a subset of changes.Only one suggestion per line can be applied in a batch.Add this suggestion to a batch that can be applied as a single commit.Applying suggestions on deleted lines is not supported.You must change the existing code in this line in order to create a valid suggestion.Outdated suggestions cannot be applied.This suggestion has been applied or marked resolved.Suggestions cannot be applied from pending reviews.Suggestions cannot be applied on multi-line comments.Suggestions cannot be applied while the pull request is queued to merge.Suggestion cannot be applied right now. Please check back later.
Layer a token-driven stylesheet over Just the Docs, inspired by ndstudio.gov: white page, near-black ink, square corners, hairline rules, tight tracking, one blue link colour, plus a dark theme. No logos, images or font files are copied from that site.
seal,seal_altin _config.yml and theseal-sizetoken); note in the sidebar footer saying the guide is a GSA open source project under the GSA Open Source Policy.The stylesheet stays plain old-style SCSS (no @use, no mixins) because the Pages build uses an old Sass. site check: unchanged (23 R11 errors about missing generated slide images were already present); tests: unchanged (1788 of 1789 pass, 1 skipped).