feat: add docs

This commit is contained in:
2026-01-29 22:44:36 +08:00
parent 110aec7d5f
commit c214c11244
10 changed files with 573 additions and 7 deletions

49
docs/.vitepress/config.ts Normal file
View File

@@ -0,0 +1,49 @@
import { defineConfig } from "vitepress";
import {
groupIconMdPlugin,
groupIconVitePlugin,
} from "vitepress-plugin-group-icons";
// https://vitepress.dev/reference/site-config
export default defineConfig({
title: "Hucky 操作指南",
description: "帮助您快速入门",
themeConfig: {
// https://vitepress.dev/reference/default-theme-config
nav: [
{ text: "首页", link: "/" },
{ text: "文档", link: "/quick_start/dependencies" },
],
sidebar: [
{
text: "快速上手",
items: [{ text: "依赖项介绍", link: "/quick_start/dependencies" }],
},
{
text: "脚手架特色",
items: [{ text: "自动路由", link: "/cli_feature/auto_router" }],
},
],
socialLinks: [
{
icon: "github",
link: "https://github.com/gushen610140/template-vue-hucky",
},
{
icon: "gitea",
link: "http://113.46.158.62:3000/gushen/template-vue-hucky",
},
],
},
markdown: {
config: (md) => {
// 使用插件为代码块丰富样式
md.use(groupIconMdPlugin);
},
},
vite: {
plugins: [groupIconVitePlugin()],
},
});

View File

@@ -0,0 +1,8 @@
// .vitepress/theme/index.ts
import DefaultTheme from "vitepress/theme";
import "virtual:group-icons.css"; //代码组样式
export default {
extends: DefaultTheme,
};

View File

@@ -0,0 +1,2 @@
/* .vitepress/theme/style/index.css */
@import './vp-code-title.css';

View File

@@ -0,0 +1,68 @@
/* .vitepress/theme/style/vp-code-title.css */
/* 整体容器样式(带阴影和圆角) */
.vp-code-block-title {
background-color: var(--vp-code-block-bg);
margin-bottom: 20px;
border-radius: 8px;
box-shadow: 0 10px 30px 0 rgba(0, 0, 0, 0.4); /* 添加阴影 */
overflow: hidden;
position: relative; /* 确保小圆点定位 */
}
/* Mac 风格的小圆点,放在容器顶部 */
.vp-code-block-title::before {
content: '';
position: absolute;
top: 12px; /* 圆点距离容器顶部的距离 */
left: 12px;
width: 12px;
height: 12px;
background-color: #fc625d; /* 红色圆点 */
border-radius: 50%;
box-shadow: 20px 0 #fdbc40, 40px 0 #35cd4b; /* 黄色和绿色圆点 */
z-index: 1;
}
/* 标题栏样式 */
.vp-code-block-title .vp-code-block-title-bar {
color: var(--vp-c-text-1);
font-size: 14px;
font-weight: bold;
}
/* 代码块标题:修正倒角、阴影、边距 */
.vp-code-block-title div[class*="language-"].vp-adaptive-theme.line-numbers-mode {
border-radius: 8px;
box-shadow: none;
padding-top: 0px;
margin-bottom: 0px;
}
/* 代码块标题:隐藏小圆点 */
.vp-code-block-title div[class*="language-"].vp-adaptive-theme.line-numbers-mode::before {
display: none;
}
/* 代码块标题:修正行号位置 */
.vp-code-block-title .line-numbers-mode .line-numbers-wrapper {
padding-top: 20px;
}
/* 代码块标题:修正行号右侧竖线位置 */
.vp-code-block-title .line-numbers-mode .line-numbers-wrapper::after {
top: 20px;
height: calc(100% - 40px);
}
/* 代码块标题(无行号):修正倒角、阴影、边距 */
.vp-code-block-title div[class*="language-"].vp-adaptive-theme {
border-radius: 8px;
box-shadow: none;
padding-top: 0px;
}
/* 代码块标题(无行号):隐藏小圆点 */
.vp-code-block-title div[class*="language-"].vp-adaptive-theme::before {
display: none;
}