---
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*