selfoss

selfoss 2.20-快照

selfoss 是一个多用途 RSS 阅读器和提要聚合 Web 应用程序。它使您可以轻松地跟踪来自不同网站、社交网络和其他平台的更新，所有这些都在一个地方。它是用 PHP 编写的，基本上允许您在任何地方运行它。

欲了解更多信息，请访问我们的网站。

地位

selfoss 目前由 Jan Tojnar 在空闲时间维护。由于容量有限，维护优先于新功能。欢迎提出拉取请求，请参阅贡献指南。

下载

• 稳定版本 – 如果您只想使用 selfoss。
• 开发版本 - 如果您想尝试未发布的功能或错误修复，或帮助测试它们。云匠主持
• Git 跟踪的源代码 – 如果您想加入 selfoss 开发。需要一些组装。

安装

1. 上传该目录的所有文件（重要：还要上传不可见的.htaccess文件）。
2. 使目录data/cache 、 data/favicons 、 data/logs 、 data/thumbnails和data/sqlite可写。
3. 在config.ini中插入数据库访问数据（见下文）。如果您想使用 SQLite，则无需更改任何内容。
4. 您不需要创建数据库表，它们将自动创建（确保您的数据库用户有权创建触发器）。
5. 创建 cronjob 或 systemd 计时器来更新 feed，并通过 wget 或 curl 将其指向 https://yourselfossurl.com/update。您还可以从命令行执行cliupdate.php 。

如果您使用 Git 获取 selfoss，则需要执行更多步骤。请参阅开发部分。

如有更多疑问或任何问题，请使用我们的支持论坛：https://forum.selfoss.aditu.de/

配置

使用 selfoss 无需配置，但您可以自定义设置，如下所示：

1. 将config-example.ini重命名为config.ini 。
2. 编辑config.ini并删除您不想覆盖的任何行。
3. 有关示例，请参阅 https://selfoss.aditu.de/。

更新

1. 备份您的数据库和data/目录。
2. （重要提示：不要删除data/目录）删除所有旧文件和目录，不包括目录data/和文件config.ini
3. 上传所有新文件和目录，不包括data/目录（重要提示：还要上传不可见的.htaccess文件）。
4. 请查阅新闻文件以了解向后不兼容的更改。
5. 清理浏览器缓存。
6. 在config.ini中插入当前的数据库连接和个人配置。重要提示：我们更改了config.ini并在新版本中添加了新选项。您还必须更新config.ini 。
7. 数据库将自动更新（确保您的数据库用户有权创建触发器）。

如果您使用 Git 获取 selfoss，则可能需要执行更多步骤。请参阅开发部分。

如有更多疑问或任何问题，请使用我们的支持论坛：https://selfoss.aditu.de/forum

支持

• 用于报告问题和请求新功能的问题跟踪器
• 有关使用的一般问题的论坛
• 在 Gitter（或#selfoss:matrix.org镜像）上聊天，讨论 selfoss 开发或任何其他事情

OPML导入

Selfoss 支持导入 OPML 文件。在旧应用程序中找到 OPML 导出，它通常位于设置中的某个位置。然后访问页面 https://yourselfossurl.com/opml 并将其上传到那里。

第三方应用程序

我们推荐适用于 Android 设备的 Reader For Selfoss。

发展

Selfoss 使用 Composer 和 npm 来安装外部库。当您克隆存储库时，您必须发出composer install才能检索外部源。

对于客户端，您还需要通过调用client/目录中的npm install来安装 JavaScript 依赖项。您可以使用npm run install-dependencies作为安装两组依赖项的快捷方式。

我们使用 Parcel（通过上面的命令安装）来构建 selfoss 的客户端。每次client/目录中的任何内容发生更改时，您都需要运行npm run build来构建客户端并将其安装到public目录中。开发时，也可以使用npm run dev ；它将监视资产更改，根据需要重建捆绑包，并自动重新加载 selfoss。在npm run dev和npm run build之间切换时，您可能需要删除client/.cache 。

如果您想创建一个捆绑所有依赖项的包，您可以运行npm run dist命令来生成 zipball。

每个补丁都应该遵循我们的编码风格，并由 CI 自动检查。您可以使用npm run install-dependencies在本地安装检查器，然后在提交拉取请求之前使用npm run check运行检查。还有npm run fix ，它将尝试修复格式。

制作人员

selfoss 由 Tobias Zeising 创建，源代码根据 GNU 通用公共许可证版本 3 或（由您选择）任何更高版本获得许可。

源代码的某些部分只能在版本 3 下获得许可，我们目前正在尝试解决该问题。

具有捆绑依赖项的包可能仅在版本 3 下分发。

非常特别感谢 GitHub 上拉取请求的所有贡献者以及 Weblate 上的翻译人员。你的进步太棒了！

特别感谢 selfoss 使用的这些库的伟大程序员：

• FatFree PHP 框架
• 简单饼图
• 宽图像
• html法律
• PHP 通用提要生成器
• Elphin IcoFileLoader
• 格雷比
• 全文RSS 过滤器
• 另一个-react-lightbox

图标由 http://blackbooze.com/ 制作

Cloudsmith 慷慨地提供了包存储库托管。 Cloudsmith 是唯一完全托管、云原生、通用包管理解决方案，使您的组织能够完全放心地在任何地方以任何格式创建、存储和共享包。