chill_notes/实践积累/MeNav个人导航站生成器.md

title, tags, created, source, stars, forks, language

title	tags	created	source	stars	forks	language
MeNav 个人导航站生成器	开源 导航站 静态网站 GitHubPages 书签管理	2026-04-21	https://github.com/rbetree/menav	256	167	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/         # 构建产物

核心功能

书签导入

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 触发

安装使用

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 — 设计编辑器