96 lines
1.8 KiB
Markdown
Executable File
96 lines
1.8 KiB
Markdown
Executable File
# MeNav 个人导航站生成器
|
|
|
|
> 一个轻量的个人导航网站，轻量级、高度可定制，完全静态部署
|
|
|
|
- **⭐ GitHub**: rbetree/menav (256 stars)
|
|
- **许可证**: AGPL-3.0
|
|
- **技术栈**: HTML5 + CSS3 + JavaScript + Handlebars
|
|
|
|
---
|
|
|
|
## 核心特点
|
|
|
|
- 🚀 **静态一键部署** — 无数据库，无后端，纯静态页面
|
|
- 📂 **书签导入** — 从浏览器书签一键导入
|
|
- 🎨 **多层级嵌套** — 支持 2-4 层级的分类结构
|
|
- 🌙 **双主题** — 明亮/黑暗主题切换
|
|
- 🔗 **GitHub Pages** — 一键 Fork 部署
|
|
- 🔖 **自动同步** — 配合 MarksVault 浏览器扩展，支持书签自动同步
|
|
|
|
---
|
|
|
|
## 快速开始
|
|
|
|
### 1. 克隆仓库
|
|
|
|
```bash
|
|
git clone https://github.com/rbetree/menav.git
|
|
cd menav
|
|
```
|
|
|
|
### 2. 安装依赖
|
|
|
|
```bash
|
|
npm install
|
|
```
|
|
|
|
### 3. 配置
|
|
|
|
编辑 `config/` 下的配置文件，定义你的网站分类和链接。
|
|
|
|
### 4. 本地预览
|
|
|
|
```bash
|
|
npm run dev
|
|
```
|
|
|
|
### 5. 构建
|
|
|
|
```bash
|
|
npm run build
|
|
```
|
|
|
|
构建产物在 `dist/` 目录。
|
|
|
|
---
|
|
|
|
## 部署到 GitHub Pages
|
|
|
|
1. Fork [menav](https://github.com/rbetree/menav) 仓库
|
|
2. 在仓库 Settings → Pages 中启用 GitHub Pages
|
|
3. 选择 `gh-pages` 分支
|
|
4. 访问 `https://yourusername.github.io/menav/`
|
|
|
|
---
|
|
|
|
## 书签导入
|
|
|
|
支持从浏览器书签导入，生成导航站点：
|
|
|
|
1. 导出浏览器书签为 HTML
|
|
2. 使用 MeNav 的书签导入功能
|
|
3. 自动生成分类结构
|
|
|
|
---
|
|
|
|
## 项目结构
|
|
|
|
```
|
|
menav/
|
|
├── src/ # 生成器、书签处理、前端脚本
|
|
├── templates/ # Handlebars 模板
|
|
├── config/ # 模块化配置
|
|
├── assets/ # 静态资源
|
|
├── bookmarks/ # 书签导入相关
|
|
└── dist/ # 构建产物
|
|
```
|
|
|
|
---
|
|
|
|
## 适用场景
|
|
|
|
- 个人导航主页
|
|
- 书签管理
|
|
- 团队内部链接导航
|
|
- 实验室/项目资源汇总
|