diff --git a/实践积累/MeNav个人导航站生成器.md b/实践积累/MeNav个人导航站生成器.md index 09fcd07..c6a73e6 100755 --- a/实践积累/MeNav个人导航站生成器.md +++ b/实践积累/MeNav个人导航站生成器.md @@ -15,16 +15,20 @@ language: JavaScript # MeNav -> 一键部署的个人导航站生成器,支持书签导入与自动构建,轻松整理展示您的网络收藏 +> 一键部署的个人导航站生成器,支持书签导入与自动构建 ## 概述 -轻量级、高度可定制的个人导航网站生成器,完全静态部署,无需数据库和后端服务。支持: -- 🔖 浏览器书签一键导入(HTML格式) -- ⚡ 自动化构建(GitHub Actions) -- 📁 2-4层多层级嵌套分类结构 -- 🔄 与 MarksVault 浏览器扩展集成,自动同步书签 -- 🚀 一键 Fork 部署到 GitHub Pages +轻量级、高度可定制的个人导航网站生成器,完全静态部署,无需数据库和后端服务。 + +### 核心功能 + +- 🔖 浏览器书签一键导入(HTML → YAML) +- 🚀 GitHub Pages 一键部署(Fork + Actions) +- 🔄 MarksVault 扩展集成,自动同步书签 +- 🎨 明亮 / 黑暗双主题,响应式布局 +- 🐳 Docker 部署支持 +- 📁 2-4 层多层级嵌套分类结构 **预览**: https://rbetree.github.io/menav/ @@ -33,47 +37,6 @@ language: JavaScript - 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 触发 ## 安装使用 @@ -85,7 +48,26 @@ npm run dev # 本地预览 npm run build # 构建静态文件 ``` -**配置**:`config/user/` 下创建个人配置(至少 `site.yml`) +## 书签导入 + +```bash +npm run import-bookmarks +# 放入 HTML 格式书签 → 自动转换为 config/user/pages/bookmarks.yml +``` + +## 部署方式 + +| 方式 | 说明 | +|------|------| +| **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 触发 ## 评分 @@ -93,7 +75,7 @@ npm run build # 构建静态文件 **优点**: - 零成本部署(GitHub Pages) -- 书签导入+自动同步,工作流完整 +- 书签导入 + 自动同步,工作流完整 - 主题美观,响应式设计 - 模块化配置,易于定制 @@ -102,9 +84,3 @@ npm run build # 构建静态文件 - 书签导入格式有要求 **适合场景**:个人主页、浏览器起始页、书签整理 - -## 相关工具 - -- [[fireworks-tech-graph技术图生成工具]] — AI技术图生成 -- [[OpenPencil]] — 设计编辑器 -