floccus

英文原文正文为项目原始 README（英文），本站后续会翻译为中文，当前仅剔除图片与无关章节并统一排版。

絮状物

在浏览器和设备之间私密同步书签

• 🔖 直接同步你真实的、本地浏览器书签
• ☸ 通过 Nextcloud Bookmarks、Linkwarden、KaraKeep、Google Drive、Dropbox、任何 Git 服务器（如 GitHub、Gitlab、Gitea 等）或 任何兼容 WebDAV 的服务 进行同步
• ⚛ 使用任何支持网页扩展的浏览器（例如 Firefox、Chrome、Edge、Opera、Brave、Vivaldi 等；Safari 尚不支持）
• 📲 安装 floccus 安卓/iOS 应用，在手机上访问你的书签（遗憾的是大部分移动浏览器不支持 floccus）
• 💼 根据需要创建任意多的同步配置文件
• 🚚 控制同步策略（即单向或双向）、⏳ 同步间隔及 📂 同步文件夹
• 📦 轻松导出你的配置

这是用于签署 floccus APK 的证书的 SHA-256 指纹：

ffed2778ff07371e6367b6dcf5d7c1327c57ff7158b8444029182a9aa2dd7085

如果您想支持这个软件的创建和维护，请考虑捐赠。:)

🎬 入门指南

如果你不知道如何开始使用 Floccus，请阅读这些指南。

如果你需要帮助，请通过 Matrix 联系我们（#floccus:matrix.org）、在 官方 Nextcloud 书签讨论频道 或在 Reddit 的 r/floccus 与我们交流 :wave:

故障排除

• 表情符号：MySQL 和 MariaDB 默认不支持表情符号，因此如果你正在同步到 Nextcloud 并收到来自 Nextcloud 的错误代码 500，请检查 Nextcloud 日志中的 SQL 错误，并按照 Nextcloud 文档中关于字符集错误的说明操作。

如果你需要帮助解决问题，可以尝试 Gitter 聊天室：https://gitter.im/marcelklehr/floccus

注意事项

这是一个好主意吗？我认为是。如果你想了解更多，请查看考虑事项文件

名字的由来？

卷云片状 是一种云，可以同步你的浏览器数据看起来非常漂亮。

贡献

欢迎所有贡献、代码、反馈和战略性建议。如果您有问题，可以在仓库中提出问题、在gitter、matrix (#marcelklehr_floccus:gitter.im)、官方 Nextcloud 书签讨论频道或在reddit 的 r/floccus上与我们交流。我也很欢迎大家帮助我测试新功能——请查看问题以获取测试版版本的公告。

翻译中

现在可以在transifex上提供翻译。

开发

设置开发环境

• 克隆此仓库。
• 安装node.js 的最新 LTS 版本。
• 在您的 floccus 仓库根目录下运行 npm install。
• 运行 npm run build 进行构建。
• 了解更多关于如何开发浏览器扩展的信息，请访问：https://extensionworkshop.com/。

构建 Android 应用需要 Android Studio。

• 在 Android Studio 中打开 android/ 文件夹，并像构建其他 Android 应用一样构建应用。
• npm run build 和 npm run watch 将根据需要将更改推送到 android/。

构建

• npm run build

运行以下命令以在修改时自动编译更改：

• npm run watch

发布

• npm run build-release

Windows 相关注意事项

按照上述关于设置开发环境的一般指导进行操作。某些 npm 脚本有针对 Windows 的版本：

• 构建: npm run build-win
• 构建发布: npm run build-release-win
• 监听: watch-win

首次构建时，可能会出现找不到 gulp 的错误。你可以通过在仓库根目录执行 npm install -g gulp 来在系统上全局安装 gulp。建议在第一次在仓库根目录执行 npm install 后，主动进行此操作。

本地运行浏览器扩展及相应测试

• 构建浏览器扩展：npm run build-release（如果使用 Windows，则为 npm run build-release-win）

• 构建成功后，扩展包将在以下位置找到：RepoRoot/builds/

• 以下步骤以 Firefox 为例；其他浏览器操作类似。Firefox 扩展包是一个 .xpi 扩展名的文件。这是一个简单的归档文件。要修改它，可以将其重命名为 .zip，进行修改后再重命名回 .xpi。许多归档相关工具都知道这一点，并允许你直接处理 .xpi 文件（例如 Total Commander）。

• 启用扩展包进行本地测试：默认情况下，测试不会包含在发布归档中。要在本地浏览器中运行测试，请将文件 RepoRoot/dist/js/test.js 复制到发布包中，使其位于 FloccusPackage.xpi/dist/js/test.js。

• 使用专用测试配置文件打开 Firefox：首页 如果使用主配置文件进行测试，测试脚本可能会破坏你现有的书签和打开的标签页！ 要管理配置文件，请访问：about:profiles

• 加载扩展：在专用 Firefox 配置文件窗口中，进入 about:debugging 选择“本 Firefox”，然后在“临时扩展”下选择“加载临时附加组件...”，然后选择你之前准备的 .xpi 文件。（如果需要修改/重建扩展包，请记得卸载扩展。）

• 扩展已加载。你可以通过浏览器的扩展菜单访问它。

• 运行测试：加载扩展后，点击“Manifest URL”。它会打开一个新的标签页，URL 为 moz-extension://SomeGuid/manifest.json，将 URL 修改为 moz-extension://SomeGuid/dist/html/test.html，保持相同的 GUID，然后按回车。测试应自动开始运行。

• 调试或暂停测试：按 F12 打开开发者工具。在“调试器”选项卡中，可以暂停执行、设置断点并逐步执行代码。

祝开发顺利，感谢你的贡献！

许可

(c) Marcel Klehr MPL-2.0（参见 LICENSE.txt）