mirror of
https://github.com/gethomepage/homepage.git
synced 2026-09-27 06:21:18 -07:00
47 lines
1.4 KiB
Markdown
47 lines
1.4 KiB
Markdown
---
|
|
title: Feed
|
|
description: RSS / Atom feed widget
|
|
---
|
|
|
|
This widget shows the latest items from an RSS 2.0 or Atom feed.
|
|
|
|
```yaml
|
|
widget:
|
|
type: feed
|
|
url: https://feeds.bbci.co.uk/news/rss.xml
|
|
maxItems: 5 # optional - defaults to 5
|
|
layout: list # optional - possible values list, grid - defaults to list
|
|
images: true # optional - set to false to hide images - defaults to true
|
|
```
|
|
|
|
## Layouts
|
|
|
|
`list` shows one row per item. Items with an image get a small thumbnail.
|
|
|
|
|
|
|
|
|
|
|
|
`grid` shows image tiles that re-flow to fit the width of the widget, e.g.:
|
|
|
|
```yaml
|
|
- World News:
|
|
widget:
|
|
type: feed
|
|
url: https://feeds.bbci.co.uk/news/world/rss.xml
|
|
layout: grid
|
|
maxItems: 8
|
|
```
|
|
|
|
|
|
|
|
## Images
|
|
|
|
Images are taken from the feed's `media:thumbnail` / `media:content` tags or image enclosures, falling back to the first image in the item's content. Some feeds do not include images at all.
|
|
|
|
Images are loaded by your browser directly from the feed's host, at whatever size the feed provides. Feeds that link full-size originals can be slow to load; set `images: false` for those.
|
|
|
|
## Notes
|
|
|
|
Feeds are fetched by homepage, not your browser, and cached for 10 minutes.
|