紧急规避敏感词防止被封禁

.gitignore

@@ -19,6 +19,7 @@ pnpm-lock.yaml
 yarn.lock
 bun.lockb
 
-# VitePress编译输出文件
+# 编译输出文件
 docs/.vitepress/cache/
 docs/.vitepress/dist/
+dist/

base/index.ts

@@ -0,0 +1 @@
+export * from "./src/utils"

base/package.json

@@ -0,0 +1,22 @@
+{
+  "name": "vitepress-handbook",
+  "description": "VitePress构建手册基础设施",
+  "version": "0.0.0",
+  "type": "module",
+  "private": true,
+  "scripts": {
+    "build": "vue-tsc -b && vite build"
+  },
+  "dependencies": {
+    "vitepress": "^1.3.3",
+    "vue": "^3.4.38"
+  },
+  "devDependencies": {
+    "@vitejs/plugin-vue": "^5.1.2",
+    "rollup-plugin-dts": "^6.1.1",
+    "typescript": "^5.5.4",
+    "vite": "^5.4.2",
+    "vite-plugin-dts": "^4.0.3",
+    "vue-tsc": "^2.0.29"
+  }
+}

base/src/utils.ts

@@ -0,0 +1,16 @@
+export function ensurePrefix(raw: string, prefix: string) {
+  return raw.startsWith(prefix) ? raw : prefix + raw
+}
+
+export function ensureSuffix(raw: string, suffix: string) {
+  return raw.endsWith(suffix) ? raw : raw + suffix
+}
+
+export function removePrefix(raw: string, prefix: string) {
+  return raw.startsWith(prefix) ? raw.slice(prefix.length) : raw
+}
+
+export function maybeCapitalCase(raw: string | undefined) {
+  if (!raw) return undefined
+  return raw.charAt(0).toUpperCase() + raw.slice(1)
+}

base/tsconfig.json

@@ -0,0 +1,25 @@
+{
+  "compilerOptions": {
+    "target": "ES2020",
+    "useDefineForClassFields": true,
+    "module": "ESNext",
+    "lib": ["ES2020", "DOM", "DOM.Iterable"],
+    "skipLibCheck": true,
+
+    // 打包模式。
+    "moduleResolution": "bundler",
+    "allowImportingTsExtensions": true,
+    "isolatedModules": true,
+    "moduleDetection": "force",
+    "noEmit": true,
+    "jsx": "preserve",
+    "declaration": true,
+
+    // 代码检查。
+    "strict": true,
+    "noUnusedLocals": true,
+    "noUnusedParameters": true,
+    "noFallthroughCasesInSwitch": true
+  },
+  "include": ["index.ts", "src/**/*.ts", "src/**/*.vue"]
+}

base/vite.config.ts

@@ -0,0 +1,22 @@
+import vue from "@vitejs/plugin-vue"
+import {defineConfig} from "vite"
+import dts from "vite-plugin-dts"
+
+export default defineConfig({
+  plugins: [vue(), dts()],
+  build: {
+    lib: {
+      entry: "index.ts",
+      name: "handbook",
+      fileName: "handbook",
+      formats: ["es", "umd"],
+    },
+    sourcemap: true,
+    outDir: "dist",
+    emptyOutDir: true,
+    rollupOptions: {
+      external: ["vitepress", "vue"],
+      output: {globals: {vitepress: "VitePress", vue: "Vue"}, compact: false},
+    },
+  },
+})

docs/index.md

@@ -4,7 +4,7 @@ layout: home
 hero:
   name: 数社软件开发手册
   text: 知识工程基础设施
-  tagline: 先进技术应当掌握在人民群众手中
+  tagline: 助您快速形成软件开发生产力
   actions:
     - {theme: brand, text: 如何使用, link: /guide}
     - {theme: alt, text: 编程规范, link: /spec/intro}

package.json

@@ -14,6 +14,7 @@
     "markdown-it": "^14.1.0",
     "pagefind": "^1.1.0",
     "vitepress": "^1.3.3",
+    "vitepress-handbook": "./base",
     "vitepress-plugin-pagefind": "^0.4.10",
     "vue": "^3.4.38"
   },

pnpm-workspace.yaml

@@ -0,0 +1 @@
+packages: [base]