165 lines
3.3 KiB
Markdown
Executable File
165 lines
3.3 KiB
Markdown
Executable File
---
|
||
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* |