chill_notes/HomePage/INDEX_导航网站.md

title, tags, created, updated

title	tags	created	updated
导航网站 - MeNav 管理	导航网站 MeNav 个人主页 书签管理	2026-04-21	2026-04-21

MeNav 个人导航站

基于 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 浏览器扩展集成

---

常用命令

# 安装依赖
npm install

# 导入书签
npm run import-bookmarks

# 本地预览
npm run dev

# 构建静态文件
npm run build

# 一键检查
npm run check

---

配置管理

配置加载机制

• 优先使用 config/user/ 配置
• 不存在则使用 config/_default/
• 采用"完全替换"策略（不合并）

站点配置 (site.yml)

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

书签导入

# 将浏览器导出的 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