c56974cf59
Add new features to documentation UI: - Add table of contents with scroll spy functionality - Add GitHub repository statistics badge - Implement new centered layout system with fixed sidebar - Add conditional Playwright installation based on CRAWL4AI_MODE Breaking changes: None
297 lines
9.3 KiB
CSS
297 lines
9.3 KiB
CSS
/* ==== File: assets/layout.css (Non-Fluid Centered Layout) ==== */
|
|
|
|
:root {
|
|
--header-height: 55px; /* Adjust if needed */
|
|
--sidebar-width: 280px; /* Adjust if needed */
|
|
--toc-width: 340px; /* As specified */
|
|
--content-max-width: 90em; /* Max width for the centered content */
|
|
--layout-transition-speed: 0.2s;
|
|
--global-space: 10px;
|
|
}
|
|
|
|
/* --- Basic Setup --- */
|
|
html {
|
|
scroll-behavior: smooth;
|
|
scroll-padding-top: calc(var(--header-height) + 15px);
|
|
box-sizing: border-box;
|
|
}
|
|
*, *:before, *:after {
|
|
box-sizing: inherit;
|
|
}
|
|
|
|
body {
|
|
padding-top: 0;
|
|
padding-bottom: 0;
|
|
background-color: var(--background-color);
|
|
color: var(--font-color);
|
|
/* Prevents horizontal scrollbars during transitions */
|
|
overflow-x: hidden;
|
|
}
|
|
|
|
/* --- Fixed Header --- */
|
|
/* Full width, fixed header */
|
|
.terminal .container:first-child { /* Assuming this targets the header container */
|
|
position: fixed;
|
|
top: 0;
|
|
left: 0;
|
|
right: 0;
|
|
height: var(--header-height);
|
|
background-color: var(--background-color);
|
|
z-index: 1000;
|
|
border-bottom: 1px solid var(--progress-bar-background);
|
|
max-width: none; /* Override any container max-width */
|
|
padding: 0 calc(var(--global-space) * 2);
|
|
}
|
|
|
|
/* --- Main Layout Container (Below Header) --- */
|
|
/* This container just provides space for the fixed header */
|
|
.container:has(.terminal-mkdocs-main-grid) {
|
|
margin: 0 auto;
|
|
padding: 0;
|
|
padding-top: var(--header-height); /* Space for fixed header */
|
|
}
|
|
|
|
/* --- Flex Container: Grid holding content and toc (CENTERED) --- */
|
|
/* THIS is the main centered block */
|
|
.terminal-mkdocs-main-grid {
|
|
display: flex;
|
|
align-items: flex-start;
|
|
/* Enforce max-width and center */
|
|
max-width: var(--content-max-width);
|
|
margin-left: auto;
|
|
margin-right: auto;
|
|
position: relative;
|
|
/* Apply side padding within the centered block */
|
|
padding-left: calc(var(--global-space) * 2);
|
|
padding-right: calc(var(--global-space) * 2);
|
|
/* Add margin-left to clear the fixed sidebar */
|
|
margin-left: var(--sidebar-width);
|
|
}
|
|
|
|
/* --- 1. Fixed Left Sidebar (Viewport Relative) --- */
|
|
#terminal-mkdocs-side-panel {
|
|
position: fixed;
|
|
top: var(--header-height);
|
|
left: max(0px, calc((100vw - var(--content-max-width)) / 2));
|
|
bottom: 0;
|
|
width: var(--sidebar-width);
|
|
background-color: var(--background-color);
|
|
border-right: 1px solid var(--progress-bar-background);
|
|
overflow-y: auto;
|
|
z-index: 900;
|
|
padding: 1em calc(var(--global-space) * 2);
|
|
padding-bottom: 2em;
|
|
/* transition: left var(--layout-transition-speed) ease-in-out; */
|
|
}
|
|
|
|
/* --- 2. Main Content Area (Within Centered Grid) --- */
|
|
#terminal-mkdocs-main-content {
|
|
flex-grow: 1;
|
|
flex-shrink: 1;
|
|
min-width: 0; /* Flexbox shrink fix */
|
|
|
|
/* No left/right margins needed here - handled by parent grid */
|
|
margin-left: 0;
|
|
margin-right: 0;
|
|
|
|
/* Internal Padding */
|
|
padding: 1.5em 2em;
|
|
|
|
position: relative;
|
|
z-index: 1;
|
|
}
|
|
|
|
/* --- 3. Right Table of Contents (Sticky, Within Centered Grid) --- */
|
|
#toc-sidebar {
|
|
flex-basis: var(--toc-width);
|
|
flex-shrink: 0;
|
|
width: var(--toc-width);
|
|
|
|
position: sticky; /* Sticks within the centered grid */
|
|
top: var(--header-height);
|
|
align-self: stretch;
|
|
height: calc(100vh - var(--header-height));
|
|
overflow-y: auto;
|
|
|
|
padding: 1.5em 1em;
|
|
font-size: 0.85em;
|
|
border-left: 1px solid var(--progress-bar-background);
|
|
z-index: 800;
|
|
/* display: none; /* JS handles */
|
|
}
|
|
|
|
/* (ToC link styles remain the same) */
|
|
#toc-sidebar h4 { margin-top: 0; margin-bottom: 1em; font-size: 1.1em; color: var(--secondary-color); padding-left: 0.8em; }
|
|
#toc-sidebar ul { list-style: none; padding: 0; margin: 0; }
|
|
#toc-sidebar ul li a { display: block; padding: 0.3em 0; color: var(--secondary-color); text-decoration: none; border-left: 3px solid transparent; padding-left: 0.8em; transition: all 0.1s ease-in-out; line-height: 1.4; word-break: break-word; }
|
|
#toc-sidebar ul li.toc-level-3 a { padding-left: 1.8em; }
|
|
#toc-sidebar ul li.toc-level-4 a { padding-left: 2.8em; }
|
|
#toc-sidebar ul li a:hover { color: var(--font-color); background-color: rgba(255, 255, 255, 0.05); }
|
|
#toc-sidebar ul li a.active { color: var(--primary-color); border-left-color: var(--primary-color); background-color: rgba(80, 255, 255, 0.08); }
|
|
|
|
|
|
/* --- Footer Styling (Respects Centered Layout) --- */
|
|
footer {
|
|
background-color: var(--code-bg-color);
|
|
color: var(--secondary-color);
|
|
position: relative;
|
|
z-index: 10;
|
|
margin-top: 2em;
|
|
|
|
/* Apply margin-left to clear the fixed sidebar */
|
|
margin-left: var(--sidebar-width);
|
|
|
|
/* Constrain width relative to the centered grid it follows */
|
|
max-width: calc(var(--content-max-width) - var(--sidebar-width));
|
|
margin-right: auto; /* Keep it left-aligned within the space next to sidebar */
|
|
|
|
/* Use padding consistent with the grid */
|
|
padding: 2em calc(var(--global-space) * 2);
|
|
}
|
|
|
|
/* Adjust footer grid if needed */
|
|
.terminal-mkdocs-footer-grid {
|
|
display: grid;
|
|
grid-template-columns: 1fr auto;
|
|
gap: 1em;
|
|
align-items: center;
|
|
}
|
|
|
|
/* ==========================================================================
|
|
RESPONSIVENESS (Adapting the Non-Fluid Layout)
|
|
========================================================================== */
|
|
|
|
/* --- Medium screens: Hide ToC --- */
|
|
@media screen and (max-width: 1200px) {
|
|
#toc-sidebar {
|
|
display: none;
|
|
}
|
|
|
|
.terminal-mkdocs-main-grid {
|
|
/* Grid adjusts automatically as ToC is removed */
|
|
/* Ensure grid padding remains */
|
|
padding-left: calc(var(--global-space) * 2);
|
|
padding-right: calc(var(--global-space) * 2);
|
|
}
|
|
|
|
#terminal-mkdocs-main-content {
|
|
/* Content area naturally expands */
|
|
}
|
|
|
|
footer {
|
|
/* Footer still respects the left sidebar and overall max width */
|
|
margin-left: var(--sidebar-width);
|
|
max-width: calc(var(--content-max-width) - var(--sidebar-width));
|
|
/* Padding remains consistent */
|
|
padding-left: calc(var(--global-space) * 2);
|
|
padding-right: calc(var(--global-space) * 2);
|
|
}
|
|
}
|
|
|
|
/* --- Small screens: Hide left sidebar, full width content & footer --- */
|
|
@media screen and (max-width: 768px) {
|
|
|
|
#terminal-mkdocs-side-panel {
|
|
left: calc(-1 * var(--sidebar-width));
|
|
z-index: 1100;
|
|
box-shadow: 2px 0 10px rgba(0,0,0,0.3);
|
|
}
|
|
#terminal-mkdocs-side-panel.sidebar-visible {
|
|
left: 0;
|
|
}
|
|
|
|
.terminal-mkdocs-main-grid {
|
|
/* Grid now takes full width (minus body padding) */
|
|
margin-left: 0; /* Override sidebar margin */
|
|
margin-right: 0; /* Override auto margin */
|
|
max-width: 100%; /* Allow full width */
|
|
padding-left: var(--global-space); /* Reduce padding */
|
|
padding-right: var(--global-space);
|
|
}
|
|
|
|
#terminal-mkdocs-main-content {
|
|
padding: 1.5em 1em; /* Adjust internal padding */
|
|
}
|
|
|
|
footer {
|
|
margin-left: 0; /* Full width footer */
|
|
max-width: 100%; /* Allow full width */
|
|
padding: 2em 1em; /* Adjust internal padding */
|
|
}
|
|
|
|
.terminal-mkdocs-footer-grid {
|
|
grid-template-columns: 1fr; /* Stack footer items */
|
|
text-align: center;
|
|
gap: 0.5em;
|
|
}
|
|
/* Remember JS for toggle button & overlay */
|
|
}
|
|
|
|
|
|
/* ==== GitHub Stats Badge Styling ==== */
|
|
|
|
.github-stats-badge {
|
|
display: inline-block; /* Or flex if needed */
|
|
margin-left: 2em; /* Adjust spacing */
|
|
vertical-align: middle; /* Align with other header items */
|
|
font-size: 0.9em; /* Slightly smaller font */
|
|
}
|
|
|
|
.github-stats-badge a {
|
|
color: var(--secondary-color); /* Use secondary color */
|
|
text-decoration: none;
|
|
display: flex; /* Use flex for alignment */
|
|
align-items: center;
|
|
gap: 0.8em; /* Space between items */
|
|
padding: 0.2em 0.5em;
|
|
border: 1px solid var(--progress-bar-background); /* Subtle border */
|
|
border-radius: 4px;
|
|
transition: color 0.2s, background-color 0.2s;
|
|
}
|
|
|
|
.github-stats-badge a:hover {
|
|
color: var(--font-color); /* Brighter color on hover */
|
|
background-color: var(--progress-bar-background); /* Subtle background on hover */
|
|
}
|
|
|
|
.github-stats-badge .repo-name {
|
|
color: var(--font-color); /* Make repo name stand out slightly */
|
|
font-weight: 500; /* Optional bolder weight */
|
|
}
|
|
|
|
.github-stats-badge .stat {
|
|
/* Styles for individual stats (version, stars, forks) */
|
|
white-space: nowrap; /* Prevent wrapping */
|
|
}
|
|
|
|
.github-stats-badge .stat i {
|
|
/* Optional: Style for FontAwesome icons */
|
|
margin-right: 0.3em;
|
|
color: var(--secondary-dimmed-color); /* Dimmer color for icons */
|
|
}
|
|
|
|
|
|
/* Adjust positioning relative to search/nav if needed */
|
|
/* Example: If search is floated right */
|
|
/* .terminal-nav { float: left; } */
|
|
/* .github-stats-badge { float: left; } */
|
|
/* #mkdocs-search-query { float: right; } */
|
|
|
|
/* --- Responsive adjustments --- */
|
|
@media screen and (max-width: 900px) { /* Example breakpoint */
|
|
.github-stats-badge .repo-name {
|
|
display: none; /* Hide full repo name on smaller screens */
|
|
}
|
|
.github-stats-badge {
|
|
margin-left: 1em;
|
|
}
|
|
.github-stats-badge a {
|
|
gap: 0.5em;
|
|
}
|
|
}
|
|
@media screen and (max-width: 768px) {
|
|
/* Further hide or simplify on mobile if needed */
|
|
.github-stats-badge {
|
|
display: none; /* Example: Hide completely on smallest screens */
|
|
}
|
|
} |