22a177c569
原单页塞了 13 个二级标题、右侧目录过长。拆成 7 页: - 概览(含选型指引与环境对照表) - 路径前缀必读(独立成页,最高频故障) - 推荐环境:Docker + nginx - 静态托管部署(nginx 子路径/根路径、Apache、Caddy、对象存储、pnpm) - 内网与离线部署(4 种方案 + 对比表) - 本地开发与预览(含新增页面步骤) - 常见问题(部署/构建/运行三类 + 自检清单) 侧边栏分为三组:部署手册 / 部署方式 / 开发与排错
158 lines
5.0 KiB
TypeScript
158 lines
5.0 KiB
TypeScript
import { defineConfig } from 'vitepress'
|
|
|
|
const webManualItems = [
|
|
{ text: '快速开始', link: '/manual/web/' },
|
|
{ text: '首页与通用操作', link: '/manual/web/home' },
|
|
{ text: '卡信息', link: '/manual/web/card-info' },
|
|
{ text: '智能诊断', link: '/manual/web/intelligent-diagnosis' },
|
|
{ text: '业务受理与达量断网', link: '/manual/web/business-operations' },
|
|
{ text: '套餐配置与定价', link: '/manual/web/packages-and-pricing' },
|
|
{ text: '预警管理', link: '/manual/web/warnings' },
|
|
{ text: '入库、库存与出库', link: '/manual/web/inventory' },
|
|
{ text: '通道与接入管理', link: '/manual/web/channels' },
|
|
{ text: '企业、用户与角色', link: '/manual/web/enterprise-management' },
|
|
{ text: '工单管理', link: '/manual/web/work-orders' },
|
|
{ text: 'API 凭证与执行日志', link: '/manual/web/api-and-logs' },
|
|
]
|
|
|
|
const miniProgramManualItems = [
|
|
{ text: '快速开始', link: '/manual/mini-program/' },
|
|
{ text: '首页公开查卡', link: '/manual/mini-program/home' },
|
|
{ text: '公开卡片详情', link: '/manual/mini-program/devices' },
|
|
{ text: '卡片排查', link: '/manual/mini-program/diagnosis' },
|
|
{ text: '登录后办理概览', link: '/manual/mini-program/business' },
|
|
{ text: '客户管理与卡片划拨', link: '/manual/mini-program/customers-and-allocation' },
|
|
{ text: '工单服务', link: '/manual/mini-program/work-orders' },
|
|
{ text: '批次执行日志', link: '/manual/mini-program/execution-logs' },
|
|
{ text: '消息与个人中心', link: '/manual/mini-program/messages-and-profile' },
|
|
]
|
|
|
|
function manualSidebar(_active: 'web' | 'mini' | 'both' = 'both') {
|
|
return [
|
|
{
|
|
text: 'Web端',
|
|
collapsed: false,
|
|
items: webManualItems,
|
|
},
|
|
{
|
|
text: '小程序端',
|
|
collapsed: false,
|
|
items: miniProgramManualItems,
|
|
},
|
|
]
|
|
}
|
|
|
|
export default defineConfig({
|
|
srcDir: './docs',
|
|
base: '/docs/',
|
|
title: 'iotLCM',
|
|
description: 'iotLCM documentation center',
|
|
lang: 'zh-CN',
|
|
cleanUrls: true,
|
|
lastUpdated: false,
|
|
head: [
|
|
['link', { rel: 'icon', type: 'image/png', href: '/docs/favicon.png' }]
|
|
],
|
|
vite: {
|
|
plugins: [
|
|
{
|
|
name: 'serve-root-favicon-in-dev',
|
|
configureServer(server) {
|
|
server.middlewares.use('/favicon.ico', (_request, response) => {
|
|
response.writeHead(302, { Location: '/docs/favicon.png' })
|
|
response.end()
|
|
})
|
|
}
|
|
}
|
|
]
|
|
},
|
|
themeConfig: {
|
|
logo: undefined,
|
|
nav: [
|
|
{ text: '文档首页', link: '/' },
|
|
{ text: '使用手册', link: '/manual/' },
|
|
{ text: 'OpenAPI', link: '/openapi/' },
|
|
{ text: '共享 Token 接口', link: '/openapi/operator/shared-token/' },
|
|
{ text: '部署手册', link: '/deploy/' }
|
|
],
|
|
sidebar: {
|
|
'/deploy/': [
|
|
{
|
|
text: '部署手册',
|
|
collapsed: false,
|
|
items: [
|
|
{ text: '部署概览', link: '/deploy/' },
|
|
{ text: '路径前缀必读', link: '/deploy/path-prefix' },
|
|
]
|
|
},
|
|
{
|
|
text: '部署方式',
|
|
collapsed: false,
|
|
items: [
|
|
{ text: '推荐:Docker + nginx', link: '/deploy/docker-nginx' },
|
|
{ text: '静态托管部署', link: '/deploy/static-hosting' },
|
|
{ text: '内网与离线部署', link: '/deploy/offline' },
|
|
]
|
|
},
|
|
{
|
|
text: '开发与排错',
|
|
collapsed: false,
|
|
items: [
|
|
{ text: '本地开发与预览', link: '/deploy/local-dev' },
|
|
{ text: '常见问题', link: '/deploy/faq' },
|
|
]
|
|
},
|
|
],
|
|
'/manual/': manualSidebar(),
|
|
'/manual/web/': manualSidebar('web'),
|
|
'/manual/mini-program/': manualSidebar('mini'),
|
|
'/openapi/operator/': [
|
|
{
|
|
text: '共享 Token 接口',
|
|
collapsed: false,
|
|
items: [
|
|
{ text: '概览', link: '/openapi/operator/' },
|
|
{ text: '共享 Token 接口', link: '/openapi/operator/shared-token/' },
|
|
{ text: '白名单转发', link: '/openapi/operator/mobile-v5/' },
|
|
]
|
|
},
|
|
],
|
|
'/openapi/': [
|
|
{
|
|
text: 'V3 接口',
|
|
collapsed: false,
|
|
items: [
|
|
{ text: '概览与鉴权', link: '/openapi/v3/' },
|
|
{ text: '获取调用凭证', link: '/openapi/v3/token' },
|
|
{ text: '查询类', link: '/openapi/v3/query' },
|
|
{ text: '业务类', link: '/openapi/v3/common' },
|
|
]
|
|
},
|
|
{
|
|
text: '旧版兼容接口',
|
|
collapsed: false,
|
|
items: [
|
|
{ text: '概览与鉴权', link: '/openapi/legacy/' },
|
|
{ text: '查询类', link: '/openapi/legacy/query' },
|
|
]
|
|
},
|
|
]
|
|
},
|
|
outline: {
|
|
level: [2, 3],
|
|
label: '本页目录'
|
|
},
|
|
docFooter: {
|
|
prev: '上一页',
|
|
next: '下一页'
|
|
},
|
|
search: {
|
|
provider: 'local'
|
|
},
|
|
footer: {
|
|
message: 'iotLCM 文档中心',
|
|
copyright: ''
|
|
}
|
|
}
|
|
})
|