MeNav 书签目录
目录
目录概述
bookmarks 目录是 MeNav 项目中用于存放浏览器导出的书签文件的专用目录。该目录与书签导入功能直接关联，用于自动将浏览器书签转换为 MeNav 配置文件，从而快速生成个人导航站点。
功能说明
书签导入功能允许用户：
- 从浏览器导出书签为 HTML 文件
- 将书签文件放入此目录
- 通过自动处理将书签转换为网站配置
- 无需手动编辑即可批量导入网站链接
这一功能极大简化了网站内容的初始设置过程，特别适合需要迁移大量书签的用户。
书签导入流程
完整的书签导入流程如下：
- 在浏览器中导出书签为 HTML 文件
- 将导出的书签文件放入
bookmarks目录 - 运行书签处理工具：
npm run import-bookmarks - 系统自动解析书签文件内容
- 根据书签文件夹结构生成分类
- 生成配置文件保存到
config/user/pages/bookmarks.yml - 构建网站应用新配置：
npm run build
重要说明：在本地开发中，
npm run dev命令不会自动处理书签文件。您必须先手动运行npm run import-bookmarks命令处理书签，然后再运行npm run dev查看效果。这与 GitHub Actions 中的自动处理流程不同，请务必注意。
支持的浏览器
MeNav 书签导入功能支持从以下浏览器导出的书签文件：
- Chrome - 通过书签管理器导出
- Firefox - 通过书签库导出
- Edge - 通过收藏夹导出
- Safari - 通过书签菜单导出
- 其他支持标准 HTML 书签格式的浏览器
书签格式要求
导入的书签文件需满足以下要求：
- 文件格式：HTML（标准网络书签格式）
- 文件编码：UTF-8
- 文件结构：包含
<DL>、<DT>和<A>标签的标准书签结构 - 文件大小：建议不超过 5MB（约数千个书签）
文件处理机制
书签处理器 (src/bookmark-processor.js) 对书签文件进行以下处理：
-
解析文件结构：
- 读取书签 HTML 文件
- 解析 DOM 结构获取书签层次
- 提取文件夹和链接信息
-
分类提取：
- 将书签文件夹转换为网站分类
- 提取链接URL、标题和添加日期
-
图标分配：
- 根据URL自动匹配合适的 Font Awesome 图标
- 为每个链接和分类分配图标
-
配置生成：
- 创建符合 MeNav 配置格式的 YAML 文件
- 按层级组织分类和链接
- 应用自动生成的元数据
将书签放入此目录后，您可以立即利用 MeNav 的书签处理功能，快速将书签转化为个性化导航站点。