Update from Sync Service

HomePage/INDEX_导航网站.md

@@ -0,0 +1,165 @@
+---
+title: 导航网站 - MeNav 管理
+tags:
+  - 导航网站
+  - MeNav
+  - 个人主页
+  - 书签管理
+created: 2026-04-21
+updated: 2026-04-21
+---
+
+# MeNav 个人导航站
+
+> 基于 [MeNav](https://github.com/rbetree/menav) 构建的个人导航网站
+
+---
+
+## 项目信息
+
+| 项目 | 说明 |
+|------|------|
+| 名称 | MeNav |
+| 源码 | https://github.com/rbetree/menav |
+| 许可证 | AGPL-3.0 |
+| 用途 | 个人导航网站生成器 |
+
+---
+
+## 目录结构
+
+```
+导航网站/
+├── bookmarks/              # 书签导入相关
+│   └── README.md
+├── config/                # 模块化配置
+│   ├── README.md           # 配置指南
+│   ├── _default/           # 默认配置
+│   ├── user/               # 用户配置（覆盖默认）
+│   ├── update-instructions-20251227.md
+│   └── update-instructions-20260102.md
+├── src/                    # 源码
+├── templates/              # 模板
+├── assets/                 # 静态资源
+└── dist/                   # 构建产物
+```
+
+---
+
+## 核心功能
+
+- ✅ 静态一键部署
+- ✅ 自动化构建
+- ✅ 书签导入（浏览器书签 → YAML）
+- ✅ 支持 2-4 层嵌套分类
+- ✅ 明暗主题切换
+- ✅ RSS 文章聚合
+- ✅ GitHub 贡献热力图
+- ✅ 与 MarksVault 浏览器扩展集成
+
+---
+
+## 常用命令
+
+```bash
+# 安装依赖
+npm install
+
+# 导入书签
+npm run import-bookmarks
+
+# 本地预览
+npm run dev
+
+# 构建静态文件
+npm run build
+
+# 一键检查
+npm run check
+```
+
+---
+
+## 配置管理
+
+### 配置加载机制
+
+- 优先使用 `config/user/` 配置
+- 不存在则使用 `config/_default/`
+- 采用"完全替换"策略（不合并）
+
+### 站点配置 (site.yml)
+
+```yaml
+title: '我的导航站'
+description: '个人收藏导航'
+profile:
+  title: '主页'
+  subtitle: '精选网站'
+navigation:
+  - name: '常用'
+    icon: 'fas fa-star'
+    id: 'common'
+```
+
+### 页面配置 (pages/*.yml)
+
+每个页面对应一个 YAML 文件，支持：
+- `common.yml` - 首页
+- `projects.yml` - 项目页
+- `articles.yml` - 文章页
+- `bookmarks.yml` - 书签页
+
+---
+
+## 管理要点
+
+### 需要管理的文件
+
+| 文件/目录 | 说明 |
+|-----------|------|
+| `config/user/site.yml` | 站点基础配置 |
+| `config/user/pages/*.yml` | 各页面配置 |
+| `bookmarks/` | 导入的书签文件 |
+| `content/` | 内容页 Markdown |
+
+### 更新流程
+
+1. 修改 `config/user/` 下的配置
+2. 运行 `npm run check` 验证
+3. `npm run build` 构建
+4. 提交到 GitHub Pages
+
+### 书签导入
+
+```bash
+# 将浏览器导出的 HTML 书签放入 bookmarks/
+# 运行导入
+npm run import-bookmarks
+
+# 确定性生成（便于版本管理）
+MENAV_BOOKMARKS_DETERMINISTIC=1 npm run import-bookmarks
+```
+
+---
+
+## 相关链接
+
+| 资源 | 链接 |
+|------|------|
+| GitHub | https://github.com/rbetree/menav |
+| 在线演示 | https://rbetree.github.io/menav/ |
+| MarksVault 扩展 | https://github.com/rbetree/MarksVault |
+
+---
+
+## 注意事项
+
+1. **配置修改后需验证**：使用 `npm run check`
+2. **书签导入是独立的**：需要手动运行 `npm run import-bookmarks`
+3. **RSS/Projects 缓存**：`dev/` 目录默认被 gitignore
+4. **Sync fork 后**：需手动触发 GitHub Actions 工作流
+
+---
+
+*整理：知识库管理员 | 归档：2026-04-21*