Refactor Chinese documentation for team skills and commands

- Removed outdated table of contents from commands-skills.md
- Updated skills overview in claude-collaboration.md with new skill names and descriptions
- Enhanced clarity and structure of skills details, including roles and pipelines
- Added new team skills: team-arch-opt, team-perf-opt, team-brainstorm, team-frontend, team-uidesign, team-issue, team-iterdev, team-quality-assurance, team-roadmap-dev, team-tech-debt, team-ultra-analyze
- Improved user command section for better usability
- Streamlined best practices for team skills usage
This commit is contained in:
catlog22
2026-03-02 22:49:52 +08:00
parent 99d6438303
commit 1bf9006d65
13 changed files with 1872 additions and 1173 deletions

View File

@@ -75,8 +75,7 @@ export default withMermaid(defineConfig({
{ text: 'Guide', link: '/guide/ch01-what-is-claude-dms3' },
{ text: 'Commands', link: '/commands/claude/' },
{ text: 'Skills', link: '/skills/' },
{ text: 'Features', link: '/features/spec' },
{ text: 'Components', link: '/components/' }
{ text: 'Features', link: '/features/spec' }
],
// Sidebar - 优化导航结构,增加二级标题和归类
@@ -423,7 +422,6 @@ export default withMermaid(defineConfig({
{ text: '命令', link: '/zh/commands/claude/' },
{ text: '技能', link: '/zh/skills/claude-index' },
{ text: '功能', link: '/zh/features/spec' },
{ text: '组件', link: '/zh/components/' },
{ text: '参考', link: '/zh/reference/commands-skills' }
],
sidebar: {

View File

@@ -1,7 +1,7 @@
/**
* VitePress Custom Styles
* Overrides and extensions for default VitePress theme
* Design System: ui-ux-pro-max — dark-mode-first, developer-focused
* Design System: ui-ux-pro-max — flat design, developer-focused, documentation-optimized
*/
/* ============================================
@@ -33,10 +33,14 @@
--vp-custom-block-danger-border: #fecaca;
--vp-custom-block-danger-text: #b91c1c;
/* Layout Width Adjustments */
/* Layout Width - Wider content area */
--vp-layout-max-width: 1600px;
--vp-content-width: 1000px;
--vp-sidebar-width: 272px;
--vp-content-width: 920px;
--vp-sidebar-width: 280px;
--vp-toc-width: 200px;
/* Prose width for optimal readability */
--vp-prose-width: 820px;
}
.dark {
@@ -55,12 +59,9 @@
/* ============================================
* Layout Container Adjustments
* Use CSS variables in :root to control layout widths
* Do not override VitePress layout calculations with !important
* ============================================ */
.VPDoc .content-container,
.VPDoc.has-aside .content-container {
max-width: 90% !important;
padding: 0 32px;
}
/* Adjust sidebar and content layout */
/* NOTE: Removed duplicate padding-left - VitePress already handles sidebar layout */
@@ -77,6 +78,18 @@
padding: 4px 8px;
}
/* ============================================
* Navigation Bar Border
* ============================================ */
.VPNav {
border-bottom: 1px solid var(--vp-c-divider);
}
/* ============================================
* Desktop Layout Adjustments
* Grid-based layout is defined in mobile.css @media (min-width: 1024px)
* ============================================ */
/* ============================================
* Home Page Override
* ============================================ */
@@ -97,6 +110,12 @@
max-width: 100vw;
}
/* Home page navbar - reduce title left margin since no sidebar */
.Layout:has(.pro-home) .VPNavBar .content-body,
.Layout:has(.pro-home) .VPNavBar .title {
padding-left: 0 !important;
}
/* Ensure VPFooter doesn't cause overflow */
.Layout:has(.pro-home) .VPFooter {
max-width: 100vw;
@@ -136,54 +155,111 @@
/* ============================================
* Documentation Content Typography
* Optimized for readability (65-75 chars per line)
* ============================================ */
.vp-doc {
font-family: var(--vp-font-family-base);
line-height: var(--vp-line-height-relaxed);
color: var(--vp-c-text-1);
}
/* Heading hierarchy with clear visual distinction */
.vp-doc h1 {
font-family: var(--vp-font-family-heading);
font-size: var(--vp-font-size-4xl);
font-weight: 800;
letter-spacing: -0.02em;
margin-bottom: 1.5rem;
letter-spacing: -0.025em;
line-height: var(--vp-line-height-tight);
margin-bottom: var(--vp-spacing-8);
color: var(--vp-c-text-1);
}
.vp-doc h2 {
font-family: var(--vp-font-family-heading);
font-size: var(--vp-font-size-2xl);
font-weight: 700;
margin-top: 3rem;
padding-top: 2rem;
letter-spacing: -0.01em;
line-height: var(--vp-line-height-tight);
margin-top: var(--vp-spacing-12);
padding-top: var(--vp-spacing-8);
border-top: 1px solid var(--vp-c-divider);
color: var(--vp-c-text-1);
}
.vp-doc h2:first-of-type {
margin-top: 1.5rem;
margin-top: var(--vp-spacing-6);
border-top: none;
}
.vp-doc h3 {
font-family: var(--vp-font-family-heading);
font-size: var(--vp-font-size-xl);
font-weight: 600;
margin-top: 2.5rem;
line-height: var(--vp-line-height-snug);
margin-top: var(--vp-spacing-10);
color: var(--vp-c-text-1);
}
.vp-doc h4 {
font-family: var(--vp-font-family-heading);
font-size: var(--vp-font-size-lg);
font-weight: 600;
margin-top: 2rem;
line-height: var(--vp-line-height-snug);
margin-top: var(--vp-spacing-8);
color: var(--vp-c-text-2);
}
.vp-doc h5 {
font-size: var(--vp-font-size-base);
font-weight: 600;
line-height: var(--vp-line-height-snug);
margin-top: var(--vp-spacing-6);
color: var(--vp-c-text-2);
}
.vp-doc h6 {
font-size: var(--vp-font-size-sm);
font-weight: 600;
line-height: var(--vp-line-height-snug);
margin-top: var(--vp-spacing-4);
color: var(--vp-c-text-3);
text-transform: uppercase;
letter-spacing: 0.05em;
}
/* Body text with optimal line height */
.vp-doc p {
line-height: 1.8;
margin: 1.25rem 0;
font-size: var(--vp-font-size-base);
line-height: var(--vp-line-height-relaxed);
margin: var(--vp-spacing-5) 0;
max-width: var(--vp-prose-width);
}
/* Lists with proper spacing */
.vp-doc ul,
.vp-doc ol {
margin: 1.25rem 0;
padding-left: 1.5rem;
font-size: var(--vp-font-size-base);
line-height: var(--vp-line-height-relaxed);
margin: var(--vp-spacing-5) 0;
padding-left: var(--vp-spacing-6);
max-width: var(--vp-prose-width);
}
.vp-doc li {
line-height: 1.8;
margin: 0.5rem 0;
line-height: var(--vp-line-height-relaxed);
margin: var(--vp-spacing-2) 0;
}
.vp-doc li + li {
margin-top: 0.5rem;
margin-top: var(--vp-spacing-2);
}
/* Nested lists */
.vp-doc ul ul,
.vp-doc ol ol,
.vp-doc ul ol,
.vp-doc ol ul {
margin: var(--vp-spacing-2) 0;
}
/* Better spacing for code blocks in lists */
@@ -191,6 +267,31 @@
margin: 0 2px;
}
/* Blockquotes */
.vp-doc blockquote {
margin: var(--vp-spacing-6) 0;
padding: var(--vp-spacing-4) var(--vp-spacing-6);
border-left: 4px solid var(--vp-c-primary);
background: var(--vp-c-bg-soft);
border-radius: 0 var(--vp-radius-lg) var(--vp-radius-lg) 0;
color: var(--vp-c-text-2);
font-style: italic;
}
.vp-doc blockquote p {
margin: var(--vp-spacing-2) 0;
}
/* Strong and emphasis */
.vp-doc strong {
font-weight: 600;
color: var(--vp-c-text-1);
}
.vp-doc em {
font-style: italic;
}
/* ============================================
* Command Reference Specific Styles
* ============================================ */
@@ -212,12 +313,15 @@
/* ============================================
* Custom Container Blocks
* Flat design with left accent border
* ============================================ */
.custom-container {
margin: 20px 0;
padding: 16px 20px;
border-radius: 12px;
margin: var(--vp-spacing-6) 0;
padding: var(--vp-spacing-4) var(--vp-spacing-5);
border-radius: var(--vp-radius-xl);
border-left: 4px solid;
background: var(--vp-c-bg-soft);
box-shadow: var(--vp-shadow-xs);
}
.custom-container.info {
@@ -231,103 +335,285 @@
}
.dark .custom-container.success {
background: rgba(16, 185, 129, 0.1);
background: rgba(16, 185, 129, 0.08);
}
.custom-container.tip {
border-radius: 12px;
border-radius: var(--vp-radius-xl);
background: rgba(59, 130, 246, 0.05);
}
.custom-container.warning {
border-radius: 12px;
border-radius: var(--vp-radius-xl);
background: rgba(245, 158, 11, 0.05);
}
.custom-container.danger {
border-radius: 12px;
border-radius: var(--vp-radius-xl);
background: rgba(239, 68, 68, 0.05);
}
/* Custom container titles */
.custom-container .custom-container-title {
font-family: var(--vp-font-family-heading);
font-weight: 600;
font-size: var(--vp-font-size-sm);
text-transform: uppercase;
letter-spacing: 0.05em;
margin-bottom: var(--vp-spacing-2);
}
/* VitePress default custom blocks */
.vp-doc .tip,
.vp-doc .warning,
.vp-doc .danger,
.vp-doc .info {
border-radius: var(--vp-radius-xl);
margin: var(--vp-spacing-6) 0;
padding: var(--vp-spacing-4) var(--vp-spacing-5);
box-shadow: var(--vp-shadow-xs);
}
.vp-doc .tip {
background: rgba(59, 130, 246, 0.05);
border-color: var(--vp-c-primary);
}
.vp-doc .warning {
background: rgba(245, 158, 11, 0.05);
border-color: var(--vp-c-accent);
}
.vp-doc .danger {
background: rgba(239, 68, 68, 0.05);
border-color: #ef4444;
}
.vp-doc .info {
background: var(--vp-c-bg-soft);
border-color: var(--vp-c-primary);
}
/* ============================================
* Code Block Improvements
* Clean, flat design with subtle borders
* ============================================ */
.vp-code-group {
margin: 20px 0;
border-radius: 12px;
margin: var(--vp-spacing-6) 0;
border-radius: var(--vp-radius-xl);
overflow: hidden;
border: 1px solid var(--vp-c-divider);
box-shadow: var(--vp-shadow-sm);
}
.vp-code-group .tabs {
background: var(--vp-c-bg-soft);
border-bottom: 1px solid var(--vp-c-divider);
padding: 0 var(--vp-spacing-2);
}
.vp-code-group div[class*='language-'] {
margin: 0;
border-radius: 0;
border: none;
}
div[class*='language-'] {
border-radius: 12px;
margin: 20px 0;
border-radius: var(--vp-radius-xl);
margin: var(--vp-spacing-6) 0;
border: 1px solid var(--vp-c-divider);
background: var(--vp-c-bg-soft) !important;
box-shadow: var(--vp-shadow-sm);
}
div[class*='language-'] pre {
line-height: 1.65;
line-height: var(--vp-line-height-relaxed);
padding: var(--vp-spacing-5) var(--vp-spacing-6);
}
/* Inline code */
div[class*='language-'] code {
font-family: var(--vp-font-family-mono);
font-size: var(--vp-font-size-sm);
font-weight: 400;
letter-spacing: -0.01em;
}
/* Code block header with language label */
div[class*='language-'] > span.lang {
font-size: var(--vp-font-size-xs);
font-weight: 500;
text-transform: uppercase;
letter-spacing: 0.05em;
color: var(--vp-c-text-3);
padding: var(--vp-spacing-2) var(--vp-spacing-4);
background: var(--vp-c-bg-soft);
border-radius: var(--vp-radius-md);
}
/* Inline code - subtle styling */
.vp-doc :not(pre) > code {
border-radius: 6px;
font-family: var(--vp-font-family-mono);
border-radius: var(--vp-radius-md);
padding: 2px 6px;
font-size: 0.875em;
font-weight: 500;
background: var(--vp-c-bg-soft);
border: 1px solid var(--vp-c-divider);
color: var(--vp-c-primary);
}
/* Copy button styling */
.vp-code-group .vp-copy,
div[class*='language-'] .vp-copy {
border-radius: var(--vp-radius-md);
transition: all var(--vp-transition-color);
}
.vp-code-group .vp-copy:hover,
div[class*='language-'] .vp-copy:hover {
background: var(--vp-c-bg-mute);
}
/* ============================================
* Table Styling
* Clean, flat design with subtle borders
* ============================================ */
table {
.vp-doc table {
border-collapse: collapse;
width: 100%;
margin: 20px 0;
border-radius: 12px;
overflow: hidden;
margin: var(--vp-spacing-6) 0;
}
table th,
table td {
padding: 12px 16px;
.vp-doc table th,
.vp-doc table td {
padding: var(--vp-spacing-3) var(--vp-spacing-4);
border: 1px solid var(--vp-c-divider);
text-align: left;
font-size: var(--vp-font-size-sm);
line-height: var(--vp-line-height-normal);
}
table th {
.vp-doc table th {
background: var(--vp-c-bg-soft);
font-family: var(--vp-font-family-heading);
font-weight: 600;
font-size: 0.875rem;
font-size: var(--vp-font-size-xs);
text-transform: uppercase;
letter-spacing: 0.03em;
letter-spacing: 0.05em;
color: var(--vp-c-text-2);
border-bottom-width: 2px;
}
table tr:hover {
.vp-doc table td {
color: var(--vp-c-text-1);
vertical-align: top;
}
.vp-doc table tr:hover {
background: var(--vp-c-bg-soft);
}
.vp-doc table tr:hover td {
color: var(--vp-c-text-1);
}
/* Responsive tables */
@media (max-width: 767px) {
.vp-doc table {
display: block;
overflow-x: auto;
-webkit-overflow-scrolling: touch;
}
.vp-doc table th,
.vp-doc table td {
padding: var(--vp-spacing-2) var(--vp-spacing-3);
font-size: var(--vp-font-size-xs);
white-space: nowrap;
}
}
/* ============================================
* Sidebar Polish
* Clean, organized navigation
* ============================================ */
.VPSidebar {
background: var(--vp-c-bg);
border-right: 1px solid var(--vp-c-divider);
}
.VPSidebar .group + .group {
margin-top: 0.5rem;
padding-top: 0.5rem;
margin-top: var(--vp-spacing-4);
padding-top: var(--vp-spacing-4);
border-top: 1px solid var(--vp-c-divider);
}
/* Sidebar item styling */
.VPSidebar .VPSidebarItem .text {
font-size: var(--vp-font-size-sm);
line-height: var(--vp-line-height-normal);
transition: color var(--vp-transition-color);
}
.VPSidebar .VPSidebarItem .link:hover .text {
color: var(--vp-c-primary);
}
.VPSidebar .VPSidebarItem.is-active .link .text {
color: var(--vp-c-primary);
font-weight: 600;
}
/* Sidebar group titles */
.VPSidebar .VPSidebarGroup .title {
font-family: var(--vp-font-family-heading);
font-size: var(--vp-font-size-xs);
font-weight: 600;
text-transform: uppercase;
letter-spacing: 0.05em;
color: var(--vp-c-text-3);
padding: var(--vp-spacing-2) var(--vp-spacing-4);
}
/* ============================================
* Navigation Polish
* ============================================ */
.VPNav {
background: var(--vp-c-bg);
border-bottom: 1px solid var(--vp-c-divider);
box-shadow: var(--vp-shadow-xs);
}
.VPNavBar .title {
font-family: var(--vp-font-family-heading);
font-weight: 700;
font-size: var(--vp-font-size-lg);
color: var(--vp-c-text-1);
}
.VPNavBarMenu .VPNavBarMenuLink {
font-family: var(--vp-font-family-heading);
font-weight: 500;
font-size: var(--vp-font-size-sm);
transition: color var(--vp-transition-color);
}
.VPNavBarMenu .VPNavBarMenuLink:hover {
color: var(--vp-c-primary);
}
.VPNavBarMenu .VPNavBarMenuLink.active {
color: var(--vp-c-primary);
font-weight: 600;
}
/* ============================================
* Scrollbar Styling
* Subtle, flat design
* ============================================ */
::-webkit-scrollbar {
width: 6px;
height: 6px;
width: 8px;
height: 8px;
}
::-webkit-scrollbar-track {
@@ -337,30 +623,148 @@ table tr:hover {
::-webkit-scrollbar-thumb {
background: var(--vp-c-surface-2);
border-radius: var(--vp-radius-full);
border: 2px solid transparent;
background-clip: padding-box;
}
::-webkit-scrollbar-thumb:hover {
background: var(--vp-c-surface-3);
border: 2px solid transparent;
background-clip: padding-box;
}
/* Firefox scrollbar */
* {
scrollbar-width: thin;
scrollbar-color: var(--vp-c-surface-2) transparent;
}
/* ============================================
* TOC (Table of Contents) Polish
* Sticky positioning handled by grid layout in mobile.css
* ============================================ */
.VPDocOutline {
padding-left: 24px;
}
.VPDocOutline .outline-link {
font-family: var(--vp-font-family-base);
font-size: var(--vp-font-size-sm);
line-height: var(--vp-line-height-normal);
padding: var(--vp-spacing-1) var(--vp-spacing-2);
color: var(--vp-c-text-3);
transition: color var(--vp-transition-color);
border-radius: var(--vp-radius-md);
}
.VPDocOutline .outline-link:hover {
color: var(--vp-c-primary);
background: var(--vp-c-bg-soft);
}
.VPDocOutline .outline-link.is-active {
color: var(--vp-c-primary);
font-weight: 500;
background: var(--vp-c-bg-soft);
}
.VPDocOutline .outline-marker {
width: 2px;
background: var(--vp-c-primary);
border-radius: var(--vp-radius-full);
}
/* ============================================
* Link Improvements
* Clean, accessible link styling
* ============================================ */
a {
text-decoration: none;
transition: color 0.2s ease;
color: var(--vp-c-primary);
transition: color var(--vp-transition-color);
cursor: pointer;
}
a:hover {
text-decoration: underline;
color: var(--vp-c-primary-600);
}
a:visited {
color: var(--vp-c-primary-700);
}
.dark a:visited {
color: var(--vp-c-primary-300);
}
/* External link indicator */
.vp-doc a[target="_blank"]::after {
content: " ↗";
font-size: 0.75em;
opacity: 0.7;
}
/* ============================================
* Button Improvements
* ============================================ */
.VPButton {
font-family: var(--vp-font-family-heading);
font-weight: 600;
font-size: var(--vp-font-size-sm);
padding: var(--vp-spacing-2-5) var(--vp-spacing-5);
border-radius: var(--vp-radius-lg);
transition: all var(--vp-transition-color);
cursor: pointer;
}
.VPButton.brand {
background: var(--vp-c-primary);
color: white;
border: none;
}
.VPButton.brand:hover {
background: var(--vp-c-primary-600);
transform: translateY(-1px);
box-shadow: var(--vp-shadow-md);
}
.VPButton.alt {
background: var(--vp-c-bg-soft);
color: var(--vp-c-text-1);
border: 1px solid var(--vp-c-divider);
}
.VPButton.alt:hover {
background: var(--vp-c-bg-mute);
border-color: var(--vp-c-primary);
}
/* ============================================
* Focus States — Accessibility
* Clear visible focus for keyboard navigation
* ============================================ */
:focus-visible {
outline: 2px solid var(--vp-c-primary);
outline-offset: 2px;
border-radius: var(--vp-radius-md);
}
/* Skip focus outline for mouse users */
:focus:not(:focus-visible) {
outline: none;
}
/* Better focus for interactive elements */
a:focus-visible,
button:focus-visible,
input:focus-visible,
select:focus-visible,
textarea:focus-visible {
outline: 2px solid var(--vp-c-primary);
outline-offset: 2px;
box-shadow: 0 0 0 4px rgba(59, 130, 246, 0.15);
}
/* ============================================

View File

@@ -1,5 +1,6 @@
/**
* Mobile-Responsive Styles
* Design System: ui-ux-pro-max — flat design, mobile-first
* Breakpoints: < 480px (xs), < 768px (sm/mobile), 768px-1024px (md/tablet), > 1024px (lg/desktop)
* WCAG 2.1 AA compliant
*
@@ -253,15 +254,16 @@
/* Base Mobile Styles (320px+) */
@media (max-width: 767px) {
/* Typography */
/* Typography - smaller base for mobile */
:root {
--vp-font-size-base: 14px;
--vp-content-width: 100%;
--vp-prose-width: 100%;
}
/* Container */
.container {
padding: 0 12px;
padding: 0 var(--vp-spacing-3);
}
/* Navigation - ensure hamburger menu is visible */
@@ -271,10 +273,15 @@
}
.VPNavBar {
padding: 0 12px;
padding: 0;
overflow: visible !important;
}
/* VPNavBar content padding for alignment */
.VPNavBar .content {
padding: 0 var(--vp-spacing-3);
}
/* Navigation bar content wrapper */
.VPNavBar .content {
overflow: visible !important;
@@ -297,8 +304,8 @@
/* Reduce nav-extensions gap on mobile */
.VPNavBar .nav-extensions {
gap: 0.25rem;
padding-left: 0.25rem;
gap: var(--vp-spacing-1);
padding-left: var(--vp-spacing-1);
overflow: visible !important;
}
@@ -333,10 +340,10 @@
overflow-y: auto;
background: var(--vp-c-bg);
border: 1px solid var(--vp-c-divider);
border-radius: 8px;
box-shadow: 0 4px 20px rgba(0, 0, 0, 0.15);
border-radius: var(--vp-radius-lg);
box-shadow: var(--vp-shadow-lg);
z-index: 100;
padding: 8px 0;
padding: var(--vp-spacing-2) 0;
}
/* Language switcher dropdown fix */
@@ -354,7 +361,7 @@
min-width: 200px !important;
max-width: calc(100vw - 24px) !important;
z-index: 1000 !important;
box-shadow: 0 8px 24px rgba(0, 0, 0, 0.2) !important;
box-shadow: var(--vp-shadow-xl) !important;
}
/* Sidebar - fix display issues */
@@ -365,12 +372,19 @@
top: 56px !important;
height: calc(100vh - 56px) !important;
max-height: calc(100vh - 56px) !important;
overflow: visible !important;
overflow-y: auto !important;
overflow-x: hidden !important;
position: fixed !important;
left: 0 !important;
z-index: 40 !important;
background: var(--vp-c-bg) !important;
transition: transform 0.25s ease !important;
border-right: 1px solid var(--vp-c-divider);
}
/* Add padding to sidebar nav to prevent scrollbar overlap with navbar */
.VPSidebar .VPSidebarNav {
padding-top: var(--vp-spacing-4) !important;
}
/* Sidebar when open */
@@ -386,7 +400,7 @@
/* Sidebar nav container */
.VPSidebar .VPSidebarNav {
padding: 12px 0;
padding: var(--vp-spacing-3) 0;
height: 100%;
min-height: auto;
overflow-y: auto;
@@ -395,17 +409,17 @@
/* Sidebar groups */
.VPSidebar .VPSidebarGroup {
padding: 8px 16px;
padding: var(--vp-spacing-2) var(--vp-spacing-4);
}
/* Sidebar items */
.VPSidebar .VPSidebarItem {
padding: 6px 0;
padding: var(--vp-spacing-1-5) 0;
}
/* Ensure sidebar links are properly sized */
.VPSidebar .link {
padding: 8px 12px;
padding: var(--vp-spacing-2) var(--vp-spacing-3);
display: block;
}
@@ -434,21 +448,21 @@
/* Make sure all sidebar content is visible */
.VPSidebar .group {
margin: 0;
padding: 12px 16px;
padding: var(--vp-spacing-3) var(--vp-spacing-4);
}
.VPSidebar .title {
font-size: 14px;
font-size: var(--vp-font-size-sm);
font-weight: 600;
padding: 4px 0;
padding: var(--vp-spacing-1) 0;
color: var(--vp-c-text-1);
}
/* Sidebar text styling */
.VPSidebar .text {
font-size: 14px;
line-height: 1.5;
padding: 6px 12px;
font-size: var(--vp-font-size-sm);
line-height: var(--vp-line-height-normal);
padding: var(--vp-spacing-1-5) var(--vp-spacing-3);
}
/* Ensure nested items are visible */
@@ -467,12 +481,12 @@
/* Content - reduce padding for better space usage */
.VPContent {
padding: 12px;
padding: var(--vp-spacing-3);
}
/* Doc content adjustments - reduce padding */
.VPDoc .content-container {
padding: 0 12px;
padding: 0 var(--vp-spacing-3);
}
/* Hide outline on mobile */
@@ -482,27 +496,27 @@
/* Hero Section */
.VPHomeHero {
padding: 40px 12px;
padding: var(--vp-spacing-10) var(--vp-spacing-3);
}
.VPHomeHero h1 {
font-size: 28px;
line-height: 1.2;
font-size: var(--vp-font-size-2xl);
line-height: var(--vp-line-height-tight);
}
.VPHomeHero p {
font-size: 14px;
font-size: var(--vp-font-size-sm);
}
/* Code Blocks - reduce margins */
div[class*='language-'] {
margin: 12px -12px;
margin: var(--vp-spacing-3) calc(var(--vp-spacing-3) * -1);
border-radius: 0;
}
div[class*='language-'] pre {
padding: 12px;
font-size: 12px;
padding: var(--vp-spacing-3);
font-size: var(--vp-font-size-xs);
}
/* Tables - make them scrollable */
@@ -514,23 +528,23 @@
}
table {
font-size: 12px;
font-size: var(--vp-font-size-xs);
}
table th,
table td {
padding: 8px 12px;
padding: var(--vp-spacing-2) var(--vp-spacing-3);
}
/* Buttons */
.VPButton {
padding: 8px 16px;
font-size: 14px;
padding: var(--vp-spacing-2) var(--vp-spacing-4);
font-size: var(--vp-font-size-sm);
}
/* Cards */
.VPFeature {
padding: 16px;
padding: var(--vp-spacing-4);
}
/* Touch-friendly tap targets (min 44x44px per WCAG) */
@@ -550,13 +564,13 @@
/* Theme Switcher */
.theme-switcher {
padding: 12px;
padding: var(--vp-spacing-3);
}
/* Breadcrumbs */
.breadcrumb {
padding: 8px 0;
font-size: 12px;
padding: var(--vp-spacing-2) 0;
font-size: var(--vp-font-size-xs);
}
/* Table of Contents - hidden on mobile */
@@ -566,34 +580,34 @@
/* Typography adjustments for mobile */
.vp-doc h1 {
font-size: 1.75rem;
margin-bottom: 1rem;
font-size: var(--vp-font-size-2xl);
margin-bottom: var(--vp-spacing-4);
}
.vp-doc h2 {
font-size: 1.375rem;
margin-top: 2rem;
padding-top: 1.5rem;
font-size: var(--vp-font-size-xl);
margin-top: var(--vp-spacing-8);
padding-top: var(--vp-spacing-6);
}
.vp-doc h3 {
font-size: 1.125rem;
margin-top: 1.5rem;
font-size: var(--vp-font-size-lg);
margin-top: var(--vp-spacing-6);
}
.vp-doc p {
line-height: 1.7;
margin: 1rem 0;
line-height: var(--vp-line-height-relaxed);
margin: var(--vp-spacing-4) 0;
}
.vp-doc ul,
.vp-doc ol {
margin: 1rem 0;
padding-left: 1.25rem;
margin: var(--vp-spacing-4) 0;
padding-left: var(--vp-spacing-5);
}
.vp-doc li {
margin: 0.375rem 0;
margin: var(--vp-spacing-1-5) 0;
}
}
@@ -602,39 +616,40 @@
* ============================================ */
@media (min-width: 768px) and (max-width: 1023px) {
:root {
--vp-content-width: 760px;
--vp-content-width: 720px;
--vp-sidebar-width: 240px;
--vp-prose-width: 640px;
}
.VPContent {
padding: 24px;
padding: var(--vp-spacing-6);
}
.VPDoc .content-container {
padding: 0 24px;
max-width: 90% !important;
padding: 0 var(--vp-spacing-6);
max-width: 98% !important;
}
.VPHomeHero {
padding: 60px 24px;
padding: var(--vp-spacing-16) var(--vp-spacing-6);
}
.VPHomeHero h1 {
font-size: 36px;
font-size: var(--vp-font-size-3xl);
}
div[class*='language-'] {
margin: 12px 0;
margin: var(--vp-spacing-3) 0;
}
/* Outline visible but narrower */
.VPDocOutline {
width: 200px;
padding-left: 16px;
padding-left: var(--vp-spacing-4);
}
.VPDocOutline .outline-link {
font-size: 12px;
font-size: var(--vp-font-size-xs);
}
}
@@ -643,52 +658,122 @@
* ============================================ */
@media (min-width: 1024px) {
:root {
--vp-layout-max-width: 1600px;
--vp-content-width: 960px;
--vp-sidebar-width: 272px;
--vp-layout-max-width: 1440px;
--vp-content-width: 860px;
--vp-sidebar-width: 280px;
--vp-prose-width: 720px;
--vp-toc-width: 220px;
}
.VPContent {
padding: 32px 48px;
max-width: var(--vp-layout-max-width);
padding: var(--vp-spacing-8) var(--vp-spacing-12);
/* Remove max-width to allow full viewport width */
}
.VPDoc .content-container {
max-width: 90% !important;
padding: 0 40px;
/* Desktop sidebar - restore fixed positioning but with proper width */
.VPSidebar {
position: fixed !important;
left: 0 !important;
top: var(--vp-nav-height, 56px) !important;
width: var(--vp-sidebar-width, 280px) !important;
height: calc(100vh - var(--vp-nav-height, 56px)) !important;
padding: 0 !important;
overflow-y: auto !important;
border-right: 1px solid var(--vp-c-divider) !important;
z-index: 10 !important;
}
/* Outline - sticky on desktop with good width */
.VPDocOutline {
position: sticky;
top: calc(var(--vp-nav-height) + 24px);
width: 256px;
padding-left: 24px;
max-height: calc(100vh - var(--vp-nav-height) - 48px);
/* Desktop sidebar - add padding to inner nav */
.VPSidebar nav.nav {
padding: var(--vp-spacing-4) !important;
height: auto;
}
/* Ensure content has proper margin-left to clear the sidebar */
.VPContent.has-sidebar {
margin-left: var(--vp-sidebar-width, 280px) !important;
margin-right: calc(var(--vp-toc-width, 220px) + 48px) !important;
padding: var(--vp-spacing-8) var(--vp-spacing-12) !important;
}
/* Adjust doc container - remove auto margin to prevent offset */
.VPDoc.has-aside .content-container {
max-width: 100%;
padding: 0 var(--vp-spacing-10);
}
/* Right TOC - fixed position with right margin */
.VPDocAside {
position: fixed;
right: 24px;
top: calc(var(--vp-nav-height, 56px) + 16px);
width: var(--vp-toc-width, 220px);
height: auto;
max-height: calc(100vh - var(--vp-nav-height, 56px) - 64px);
overflow-y: auto;
}
.aside-container {
position: fixed;
right: 24px;
top: calc(var(--vp-nav-height, 56px) + 16px);
width: var(--vp-toc-width, 220px);
height: auto;
max-height: calc(100vh - var(--vp-nav-height, 56px) - 64px);
overflow-y: auto;
}
.VPDocOutline {
position: relative;
height: auto;
max-height: 100%;
overflow-y: auto;
padding: var(--vp-spacing-4);
}
/* Navbar title - anchor to left edge */
.VPNavBarTitle {
position: relative !important;
margin-left: 0 !important;
padding-left: 0 !important;
}
/* Ensure navbar content-body has proper left padding */
.VPNavBar .content-body {
padding-left: var(--vp-spacing-4) !important;
}
/* Fix title position */
.VPNavBar .title {
padding-left: var(--vp-spacing-4) !important;
left: 0 !important;
}
/* Home page navbar - reduce title left margin since no sidebar */
.Layout:has(.pro-home) .VPNavBar .content-body,
.Layout:has(.pro-home) .VPNavBar .title {
padding-left: 0 !important;
}
/* Home page - no sidebar margin */
.Layout:has(.pro-home) .VPContent {
margin-left: 0 !important;
}
.VPDocOutline .outline-marker {
display: block;
}
.VPDocOutline .outline-link {
font-size: 13px;
line-height: 1.6;
padding: 4px 12px;
transition: color 0.2s ease;
font-size: var(--vp-font-size-sm);
line-height: var(--vp-line-height-normal);
padding: var(--vp-spacing-1) var(--vp-spacing-3);
transition: color var(--vp-transition-color);
}
.VPDocOutline .outline-link:hover {
color: var(--vp-c-primary);
}
/* Two-column layout for content + TOC */
.content-with-toc {
display: grid;
grid-template-columns: 1fr 280px;
gap: 32px;
}
}
/* ============================================
@@ -696,17 +781,17 @@
* ============================================ */
@media (min-width: 1440px) {
:root {
--vp-content-width: 1040px;
--vp-sidebar-width: 280px;
--vp-content-width: 920px;
--vp-sidebar-width: 300px;
--vp-prose-width: 760px;
--vp-toc-width: 260px;
}
.VPDoc .content-container {
max-width: 90% !important;
padding: 0 48px;
}
.VPDocOutline {
width: 280px;
.VPDoc.has-aside .content-container {
max-width: 100%;
padding: 0 var(--vp-spacing-12);
margin-left: 0;
margin-right: 0;
}
}

View File

@@ -79,23 +79,58 @@
--vp-c-text-4: #9ca3af;
--vp-c-text-code: #ef4444;
/* Typography */
--vp-font-family-base: 'Inter', -apple-system, BlinkMacSystemFont, 'Segoe UI', Roboto, Oxygen, Ubuntu, Cantarell, 'Fira Sans', 'Droid Sans', 'Helvetica Neue', sans-serif;
--vp-font-family-mono: 'Fira Code', 'Cascadia Code', 'JetBrains Mono', Consolas, 'Courier New', monospace;
/* Typography - Developer-focused font pairing */
--vp-font-family-base: 'Inter', 'IBM Plex Sans', -apple-system, BlinkMacSystemFont, 'Segoe UI', Roboto, Oxygen, Ubuntu, Cantarell, 'Helvetica Neue', sans-serif;
--vp-font-family-mono: 'JetBrains Mono', 'Fira Code', 'Cascadia Code', Consolas, 'Courier New', monospace;
--vp-font-family-heading: 'Inter', 'IBM Plex Sans', -apple-system, BlinkMacSystemFont, sans-serif;
/* Font Sizes */
--vp-font-size-base: 16px;
--vp-font-size-sm: 14px;
--vp-font-size-lg: 18px;
--vp-font-size-xl: 20px;
/* Font Sizes - Modular scale (1.25 ratio) */
--vp-font-size-xs: 0.75rem; /* 12px */
--vp-font-size-sm: 0.875rem; /* 14px */
--vp-font-size-base: 1rem; /* 16px */
--vp-font-size-lg: 1.125rem; /* 18px */
--vp-font-size-xl: 1.25rem; /* 20px */
--vp-font-size-2xl: 1.5rem; /* 24px */
--vp-font-size-3xl: 1.875rem; /* 30px */
--vp-font-size-4xl: 2.25rem; /* 36px */
/* Spacing (Fixed) */
--vp-spacing-xs: 0.25rem; /* 4px */
--vp-spacing-sm: 0.5rem; /* 8px */
--vp-spacing-md: 1rem; /* 16px */
--vp-spacing-lg: 1.5rem; /* 24px */
--vp-spacing-xl: 2rem; /* 32px */
--vp-spacing-2xl: 3rem; /* 48px */
/* Line Heights - Optimized for readability */
--vp-line-height-tight: 1.25;
--vp-line-height-snug: 1.4;
--vp-line-height-normal: 1.6;
--vp-line-height-relaxed: 1.75;
--vp-line-height-loose: 2;
/* Spacing (Fixed) - 8px base grid */
--vp-spacing-0: 0;
--vp-spacing-px: 1px;
--vp-spacing-0-5: 0.125rem; /* 2px */
--vp-spacing-1: 0.25rem; /* 4px */
--vp-spacing-1-5: 0.375rem; /* 6px */
--vp-spacing-2: 0.5rem; /* 8px */
--vp-spacing-2-5: 0.625rem; /* 10px */
--vp-spacing-3: 0.75rem; /* 12px */
--vp-spacing-3-5: 0.875rem; /* 14px */
--vp-spacing-4: 1rem; /* 16px */
--vp-spacing-5: 1.25rem; /* 20px */
--vp-spacing-6: 1.5rem; /* 24px */
--vp-spacing-7: 1.75rem; /* 28px */
--vp-spacing-8: 2rem; /* 32px */
--vp-spacing-9: 2.25rem; /* 36px */
--vp-spacing-10: 2.5rem; /* 40px */
--vp-spacing-12: 3rem; /* 48px */
--vp-spacing-14: 3.5rem; /* 56px */
--vp-spacing-16: 4rem; /* 64px */
--vp-spacing-20: 5rem; /* 80px */
--vp-spacing-24: 6rem; /* 96px */
/* Legacy aliases for backward compatibility */
--vp-spacing-xs: var(--vp-spacing-1);
--vp-spacing-sm: var(--vp-spacing-2);
--vp-spacing-md: var(--vp-spacing-4);
--vp-spacing-lg: var(--vp-spacing-6);
--vp-spacing-xl: var(--vp-spacing-8);
--vp-spacing-2xl: var(--vp-spacing-12);
/* Fluid Spacing (Responsive with clamp())
* Scales smoothly between viewport widths
@@ -116,18 +151,24 @@
--container-outline: outline;
--container-nav: nav;
/* Border Radius */
/* Border Radius - Subtle, flat design friendly */
--vp-radius-none: 0;
--vp-radius-sm: 0.25rem; /* 4px */
--vp-radius-md: 0.375rem; /* 6px */
--vp-radius-lg: 0.5rem; /* 8px */
--vp-radius-xl: 0.75rem; /* 12px */
--vp-radius-2xl: 1rem; /* 16px */
--vp-radius-3xl: 1.5rem; /* 24px */
--vp-radius-full: 9999px;
/* Shadows */
--vp-shadow-sm: 0 1px 2px 0 rgb(0 0 0 / 0.05);
--vp-shadow-md: 0 4px 6px -1px rgb(0 0 0 / 0.1);
--vp-shadow-lg: 0 10px 15px -3 rgb(0 0 0 / 0.1);
--vp-shadow-xl: 0 20px 25px -5 rgb(0 0 0 / 0.1);
/* Shadows - Subtle for flat design */
--vp-shadow-xs: 0 1px 2px 0 rgb(0 0 0 / 0.03);
--vp-shadow-sm: 0 1px 3px 0 rgb(0 0 0 / 0.05), 0 1px 2px -1px rgb(0 0 0 / 0.05);
--vp-shadow-md: 0 4px 6px -1px rgb(0 0 0 / 0.07), 0 2px 4px -2px rgb(0 0 0 / 0.05);
--vp-shadow-lg: 0 10px 15px -3px rgb(0 0 0 / 0.08), 0 4px 6px -4px rgb(0 0 0 / 0.05);
--vp-shadow-xl: 0 20px 25px -5px rgb(0 0 0 / 0.08), 0 8px 10px -6px rgb(0 0 0 / 0.05);
--vp-shadow-inner: inset 0 2px 4px 0 rgb(0 0 0 / 0.05);
--vp-shadow-none: 0 0 #0000;
/* Transitions */
--vp-transition-color: 0.2s ease;