# xh-wiki

**Repository Path**: ysmip/xh-wiki

## Basic Information

- **Project Name**: xh-wiki
- **Description**: Xuhai wiki, A perfect guide to life.
- **Primary Language**: Unknown
- **License**: AGPL-3.0
- **Default Branch**: main
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2026-10-26
- **Last Updated**: 2026-10-27

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# XH-Wiki

一个简洁的静态文档/wiki网站项目。

## 项目简介

XH-Wiki 是一个基于纯静态 HTML/CSS/JS 构建的文档知识库系统。设计风格简洁现代，支持深色/浅色主题切换，适合用于个人知识管理、文档查阅或小型Wiki站点建设。

## 主要特性

- **静态站点**：无需后端服务器，纯前端实现，部署简单
- **响应式设计**：适配桌面端和移动端设备
- **深色模式**：支持明暗主题切换
- **搜索功能**：内置文章搜索功能
- **分类浏览**：支持按分类筛选查看文档
- **目录导航**：侧边栏目录快速导航

## 页面结构

- **首页 (index.html)**：展示分类、最新文章、推荐内容等
- **全部分类 (all.html)**：展示所有文档列表，支持过滤搜索
- **文章页 (article.html)**：文档详细内容展示页面

## 内容模块

网站内容涵盖以下主题：

- 概述 (overview)
- 大学 (daxue)
- 学习 (study)
- 文昌 (wenchang)
- 旅行 (travel)
- 元信息 (meta)

## 技术栈

- HTML5
- CSS3 (支持 CSS 变量和深色模式)
- Vanilla JavaScript

## 使用说明

1. 克隆项目到本地
2. 直接在浏览器中打开 `index.html` 即可预览
3. 如需修改内容，编辑 `assets/js/content/` 目录下的对应 JS 文件

## 部署

由于是纯静态站点，可部署到任何静态网页托管服务：

- GitHub Pages
- Gitee Pages
- Vercel
- Netlify
- 或任意 Web 服务器

## 目录结构

```
├── index.html          # 首页
├── all.html            # 全部文档页面
├── article.html        # 文章详情页
├── assets/
│   ├── arts/           # 图片资源
│   ├── css/
│   │   └── style.css   # 样式文件
│   └── js/
│       ├── app.js      # 应用逻辑
│       ├── data.js     # 数据配置
│       ├── theme.js    # 主题切换
│       └── content/    # 各分类内容
├── LICENSE             # 许可证
└── README.md           # 说明文档
```

## 许可证

请查看 LICENSE 文件了解具体的开源许可协议。