Convert News Aggregators HTML admonitions (#2376)

This commit is contained in:
Daniel Gray 2024-01-28 09:02:33 +00:00
parent e756ae4b37
commit 33aecf011a
No known key found for this signature in database
GPG Key ID: 41911F722B0F9AE3

View File

@ -11,7 +11,7 @@ A [news aggregator](https://en.wikipedia.org/wiki/News_aggregator) is a way to k
### Akregator ### Akregator
!!! recommendation <div class="admonition recommendation" markdown>
![Akregator logo](assets/img/news-aggregators/akregator.svg){ align=right } ![Akregator logo](assets/img/news-aggregators/akregator.svg){ align=right }
@ -23,13 +23,18 @@ A [news aggregator](https://en.wikipedia.org/wiki/News_aggregator) is a way to k
[:octicons-code-16:](https://invent.kde.org/pim/akregator){ .card-link title="Source Code" } [:octicons-code-16:](https://invent.kde.org/pim/akregator){ .card-link title="Source Code" }
[:octicons-heart-16:](https://kde.org/community/donations/){ .card-link title=Contribute } [:octicons-heart-16:](https://kde.org/community/donations/){ .card-link title=Contribute }
??? downloads <details class="downloads" markdown>
<summary>Downloads</summary>
- [:simple-flathub: Flathub](https://flathub.org/apps/details/org.kde.akregator) - [:simple-flathub: Flathub](https://flathub.org/apps/details/org.kde.akregator)
</details>
</div>
### NewsFlash ### NewsFlash
!!! recommendation <div class="admonition recommendation" markdown>
![NewsFlash logo](assets/img/news-aggregators/newsflash.png){ align=right } ![NewsFlash logo](assets/img/news-aggregators/newsflash.png){ align=right }
@ -38,13 +43,18 @@ A [news aggregator](https://en.wikipedia.org/wiki/News_aggregator) is a way to k
[:octicons-repo-16: Repository](https://gitlab.com/news-flash/news_flash_gtk){ .md-button .md-button--primary } [:octicons-repo-16: Repository](https://gitlab.com/news-flash/news_flash_gtk){ .md-button .md-button--primary }
[:octicons-code-16:](https://gitlab.com/news-flash/news_flash_gtk){ .card-link title="Source Code" } [:octicons-code-16:](https://gitlab.com/news-flash/news_flash_gtk){ .card-link title="Source Code" }
??? downloads <details class="downloads" markdown>
<summary>Downloads</summary>
- [:simple-flathub: Flathub](https://flathub.org/apps/io.gitlab.news_flash.NewsFlash) - [:simple-flathub: Flathub](https://flathub.org/apps/io.gitlab.news_flash.NewsFlash)
</details>
</div>
### Feeder ### Feeder
!!! recommendation <div class="admonition recommendation" markdown>
![Feeder logo](assets/img/news-aggregators/feeder.png){ align=right } ![Feeder logo](assets/img/news-aggregators/feeder.png){ align=right }
@ -54,13 +64,18 @@ A [news aggregator](https://en.wikipedia.org/wiki/News_aggregator) is a way to k
[:octicons-code-16:](https://github.com/spacecowboy/Feeder){ .card-link title="Source Code" } [:octicons-code-16:](https://github.com/spacecowboy/Feeder){ .card-link title="Source Code" }
[:octicons-heart-16:](https://ko-fi.com/spacecowboy){ .card-link title=Contribute } [:octicons-heart-16:](https://ko-fi.com/spacecowboy){ .card-link title=Contribute }
??? downloads <details class="downloads" markdown>
<summary>Downloads</summary>
- [:simple-googleplay: Google Play](https://play.google.com/store/apps/details?id=com.nononsenseapps.feeder.play) - [:simple-googleplay: Google Play](https://play.google.com/store/apps/details?id=com.nononsenseapps.feeder.play)
</details>
</div>
### Fluent Reader ### Fluent Reader
!!! recommendation <div class="admonition recommendation" markdown>
![Fluent Reader logo](assets/img/news-aggregators/fluent-reader.svg){ align=right } ![Fluent Reader logo](assets/img/news-aggregators/fluent-reader.svg){ align=right }
@ -72,28 +87,40 @@ A [news aggregator](https://en.wikipedia.org/wiki/News_aggregator) is a way to k
[:octicons-code-16:](https://github.com/yang991178/fluent-reader){ .card-link title="Source Code" } [:octicons-code-16:](https://github.com/yang991178/fluent-reader){ .card-link title="Source Code" }
[:octicons-heart-16:](https://github.com/sponsors/yang991178){ .card-link title=Contribute } [:octicons-heart-16:](https://github.com/sponsors/yang991178){ .card-link title=Contribute }
??? downloads <details class="downloads" markdown>
<summary>Downloads</summary>
- [:simple-windows11: Windows](https://hyliu.me/fluent-reader) - [:simple-windows11: Windows](https://hyliu.me/fluent-reader)
- [:simple-appstore: App Store](https://apps.apple.com/app/id1520907427) - [:simple-appstore: App Store](https://apps.apple.com/app/id1520907427)
</details>
</div>
### Miniflux ### Miniflux
!!! recommendation <div class="admonition recommendation" markdown>
![Miniflux logo](assets/img/news-aggregators/miniflux.svg#only-light){ align=right } ![Miniflux logo](assets/img/news-aggregators/miniflux.svg#only-light){ align=right }
![Miniflux logo](assets/img/news-aggregators/miniflux-dark.svg#only-dark){ align=right } ![Miniflux logo](assets/img/news-aggregators/miniflux-dark.svg#only-dark){ align=right }
**Miniflux** is a web-based news aggregator that you can self-host. It supports [RSS](https://en.wikipedia.org/wiki/RSS), [Atom](https://en.wikipedia.org/wiki/Atom_(Web_standard)), [RDF](https://en.wikipedia.org/wiki/RDF%2FXML) and [JSON Feed](https://en.wikipedia.org/wiki/JSON_Feed). **Miniflux** is a web-based news aggregator that you can self-host. It supports [RSS](https://en.wikipedia.org/wiki/RSS), [Atom](https://en.wikipedia.org/wiki/Atom_(Web_standard)), [RDF](https://en.wikipedia.org/wiki/RDF%2FXML) and [JSON Feed](https://en.wikipedia.org/wiki/JSON_Feed).
<details class="downloads" markdown>
<summary>Downloads</summary>
[:octicons-home-16: Homepage](https://miniflux.app){ .md-button .md-button--primary } [:octicons-home-16: Homepage](https://miniflux.app){ .md-button .md-button--primary }
[:octicons-info-16:](https://miniflux.app/docs/index.html){ .card-link title=Documentation} [:octicons-info-16:](https://miniflux.app/docs/index.html){ .card-link title=Documentation}
[:octicons-code-16:](https://github.com/miniflux/v2){ .card-link title="Source Code" } [:octicons-code-16:](https://github.com/miniflux/v2){ .card-link title="Source Code" }
[:octicons-heart-16:](https://miniflux.app/#donations){ .card-link title=Contribute } [:octicons-heart-16:](https://miniflux.app/#donations){ .card-link title=Contribute }
</details>
</div>
### NetNewsWire ### NetNewsWire
!!! recommendation <div class="admonition recommendation" markdown>
![NetNewsWire logo](assets/img/news-aggregators/netnewswire.png){ align=right } ![NetNewsWire logo](assets/img/news-aggregators/netnewswire.png){ align=right }
@ -104,14 +131,19 @@ A [news aggregator](https://en.wikipedia.org/wiki/News_aggregator) is a way to k
[:octicons-info-16:](https://netnewswire.com/help/){ .card-link title=Documentation} [:octicons-info-16:](https://netnewswire.com/help/){ .card-link title=Documentation}
[:octicons-code-16:](https://github.com/Ranchero-Software/NetNewsWire){ .card-link title="Source Code" } [:octicons-code-16:](https://github.com/Ranchero-Software/NetNewsWire){ .card-link title="Source Code" }
??? downloads <details class="downloads" markdown>
<summary>Downloads</summary>
- [:simple-appstore: App Store](https://apps.apple.com/us/app/netnewswire-rss-reader/id1480640210) - [:simple-appstore: App Store](https://apps.apple.com/us/app/netnewswire-rss-reader/id1480640210)
- [:simple-apple: macOS](https://netnewswire.com) - [:simple-apple: macOS](https://netnewswire.com)
</details>
</div>
### Newsboat ### Newsboat
!!! recommendation <div class="admonition recommendation" markdown>
![Newsboat logo](assets/img/news-aggregators/newsboat.svg){ align=right } ![Newsboat logo](assets/img/news-aggregators/newsboat.svg){ align=right }
@ -121,14 +153,19 @@ A [news aggregator](https://en.wikipedia.org/wiki/News_aggregator) is a way to k
[:octicons-info-16:](https://newsboat.org/releases/2.27/docs/newsboat.html){ .card-link title=Documentation} [:octicons-info-16:](https://newsboat.org/releases/2.27/docs/newsboat.html){ .card-link title=Documentation}
[:octicons-code-16:](https://github.com/newsboat/newsboat){ .card-link title="Source Code" } [:octicons-code-16:](https://github.com/newsboat/newsboat){ .card-link title="Source Code" }
</div>
## Criteria ## Criteria
**Please note we are not affiliated with any of the projects we recommend.** In addition to [our standard criteria](about/criteria.md), we have developed a clear set of requirements to allow us to provide objective recommendations. We suggest you familiarize yourself with this list before choosing to use a project, and conduct your own research to ensure it's the right choice for you. **Please note we are not affiliated with any of the projects we recommend.** In addition to [our standard criteria](about/criteria.md), we have developed a clear set of requirements to allow us to provide objective recommendations. We suggest you familiarize yourself with this list before choosing to use a project, and conduct your own research to ensure it's the right choice for you.
!!! example "This section is new" <div class="admonition example" markdown>
<p class="admonition-title">This section is new</p>
We are working on establishing defined criteria for every section of our site, and this may be subject to change. If you have any questions about our criteria, please [ask on our forum](https://discuss.privacyguides.net/latest) and don't assume we didn't consider something when making our recommendations if it is not listed here. There are many factors considered and discussed when we recommend a project, and documenting every single one is a work-in-progress. We are working on establishing defined criteria for every section of our site, and this may be subject to change. If you have any questions about our criteria, please [ask on our forum](https://discuss.privacyguides.net/latest) and don't assume we didn't consider something when making our recommendations if it is not listed here. There are many factors considered and discussed when we recommend a project, and documenting every single one is a work-in-progress.
</div>
- Must be open-source software. - Must be open-source software.
- Must operate locally, i.e. must not be a cloud service. - Must operate locally, i.e. must not be a cloud service.
@ -140,33 +177,44 @@ Some social media services also support RSS although it's not often advertised.
Reddit allows you to subscribe to subreddits via RSS. Reddit allows you to subscribe to subreddits via RSS.
!!! example <div class="admonition example" markdown>
<p class="admonition-title">Example</p>
Replace `[SUBREDDIT]` with the subreddit you wish to subscribe to. Replace `[SUBREDDIT]` with the subreddit you wish to subscribe to.
```text ```text
https://www.reddit.com/r/[SUBREDDIT]/new/.rss https://www.reddit.com/r/[SUBREDDIT]/new/.rss
``` ```
</div>
### Twitter ### Twitter
Using any of the Nitter [instances](https://github.com/zedeus/nitter/wiki/Instances) you can easily subscribe using RSS. Using any of the Nitter [instances](https://github.com/zedeus/nitter/wiki/Instances) you can easily subscribe using RSS.
!!! example <div class="admonition example" markdown>
<p class="admonition-title">Example</p>
1. Pick an instance and set `nitter_instance`. 1. Pick an instance and set `nitter_instance`.
2. Replace `twitter_account` with the account name. 2. Replace `twitter_account` with the account name.
```text ```text
https://{{ nitter_instance }}/{{ twitter_account }}/rss https://[nitter_instance]/[twitter_account]/rss
``` ```
</div>
### YouTube ### YouTube
You can subscribe YouTube channels without logging in and associating usage information with your Google Account. You can subscribe YouTube channels without logging in and associating usage information with your Google Account.
!!! example <div class="admonition example" markdown>
<p class="admonition-title">Example</p>
To subscribe to a YouTube channel with an RSS client, first look for its [channel code](https://support.google.com/youtube/answer/6180214). The channel code can be found on the about page of the YouTube channel you wish to subscribe to, under: **About** > **Share** > **Copy channel ID**. Replace `[CHANNEL ID]` below: To subscribe to a YouTube channel with an RSS client, first look for its [channel code](https://support.google.com/youtube/answer/6180214). The channel code can be found on the about page of the YouTube channel you wish to subscribe to, under: **About** > **Share** > **Copy channel ID**. Replace `[CHANNEL ID]` below:
```text ```text
https://www.youtube.com/feeds/videos.xml?channel_id=[CHANNEL ID] https://www.youtube.com/feeds/videos.xml?channel_id=[CHANNEL ID]
``` ```
</div>