Publish a scannable manual and a bibliography that links each paper back to the pages that use it.

Co-authored-by: Cursor <cursoragent@cursor.com>
This commit is contained in:
Ryan Henry 2026-09-26 23:51:06 -06:00
parent cf8054a0b3
commit 695f8e84f7
45 changed files with 4848 additions and 338 deletions

View file

@ -1,3 +1,55 @@
/* Layout carried over from the v2.2.0 theme patches.
Sidebar width matches TREEVIEW_WIDTH. The header is tall enough for the
116px wordmark plus the search row; the theme's 120px header clipped it.
Tree arrows stay visible. Doxygen 1.14+ draws them as arrowheads. */
html {
--side-nav-fixed-width: 350px;
--top-height: 185px;
--side-nav-arrow-opacity: 0.9;
--side-nav-arrow-hover-opacity: 0.9;
}
/* The theme caps logo images at 2x the title size. The wordmark is 330x116,
so the sidebar header padding is tightened so the mark is not clipped. */
#titlearea {
padding-left: 8px;
padding-right: 8px;
}
#projectlogo img {
max-height: none;
width: 330px;
height: 116px;
}
#titlearea table {
width: 100%;
}
@media screen and (min-width: 768px) {
/* Keep the dark-mode toggle on the search row. The theme appends it
inside the search cell, and a block-level search box would wrap it. */
#titlearea tr:last-child > td {
display: flex;
align-items: center;
}
#MSearchBox {
display: block;
flex: 1 1 auto;
width: auto;
min-width: 0;
}
#MSearchField {
width: calc(100% - 80px);
}
#nav-sync {
left: 308px;
}
}
.github-corner svg {
fill: var(--primary-light-color);
color: var(--page-background-color);
@ -178,3 +230,189 @@ dpf trees: \e4bd
.iterables_2zip_iterable_8cpp\.html::before {
content: "\f1c9";
}
/* Click-through on Which DPF. A checked radio reveals the next question
and the matching program. The programs are the files under examples/mwe. */
.chooser {
margin: 1.2rem 0 1.6rem;
}
.chooser .q {
font-weight: 600;
margin: 1rem 0 0.45rem;
}
.chooser input {
position: absolute;
opacity: 0;
width: 1px;
height: 1px;
}
.chooser .choice {
display: inline-block;
vertical-align: top;
width: 14rem;
margin: 0 0.6rem 0.6rem 0;
padding: 0.7rem 0.8rem;
border: 1px solid var(--separator-color);
border-radius: 8px;
background: var(--fragment-background);
cursor: pointer;
}
.chooser .choice strong {
display: block;
margin-bottom: 0.2rem;
}
.chooser .choice span {
display: block;
font-size: 0.92rem;
color: var(--page-secondary-foreground-color, #555);
}
.chooser input:checked + .choice,
.chooser input:focus-visible + .choice {
border-color: var(--primary-color);
box-shadow: inset 0 0 0 1px var(--primary-color);
}
.chooser .branch,
.chooser .result {
display: none;
}
#h-dealer:checked ~ .branch-dealer,
#h-share:checked ~ .branch-share,
#h-answer:checked ~ .branch-answer,
#h-three:checked ~ .branch-three {
display: block;
}
#d-point:checked ~ .result-point,
#d-cmp:checked ~ .result-cmp,
#d-ic:checked ~ .result-ic {
display: block;
}
.chooser .result {
margin-top: 0.8rem;
padding: 0.9rem 1rem 1rem;
border: 1px solid var(--separator-color);
border-radius: 8px;
}
.chooser .result h3 {
margin-top: 0;
}
.chooser pre.mwe {
overflow: auto;
padding: 0.8rem 1rem;
border-radius: 6px;
background: var(--fragment-background);
border: 1px solid var(--separator-color);
}
.mwe-copy {
cursor: pointer;
border: 1px solid var(--separator-color);
border-radius: 6px;
background: var(--page-background-color);
color: var(--page-foreground-color);
padding: 0.25rem 0.7rem;
margin-bottom: 0.6rem;
}
.mwe-cmd {
font-size: 0.92rem;
}
.hero-lead {
font-size: 1.2rem;
line-height: 1.45;
max-width: 40rem;
margin-top: 0.2rem;
}
.feature-grid {
display: grid;
grid-template-columns: repeat(auto-fill, minmax(220px, 1fr));
gap: 0.75rem;
margin: 0.4rem 0 1.6rem;
}
.feature-card {
display: block;
padding: 0.85rem 0.95rem 0.95rem;
border: 1px solid var(--separator-color);
border-radius: 10px;
background: var(--fragment-background);
text-decoration: none;
color: var(--page-foreground-color);
line-height: 1.35;
}
.feature-card:hover {
border-color: var(--primary-color);
}
.feature-card strong,
.feature-card b {
display: block;
margin: 0.2rem 0 0.35rem;
font-size: 1.02rem;
}
.feature-card p {
margin: 0;
color: var(--page-secondary-foreground-color);
font-size: 0.92rem;
}
.feature-kicker {
display: block;
font-size: 0.72rem;
letter-spacing: 0.06em;
text-transform: uppercase;
color: var(--primary-color);
font-weight: 700;
}
details.type-note {
border-bottom: 1px solid var(--separator-color);
margin: 0;
}
details.type-note summary {
cursor: pointer;
font-weight: 650;
padding: 0.55rem 0;
}
details.type-note > p:first-of-type {
margin-top: 0.2rem;
}
.page-nav {
display: flex;
justify-content: space-between;
align-items: center;
gap: 1rem;
margin: 0 0 1.1rem;
padding: 0.45rem 0 0.7rem;
border-bottom: 1px solid var(--separator-color);
}
.page-nav-bottom {
margin: 2rem 0 0.25rem;
padding-top: 0.85rem;
border-bottom: 0;
border-top: 1px solid var(--separator-color);
}
.page-nav a {
text-decoration: none;
font-weight: 650;
max-width: 46%;
}
.page-nav a.page-nav-next {
margin-left: auto;
text-align: right;
}
pre.fragment {
overflow: auto;
padding: 0.9rem 1rem;
border-radius: 8px;
background: var(--fragment-background);
border: 1px solid var(--separator-color);
}