Files
menav/bookmarks
2025-05-09 01:09:55 +08:00
..
2025-05-02 00:32:44 +08:00

MeNav 书签目录

目录

目录概述

bookmarks 目录是 MeNav 项目中用于存放浏览器导出的书签文件的专用目录。该目录与书签导入功能直接关联,用于自动将浏览器书签转换为 MeNav 配置文件,从而快速生成个人导航站点。

功能说明

书签导入功能允许用户:

  • 从浏览器导出书签为 HTML 文件
  • 将书签文件放入此目录
  • 通过自动处理将书签转换为网站配置
  • 无需手动编辑即可批量导入网站链接

这一功能极大简化了网站内容的初始设置过程,特别适合需要迁移大量书签的用户。

书签导入流程

完整的书签导入流程如下:

  1. 在浏览器中导出书签为 HTML 文件
  2. 将导出的书签文件放入 bookmarks 目录
  3. 运行书签处理工具:
    npm run import-bookmarks
    
  4. 系统自动解析书签文件内容
  5. 根据书签文件夹结构生成分类
  6. 生成配置文件保存到 config/user/pages/bookmarks.yml
  7. 构建网站应用新配置:
    npm run build
    

支持的浏览器

MeNav 书签导入功能支持从以下浏览器导出的书签文件:

  • Chrome - 通过书签管理器导出
  • Firefox - 通过书签库导出
  • Edge - 通过收藏夹导出
  • Safari - 通过书签菜单导出
  • 其他支持标准 HTML 书签格式的浏览器

书签格式要求

导入的书签文件需满足以下要求:

  • 文件格式HTML标准网络书签格式
  • 文件编码UTF-8
  • 文件结构:包含 <DL><DT><A> 标签的标准书签结构
  • 文件大小:建议不超过 5MB约数千个书签

文件处理机制

书签处理器 (src/bookmark-processor.js) 对书签文件进行以下处理:

  1. 解析文件结构

    • 读取书签 HTML 文件
    • 解析 DOM 结构获取书签层次
    • 提取文件夹和链接信息
  2. 分类提取

    • 将书签文件夹转换为网站分类
    • 提取链接URL、标题和添加日期
  3. 图标分配

    • 根据URL自动匹配合适的 Font Awesome 图标
    • 为每个链接和分类分配图标
  4. 配置生成

    • 创建符合 MeNav 配置格式的 YAML 文件
    • 按层级组织分类和链接
    • 应用自动生成的元数据

将书签放入此目录后,您可以立即利用 MeNav 的书签处理功能,快速将书签转化为个性化导航站点。