111 lines
2.8 KiB
Markdown
Executable File
111 lines
2.8 KiB
Markdown
Executable File
---
|
||
title: MeNav 个人导航站生成器
|
||
tags:
|
||
- 开源
|
||
- 导航站
|
||
- 静态网站
|
||
- GitHubPages
|
||
- 书签管理
|
||
created: 2026-04-21
|
||
source: https://github.com/rbetree/menav
|
||
stars: 256
|
||
forks: 167
|
||
language: JavaScript
|
||
---
|
||
|
||
# MeNav
|
||
|
||
> 一键部署的个人导航站生成器，支持书签导入与自动构建，轻松整理展示您的网络收藏
|
||
|
||
## 概述
|
||
|
||
轻量级、高度可定制的个人导航网站生成器，完全静态部署，无需数据库和后端服务。支持：
|
||
- 🔖 浏览器书签一键导入（HTML格式）
|
||
- ⚡ 自动化构建（GitHub Actions）
|
||
- 📁 2-4层多层级嵌套分类结构
|
||
- 🔄 与 MarksVault 浏览器扩展集成，自动同步书签
|
||
- 🚀 一键 Fork 部署到 GitHub Pages
|
||
|
||
**预览**: https://rbetree.github.io/menav/
|
||
|
||
## 技术栈
|
||
|
||
- HTML5 + CSS3 + JavaScript（原生）
|
||
- Handlebars 模板引擎
|
||
- Google Favicon API + Font Awesome 图标
|
||
- Docker + nginx（可选部署）
|
||
|
||
## 项目结构
|
||
|
||
```
|
||
menav/
|
||
├── src/ # 生成器、书签处理、前端脚本（入口：src/generator.js）
|
||
├── templates/ # Handlebars 模板（layouts/pages/components）
|
||
├── config/ # 模块化配置
|
||
├── assets/ # 静态资源
|
||
├── bookmarks/ # 书签导入相关
|
||
└── dist/ # 构建产物
|
||
```
|
||
|
||
## 核心功能
|
||
|
||
### 书签导入
|
||
```bash
|
||
npm run import-bookmarks
|
||
# 放入 HTML 格式书签 → 自动转换为 config/user/pages/bookmarks.yml
|
||
```
|
||
|
||
### MarksVault 扩展集成
|
||
配合浏览器扩展，支持书签自动同步到导航站，部署后自动更新。
|
||
|
||
### 主题支持
|
||
- 明亮主题 / 黑暗主题
|
||
- 响应式布局，适配移动端
|
||
|
||
### 部署方式
|
||
|
||
| 方式 | 说明 |
|
||
|------|------|
|
||
| **GitHub Pages（推荐）** | Fork → 启用Actions → 提交配置 → 自动部署 |
|
||
| **Vercel / Netlify / Cloudflare Pages** | `Build: npm run build` / `Output: dist/` |
|
||
| **Docker** | `docker compose up -d` |
|
||
| **自建服务器** | `npm run build` → 复制 dist/ → nginx/Apache |
|
||
|
||
### 定时更新
|
||
- RSS 文章聚合自动刷新
|
||
- GitHub Actions 默认每天 UTC 02:00 触发
|
||
|
||
## 安装使用
|
||
|
||
```bash
|
||
git clone https://github.com/rbetree/menav.git
|
||
cd menav
|
||
npm install
|
||
npm run dev # 本地预览
|
||
npm run build # 构建静态文件
|
||
```
|
||
|
||
**配置**：`config/user/` 下创建个人配置（至少 `site.yml`）
|
||
|
||
## 评分
|
||
|
||
⭐⭐⭐⭐（4/5）
|
||
|
||
**优点**：
|
||
- 零成本部署（GitHub Pages）
|
||
- 书签导入+自动同步，工作流完整
|
||
- 主题美观，响应式设计
|
||
- 模块化配置，易于定制
|
||
|
||
**局限**：
|
||
- 需要 GitHub 生态（书签同步依赖 Actions）
|
||
- 书签导入格式有要求
|
||
|
||
**适合场景**：个人主页、浏览器起始页、书签整理
|
||
|
||
## 相关工具
|
||
|
||
- [[fireworks-tech-graph技术图生成工具]] — AI技术图生成
|
||
- [[OpenPencil]] — 设计编辑器
|
||
|