feat(11.1-01): add summer docs:build with the docsite generator core
- internal/docsite loads docs/ with strict site.yaml and frontmatter decoding - goldmark GFM pipeline renders pages into an embedded html/template shell - emits .html pages, .md siblings, llms.txt, llms-full.txt, search-index.json - output guard refuses unmarked non-empty dirs and --out inside --src or root - docs/index.md and docs/setup/installation.md; /site/ is gitignored
This commit is contained in:
Jakub Zych
142
internal/docsite/theme/assets/site.css
Normal file
142
internal/docsite/theme/assets/site.css
Normal file
@@ -0,0 +1,142 @@
|
||||
/* SummerCMS docs: tracer theme. Light tokens copied by value from the admin SPA. */
|
||||
:root {
|
||||
--c-bg: #f4f6f9;
|
||||
--c-surface: #ffffff;
|
||||
--c-subtle: #f3f5f8;
|
||||
--c-border: #e6e9ef;
|
||||
--c-border-strong: #d2d8e2;
|
||||
--c-text: #141b2d;
|
||||
--c-muted: #566175;
|
||||
--c-primary: #22304d;
|
||||
--c-ring: rgba(252, 196, 40, 0.55);
|
||||
--c-sel: #fdf3cf;
|
||||
--font-sans: "DM Sans", ui-sans-serif, system-ui, sans-serif;
|
||||
--font-mono: "DM Mono", ui-monospace, monospace;
|
||||
color-scheme: light;
|
||||
}
|
||||
|
||||
* { box-sizing: border-box; }
|
||||
|
||||
html {
|
||||
-webkit-text-size-adjust: 100%;
|
||||
font-size: 16px;
|
||||
}
|
||||
|
||||
body {
|
||||
margin: 0;
|
||||
background: var(--c-surface);
|
||||
color: var(--c-text);
|
||||
font-family: var(--font-sans);
|
||||
line-height: 1.6;
|
||||
}
|
||||
|
||||
.layout {
|
||||
display: grid;
|
||||
grid-template-columns: 272px minmax(0, 1fr);
|
||||
min-height: 100vh;
|
||||
}
|
||||
|
||||
.sidebar {
|
||||
background: var(--c-bg);
|
||||
border-right: 1px solid var(--c-border);
|
||||
padding: 24px 8px;
|
||||
font-size: 14px;
|
||||
line-height: 1.5;
|
||||
}
|
||||
|
||||
.sidebar-home {
|
||||
display: block;
|
||||
padding: 0 8px 24px;
|
||||
font-size: 20px;
|
||||
font-weight: 600;
|
||||
color: var(--c-text);
|
||||
text-decoration: none;
|
||||
}
|
||||
|
||||
.sidebar-section + .sidebar-section { margin-top: 24px; }
|
||||
|
||||
.sidebar-title {
|
||||
margin: 0 0 8px;
|
||||
padding: 0 8px;
|
||||
font-weight: 600;
|
||||
}
|
||||
|
||||
.sidebar ul { list-style: none; margin: 0; padding: 0; }
|
||||
|
||||
.sidebar li a {
|
||||
display: block;
|
||||
min-height: 32px;
|
||||
padding: 4px 8px;
|
||||
border-radius: 10px;
|
||||
color: var(--c-muted);
|
||||
text-decoration: none;
|
||||
}
|
||||
|
||||
.sidebar li a:hover { color: var(--c-text); }
|
||||
|
||||
.sidebar li a[aria-current="page"] {
|
||||
background: var(--c-sel);
|
||||
color: var(--c-text);
|
||||
}
|
||||
|
||||
main {
|
||||
max-width: 768px;
|
||||
padding: 48px 32px 64px;
|
||||
}
|
||||
|
||||
h1 {
|
||||
margin: 0 0 8px;
|
||||
font-size: 32px;
|
||||
font-weight: 600;
|
||||
line-height: 1.2;
|
||||
letter-spacing: -0.02em;
|
||||
}
|
||||
|
||||
h2 { margin: 48px 0 16px; font-size: 20px; font-weight: 600; line-height: 1.3; }
|
||||
h3, h4, h5, h6 { margin: 32px 0 8px; font-size: 16px; font-weight: 600; line-height: 1.5; }
|
||||
h1, h2, h3, h4, h5, h6 { scroll-margin-top: 32px; }
|
||||
|
||||
.lead { margin: 0 0 32px; font-size: 20px; color: var(--c-muted); line-height: 1.3; }
|
||||
|
||||
p, ul, ol { margin: 0 0 16px; }
|
||||
|
||||
a { color: var(--c-primary); text-decoration-color: var(--c-border-strong); text-underline-offset: 3px; }
|
||||
a:hover { text-decoration-color: currentColor; }
|
||||
a:focus-visible { outline: 3px solid var(--c-ring); outline-offset: 2px; }
|
||||
|
||||
code {
|
||||
font-family: var(--font-mono);
|
||||
font-size: 0.875em;
|
||||
background: var(--c-subtle);
|
||||
border-radius: 6px;
|
||||
padding: 0 4px;
|
||||
}
|
||||
|
||||
pre {
|
||||
margin: 0 0 24px;
|
||||
padding: 16px;
|
||||
overflow-x: auto;
|
||||
background: var(--c-subtle);
|
||||
border: 1px solid var(--c-border);
|
||||
border-radius: 12px;
|
||||
font-size: 14px;
|
||||
line-height: 1.5;
|
||||
}
|
||||
|
||||
pre code { background: none; padding: 0; font-size: inherit; }
|
||||
|
||||
figure.code { margin: 0 0 24px; }
|
||||
figure.code pre { margin: 0; }
|
||||
figure.code figcaption { margin: 0 0 4px; font-size: 14px; color: var(--c-muted); font-family: var(--font-mono); }
|
||||
|
||||
table { border-collapse: collapse; margin: 0 0 24px; font-size: 14px; font-variant-numeric: tabular-nums; }
|
||||
th, td { border-bottom: 1px solid var(--c-border); padding: 8px 16px; text-align: left; vertical-align: top; }
|
||||
th { background: var(--c-subtle); font-weight: 600; }
|
||||
|
||||
blockquote { margin: 0 0 24px; padding: 16px; background: var(--c-subtle); border-left: 4px solid var(--c-border-strong); border-radius: 12px; }
|
||||
|
||||
@media (max-width: 1023px) {
|
||||
.layout { grid-template-columns: minmax(0, 1fr); }
|
||||
.sidebar { border-right: 0; border-bottom: 1px solid var(--c-border); }
|
||||
main { padding: 24px 16px 48px; }
|
||||
}
|
||||
32
internal/docsite/theme/templates/page.html
Normal file
32
internal/docsite/theme/templates/page.html
Normal file
@@ -0,0 +1,32 @@
|
||||
<!doctype html>
|
||||
<html lang="en">
|
||||
<head>
|
||||
<meta charset="utf-8">
|
||||
<meta name="viewport" content="width=device-width, initial-scale=1">
|
||||
<title>{{.DocTitle}}</title>
|
||||
<meta name="description" content="{{.Description}}">
|
||||
<link rel="stylesheet" href="{{.CSS}}">
|
||||
</head>
|
||||
<body class="docs">
|
||||
<div class="layout">
|
||||
<nav class="sidebar" aria-label="Documentation">
|
||||
<a class="sidebar-home" href="{{.HomeURL}}">SummerCMS</a>
|
||||
{{- range .Nav}}
|
||||
<div class="sidebar-section">
|
||||
<p class="sidebar-title">{{.Title}}</p>
|
||||
<ul>
|
||||
{{- range .Items}}
|
||||
<li><a href="{{.URL}}"{{if .Current}} aria-current="page"{{end}}>{{.Title}}</a></li>
|
||||
{{- end}}
|
||||
</ul>
|
||||
</div>
|
||||
{{- end}}
|
||||
</nav>
|
||||
<main id="content">
|
||||
<h1>{{.Title}}</h1>
|
||||
<p class="lead">{{.Description}}</p>
|
||||
{{.Content}}
|
||||
</main>
|
||||
</div>
|
||||
</body>
|
||||
</html>
|
||||
Reference in New Issue
Block a user