T48a Docs · Frame: a Docs tab, /docs/ and /docs/$page/, Markdown guides with a rail, an on-this-page list, previous and next and code blocks; full Rust samples are compiled examples shown as text

frontend/src/styles.css

@@ -9,6 +9,7 @@
   --iso-line: #1a1918;
   --iso-side: #f3f0ec;
   --iso-shade: #e9e5df;
+  --code: #f3f0ec;
   --sans: "Geist Variable", system-ui, sans-serif;
   --mono: "Geist Mono Variable", ui-monospace, monospace;
   color-scheme: light;
@@ -25,6 +26,7 @@
   --iso-line: #d9d5d0;
   --iso-side: #1a1816;
   --iso-shade: #201e1c;
+  --code: #1b1917;
   color-scheme: dark;
 }
 
@@ -162,13 +164,51 @@ img.shot { display: block; max-width: 100%; height: auto; }
 .pager a:hover { color: var(--fg); }
 .pager .next { margin-left: auto; text-align: right; }
 
+.docs { display: grid; grid-template-columns: 200px minmax(0, 720px) 200px; justify-content: center; gap: 64px; padding: 0 64px; }
+.docs-rail, .doc-toc { position: sticky; top: 64px; height: calc(100vh - 64px); overflow-y: auto; padding: 96px 0 64px; }
+.docs-rail ol, .doc-toc ol { list-style: none; margin: 0; padding: 0; }
+.docs-rail li { padding: 5px 0; font-size: 15px; }
+.doc-toc li { padding: 4px 0; font-size: 13px; line-height: 20px; }
+.docs-rail a, .doc-toc a { color: var(--muted); transition: color 160ms ease-out; }
+.doc-toc a { color: var(--faint); }
+.docs-rail a:hover, .doc-toc a:hover, .docs-rail a[aria-current="page"] { color: var(--fg); }
+.docs-rail a[aria-current="page"] { font-weight: 500; }
+.doc { padding: 96px 0 128px; min-width: 0; }
+.doc h1 { font-size: clamp(36px, 4vw, 56px); line-height: 1.05; font-weight: 800; letter-spacing: -0.035em; margin-bottom: 40px; }
+.prose { font-size: 17px; line-height: 30px; }
+.prose p, .prose li { color: color-mix(in srgb, var(--fg) 82%, var(--bg)); }
+.prose p { margin: 0 0 20px; }
+.prose h2 { font-size: 28px; line-height: 36px; font-weight: 700; letter-spacing: -0.02em; margin: 64px 0 16px; scroll-margin-top: 96px; }
+.prose h3 { font-size: 20px; line-height: 28px; font-weight: 600; margin: 40px 0 12px; scroll-margin-top: 96px; }
+.prose a { color: var(--fg); text-decoration: underline; text-underline-offset: 3px; text-decoration-color: var(--line); }
+.prose a:hover { text-decoration-color: var(--fg); }
+.prose ul, .prose ol { margin: 0 0 20px; padding-left: 22px; }
+.prose code { font: 400 0.86em/1 var(--mono); background: var(--code); padding: 3px 6px; border-radius: 6px; }
+.prose table { width: 100%; border-collapse: collapse; margin: 8px 0 28px; font-size: 15px; line-height: 24px; }
+.prose th, .prose td { text-align: left; vertical-align: top; padding: 12px 16px 12px 0; border-top: 1px solid var(--line); }
+.prose th { font-weight: 600; }
+.prose td { color: color-mix(in srgb, var(--fg) 82%, var(--bg)); }
+.code { position: relative; margin: 28px 0; background: var(--code); border-radius: 12px; }
+.code figcaption { padding: 14px 88px 0 20px; font: 400 12px/18px var(--mono); color: var(--faint); overflow-wrap: anywhere; }
+.code pre { margin: 0; padding: 14px 20px 20px; overflow-x: auto; }
+.code code { display: block; font: 400 13.5px/22px var(--mono); background: none; padding: 0; color: var(--fg); }
+.code .copy { position: absolute; top: 10px; right: 12px; padding: 4px 8px; font-size: 12px; color: var(--muted); transition: color 160ms ease-out; }
+.code .copy:hover { color: var(--fg); }
+
 .missing { min-height: 70vh; display: grid; align-content: center; justify-items: start; gap: 24px; padding: 160px 64px; }
 .missing h1 { font-size: 64px; letter-spacing: -0.04em; }
 
 .foot { display: flex; flex-wrap: wrap; gap: 8px 28px; padding: 48px 64px; font-size: 13px; color: var(--faint); }
 .foot a { text-decoration: underline; text-underline-offset: 3px; }
 
+@media (max-width: 1279px) {
+  .docs { grid-template-columns: 200px minmax(0, 720px); }
+  .doc-toc { display: none; }
+}
+
 @media (max-width: 1023px) {
+  .docs { grid-template-columns: minmax(0, 1fr); }
+  .docs-rail { display: none; }
   .reader { grid-template-columns: minmax(0, 1fr); }
   .side { display: none; }
   .feature, .feature:nth-of-type(odd), .city { grid-template-columns: minmax(0, 1fr); grid-template-rows: none; gap: 32px; }
@@ -182,7 +222,7 @@ img.shot { display: block; max-width: 100%; height: auto; }
   .bar { padding: 0 16px; gap: 12px; }
   .bar .end { gap: 0; }
   .hero, .chapters, .missing { padding-left: 20px; padding-right: 20px; }
-  .reader { padding: 0 20px; }
+  .reader, .docs { padding: 0 20px; }
   .chapters li { grid-template-columns: 40px minmax(0, 1fr); }
   .chapters .titles { grid-column: 2; margin-top: 8px; }
   .foot { padding: 32px 20px; }
@@ -199,6 +239,13 @@ img.shot { display: block; max-width: 100%; height: auto; }
   .close { padding: 112px 20px; }
 }
 
+@media (max-width: 359px) {
+  .bar { padding: 0 12px; gap: 10px; }
+  .bar nav { gap: 14px; }
+  .bar .tool { width: 32px; }
+  .bar .sound { display: none; }
+}
+
 @media (prefers-reduced-motion: reduce) {
   * { transition: none !important; animation: none !important; }
 }