Commit Graph

38 Commits

Author SHA1 Message Date
Johannes Kirschbauer
dd29ae4ccb pkgs/nixos-render-docs: fix included content should be 'page' to avoid class collisions 2026-08-07 17:16:57 +02:00
Johannes Kirschbauer
a98c685b18 doc/style.css: add dark mode to sidebar 2026-07-18 12:21:03 +02:00
Johannes Kirschbauer
e6eb0f8830 doc/style.css: fix .nav-sidebar class selector 2026-07-18 11:37:16 +02:00
Johannes Kirschbauer
fc182eeca8 pkgs/nixos-render-docs: add auto-highlight toc
Added an intersection observer, that adds 'active' and 'active-trailing'
classes to the toc
2026-07-16 16:18:14 +02:00
Johannes Kirschbauer
b54016c89c docs: add header feature to nrd to inject a custom headers (#535662) 2026-07-13 13:10:07 +00:00
Johannes Kirschbauer
4388cd791a doc/doc-support: inject custom header via nixos-render-docs --header 2026-07-13 14:30:39 +02:00
Johannes Kirschbauer
69640f6d1f doc/style.css: clamp content max-width 2026-07-12 21:33:32 +02:00
Johannes Kirschbauer
9ccbbb9c9a doc/style.css: use major second scale for headings (#540393) 2026-07-11 19:47:57 +00:00
Johannes Kirschbauer
ae2e8f41c5 doc/style.css: use major second scale for headings 2026-07-10 17:15:32 +02:00
Johannes Kirschbauer
e6b7601eb7 doc/style.css: add pill background to inline-code 2026-07-10 16:44:33 +02:00
Johannes Kirschbauer
fcb65cb49d doc/styles: distinct colors for admonitions (#538119) 2026-07-04 16:30:37 +00:00
Johannes Kirschbauer
140264dc32 pkgs/nixos-render-docs: remove dead {examples,figures} table
It is emited into the output but we set 'display: none
2026-07-03 15:59:05 +02:00
Johannes Kirschbauer
ced951f38c doc/style.css: make admonition styles container-agnostic 2026-07-03 15:51:11 +02:00
Johannes Kirschbauer
b2f49162a5 doc/styles: distinct colors for admonitions
Made sure every text-background pair passes WCAG-AA
https://webaim.org/resources/contrastchecker/
2026-07-03 15:25:48 +02:00
Johannes Kirschbauer
e4f7bfed18 pkgs/nixos-render-docs: add sidebar-open and popover for mobile support 2026-07-02 17:17:25 +02:00
Johannes Kirschbauer
ad97f5573d pkgs/nixos-render-docs: replace inlince tocs with collapsible sidebar
tables of contents disconnect headings from body text.
decouples heading levels from include type (part,chapter,part etc.)
structure of the sidebar is derived from the include type for now.
Can be changed to a meta file later.

sidebar now uses proper ol-, li-, span-, a-tags
definition tables are not ideal for navigation and accessibility

breaking change:
--toc-depth, --chunk-toc-depth, --section-toc-depth is
now collapsed into --sidebar-depth
2026-07-02 15:44:56 +02:00
Johannes Kirschbauer
f51d8dfb42 pkgs/nixos-render-docs: introduce sidebar navigation 2026-06-18 11:54:43 +02:00
isabel
0613730f2f doc: style important admonishments 2026-05-11 09:43:44 +01:00
Cassie
c90739d2c6 doc: add content-visibility: auto
adding `content-visibility: auto` to `.chapter` improves rendering
performance by skipping the rendering of off-screen content of the
manual.
2026-03-18 01:57:13 -06:00
Wolfgang Walther
3c0eec6236 doc: fix biome linting errors 2025-08-20 15:41:45 +02:00
Wolfgang Walther
46df6abf87 doc: apply safe formatting with biome 2025-08-20 15:41:40 +02:00
Marcell Tóth
c11863f1e9 doc, nixos/doc: include roboto font
Roboto was already set as the font for the manuals,
but without a way to get it, so people who didn't
happen to have it installed saw their default font
2025-04-21 13:18:05 +02:00
Marcell Tóth
4885c47f70 doc, documentation-highlighter: use variables & add dark mode 2025-04-21 13:18:05 +02:00
Marcell Tóth
4c446a479e doc: center align appendices 2025-04-21 13:18:05 +02:00
Marcell Tóth
6919a0d046 doc, documentation-highlighter: format css 2025-04-21 13:18:05 +02:00
Daniel Sidhion
1ee0e2dcfe doc: improve the look of terms in definition lists (#313891) 2024-05-31 16:26:48 +02:00
Silvan Mosberger
62c8b542c3 Merge pull request #301439 from DanielSidhion/unselectable-prompt
doc: make prompts unselectable on the manuals
2024-04-04 16:52:32 +02:00
DS
14d67caaa4 doc: make prompts unselectable on the manuals 2024-04-03 22:41:13 -07:00
DS
2ce2079e4d nixos-render-docs: make examples collapsible by default 2024-04-02 21:48:03 -07:00
Daniel Sidhion
a1581a3647 doc: fix and simplify stylesheets for the manuals, fix nrd bug (#295847)
* doc: fix and simplify stylesheets for the manuals, fix nrd bug

* Add anchorjs script to add links on section headers

* Fix another nrd bug, address style changes

* Use span instead of a for inline span syntax
2024-03-16 20:16:59 +01:00
Jörg Thalheim
06bcc2dee3 manual: limit text width
Currently the manual scales to the view port of the browser.
This leads to an unreadable layout and I found myself
reading the xml source instead.
The optimal width would be around 50 characters per line.
Since we have code listings also in the manual I relaxed
this limit a bit towards 70 characters per line.
2019-01-08 15:08:42 +00:00
Graham Christensen
8f33464ca7 nixos docs: syntax highlight
- Rectifies diverging CSS by combining
   nixos/nixpkgs docs CSS
 - Moves our custom Highlight.js loader in to
   the hljs package
 - Switches the nixos docs to use SVG
   callouts too
2018-04-05 07:54:01 -04:00
Graham Christensen
8dac5ce146 nixpkgs docs: syntax highlight 2018-03-26 21:44:24 -04:00
Graham Christensen
da17974541 Move the overridden CSS to overrides.css which can be applied on nixos.org 2018-03-26 14:45:00 -04:00
Graham Christensen
a80856cec5 nixpkgs docs: Use SVGs for callouts 2018-03-26 14:08:36 -04:00
Eelco Dolstra
09ab016c6c * Sync CSS with the Nix manual.
svn path=/nixpkgs/trunk/; revision=34062
2012-05-11 21:42:00 +00:00
Eelco Dolstra
921c08c7b3 * Start of Nixpkgs 0.10 release notes.
svn path=/nixpkgs/trunk/; revision=6676
2006-10-06 13:37:31 +00:00
Eelco Dolstra
6eff2a5ff8 * NEWS in DocBook.
svn path=/nixpkgs/trunk/; revision=4627
2006-01-30 17:34:34 +00:00