# 开发导航

**Repository Path**: Jhlxge/dev-guide

## Basic Information

- **Project Name**: 开发导航
- **Description**: 适用于个人或中小团队的导航工具，涵盖导航链接、团队规范文档等场景，使用VitePress 开发，无后端服务。
- **Primary Language**: Unknown
- **License**: MIT
- **Default Branch**: master
- **Homepage**: https://123.dev.zhuzhilong.com
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2026-01-23
- **Last Updated**: 2026-01-26

## Categories & Tags

**Categories**: Uncategorized

**Tags**: 导航, 开发导航

## README

# 朱治龙个人应用导航

## 项目概述
这是一个基于 VitePress 构建的个人应用导航网站，主要用于收集、整理、记录个人开发过程中用到的各种工具和网站导航。项目采用现代化的前端技术栈，具有清晰的结构设计和丰富的功能模块。可查看我的个人导航站点：https://123.dev.zhuzhilong.com/

## 技术架构
- **框架**: VitePress 1.6.4
- **前端语言**: Vue 3.3.4 (Composition API)
- **样式**: Bootstrap 5.3.0 + Less 4.1.3
- **包管理**: pnpm
- **构建工具**: Vite (内置于 VitePress)


## 开发
- 首次运行前执行 `pnpm install` 安装项目依赖
- 安装依赖后执行 `pnpm dev` 开启开发模式，开发模式下会热加载
- 开发完成后执行 `pnpm build` 打包

## 构建
### 直接打包成静态文件
``` bash
pnpm build
```
执行构建命令后将 dist 文件夹中的文件部署到 Apache、Nginx、IIS 之类的Web服务器即可。

### 构建为Docker镜像
``` bash
docker build --no-cache -t dev-guide:1.0.0 -f Dockerfile .
```
### 运行所需的 docker-compose.yaml 参考：
``` yaml
services:
  devGuide:
    image: dev-guide:1.0.0
    container_name: devGuide
    restart: always
    ports:
      - 8103:80
```

## 项目结构
```
├── .vitepress/          # VitePress 配置
├── components/          # Vue 组件
├── config/             # 配置文件 (homepage.json)
├── public/             # 静态资源
├── sites/              # 网址导航相关
├── softwareSites/      # 软件导航相关
├── FESites/            # 前端资源导航
├── guide/              # 开发规范文档
├── others/             # 其他文档
└── index.md            # 首页入口
```

## 核心功能模块

### 1. 主页应用导航 (components/HomePage.vue)
- 展示个人常用开发应用的聚合页面
- 从 `config/homepage.json` 读取应用数据
- 支持应用隐藏/显示功能
- 响应式布局设计

### 2. 网址导航系统 (sites/)
包含10个分类的网址导航:
- 常用网址 (oftenUsed.json)
- 学习资源 (study.json)
- AI工具 (ai.json)
- 技术博客 (blog.json)
- 在线工具 (online.json)
- 常用工具 (tools.json)
- 设计资源 (design.json)
- 资源下载 (download.json)
- 导航站 (nav.json)
- 待分类/研究 (todo.json, todoStudy.json)

### 3. 软件导航 (softwareSites/)
专门收集各类软件工具:
- PE工具 (pe.json)
- 装机工具 (zhuangji.json)
- API客户端 (apiClient.json)
- 多媒体工具 (media.json)
- 运维工具 (ops.json)

### 4. 前端资源导航 (FESites/)
前端开发专用资源:
- UI组件库 (ui.json)
- JavaScript库 (js-lib.json)
- 图标库 (icon.json)
- 动画库 (animate.json)
- 图表库 (chart.json)
- 模板资源 (template.json)
- 跨平台开发 (cross-platform.json)

### 5. 开发规范文档 (guide/)
包含多个开发规范:
- 前端代码规范
- Java代码规范
- SQL规范
- 中文排版规范

### 6. 服务器部署文档 (others/)
记录各服务器的部署情况:
- workServer部署情况

## 数据管理

### JSON数据结构
所有导航数据采用JSON格式存储，便于维护和扩展:
```json
{
  "name": "应用名称",
  "description": "应用描述",
  "link": "访问链接",
  "logoFile": "图标路径",
  "appStatusIcon": "wan/lan",
  "hide": true/false
}
```