Skip to content
New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

Sign up for GitHub

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Jump to bottom

yfquotes@thegli: add individual quote design feature #1261

Merged
merged 1 commit into from
Aug 22, 2024
Merged

yfquotes@thegli: add individual quote design feature #1261

Show file tree
Hide file tree
Changes from all commits
Commits
Show all changes
1 commit
Select commit
File filter

Filter by extension

Filter by extension
Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
45 changes: 45 additions & 0 deletions yfquotes@thegli/README.md
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -23,6 +23,36 @@ Either follow the installation instructions on [Cinnamon spices](https://cinnamo

Check out the desklet configuration settings, and choose the data refresh period, the list of quotes to show, and quote details to display. The default list contains the Dow 30 companies.

### Individual Quote Design

By default, all quotes in the list are rendered in the same style and color, following whatever settings are active and selected.
Optionally, the *name* and the *symbol* of each quote can have a custom design. These individual design settings override the global settings. They are configured with a set of text properties within the quotes list.

The design properties are appended to the quote symbol in the format `property=value`. Each property/value pair is separated by a semicolon. Also insert a semicolon between the quote symbol and the first property. The order of the properties is irrelevant.
The full syntax: `SYMBOL;property1=value1;property2=value2`

The following table explains all supported properties:

| Property | Values | Description |
|---|---|---|
| color | any CSS color value | Text color for name and symbol |
| name | any text, except ';' | Custom name, overrides the original short/long name |
| style | normal, italic, oblique | Font style for name and symbol |
| weight | normal, bold, bolder, lighter, 100 - 900 | Font weight (thickness) for name and symbol |

Some examples:

```
CAT;color=#f6d001;weight=500
CSCO;name=Cisco;weight=bold;color=#00bceb
HD;color=#f96300
MMM;name=Post-It Makers;color=#ff0000
IBM;name=Big Blue;color=blue;weight=bolder
KO;name=Bubbly Brown Water;style=oblique;weight=lighter;color=#e61a27
```

> Note that any changes in the quotes list are not applied immediately (anymore). Press the "Refresh quotes data" button to trigger a manual data update for the current quotes list.

## Troubleshooting

Problem: The desklet fails to load data, and shows error message "Status: 429 Too Many Requests".
Expand All @@ -42,6 +72,21 @@ To disable the debug log mode, delete the "DEBUG" file, and restart the Cinnamon

## Release Notes

### 0.14.0 - August 21, 2024

Features:

- style each quote individually - see section [Individual Quote Design](#individual-quote-design) for details
- add Catalan translation (courtesy of [Odyssey]((https://github.com/odyssey))
- update Dutch translation (courtesy of [qadzek](https://github.com/qadzek))
- update Hungarian translation (courtesy of [bossbob88](https://github.com/bossbob88))
- update Spanish translation (courtesy of [haggen88](https://github.com/haggen88))

Bugfixes:

- quotes list sorting is now case-insensitive
- changes in quotes list are not instantly applied anymore (preventing potential network congestion, and desktop instabilities)

### 0.13.0 - July 10, 2024

Features:
Expand Down
Loading