Pintree - 将浏览器书签转换为精美导航网站

Pintree 是一个开源项目，旨在将浏览器书签转换为精美的导航网站。只需几个简单步骤，你就可以将收藏的书签转化为美观且用户友好的导航页面。

项目简介

Pintree 由 ViggoZ 开发维护，是一个基于 Web 技术的静态网站生成工具。截至目前，该项目在 GitHub 上已获得 2.6k+ stars 和 1.8k+ forks，主要使用 TypeScript (99.2%) 编写。项目采用 MIT 开源协议，欢迎社区贡献。

核心特性

• 书签导出：通过浏览器扩展一键导出浏览器书签
• JSON 格式转换：将书签文件转换为结构化的 JSON 格式
• 静态网站生成：自动生成美观的静态导航网站
• GitHub Pages 托管：支持免费部署到 GitHub Pages
• 深色模式：内置深色主题支持
• 响应式设计：适配各种设备屏幕

技术栈

• 前端：HTML / CSS / JavaScript
• 主要语言：TypeScript (99.2%)
• 数据处理：JSON 格式处理
• 部署：静态网站托管（GitHub Pages）

安装与使用

前置要求

• 一个 GitHub 账号
• Chrome 浏览器（用于安装扩展）

使用步骤

第一步：下载浏览器书签

1. 安装 Pintree Bookmarks Exporter Chrome 扩展
2. 使用扩展导出浏览器书签，保存 JSON 文件到本地

第二步：Fork 项目

1. 访问 Pintree GitHub 仓库
2. 点击页面右上角的 Fork 按钮，将项目复制到你的 GitHub 账号

第三步：替换 JSON 文件

1. 打开你账号下的 pintree 仓库
2. 点击仓库中的 json 文件夹
3. 点击 Upload files 按钮，选择之前下载的 JSON 文件并上传
4. 确保上传的文件命名为 pintree.json，然后点击 Commit changes

第四步：启用 GitHub Pages

1. 在你的 pintree 仓库页面，点击 Settings
2. 找到 Pages 选项
3. 在 Source 下拉菜单中，选择 gh-pages 分支并点击 Save
4. 几分钟后，你的静态网站将在 https://yourusername.github.io/pintree 上线

项目结构

pintree/
├── assets/          # 静态资源文件
├── css/             # 样式文件
├── json/            # 书签 JSON 数据
├── index.html       # 主页面
├── 404.html         # 404 页面
└── README.md        # 项目文档

贡献指南

欢迎参与项目贡献！请按照以下步骤参与：

1. Fork 本仓库：https://github.com/Pintree-io/pintree/tree/main
2. 创建新分支：git checkout -b feature/your-feature
3. 提交更改：git commit -am 'Add some feature'
4. 推送到分支：git push origin feature/your-feature
5. 提交 Pull Request

注意：main 分支是项目的源代码分支，gh-pages 分支是打包后的静态网站代码分支。请在 main 分支上开发和提交更改。

适用场景

• 个人书签管理：将零散的书签整理成美观的导航站
• 团队资源共享：为团队创建统一的书标资源库
• 产品导航页面：为产品或服务创建链接集合页面
• 学习资源汇总：整理学习资料链接，方便查阅

相关链接

• 项目官网：https://pintree.io/
• GitHub 仓库：https://github.com/Pintree-io/pintree
• Chrome 扩展：Pintree Bookmarks Exporter

总结

Pintree 是一个简洁实用的开源工具，通过将浏览器书签转换为静态导航网站，解决了书签管理混乱、难以分享的问题。其零成本部署（GitHub Pages）、简单易用的特点，使其成为个人和团队管理网络资源的理想选择。