一个完全由你的GitHub repo运行的基于网络的RSS阅读器

535 阅读3分钟

一个完全由你的GitHub repo运行的RSS阅读器。

  • 免费托管在GitHub页面上。没有广告。没有第三方跟踪。
  • 不需要后台。通过GitHub Actions进行内容更新。
  • 通过模板和主题API可定制的布局和风格。只要带上你的HTML和CSS。
  • 免费和开放源代码。没有第三方跟踪。

演示

image

开始吧

创建一个资源库

  1. 从osmososfeed-template打开创建一个新的资源库
  2. 将可见性设置为 "公共"。
    image
  3. 点击 "从模板创建仓库 "按钮。

开启GitHub页面

  1. 在你刚刚创建的仓库中,导航到设置标签>页面部分。

  2. 选项中,选择gh-pages ,点击 "保存 "按钮。如果gh-pages 不存在,等待几秒钟并刷新页面。它最终会显示出来。
    image

  3. 刷新页面,直到它显示Your site is published at https://<github_username>.github.io/<repo> 。这可能需要一分钟的时间。
    image

定制feed

  1. 在仓库根部,打开osmosfeed.yaml 文件,点击 "铅笔(编辑此文件)"按钮进行编辑。

  2. 删除# ,取消对cacheUrl 属性的推荐,用你的GitHub用户名替换<github_username> ,用你的GitHub repo名称替换<repo>

  3. 在来源中,将项目更新为你要遵循的来源。文件的最终内容应该与此类似。

    cacheUrl
    
  4. 滚动到页面底部,点击 "提交修改 "按钮。

  5. 一旦重建完成,你的feed将可以在https://<github_username>.github.io/<repo>

指南和参考资料

贡献

常见问题

我可以更频繁地更新内容吗?

是的,你可以按你想要的频率进行。在.github/workflows/update-feed.yaml 文件中,改变cron时间表。但请注意,GitHub Actions的免费层级是有限制的。我的粗略估计显示,即使每小时更新一次,你也应该有大量的未使用时间。你可以在账户设置中的账单和计划页面监控支出

我可以把网站变成私有的,只有我可以看到吗?

这在GitHub页面上是不可能的。但是,如果你把网站转移到一个不同的主机服务,你应该能够在主机层面上设置授权。例如,如果你部署到 Netlify,有一个付费的密码保护计划。

我必须在URL的末尾输入index.html 吗?

不,GitHub有一个已知的问题,所以你可能要输入它直到它开始工作。见GitHub社区的讨论Stack Overflow的一些解决方案

如何触发手动网站更新?

你可以对osmosfeed.yaml 文件做一些修改来触发更新。例如,在新的一行添加一个像这样的空注释#

如何在不使用缓存的情况下建立网站?

你可以在osmosfeed.yaml 中注释掉cacheUrl 这个属性。注意,建站后,缓存仍然会被创建,只不过它不会包含之前缓存的任何内容。

生态系统

osmos::feed是osmos::craft生态系统的一部分。如果你喜欢这个工具,你可能也会喜欢。

  • osmos::memo:一个为标签和检索速度而优化的浏览器内的书签管理器。
  • osmos::note: 一个基于网络的文本编辑器,用于网络记事,可自行托管在任何Git仓库。