You can not select more than 25 topics Topics must start with a letter or number, can include dashes ('-') and can be up to 35 characters long.
homepage/docs/configs/bookmarks.md

38 lines
1.3 KiB

1 year ago
---
title: Bookmarks
description: Bookmark Configuration
---
Bookmarks are configured in the `bookmarks.yaml` file. They function much the same as [Services](services.md), in how groups and lists work. They're just much simpler, smaller, and contain no extra features other than being a link out.
1 year ago
The design of homepage expects `abbr` to be 2 letters, but is not otherwise forced.
You can also use an icon for bookmarks similar to the [options for service icons](services.md#icons). If both icon and abbreviation are supplied, the icon takes precedence.
By default, the description will use the hostname of the link, but you can override it with a custom description.
```yaml
---
1 year ago
- Developer:
- Github:
- abbr: GH
href: https://github.com/
1 year ago
- Social:
- Reddit:
- icon: reddit.png
href: https://reddit.com/
description: The front page of the internet
1 year ago
- Entertainment:
- YouTube:
- abbr: YT
href: https://youtube.com/
1 year ago
```
which renders to (depending on your theme, etc.):
1 year ago
<img width="1000" alt="Bookmarks" src="https://user-images.githubusercontent.com/19408/269307009-d7e45885-230f-4e07-b421-9822017ae878.png">
The default [bookmarks.yaml](https://github.com/gethomepage/homepage/blob/main/src/skeleton/bookmarks.yaml) is a working example.