docs: migrate documentation from VitePress to Starlight (#361)
- Replace VitePress with Astro Starlight for documentation - Reorganize document structure with better hierarchy - Split large documents into sub-modules for better readability - Add new sections: component, entity-query, serialization, system - Support both Chinese (default) and English documentation - Add responsive design and improved navigation
This commit is contained in:
YHH
GitHub
238
docs/src/styles/custom.css
Normal file
238
docs/src/styles/custom.css
Normal file
@@ -0,0 +1,238 @@
|
||||
/* ESEngine Documentation Theme */
|
||||
|
||||
:root {
|
||||
/* Brand colors */
|
||||
--sl-color-accent-low: #1a1a2e;
|
||||
--sl-color-accent: #646cff;
|
||||
--sl-color-accent-high: #a5b4fc;
|
||||
|
||||
/* Background */
|
||||
--sl-color-bg: #0a0a0f;
|
||||
--sl-color-bg-nav: rgba(10, 10, 15, 0.95);
|
||||
--sl-color-bg-sidebar: #0f0f14;
|
||||
|
||||
/* Text */
|
||||
--sl-color-white: #ffffff;
|
||||
--sl-color-gray-1: #f8fafc;
|
||||
--sl-color-gray-2: #e2e8f0;
|
||||
--sl-color-gray-3: #94a3b8;
|
||||
--sl-color-gray-4: #64748b;
|
||||
--sl-color-gray-5: #475569;
|
||||
--sl-color-gray-6: #1e293b;
|
||||
|
||||
/* Typography */
|
||||
--sl-font-system: 'Inter', -apple-system, BlinkMacSystemFont, 'Segoe UI', Roboto, sans-serif;
|
||||
--sl-font-system-mono: 'JetBrains Mono', 'Fira Code', Consolas, monospace;
|
||||
|
||||
/* Layout */
|
||||
--sl-content-width: 75rem;
|
||||
--sl-sidebar-width: 18rem;
|
||||
}
|
||||
|
||||
/* Navigation bar */
|
||||
header.header {
|
||||
backdrop-filter: blur(12px);
|
||||
border-bottom: 1px solid rgba(100, 108, 255, 0.1);
|
||||
}
|
||||
|
||||
/* Sidebar styling */
|
||||
.sidebar-content {
|
||||
background: var(--sl-color-bg-sidebar);
|
||||
}
|
||||
|
||||
nav.sidebar-content ul li a {
|
||||
padding: 0.5rem 1rem;
|
||||
border-radius: 6px;
|
||||
transition: all 0.2s ease;
|
||||
}
|
||||
|
||||
nav.sidebar-content ul li a:hover {
|
||||
background: rgba(100, 108, 255, 0.1);
|
||||
}
|
||||
|
||||
nav.sidebar-content ul li a[aria-current="page"] {
|
||||
background: rgba(100, 108, 255, 0.15);
|
||||
border-left: 3px solid var(--sl-color-accent);
|
||||
color: var(--sl-color-accent-high);
|
||||
}
|
||||
|
||||
/* Group labels */
|
||||
.sidebar-content .top-level > li > details > summary,
|
||||
.sidebar-content .top-level > li > a {
|
||||
font-weight: 600;
|
||||
text-transform: uppercase;
|
||||
font-size: 0.75rem;
|
||||
letter-spacing: 0.05em;
|
||||
color: var(--sl-color-gray-3);
|
||||
}
|
||||
|
||||
/* Content area */
|
||||
.sl-markdown-content {
|
||||
font-size: 1rem;
|
||||
line-height: 1.75;
|
||||
}
|
||||
|
||||
/* Headings */
|
||||
.sl-markdown-content h1 {
|
||||
font-size: 2rem;
|
||||
font-weight: 700;
|
||||
margin-top: 0;
|
||||
padding-bottom: 0.75rem;
|
||||
border-bottom: 1px solid var(--sl-color-gray-6);
|
||||
}
|
||||
|
||||
.sl-markdown-content h2 {
|
||||
font-size: 1.5rem;
|
||||
font-weight: 600;
|
||||
margin-top: 2.5rem;
|
||||
padding-left: 1rem;
|
||||
border-left: 3px solid var(--sl-color-accent);
|
||||
background: linear-gradient(90deg, rgba(100, 108, 255, 0.1) 0%, transparent 100%);
|
||||
}
|
||||
|
||||
.sl-markdown-content h3 {
|
||||
font-size: 1.25rem;
|
||||
font-weight: 600;
|
||||
margin-top: 2rem;
|
||||
padding-left: 0.75rem;
|
||||
border-left: 2px solid var(--sl-color-gray-5);
|
||||
}
|
||||
|
||||
/* Code blocks */
|
||||
.sl-markdown-content pre {
|
||||
background: #0d0d12 !important;
|
||||
border: 1px solid var(--sl-color-gray-6);
|
||||
border-radius: 8px;
|
||||
padding: 1rem;
|
||||
}
|
||||
|
||||
.sl-markdown-content code {
|
||||
font-family: var(--sl-font-system-mono);
|
||||
font-size: 0.9em;
|
||||
}
|
||||
|
||||
.sl-markdown-content :not(pre) > code {
|
||||
background: rgba(100, 108, 255, 0.1);
|
||||
padding: 0.2em 0.4em;
|
||||
border-radius: 4px;
|
||||
color: var(--sl-color-accent-high);
|
||||
}
|
||||
|
||||
/* Tables */
|
||||
.sl-markdown-content table {
|
||||
width: 100%;
|
||||
border-collapse: separate;
|
||||
border-spacing: 0;
|
||||
border-radius: 8px;
|
||||
overflow: hidden;
|
||||
border: 1px solid var(--sl-color-gray-6);
|
||||
}
|
||||
|
||||
.sl-markdown-content th {
|
||||
background: var(--sl-color-gray-6);
|
||||
font-weight: 600;
|
||||
text-transform: uppercase;
|
||||
font-size: 0.75rem;
|
||||
letter-spacing: 0.05em;
|
||||
padding: 0.75rem 1rem;
|
||||
text-align: left;
|
||||
}
|
||||
|
||||
.sl-markdown-content td {
|
||||
padding: 0.75rem 1rem;
|
||||
border-top: 1px solid var(--sl-color-gray-6);
|
||||
}
|
||||
|
||||
.sl-markdown-content tr:nth-child(even) td {
|
||||
background: rgba(30, 41, 59, 0.3);
|
||||
}
|
||||
|
||||
/* Callouts / Asides */
|
||||
.starlight-aside {
|
||||
border-radius: 8px;
|
||||
border-left-width: 4px;
|
||||
padding: 1rem 1.25rem;
|
||||
}
|
||||
|
||||
.starlight-aside--note {
|
||||
background: linear-gradient(90deg, rgba(59, 130, 246, 0.1) 0%, transparent 100%);
|
||||
border-color: #3b82f6;
|
||||
}
|
||||
|
||||
.starlight-aside--tip {
|
||||
background: linear-gradient(90deg, rgba(34, 197, 94, 0.1) 0%, transparent 100%);
|
||||
border-color: #22c55e;
|
||||
}
|
||||
|
||||
.starlight-aside--caution {
|
||||
background: linear-gradient(90deg, rgba(245, 158, 11, 0.1) 0%, transparent 100%);
|
||||
border-color: #f59e0b;
|
||||
}
|
||||
|
||||
.starlight-aside--danger {
|
||||
background: linear-gradient(90deg, rgba(239, 68, 68, 0.1) 0%, transparent 100%);
|
||||
border-color: #ef4444;
|
||||
}
|
||||
|
||||
/* Links */
|
||||
.sl-markdown-content a {
|
||||
color: var(--sl-color-accent);
|
||||
text-decoration: none;
|
||||
border-bottom: 1px solid transparent;
|
||||
transition: border-color 0.2s ease;
|
||||
}
|
||||
|
||||
.sl-markdown-content a:hover {
|
||||
border-bottom-color: var(--sl-color-accent);
|
||||
}
|
||||
|
||||
/* Search */
|
||||
.search-input {
|
||||
background: var(--sl-color-gray-6);
|
||||
border: 1px solid transparent;
|
||||
border-radius: 8px;
|
||||
transition: border-color 0.2s ease;
|
||||
}
|
||||
|
||||
.search-input:focus {
|
||||
border-color: var(--sl-color-accent);
|
||||
outline: none;
|
||||
}
|
||||
|
||||
/* Badge */
|
||||
.sl-badge {
|
||||
font-size: 0.75rem;
|
||||
font-weight: 600;
|
||||
padding: 0.25em 0.5em;
|
||||
border-radius: 4px;
|
||||
}
|
||||
|
||||
/* Hero section */
|
||||
.hero {
|
||||
text-align: center;
|
||||
padding: 4rem 0;
|
||||
}
|
||||
|
||||
.hero h1 {
|
||||
font-size: 3rem;
|
||||
font-weight: 800;
|
||||
background: linear-gradient(135deg, #fff 0%, var(--sl-color-accent-high) 100%);
|
||||
-webkit-background-clip: text;
|
||||
-webkit-text-fill-color: transparent;
|
||||
background-clip: text;
|
||||
}
|
||||
|
||||
/* Responsive */
|
||||
@media (max-width: 768px) {
|
||||
.sl-markdown-content h1 {
|
||||
font-size: 1.75rem;
|
||||
}
|
||||
|
||||
.sl-markdown-content h2 {
|
||||
font-size: 1.25rem;
|
||||
}
|
||||
|
||||
.hero h1 {
|
||||
font-size: 2rem;
|
||||
}
|
||||
}
|
||||
1
docs/src/styles/global.css
Normal file
1
docs/src/styles/global.css
Normal file
@@ -0,0 +1 @@
|
||||
@import "tailwindcss";
|
||||
Reference in New Issue
Block a user