From a68805b55dd01151c1f7675c8d0635ae47adf98e Mon Sep 17 00:00:00 2001 From: Svilen Markov <7613769+svilenmarkov@users.noreply.github.com> Date: Tue, 29 Apr 2025 18:55:30 +0100 Subject: [PATCH] Merge remote-tracking branch 'upstream/dev' into theme_switcher --- .dockerignore | 1 + .github/ISSUE_TEMPLATE/bug_report.yml | 37 + .github/ISSUE_TEMPLATE/config.yml | 8 + .github/ISSUE_TEMPLATE/feature_request.yml | 33 + .github/PULL_REQUEST_TEMPLATE.md | 8 +- .gitignore | 2 +- Dockerfile | 4 +- Dockerfile.goreleaser | 2 +- README.md | 454 +++- docs/configuration.md | 1216 ++++++++-- docs/custom-api.md | 416 ++++ docs/extensions.md | 3 + docs/glance.yml | 105 + .../images/calendar-legacy-widget-preview.png | Bin 0 -> 10835 bytes docs/images/calendar-widget-preview.png | Bin 10835 -> 13174 bytes docs/images/custom-api-preview-1.png | Bin 0 -> 8068 bytes docs/images/custom-api-preview-2.png | Bin 0 -> 5826 bytes docs/images/custom-api-preview-3.png | Bin 0 -> 21811 bytes docs/images/docker-container-parent.png | Bin 0 -> 17836 bytes docs/images/docker-container-parent2.png | Bin 0 -> 20362 bytes docs/images/docker-containers-preview.png | Bin 0 -> 34236 bytes docs/images/preconfigured-page-preview.png | Bin 350979 -> 371001 bytes docs/images/reddit-field-search.png | Bin 44930 -> 43483 bytes docs/images/server-stats-flame-icon.png | Bin 0 -> 9864 bytes docs/images/server-stats-preview.gif | Bin 0 -> 204897 bytes docs/images/split-column-widget-3-columns.png | Bin 0 -> 149054 bytes docs/images/split-column-widget-4-columns.png | Bin 0 -> 185117 bytes docs/images/split-column-widget-masonry.png | Bin 0 -> 333240 bytes docs/images/split-column-widget-preview.png | Bin 335405 -> 347141 bytes docs/images/themes/dracula.png | Bin 0 -> 1150915 bytes docs/images/themes/gruvbox.png | Bin 0 -> 1398339 bytes .../videos-widget-vertical-list-preview.png | Bin 0 -> 79163 bytes docs/themes.md | 21 + docs/v0.7.0-upgrade.md | 57 + go.mod | 20 +- go.sum | 68 +- internal/glance/cli.go | 85 +- internal/glance/config-fields.go | 150 +- internal/glance/config.go | 242 +- internal/glance/diagnose.go | 8 +- internal/glance/embed.go | 90 + internal/glance/glance.go | 84 +- internal/glance/main.go | 12 +- internal/glance/static/css/forum-posts.css | 19 + internal/glance/static/css/main.css | 66 + internal/glance/static/css/mobile.css | 223 ++ internal/glance/static/css/popover.css | 65 + internal/glance/static/css/site.css | 396 ++++ internal/glance/static/css/utils.css | 562 +++++ .../glance/static/css/widget-bookmarks.css | 31 + .../glance/static/css/widget-calendar.css | 71 + internal/glance/static/css/widget-clock.css | 7 + .../glance/static/css/widget-dns-stats.css | 120 + .../static/css/widget-docker-containers.css | 26 + internal/glance/static/css/widget-group.css | 49 + internal/glance/static/css/widget-markets.css | 13 + internal/glance/static/css/widget-monitor.css | 36 + internal/glance/static/css/widget-reddit.css | 22 + .../glance/static/css/widget-releases.css | 6 + internal/glance/static/css/widget-rss.css | 56 + internal/glance/static/css/widget-search.css | 79 + .../glance/static/css/widget-server-stats.css | 81 + internal/glance/static/css/widget-twitch.css | 47 + internal/glance/static/css/widget-videos.css | 13 + internal/glance/static/css/widget-weather.css | 139 ++ internal/glance/static/css/widgets.css | 88 + internal/glance/static/js/animations.js | 33 + internal/glance/static/js/calendar.js | 212 ++ internal/glance/static/js/main.js | 26 +- internal/glance/static/js/popover.js | 10 +- internal/glance/static/js/templating.js | 190 ++ internal/glance/static/main.css | 1975 ----------------- internal/glance/static/manifest.json | 14 - internal/glance/templates.go | 46 +- internal/glance/templates/bookmarks.html | 29 +- internal/glance/templates/calendar.html | 29 +- internal/glance/templates/dns-stats.html | 8 +- .../glance/templates/docker-containers.html | 74 +- internal/glance/templates/document.html | 12 +- internal/glance/templates/forum-posts.html | 62 +- internal/glance/templates/group.html | 17 +- internal/glance/templates/manifest.json | 15 + internal/glance/templates/markets.html | 4 +- internal/glance/templates/monitor.html | 2 +- internal/glance/templates/old-calendar.html | 34 + internal/glance/templates/page.html | 28 +- .../templates/reddit-horizontal-cards.html | 2 +- .../templates/reddit-vertical-cards.html | 2 +- internal/glance/templates/search.html | 2 +- internal/glance/templates/server-stats.html | 140 ++ .../glance/templates/twitch-channels.html | 2 +- .../glance/templates/twitch-games-list.html | 2 +- .../templates/v0.7-update-notice-page.html | 8 +- .../templates/videos-vertical-list.html | 20 + internal/glance/templates/widget-base.html | 36 +- internal/glance/utils.go | 76 +- internal/glance/widget-bookmarks.go | 29 +- internal/glance/widget-calendar.go | 93 +- internal/glance/widget-custom-api.go | 532 ++++- internal/glance/widget-dns-stats.go | 567 ++++- internal/glance/widget-docker-containers.go | 152 +- internal/glance/widget-extension.go | 48 +- internal/glance/widget-markets.go | 55 +- internal/glance/widget-monitor.go | 32 +- internal/glance/widget-old-calendar.go | 86 + internal/glance/widget-reddit.go | 195 +- internal/glance/widget-releases.go | 168 +- internal/glance/widget-rss.go | 195 +- internal/glance/widget-search.go | 5 + internal/glance/widget-server-stats.go | 117 + internal/glance/widget-twitch-channels.go | 4 + internal/glance/widget-utils.go | 31 +- internal/glance/widget-videos.go | 36 +- internal/glance/widget-weather.go | 2 +- internal/glance/widget.go | 19 +- pkg/sysinfo/sysinfo.go | 298 +++ 116 files changed, 8020 insertions(+), 3095 deletions(-) create mode 100644 .github/ISSUE_TEMPLATE/bug_report.yml create mode 100644 .github/ISSUE_TEMPLATE/config.yml create mode 100644 .github/ISSUE_TEMPLATE/feature_request.yml create mode 100644 docs/custom-api.md create mode 100644 docs/glance.yml create mode 100644 docs/images/calendar-legacy-widget-preview.png create mode 100644 docs/images/custom-api-preview-1.png create mode 100644 docs/images/custom-api-preview-2.png create mode 100644 docs/images/custom-api-preview-3.png create mode 100644 docs/images/docker-container-parent.png create mode 100644 docs/images/docker-container-parent2.png create mode 100644 docs/images/docker-containers-preview.png create mode 100644 docs/images/server-stats-flame-icon.png create mode 100644 docs/images/server-stats-preview.gif create mode 100644 docs/images/split-column-widget-3-columns.png create mode 100644 docs/images/split-column-widget-4-columns.png create mode 100644 docs/images/split-column-widget-masonry.png create mode 100644 docs/images/themes/dracula.png create mode 100644 docs/images/themes/gruvbox.png create mode 100644 docs/images/videos-widget-vertical-list-preview.png create mode 100644 docs/v0.7.0-upgrade.md create mode 100644 internal/glance/static/css/forum-posts.css create mode 100644 internal/glance/static/css/main.css create mode 100644 internal/glance/static/css/mobile.css create mode 100644 internal/glance/static/css/popover.css create mode 100644 internal/glance/static/css/site.css create mode 100644 internal/glance/static/css/utils.css create mode 100644 internal/glance/static/css/widget-bookmarks.css create mode 100644 internal/glance/static/css/widget-calendar.css create mode 100644 internal/glance/static/css/widget-clock.css create mode 100644 internal/glance/static/css/widget-dns-stats.css create mode 100644 internal/glance/static/css/widget-docker-containers.css create mode 100644 internal/glance/static/css/widget-group.css create mode 100644 internal/glance/static/css/widget-markets.css create mode 100644 internal/glance/static/css/widget-monitor.css create mode 100644 internal/glance/static/css/widget-reddit.css create mode 100644 internal/glance/static/css/widget-releases.css create mode 100644 internal/glance/static/css/widget-rss.css create mode 100644 internal/glance/static/css/widget-search.css create mode 100644 internal/glance/static/css/widget-server-stats.css create mode 100644 internal/glance/static/css/widget-twitch.css create mode 100644 internal/glance/static/css/widget-videos.css create mode 100644 internal/glance/static/css/widget-weather.css create mode 100644 internal/glance/static/css/widgets.css create mode 100644 internal/glance/static/js/animations.js create mode 100644 internal/glance/static/js/calendar.js create mode 100644 internal/glance/static/js/templating.js delete mode 100644 internal/glance/static/main.css delete mode 100644 internal/glance/static/manifest.json create mode 100644 internal/glance/templates/manifest.json create mode 100644 internal/glance/templates/old-calendar.html create mode 100644 internal/glance/templates/server-stats.html create mode 100644 internal/glance/templates/videos-vertical-list.html create mode 100644 internal/glance/widget-old-calendar.go create mode 100644 internal/glance/widget-server-stats.go create mode 100644 pkg/sysinfo/sysinfo.go diff --git a/.dockerignore b/.dockerignore index 8708dce..1f9515c 100644 --- a/.dockerignore +++ b/.dockerignore @@ -5,6 +5,7 @@ # Only add necessary files to the Docker build context (Dockerfiles are always included implicitly) !/build/ !/internal/ +!/pkg/ !/go.mod !/go.sum !main.go diff --git a/.github/ISSUE_TEMPLATE/bug_report.yml b/.github/ISSUE_TEMPLATE/bug_report.yml new file mode 100644 index 0000000..bdd4fe6 --- /dev/null +++ b/.github/ISSUE_TEMPLATE/bug_report.yml @@ -0,0 +1,37 @@ +name: Bug report +description: Let us know if something isn't working as expected +labels: ["bug report"] +body: + - type: markdown + attributes: + value: | + > [!NOTE] + > + > Do not prefix your title with "[BUG]", "[Bug report]", etc., a label will be added automatically. + + If you're unsure whether you're experiencing a bug or not, consider using the [Discussions](https://github.com/glanceapp/glance/discussions) or [Discord](https://discord.com/invite/7KQ7Xa9kJd) to ask for help. + + Please include only the information you think is relevant to the bug: + + * How did you install Glance? (Docker container, manual binary install, etc) + * Which version of Glance are you using? + * Include the relevant parts of your `glance.yml` if applicable (widget, data source, properties used, etc) + * Include any relevant logs or screenshots if applicable + * Is the issue specific to a certain browser or OS? + * Steps to reliably reproduce the issue + * Are you hosting Glance on a VPS? + * Anything else you think might be relevant + + **No need to copy the above list into your description, it's just a guide to help you provide the most useful information.** + + - type: textarea + id: description + validations: + required: true + attributes: + label: Description + + - type: markdown + attributes: + value: | + Thank you for taking the time to submit a bug report. diff --git a/.github/ISSUE_TEMPLATE/config.yml b/.github/ISSUE_TEMPLATE/config.yml new file mode 100644 index 0000000..e8c34af --- /dev/null +++ b/.github/ISSUE_TEMPLATE/config.yml @@ -0,0 +1,8 @@ +blank_issues_enabled: false +contact_links: + - name: Discussions + url: https://github.com/glanceapp/glance/discussions + about: For help, feedback, guides, resources and more + - name: Discord + url: https://discord.com/invite/7KQ7Xa9kJd + about: Much like the discussions but more chatty diff --git a/.github/ISSUE_TEMPLATE/feature_request.yml b/.github/ISSUE_TEMPLATE/feature_request.yml new file mode 100644 index 0000000..d8f5343 --- /dev/null +++ b/.github/ISSUE_TEMPLATE/feature_request.yml @@ -0,0 +1,33 @@ +name: Feature request +description: Share your ideas for new features or improvements +labels: ["feature request"] +body: + - type: markdown + attributes: + value: | + > [!NOTE] + > + > Do not prefix your title with "[REQUEST]", "[Feature request]", etc., a label will be added automatically. + + Please provide a detailed description of what the feature would do and what it would look like: + + * What problem would this feature solve? + * Are there any potential downsides to this feature? + * If applicable, what would the configuration for this feature look like? + * Are there any existing examples of this feature in other software? + * If applicable, include any external documentation required to implement this feature + * Anything else you think might be relevant + + **No need to copy the above list into your description, it's just a guide to help you provide the most useful information.** + + - type: textarea + id: description + validations: + required: true + attributes: + label: Description + + - type: markdown + attributes: + value: | + Thank you for taking the time to submit your idea. diff --git a/.github/PULL_REQUEST_TEMPLATE.md b/.github/PULL_REQUEST_TEMPLATE.md index 22b3d05..690586f 100644 --- a/.github/PULL_REQUEST_TEMPLATE.md +++ b/.github/PULL_REQUEST_TEMPLATE.md @@ -1,7 +1 @@ - + diff --git a/.gitignore b/.gitignore index e466992..2cd84fc 100644 --- a/.gitignore +++ b/.gitignore @@ -2,4 +2,4 @@ /build /playground /.idea -glance*.yml +/glance*.yml diff --git a/Dockerfile b/Dockerfile index b89541a..0c4cc63 100644 --- a/Dockerfile +++ b/Dockerfile @@ -1,10 +1,10 @@ -FROM golang:1.23.1-alpine3.20 AS builder +FROM golang:1.24.2-alpine3.21 AS builder WORKDIR /app COPY . /app RUN CGO_ENABLED=0 go build . -FROM alpine:3.20 +FROM alpine:3.21 WORKDIR /app COPY --from=builder /app/glance . diff --git a/Dockerfile.goreleaser b/Dockerfile.goreleaser index eaf8336..bbfa8ad 100644 --- a/Dockerfile.goreleaser +++ b/Dockerfile.goreleaser @@ -1,4 +1,4 @@ -FROM alpine:3.20 +FROM alpine:3.21 WORKDIR /app COPY glance . diff --git a/README.md b/README.md index da6fb58..ca16c49 100644 --- a/README.md +++ b/README.md @@ -1,114 +1,436 @@
What if you could see everything at a...
Install • Configuration • Preconfigured pages • Themes • Discord
+Install • Configuration • Discord • Sponsor
+Community widgets • Preconfigured pages • Themes
- + -### Features -#### Various widgets +## Features +### Various widgets * RSS feeds * Subreddit posts -* Weather -* Bookmarks -* Hacker News -* Lobsters -* Latest YouTube videos from specific channels -* Clock -* Calendar -* Stocks -* iframe -* Twitch channels & top games -* GitHub releases -* Repository overview -* Docker containers -* Site monitor -* Search box +* Hacker News posts +* Weather forecasts +* YouTube channel uploads +* Twitch channels +* Market prices +* Docker containers status +* Server stats +* Custom widgets +* [and many more...](docs/configuration.md) -#### Themeable - +### Fast and lightweight +* Low memory usage +* Few dependencies +* Minimal vanilla JS +* Single <20mb binary available for multiple OSs & architectures and just as small Docker container +* Uncached pages usually load within ~1s (depending on internet speed and number of widgets) -#### Optimized for mobile devices - +### Tons of customizability +* Different layouts +* As many pages/tabs as you need +* Numerous configuration options for each widget +* Multiple styles for some widgets +* Custom CSS -#### Fast and lightweight -* Minimal JS, no bloated frameworks -* Very few dependencies -* Single, easily distributed <15mb binary and just as small docker container -* All requests are parallelized, uncached pages usually load within ~1s (depending on internet speed and number of widgets) +### Optimized for mobile devices +Because you'll want to take it with you on the go. -### Configuration -Checkout the [configuration docs](docs/configuration.md) to learn more. A [preconfigured page](docs/configuration.md#preconfigured-page) is also available to get you started quickly. + -### Installation -> [!CAUTION] -> -> The project is under active development, expect things to break every once in a while. +### Themeable +Easily create your own theme by tweaking a few numbers or choose from one of the [already available themes](docs/themes.md). -#### Manual -Checkout the [releases page](https://github.com/glanceapp/glance/releases) for available binaries. You can place the binary inside `/opt/glance/` and have it start with your server via a [systemd service](https://linuxhandbook.com/create-systemd-services/). To specify a different path for the config file use the `--config` option: + + +Powered by Glance
logo-url: /assets/logo.png favicon-url: /assets/logo.png + app-name: "My Dashboard" + app-icon-url: "/assets/app-icon.png" + app-background-color: "#151519" ``` ### Properties @@ -205,6 +287,9 @@ branding: | logo-text | string | no | G | | logo-url | string | no | | | favicon-url | string | no | | +| app-name | string | no | Glance | +| app-icon-url | string | no | Glance's default icon | +| app-background-color | string | no | Glance's default background color | #### `hide-footer` Hides the footer when set to `true`. @@ -221,6 +306,15 @@ Specify a URL to a custom image to use instead of the "G" found in the navigatio #### `favicon-url` Specify a URL to a custom image to use for the favicon. +#### `app-name` +Specify the name of the web app shown in browser tab and PWA. + +#### `app-icon-url` +Specify URL for PWA and browser tab icon (512x512 PNG). + +#### `app-background-color` +Specify background color for PWA. Must be a valid CSS color. + ## Theme Theming is done through a top level `theme` property. Values for the colors are in [HSL](https://giggster.com/guide/basics/hue-saturation-lightness/) (hue, saturation, lightness) format. You can use a color picker [like this one](https://hslpicker.com/) to convert colors from other formats to HSL. The values are separated by a space and `%` is not required for any of the numbers. @@ -248,7 +342,7 @@ theme: negative-color: 347 87 44 ``` -### Themes +### Available themes If you don't want to spend time configuring your own theme, there are [several available themes](themes.md) which you can simply copy the values for. ### Properties @@ -351,23 +445,29 @@ pages: ### Properties | Name | Type | Required | Default | | ---- | ---- | -------- | ------- | -| title | string | yes | | +| name | string | yes | | | slug | string | no | | | width | string | no | | +| desktop-navigation-width | string | no | | | center-vertically | boolean | no | false | | hide-desktop-navigation | boolean | no | false | | expand-mobile-page-navigation | boolean | no | false | | show-mobile-header | boolean | no | false | | columns | array | yes | | -#### `title` +#### `name` The name of the page which gets shown in the navigation bar. #### `slug` The URL friendly version of the title which is used to access the page. For example if the title of the page is "RSS Feeds" you can make the page accessible via `localhost:8080/feeds` by setting the slug to `feeds`. If not defined, it will automatically be generated from the title. #### `width` -The maximum width of the page on desktop. Possible values are `slim` and `wide`. +The maximum width of the page on desktop. Possible values are `default`, `slim` and `wide`. + +#### `desktop-navigation-width` +The maximum width of the desktop navigation. Useful if you have a few pages that use a different width than the rest and don't want the navigation to jump abruptly when going to and away from those pages. Possible values are `default`, `slim` and `wide`. + +Here are the pixel equivalents for each value: * default: `1600px` * slim: `1100px` @@ -526,9 +626,22 @@ Example: | thumbnail-height | float | no | 10 | | card-height | float | no | 27 | | limit | integer | no | 25 | +| preserve-order | bool | no | false | | single-line-titles | boolean | no | false | | collapse-after | integer | no | 5 | +##### `limit` +The maximum number of articles to show. + +##### `collapse-after` +How many articles are visible before the "SHOW MORE" button appears. Set to `-1` to never collapse. + +##### `preserve-order` +When set to `true`, the order of the articles will be preserved as they are in the feeds. Useful if a feed uses its own sorting order which denotes the importance of the articles. If you use this property while having a lot of feeds, it's recommended to set a `limit` to each individual feed since if the first defined feed has 15 articles, the articles from the second feed will start after the 15th article in the list. + +##### `single-line-titles` +When set to `true`, truncates the title of each post if it exceeds one line. Only applies when the style is set to `vertical-list`. + ##### `style` Used to change the appearance of the widget. Possible values are: @@ -571,9 +684,13 @@ An array of RSS/atom feeds. The title can optionally be changed. | title | string | no | the title provided by the feed | | | hide-categories | boolean | no | false | Only applicable for `detailed-list` style | | hide-description | boolean | no | false | Only applicable for `detailed-list` style | +| limit | integer | no | | | | item-link-prefix | string | no | | | | headers | key (string) & value (string) | no | | | +###### `limit` +The maximum number of articles to show from that specific feed. Useful if you have a feed which posts a lot of articles frequently and you want to prevent it from excessively pushing down articles from other feeds. + ###### `item-link-prefix` If an RSS feed isn't returning item links with a base domain and Glance has failed to automatically detect the correct domain you can manually add a prefix to each link with this property. @@ -588,15 +705,6 @@ Optionally specify the headers that will be sent with the request. Example: User-Agent: Custom User Agent ``` -##### `limit` -The maximum number of articles to show. - -##### `single-line-titles` -When set to `true`, truncates the title of each post if it exceeds one line. Only applies when the style is set to `vertical-list`. - -##### `collapse-after` -How many articles are visible before the "SHOW MORE" button appears. Set to `-1` to never collapse. - ### Videos Display a list of the latest videos from specific YouTube channels. @@ -617,20 +725,16 @@ Preview: | Name | Type | Required | Default | | ---- | ---- | -------- | ------- | | channels | array | yes | | +| playlists | array | no | | | limit | integer | no | 25 | | style | string | no | horizontal-cards | +| collapse-after | integer | no | 7 | | collapse-after-rows | integer | no | 4 | | include-shorts | boolean | no | false | | video-url-template | string | no | https://www.youtube.com/watch?v={VIDEO-ID} | ##### `channels` -A list of channel or playlist IDs. To specify a playlist, use the `playlist:` prefix like such: - -```yaml -channels: - - playlist:PL8mG-RkN2uTyZZ00ObwZxxoG_nJbs3qec - - playlist:PL8mG-RkN2uTxTK4m_Vl2dYR9yE41kRdBg -``` +A list of channels IDs. One way of getting the ID of a channel is going to the channel's page and clicking on its description: @@ -640,14 +744,32 @@ Then scroll down and click on "Share channel", then "Copy channel ID":  +##### `playlists` + +A list of playlist IDs: + +```yaml +- type: videos + playlists: + - PL8mG-RkN2uTyZZ00ObwZxxoG_nJbs3qec + - PL8mG-RkN2uTxTK4m_Vl2dYR9yE41kRdBg +``` + ##### `limit` The maximum number of videos to show. +##### `collapse-after` +Specify the number of videos to show when using the `vertical-list` style before the "SHOW MORE" button appears. + ##### `collapse-after-rows` Specify the number of rows to show when using the `grid-cards` style before the "SHOW MORE" button appears. ##### `style` -Used to change the appearance of the widget. Possible values are `horizontal-cards` and `grid-cards`. +Used to change the appearance of the widget. Possible values are `horizontal-cards`, `vertical-list` and `grid-cards`. + +Preview of `vertical-list`: + + Preview of `grid-cards`: @@ -762,7 +884,10 @@ Display a list of posts from a specific subreddit. > [!WARNING] > -> Reddit does not allow unauthorized API access from VPS IPs, if you're hosting Glance on a VPS you will get a 403 response. As a workaround you can route the traffic from Glance through a VPN or your own HTTP proxy using the `request-url-template` property. +> Reddit does not allow unauthorized API access from VPS IPs, if you're hosting Glance on a VPS you will get a 403 +> response. As a workaround you can either [register an app on Reddit](https://ssl.reddit.com/prefs/apps/) and use the +> generated ID and secret in the widget configuration to authenticate your requests (see `app-auth` property), use a proxy +> (see `proxy` property) or route the traffic from Glance through a VPN. Example: @@ -782,10 +907,12 @@ Example: | collapse-after | integer | no | 5 | | comments-url-template | string | no | https://www.reddit.com/{POST-PATH} | | request-url-template | string | no | | +| proxy | string or multiple parameters | no | | | sort-by | string | no | hot | | top-period | string | no | day | | search | string | no | | | extra-sort-by | string | no | | +| app-auth | object | no | | ##### `subreddit` The subreddit for which to fetch the posts from. @@ -843,7 +970,7 @@ r/selfhosted/comments/bsp01i/welcome_to_rselfhosted_please_read_this_first/ `{SUBREDDIT}` - the subreddit name ##### `request-url-template` -A custom request url that will be used to fetch the data instead. This is useful when you're hosting Glance on a VPS and Reddit is blocking the requests, and you want to route it through an HTTP proxy. +A custom request URL that will be used to fetch the data. This is useful when you're hosting Glance on a VPS where Reddit is blocking the requests and you want to route them through a proxy that accepts the URL as either a part of the path or a query parameter. Placeholders: @@ -854,6 +981,29 @@ https://proxy/{REQUEST-URL} https://your.proxy/?url={REQUEST-URL} ``` +##### `proxy` +A custom HTTP/HTTPS proxy URL that will be used to fetch the data. This is useful when you're hosting Glance on a VPS where Reddit is blocking the requests and you want to bypass the restriction by routing the requests through a proxy. Example: + +```yaml +proxy: http://user:pass@proxy.com:8080 +proxy: https://user:pass@proxy.com:443 +``` + +Alternatively, you can specify the proxy URL as well as additional options by using multiple parameters: + +```yaml +proxy: + url: http://proxy.com:8080 + allow-insecure: true + timeout: 10s +``` + +###### `allow-insecure` +When set to `true`, allows the use of insecure connections such as when the proxy has a self-signed certificate. + +###### `timeout` +The maximum time to wait for a response from the proxy. The value is a string and must be a number followed by one of s, m, h, d. Example: `10s` for 10 seconds, `1m` for 1 minute, etc + ##### `sort-by` Can be used to specify the order in which the posts should get returned. Possible values are `hot`, `new`, `top` and `rising`. @@ -870,6 +1020,17 @@ Can be used to specify an additional sort which will be applied on top of the al The `engagement` sort tries to place the posts with the most points and comments on top, also prioritizing recent over old posts. +##### `app-auth` +```yaml +widgets: + - type: reddit + subreddit: technology + app-auth: + name: ${REDDIT_APP_NAME} + id: ${REDDIT_APP_CLIENT_ID} + secret: ${REDDIT_APP_SECRET} +``` + ### Search Widget Display a search bar that can be used to search for specific terms on various search engines. @@ -907,6 +1068,7 @@ Preview: | search-engine | string | no | duckduckgo | | new-tab | boolean | no | false | | autofocus | boolean | no | false | +| target | string | no | _blank | | placeholder | string | no | Type here to search… | | bangs | array | no | | @@ -917,6 +1079,10 @@ Either a value from the table below or a URL to a custom search engine. Use `{QU | ---- | --- | | duckduckgo | `https://duckduckgo.com/?q={QUERY}` | | google | `https://www.google.com/search?q={QUERY}` | +| bing | `https://www.bing.com/search?q={QUERY}` | +| perplexity | `https://www.perplexity.ai/search?q={QUERY}` | +| kagi | `https://kagi.com/search?q={QUERY}` | +| startpage | `https://www.startpage.com/search?q={QUERY}` | ##### `new-tab` When set to `true`, swaps the shortcuts for showing results in the same or new tab, defaulting to showing results in a new tab. @@ -924,6 +1090,9 @@ When set to `true`, swaps the shortcuts for showing results in the same or new t ##### `autofocus` When set to `true`, automatically focuses the search input on page load. +##### `target` +The target to use when opening the search results in a new tab. Possible values are `_blank`, `_self`, `_parent` and `_top`. + ##### `placeholder` When set, modifies the text displayed in the input field before typing. @@ -1006,65 +1175,348 @@ Example: ``` ### Split Column - -Splits a full sized column in half, allowing you to place widgets side by side. This is converted to a single column on mobile devices or if not enough width is available. Widgets are defined using a `widgets` property exactly as you would on a page column. +Splits a full sized column in half, allowing you to place widgets side by side horizontally. This is converted to a single column on mobile devices or if not enough width is available. Widgets are defined using a `widgets` property exactly as you would on a page column. -Example of a full page with an effective 4 column layout using two split column widgets inside of two full sized columns: +Two widgets side by side in a `full` column: + +glance.yml
glance.yml
glance.yml
glance.yml
glance.yml
{{ .JSON.String "text" }}
+``` +glance.yml
glance.yml
{{ .JSON.String "text" }}
+{{ (.Subrequest "another-one").JSON.String "text" }}
+``` + +The subrequests support all the same properties as the main request, except for `subrequests` itself, so you can use `headers`, `parameters`, etc. + +`(.Subrequest "key")` can be a little cumbersome to write, so you can define a variable to make it easier: + +```yaml + template: | + {{ $anotherOne := .Subrequest "another-one" }} +{{ $anotherOne.JSON.String "text" }}
+``` + +You can also access the `.Response` property of a subrequest as you would with the main request: + +```yaml + template: | + {{ $anotherOne := .Subrequest "another-one" }} +{{ $anotherOne.Response.StatusCode }}
+``` + +> [!NOTE] +> +> Setting this property will override any query parameters that are already in the URL. + +```yaml +parameters: + param1: value1 + param2: + - item1 + - item2 +``` ### Extension Display a widget provided by an external source (3rd party). If you want to learn more about developing extensions, checkout the [extensions documentation](extensions.md) (WIP). @@ -1083,6 +1535,7 @@ Display a widget provided by an external source (3rd party). If you want to lear | url | string | yes | | | fallback-content-type | string | no | | | allow-potentially-dangerous-html | boolean | no | false | +| headers | key & value | no | | | parameters | key & value | no | | ##### `url` @@ -1091,6 +1544,14 @@ The URL of the extension. **Note that the query gets stripped from this URL and ##### `fallback-content-type` Optionally specify the fallback content type of the extension if the URL does not return a valid `Widget-Content-Type` header. Currently the only supported value for this property is `html`. +##### `headers` +Optionally specify the headers that will be sent with the request. Example: + +```yaml +headers: + x-api-key: ${SECRET_KEY} +``` + ##### `allow-potentially-dangerous-html` Whether to allow the extension to display HTML. @@ -1224,10 +1685,12 @@ Properties for each site: | title | string | yes | | | url | string | yes | | | check-url | string | no | | +| error-url | string | no | | | icon | string | no | | | allow-insecure | boolean | no | false | | same-tab | boolean | no | false | | alt-status-codes | array | no | | +| basic-auth | object | no | | `title` @@ -1235,12 +1698,16 @@ The title used to indicate the site. `url` -The public facing URL of a monitored service, the user will be redirected here. If `check-url` is not specified, this is used as the status check. +The URL of the monitored service, which must be reachable by Glance, and will be used as the link to go to when clicking on the title. If `check-url` is not specified, this is used as the status check. `check-url` The URL which will be requested and its response will determine the status of the site. If not specified, the `url` property is used. +`error-url` + +If the monitored service returns an error, the user will be redirected here. If not specified, the `url` property is used. + `icon` Optional URL to an image which will be used as the icon for the site. Can be an external URL or internal via [server configured assets](#assets-path). You can also directly use [Simple Icons](https://simpleicons.org/) via a `si:` prefix or [Dashboard Icons](https://github.com/walkxcode/dashboard-icons) via a `di:` prefix: @@ -1272,6 +1739,16 @@ alt-status-codes: - 403 ``` +`basic-auth` + +HTTP Basic Authentication credentials for protected sites. + +```yaml +basic-auth: + usename: your-username + password: your-password +``` + ### Releases Display a list of latest releases for specific repositories on Github, GitLab, Codeberg or Docker Hub. @@ -1314,7 +1791,7 @@ repositories: - codeberg:redict/redict ``` -Official images on Docker Hub can be specified by ommiting the owner: +Official images on Docker Hub can be specified by omitting the owner: ```yaml repositories: @@ -1323,7 +1800,7 @@ repositories: - dockerhub:alpine ``` -You can also specify specific tags for Docker Hub images: +You can also specify exact tags for Docker Hub images: ```yaml repositories: @@ -1331,6 +1808,17 @@ repositories: - dockerhub:nginx:stable-alpine ``` +To include prereleases you can specify the repository as an object and use the `include-prereleases` property: + +**Note: This feature is currently only available for GitHub repositories.** + +```yaml +repositories: + - gitlab:inkscape/inkscape + - repository: glanceapp/glance + include-prereleases: true + - codeberg:redict/redict +``` ##### `show-source-icon` Shows an icon of the source (GitHub/GitLab/Codeberg/Docker Hub) next to the repository name when set to `true`. @@ -1345,7 +1833,7 @@ services: glance: image: glanceapp/glance environment: - - GITHUB_TOKEN:docker-compose.yml
Success!
+{{ else }} +Failed to fetch data
+{{ end }} +``` + +You can also access the response headers: + +```html +{{ .String "name" }} is {{ .Int "age" }} years old
+{{ end }} +``` + +Output: + +```html +Steve is 30 years old
+Alex is 25 years old
+John is 35 years old
+``` + +For other ways of selecting data from a JSON Lines response, have a look at the docs for [tidwall/gjson](https://github.com/tidwall/gjson/tree/master?tab=readme-ov-file#json-lines). For example, to get an array of all names, you can use the following: + +```html +{{ range .JSON.Array "..#.name" }} +{{ .String "" }}
+{{ end }} +``` + +Output: + +```html +Steve
+Alex
+John
+``` + +## Functions + +The following functions are available on the `JSON` object: + +- `String(key string) string`: Returns the value of the key as a string. +- `Int(key string) int`: Returns the value of the key as an integer. +- `Float(key string) float`: Returns the value of the key as a float. +- `Bool(key string) bool`: Returns the value of the key as a boolean. +- `Array(key string) []JSON`: Returns the value of the key as an array of `JSON` objects. +- `Exists(key string) bool`: Returns true if the key exists in the JSON object. + +The following helper functions provided by Glance are available: + +- `toFloat(i int) float`: Converts an integer to a float. +- `toInt(f float) int`: Converts a float to an integer. +- `toRelativeTime(t time.Time) template.HTMLAttr`: Converts Time to a relative time such as 2h, 1d, etc which dynamically updates. **NOTE:** the value of this function should be used as an attribute in an HTML tag, e.g. ``. +- `now() time.Time`: Returns the current time. +- `offsetNow(offset string) time.Time`: Returns the current time with an offset. The offset can be positive or negative and must be in the format "3h" "-1h" or "2h30m10s". +- `duration(str string) time.Duration`: Parses a string such as `1h`, `24h`, `5h30m`, etc into a `time.Duration`. +- `parseTime(layout string, s string) time.Time`: Parses a string into time.Time. The layout must be provided in Go's [date format](https://pkg.go.dev/time#pkg-constants). You can alternatively use these values instead of the literal format: "unix", "RFC3339", "RFC3339Nano", "DateTime", "DateOnly". +- `parseLocalTime(layout string, s string) time.Time`: Same as the above, except in the absence of a timezone, it will use the local timezone instead of UTC. +- `parseRelativeTime(layout string, s string) time.Time`: A shorthand for `{{ .String "date" | parseTime "rfc3339" | toRelativeTime }}`. +- `add(a, b float) float`: Adds two numbers. +- `sub(a, b float) float`: Subtracts two numbers. +- `mul(a, b float) float`: Multiplies two numbers. +- `div(a, b float) float`: Divides two numbers. +- `formatApproxNumber(n int) string`: Formats a number to be more human-readable, e.g. 1000 -> 1k. +- `formatNumber(n float|int) string`: Formats a number with commas, e.g. 1000 -> 1,000. +- `trimPrefix(prefix string, str string) string`: Trims the prefix from a string. +- `trimSuffix(suffix string, str string) string`: Trims the suffix from a string. +- `trimSpace(str string) string`: Trims whitespace from a string on both ends. +- `replaceAll(old string, new string, str string) string`: Replaces all occurrences of a string in a string. +- `replaceMatches(pattern string, replacement string, str string) string`: Replaces all occurrences of a regular expression in a string. +- `findMatch(pattern string, str string) string`: Finds the first match of a regular expression in a string. +- `findSubmatch(pattern string, str string) string`: Finds the first submatch of a regular expression in a string. +- `sortByString(key string, order string, arr []JSON): []JSON`: Sorts an array of JSON objects by a string key in either ascending or descending order. +- `sortByInt(key string, order string, arr []JSON): []JSON`: Sorts an array of JSON objects by an integer key in either ascending or descending order. +- `sortByFloat(key string, order string, arr []JSON): []JSON`: Sorts an array of JSON objects by a float key in either ascending or descending order. +- `sortByTime(key string, layout string, order string, arr []JSON): []JSON`: Sorts an array of JSON objects by a time key in either ascending or descending order. The format must be provided in Go's [date format](https://pkg.go.dev/time#pkg-constants). +- `concat(strings ...string) string`: Concatenates multiple strings together. +- `unique(key string, arr []JSON) []JSON`: Returns a unique array of JSON objects based on the given key. + +The following helper functions provided by Go's `text/template` are available: + +- `eq(a, b any) bool`: Compares two values for equality. +- `ne(a, b any) bool`: Compares two values for inequality. +- `lt(a, b any) bool`: Compares two values for less than. +- `lte(a, b any) bool`: Compares two values for less than or equal to. +- `gt(a, b any) bool`: Compares two values for greater than. +- `gte(a, b any) bool`: Compares two values for greater than or equal to. +- `and(a, b bool) bool`: Returns true if both values are true. +- `or(a, b bool) bool`: Returns true if either value is true. +- `not(a bool) bool`: Returns the opposite of the value. +- `index(a any, b int) any`: Returns the value at the specified index of an array. +- `len(a any) int`: Returns the length of an array. +- `printf(format string, a ...any) string`: Returns a formatted string. diff --git a/docs/extensions.md b/docs/extensions.md index b1fa4fa..b6719c1 100644 --- a/docs/extensions.md +++ b/docs/extensions.md @@ -26,6 +26,9 @@ If you know how to setup an HTTP server and a bit of HTML and CSS you're ready t ### `Widget-Title` Used to specify the title of the widget. If not provided, the widget's title will be "Extension". +### `Widget-Title-URL` +Used to specify the URL that will be opened when the widget's title is clicked. If the user has specified a `title-url` in their config, it will take precedence over this header. + ### `Widget-Content-Type` Used to specify the content type that will be returned by the extension. If not provided, the content will be shown as plain text. diff --git a/docs/glance.yml b/docs/glance.yml new file mode 100644 index 0000000..35dc7cb --- /dev/null +++ b/docs/glance.yml @@ -0,0 +1,105 @@ +pages: + - name: Home + # Optionally, if you only have a single page you can hide the desktop navigation for a cleaner look + # hide-desktop-navigation: true + columns: + - size: small + widgets: + - type: calendar + first-day-of-week: monday + + - type: rss + limit: 10 + collapse-after: 3 + cache: 12h + feeds: + - url: https://selfh.st/rss/ + title: selfh.st + limit: 4 + - url: https://ciechanow.ski/atom.xml + - url: https://www.joshwcomeau.com/rss.xml + title: Josh Comeau + - url: https://samwho.dev/rss.xml + - url: https://ishadeed.com/feed.xml + title: Ahmad Shadeed + + - type: twitch-channels + channels: + - theprimeagen + - j_blow + - piratesoftware + - cohhcarnage + - christitustech + - EJ_SA + + - size: full + widgets: + - type: group + widgets: + - type: hacker-news + - type: lobsters + + - type: videos + channels: + - UCXuqSBlHAE6Xw-yeJA0Tunw # Linus Tech Tips + - UCR-DXc1voovS8nhAvccRZhg # Jeff Geerling + - UCsBjURrPoezykLs9EqgamOA # Fireship + - UCBJycsmduvYEL83R_U4JriQ # Marques Brownlee + - UCHnyfMqiRRG1u-2MsSQLbXA # Veritasium + + - type: group + widgets: + - type: reddit + subreddit: technology + show-thumbnails: true + - type: reddit + subreddit: selfhosted + show-thumbnails: true + + - size: small + widgets: + - type: weather + location: London, United Kingdom + units: metric # alternatively "imperial" + hour-format: 12h # alternatively "24h" + # Optionally hide the location from being displayed in the widget + # hide-location: true + + - type: markets + markets: + - symbol: SPY + name: S&P 500 + - symbol: BTC-USD + name: Bitcoin + - symbol: NVDA + name: NVIDIA + - symbol: AAPL + name: Apple + - symbol: MSFT + name: Microsoft + + - type: releases + cache: 1d + # Without authentication the Github API allows for up to 60 requests per hour. You can create a + # read-only token from your Github account settings and use it here to increase the limit. + # token: ... + repositories: + - glanceapp/glance + - go-gitea/gitea + - immich-app/immich + - syncthing/syncthing + + # Add more pages here: + # - name: Your page name + # columns: + # - size: small + # widgets: + # # Add widgets here + + # - size: full + # widgets: + # # Add widgets here + + # - size: small + # widgets: + # # Add widgets here diff --git a/docs/images/calendar-legacy-widget-preview.png b/docs/images/calendar-legacy-widget-preview.png new file mode 100644 index 0000000000000000000000000000000000000000..5a161bf5ac6980992e3ad0d987e9fe8f918eb21b GIT binary patch literal 10835 zcmch7Wl&tvnr#CCf`t&=lMvip8-fQKcZWc53+^<*-Q6X)1=pr=*C35`2=4CwxO4AR z&5xO?nfIpNkF!qgUHiwWbN2q$`qo)tN($0g=p^U>002woi-ZaQfMD=)A-qO>nSsXX z*uUHmoK&R609E5;yDx)R=A!bV06*vhOK+vS;u#QLv8N=-2x}-mE&TY4D31$LJ;QVKwDO6JY zTG6z@ljv~_Yx~SPr;AhT&+^k}U)y&Q; k4 z^x85&etn#`bInJ{GN!iEUTNEPFfi~+A7eOw#Srqbzx9O@&8aF=)pMrU`Co2 *?<=EK}a{lGu_1z#k&uQ!*}pFNHdY>2?4o1+nD zO#Csrd9&&>F(T~ZJOLKVjD2`%&nk$Q3PMEN>wEYKPJmkbCQQM;hT+K7_GF-r2MyZK zK2|uLZqtr=yDqiX{pNGF?O^g*fOm`WO{3INCSg}-kU{BhA@hTQ{kSJUS=|0Jq?h{O zPp9yOizS>f&T%6(6KY}Mw;e6js%y`VcHq#+pF9@51nP9dVr+h+@K8S;e%~a;;Wyk8 zq;rPy^CEE)Rpp!Bkf6&0t?s^DBTxZv+0*iz7K#OWwr`Dt&7kpP4PgD3)uTlqVxZDh z817$knM!nI6!QIJ=h;ByF{wFzIU?6p0+bwczI ?fkjjJ906EzI#1b@$8~1)L;5d*k!jod-6U?Vt0$8h0wK z7O+~tr3(5LTSuU`6As3wYHcqbiWZ049hD{8>Q>JKNMBl`#tKmRQ_Xc9r#cAVFRXP; zVj;V+w5N-$pP`vPNOYGzajCda+nm%`@T_wTW1JC_5KuG>G`X<+up$5*GrzhGZsF?O z@SCIq(=|ch#HC~C&u~fbjrPfv%kb33Ni#Yo{-tY% q%wPlJ15a7>eI$^|pEtrdf7(*%OkQFl&2SW#}?H*f`rWQuxegtFiYQ#>6Jt z83-6Fu)_}1+t}-qlpTAslQb8p9E_kT??+1dJyM_A%j>^w GlrFjI;Tg)XvWK=9T4@lMFI+#`X8WyqCSc z>c$^$RSkR}nAS? H0MDJ%dN>Ua<$Vo0XMRQLBHiZ|bS1l=PwJoJSaM)dRQm7~>)qKEQO zznmPR1|}a^RdS~~QWb+J+6&H&HmxY!Je4abES9R@v;}{;EbIZ{r7o?~Qd5%BJbk+9 zAoW2}WbV=So}RNqk1{Vu{%G+Y(kC|C0@drM8&<5aCK@L6unECg9&aG(0dVv`W&Pqp zJ3GCNr(aHQU1Q)Ul$N^`QCutCYn%R|QFI@NZ;2;m4nIJg&C}yYvPlfwok8M9==M_R zyd?cfPs#Jd@(w$Jv<4xgEN=HogWc3##e-z`8MX}SDf>8b8j{X3Qfv$D{032c)#1jO z6b{y*U!{J!sO<}m*!(oj970_;ORh<#{^bu_N=F{}tbVXB6rR4?iGAT^HcCIfcjY zz6`^+-spNgv9vtRSXUa4`Vpc4FjUIUP(6+IIR(Y@wbxlFiVeHovGI{R$>~PZDQq?I zvM;T!J_NXp!ZN?TVgx#C@9KKN#>Z=w_@uwY>)V v%9(XmSDr6elCEdVY1>UbLVcW|!;Az*zk2&si33tlY|pZ&DEdf(k}2L? zj5a^ciiYMq!=--9ipWeZTf-!Ng`9HPrRYMD%iY!mb !;THu4RsMRGUeHE||dKPVLWg+)jQN!TeWXa<8`&La3DIsu(^+o!n z3WSJ&V72$aA^5Ro{2vgJW|pKR)^n2MbzH2Cd;fKu=|4fNLVdZ3lj@bT3VNayx3>~T z*A{w8wM}5!f2cNRFbT~gku?OJ9X0jjRXJNq(;V|Hud$=X%f9lh*(|Un7luV-p(DkT zDWpyV%Mr{&? F2E3U zd^sVAe3@FBqhIbP)D|L-P8chooo+ZX;P2JXYPz59JscwSiRifa`=6!}k^1`d^cc;+ zT7zsy&Q{mnh6HUbJwro1_SLCJd1JEtUur%LYsEWkldZk07#bXS+Z9H`gcnm>k{)s4 z?^x91MMzk=%`r64!vTytlue}mHK-fYVO*v$uV woNjZzps^u7 zmTCe%l523J$Y^qoFp_g7VHYdF5vkhRq7SI6$uE}jqA^=GlrO(TPaCKK91}nLYA;7v zA6A6h(p((^t7ACPw|~MUM@WJ^&{2!l8NKwd9h%9S_O=lfO;B}>;>gsLj;0PfFSj;W zf| C zmaXI$iCNcp)%WFx4Iwm|`rmi-6m&T=qHWeUhl=Zy0LAq`zt`8lGc<}TGVCg?vMn#t zMXYjkD=EubVK*{xUT9hHGB;=X3H?gdzpip?hxz&ep}g$F+6h(Qv$4qF$mn0v%w@0j zUHQ5-C@jyns}S^L0=al1bA^q{83$>zd3ij8k(n-bgZiU-Psh#GlsoH^1aKDmq`W%K z-|%MRlr+~W-aP+1+eE4EuYDYYZ^zm7J-JiZ_+%fImw|r RU}Xyo8A z1VI*KAAM%6BVFiucO^vMaC_uW*QLL`^bFA)>*BlCIhShRmeRSgbt6s5a$j<>yUOj! z2qg yhr@KR?B7Nm>LfI& zcZrw2rCVUy@@SMMdq@>TDgR>G?#-aOVj0!`DVfmBhjbvzBQreW;vVlBSe)M4nqbjs zSiiecdUS}|ms4LVON!Oyoo%v}#01Vi{GML0 U{7MzE!`|o^6&Y>>;`%ZV!Vx~rgAC>6u2ACt7zsztARofz4LIqYNzmq}mB0zM zMbjI{?Rad_;?UkF?dmJ4`1^|y9;o6!T}}dFg95gNX|IZqPEKVTGOmQcqDjNK;UUnm z*V4+H0C`s?UK Xr=E#72aPl79 ziu1K^!RHm&VayM2Uw^p79KB9*-IzYa%Y I_MmjqZRq#)WWuPoc5tl$He?WR0> zc(zYnviQx&G-_+&gBWN*8zcN_FVRAyQ*K0^gK|YtVz`{(V}xV$lHi}*8!W76|24`0 zXZ`g42P$f!iH u<2)6kc)(3c@TaCuNxE 7vj68uj@N8fMtLkb_+(e$e%u*@2XfvbgF^L}r2+c|7rT )HvF=5b=7sV_nkk!e5Kic?M?TJq|T<#gy3} zM=?JW&h~#}AqgCdQf|-ijpi`48ai;TqwS+sCHT_Ur{(F|(dCl>c~!Tums`(u1F(Gm zJ|N(|V`INHvG1B0#yW1niDLbvgG#xq96cK(M?5xbC-%F($zcXj+}Yu(@80=r1XXzH z>A#iQE4u)8&q*7FXN8_c%Myh&N}R8O#_nYT-O`pACC>Uoo;~w_V8|KZ9LRU&H+yOl zR?d8FNfvs YhQ;n$tF(psd9#~KJ#{oxjK>y^B-*^Kf6RFE6Lw3*VV-~bR%dc za~g>imA#~7Wu?jtcUF$hd!f#g%3BRN$z!?wuVYZem@KH{FAhb9mXtK3HxzU4aNSIs zes9Vd&lZlWHY9>-Y9oRC1e4ER{F(mdvCCFZ_kl<+Uru)2`#VCPe?TIRtDjTF1j|Mc{NhAzlMH*fh`9lpA?p5Z8d)ob4v3|~2( zv_~FgoA{r0>`tA`g>eqnzPGaGF{yE?%h2uE%2?RF@Y#K)KO)*sz0h(wc!RUmm|x8# z3M=SHY_>{FG~#f>H?@r7qy$Y9(goRQ5~WE$!w!q-6*WSB%`;(HPkAyu74P$~WvW8J z=JxYEBU?caPPI4{hZ) $-O_x|EF|B8i?JYxC+IQq3?RM zP8l{U%9-N5WXw?y1XswLMSg<@py$p`8S3iiZuSG#x8N1ua((GNOb?H5)~5WyYK*>M zB~5R3sHp$yQ9m7kk258m_N-N1-^*tu+OirBc*5nX_fZ+B=BW7`G!4J?s_?fO$>cSB zv+yQt@HU%1pvmv#s6;>TgWMha)q=&RKw8lm^|=xVrsj}B`3)n(1 yZjP!TWGB!QZWs@Y}CFG!#KRMC!K0~eG@XqY}c~@t;)RVo3>vKshD4=aho{+ zKuKIH9?5z1xZ9#RCmMn?eb9~2pxeWXRBwZ!kX)Iwmv1H?To$9(YQ-wQ^*mOM?*MwI z6pGy@ANdI_k4u|dpkHrH?YkuQMQ_k!G@E8=3{+3Vp)Q9B4UDu4&s5{tHZr+pMp(fK z&_HDHREw$|2(6~Kdqj7AUGYAusJiF&V~J38;NWx4mIE-=nO$E)@et-RIUC~&YA1sC z-T>j}`xYR+PF`Ct=3b}Q5Fz$y(t_#x3%psVH;T3rCwoQ^oE*GBHmeeyNW+=4fFs+j zU3;WK0rYW3+#^X-O+av_$V9)W7lu^DuIyX1VfFQk3Cv^#EVomHcPB8&7X}<{drRkH zDAj0wn5aJBRjN8Gy?6UT+0Ad{$Ac4nmxF`OrbY9WdsSx_ok>zhxdp$%qqYo!AmZ*Y z<#vXI j %Kr@shDM+1X|pw%Z&gKLz%v z$djypnG!IIm}wDA{S(QOe*`s +oZHsK&wq=1w9VP$$ipYyN-d7P z L(w45(@e5O&_?`GZ+ACWTvuM+k9CynPE(iBC&bnXj95h^57%2w7~JvJ kyao1002i` zoDzxCJ#4uQGa(yZoO}$69w?NzJ9rLXP}Mr@9(vO5x@~KE+TVyda}L5_R>^m^S>Scx z^!&|3GA1Qwap~}_;Nl-SpVNIiIjIB#(&Yoz$=FE>aQu|CPSGuZY(UpP#&a8`GO$R& z^0_BF$v;0-MK&QVi&$F|t~%^x5xxY!IO;+yM?DNQcAsQRt$D1 HKX=r+^#QQZ&K(X!HS!|Aa7Rg*Z*%;cwDRWHhN{D1hH`f@fn|kg#*K!Q54hL& zXs;FvOn~dzMWQKV36n2#sgl*Q6}9R`jaX-VP bqTe|Yp z%j4ZSZimK`W7UJ0UEL7O8&0+wIbMa8lXubDNF=7|@Z7@{&0b}4+}F2hANnfw!xBPh zzZFx4SrbZY(B_ubFE{!Vhv`0(sh|pbs5*=%5UV;YZ_yS)mk4|D{1?JDJf$USK7gZU z38rckyHx~bzjxP&=Wipcdm&~c%vKaf!(W)Y$$`$afr2vac65#2gZK8vD(Yy9 @PCgzp)R1^Uwx 1sZKG7*dpQ`f<`9uQHmMYEY#3ZB zmrur>Z1k5Y^A-A{?S8~_8NyA~V7b)FE^b!uJbNDaEL*< |4INZc7Jh1u0S3ZmF@%AKE>ew!QYwG`Y+ z_iVm;Q#PqE*(*D3s++$Xygn|$H5F--=fv9b3sZt#iI`p CW>v{{0*)i{Srl^vOS{0Ha3oyzKTFq5U8;ZO&OqdFWp4^jSi- zAvmb{Mv(oc+%x+u^3;M=Uz~JlKwsRm>$Xf(gNbK^BdWOebwo4du{A~SZs061dSX8} zJ!Ky`hqU4`RQhpG^+`9M`|esT@_UVEM&;Amw{1aGY-@IRYg5245n*q@@ tHF(1hAaCeS|8g@-}C4<0+?R1;xJo99&y&{Q *4PL zCp=HB*H6Ftv ^lSyj3BDP6CuHFD|=l3Jv$-@a_nFDQO9`7A7Fp+ypD*Z6sKzFS(4{!Vw^tqpB) zj;TN0w&lH0$^X @dfaJ*DEA9onelh^^w!Ok^h}zBF?V|*;rby0w39U# zDi~st5kER$nF8fMt0H#Iv-RVwQjO8{T>AC3kE{cppC41NXoMu2ml1nR^oH CE&P%W2F6S&H%PR^oFQWq16{l}};hpAoJ2j=Q<)P($atb8W+yCPsj|F~Vo%FBzAp z+Nb@?L^{g#ynfaa`)quxr_BgS-P{oDa{Oh}QEHVeJC&3n=@Zj4CV@hScqu!3oCf*l zE9P;OIT)(jqF1t66Q-^Vlx6S!L}J7Ef%)zSX&NSe2fC=XLFf?r{9=_j{4zm(<+NF^ z@sY%;ZHkR`Xz9ftSs35)kl6^iPUZRw<`K1zNG(n1zjhk8pKkAV;4GQvCeFv4zkxIF z$o?;5+x`>G@qd=o-t@7cZhXjbppZ<$SC1Ss-YCy9{0KX=oczvzG=!Efeh~oBx=`qn zF=rZ9@0QV|%9!T)^hD+fNK8~k)7QO1M|D-55+B!CfRge}`tJgW6d3crMZqc*e&=|x zGI$9K9+p_o*%K-5b&$?U!^Gv9GJULy#!fP35OE9B6duq6to6fuXUP&j_7xawy(ONM zD{3hzp5kPbH!-RO^GAk1zM?EC(po@*uHkh=4C2Zh;G;(1X+1Wkc<$t&s{5HRCNYfp zICJawTZAHl#W^lrRJAI5Oa~TsSTw#(tCG1XRG!FyDI z$J$8WgL?&3Zf>c80^Z?ScZWR&@%OMF_|kRV^Hw%J{LyB+tgi+zFih*+#>Y<+VfYIR zdhtAOp-8hTB;>xHo}o2D1o2FlFQSEVsMv{6_EZ0>PxoLLfb>LGO?m4*Edd3=)>mqk zjU%?$a_?04e+*XEDaf 8&Si{Y0eTgrkdV=qS>(fJ>=nN_j^;yu*())?}(Azy72?UrD8Tcv8k+JN( z>B )dhVOO`bzsBk~_*H>dI$#vpKYsUdfhmF9hVfjgt%p;cA#)xPHg zh5dOgAHW+>!>(3~+hX^wK>pqx-?FBSZaFb{nf9^?dH96H=!e$8bj$iMv o|#gNUjHjMa+>94brm2ZsqK83t9 zS4tG{ii|=faxfIa-J>9!YdE-6WYkKd)J2rl*{t3X?4Q@<)!m+wja6RL`u}lB4psIa zT7Blx0p5rld{$Bfl2_N&)tN?sZTjI3yq5CJ*2;PdElLK z1N#P9lE}F!d>lmNyp3+TgT@430X&H%c4fvq4Sj-tYP+~Bw4`mw^*_{ky3jGKy>cYg zuW*O51tiCP@VDa29#2V5(Te(uiper>GLcC|x!lFi0zCgea;QA}1U^JfuZxAyI;5%k z=FK6tOHV~owcTFjCLG_Ezh59nNRZW!&G3vkOSkXNjA*-0E4Z@1IgB~p^`|i-Ow`LW zdCPb*QWr>NEBFrw64#vKSK)(u2SrKGk89|f=>BCUI9H6)yakhz`4jJusBRBDw{@M> zKjT~3X%V$lxr_&LEsop=M$+jy%EU35_N03f0)xUumj>^nU3WYFp*L~>za5zoaxcp` zieHs)9+;~b!MSk#yj*PM+%jfo-4cci8yZqa^(c+Ie?Mv5TONqssd~t4#@G94#&}HO zgZvcs-fz;mKu=cdgdw$v=*^AIfpSH-j?x|GM270s?I`5zL#gu{!`?@7=C3g_!I1ac z-1ZkIY?9*OBl_Abf2uNZbW#ARUQs1my=6{L13ZpJ0}dM+f&=C8?!NSb1GY1Ow3;Lv z5?C?7GkNue;4u5n1N+QRX^*b1shPl%1$%u|tGk!J1w3Wqvnpvv1SfYe(}0zlwY7@1 z%<&6#s^tcEpgdXq^pQ|b+@q!(*!{53P(|&;^shSkhDg+I=|$u;OBKjz8ZiALfEAat z#a_<#J%OG-@cA9Uq#H(S;~JLfQlAsmYMsq|-)1rW#?e-dV~tG&(TW_;YtB#Fxp|vb z1gUu5%p$5>y4d(-mO+bjJbu mcfPjBsjc+87#qoIt@EGq8{Z)*B9oA!B8Seg zUB=Uvq3`)hm6>T3AE*OOCcQ#BA6uiH6)1t+jV~pMK}_;Sa)EMkioEp|MFZhX?sYsa zz$c)$F$3S5#Ru}fUDOWdwHTpy27_uZqx14S6!kfhS)EO&eeL7ejB)j;N(ErwXESPp z8vfXShF3FJ6q>dQ!rt@tysm-i>XCd?Z2akBXd>nN9HnF(X&WB{baoig)K|N`eSw-5 z9msCvJMy!1_si^f{c>3L?AvV5D9O5>7s2OzxeghX^kws4ew}X=KDqOF$GT?nxdwep z2~AX;9#7J0^j>UM*NSBH3fLYy`LL3h@KN>}Es62cHfv8GZH~_&$9t`-kuQ253<=Dx zrQ!2Hjvao|?6T*5tG`e!4!o`UKEh~~{d|h (6 GZuMmvs3C~Zx_K>#8P#^(Gq)o3J`Y+ zvmzht8jmb5h_M*sIiv~HMN ?o*Wx3YJ-ycINR#6ltJMjmF`4imnr)Rw zo?hN{)z-=^u7AEJ2D~NQZc8p)mm`}L<}&J$SezJRbopT<)Y$NA+K^JY E zCYNhEBv*g`>gYa}+`a#=dhZ_`$qFB=pFGkN9?N(a0{umvnD}MdaBoUmh0a~*#+^^O zf(4 e#`KW^Gjlx2mfz4*MI*T3%vGQx|h+fX-9S?-~Ro0L{U~vru@Bm@c#g^ C9<_V` literal 10835 zcmch7Wl&tvnr#CCf`t&=lMvip8-fQKcZWc53+^<*-Q6X)1=pr=*C35`2=4CwxO4AR z&5xO?nfIpNkF!qgUHiwWbN2q$`qo)tN($0g=p^U>002woi-ZaQfMD=)A-qO>nSsXX z*uUHmoK&R609E5;yDx)R=A!bV06 Fp_iw-VgeS^C9tjnA0f6ntX1Oi*0^B-kKgemm3wQ;DCB; z4aE)&E-q3a0sQ_D?K~p@a#2H30089wJqW@%V^$P{YO_k+E}o^4sOw59bWflmS6X0< zyG`v88JZ0Zv0@jND&q$uLoO8D;V~=yn)$VF3`Ba!;V=gNmQy7Xn(W8DHMT$S0z=A) z?i>jrpE2Wz2npa5tFcJhs+h1!flaxBVrazi0-yT6!nC12|D2jv&K@dC=Sftka=`2c zp}B|2t$E||@-2KpC4t?EAoygGCbKOBV@?Uiazz%zKvBZwvb~iBZ&FPw(JAfJLu^kg znNi)Z4Cti-KQ#CS@d|??%g~S-4C2asd=If7!~$Q>BAvJs;Y|IdYfK`{6alxXFjTga z=cv8sZE}&!I6-PJPc_U+Q;BMEzo5Xvl%r1I`O;=@i>?+m%U$mtMLHl|NYRSN+)Gtn zhx^WHX$<0Hqx|^3vi#fP_5k=V$P`mh`mh nzhof;3SZV({7~S9gV?AND=is z{Vd !Fro5b9+7v*6P31!p zzkB#~Nkxw?2~J Y8o-Z-M%68FbXAiQN2?PX9^PWoMco)-7RbQ|BNYp?(U!bbY6y#c1Tf)I(9oESm!g;_R*Zw zV6(x;;&rS_zvG4bP7FOtZbyQuG09t_AK^aisZyy@mGTK877(gO9ULiO1Dc;GDbAFV zfp*VjI(v^I)4Q-oGigtU46E=k&+MiUb&$3wHwofK3hcBu`&tCZwuUZ|{1HAj(|kWa zwsu`Yh{ji<1InVN-xB1{8+lhB$yd}%b% 6@7TDh+PviR@kI#T~ zlKQeUl)$GU({8_%IW;S_PKOi5549ac3~7a{jXc{zlenqjgxoU6Ne$_OEiTxsfuc^D z?G0jXx?C+@9aA1EF?aZi$az-eGM;v*1uzW4Xy0h}jkOj7hW69xZxPs5`o*7^3%VR_ znguh}{07h~JkS8SY~95l5CAbK5-?@&6efS74pSHED7*0SJb+h@IajEoS(VWW$EJ z^7u*SZCEHU7?Mby9hC6_pL0%n*dqGW%DH6=$<(KQjN_s^ws$Jg;l*MAFiE}LdfWuO zVLfi2)g(~`3J^qMItMUH001JXo2rmwzmm`Yn53NVbVu-$MqIhv$@&|hNCyDmy(jr! zgQt-EuH^;T0vQ|?fO!O_Au;A5yZL&Ljmp!T%K +=}^0LxdBJ-A(emizZLk4q~dJ>E)LzMGi~4PLwspvv5HjE848=7n_UR5CAl zEjK=TkCAt^cA&HC>P4LEC*9tJhih^E^Ahg1HQdv$xs4vo52$S-LO;!8cR0M@ i;Ke8W%#1Jm8bW*lCpDPyQp3dP;P&_&AY6+LY(6k_|rx(f8 z*Uw!A+>ZHOFqk$S>o8D5Ei4Qu=IKg$D=gS 25=NmY =ylFE*{q4XEt*6;h1$`WKDsH)CFFJr3!rHWLf3fNf{nR<>SKof^My>9Xr< zosH{W5?nF7Tx?q@a)| t>ZOE5DBA$^^$KWFmq!BWl|cUILxfw(u59 zYuq$UZ=p7N?7Gwue=Lz4h0ePBrn(T`YmxN$0|H+kfz!XOLy4qqEsJiMxA*az8R+;W zh;bu28T;j*bPmu&S 8zT0Dm0lObCG7dO$nweK?+Qf7(1k6N0?mo{fx=hD>+8ob(wd?3OrH z{J*}EL}H&(O3u)W(vM3V3@Yfq&ayK~c|6-H&+)0d&zLYUtYy_4!%n? m_)8NC3Wbs4k!%G95yVc+`0Zy*tRq zoK?ENeN@+-PFKnc={bJzSV)02Tt8ooesegVRh32o7j>!o+&gY?QW{E7chKh)Xbih3 z(j8lfUb7|XM4ie>^unDednKwC3%nwu(6Ch*1eJz-r_zxN(%&`NkBj0{b$tm#G0xAc zRErN;0ebCIm>u#IO{iot&jz(7robzcjW?!BLu$KMCV>Y{ZKgzK6^}uFU)A-d>A0HK zGtj 8IucnVxPq1Jy zKE73c$9u)_-(#DF*V)&$q0j9wvNOudi-c9PB*GXMsO}wZGjgz`q+BGXBR8j*dO(-7 z_{6I+&Ujx*Q~v?$HeZm?Nz+@kgAvoAVY;Q-@?yJK>L=Xl0hIb;@AFI3hX-r;S1#%E z!Khe^_p~HucG*-%BUOLsd-SBGv4x$ O2{$u;}Cz9PFxXy)bsls7Wfw z8dTF!#EjR*EPB5Ng#VlvP$pOe`+X&&K{^iwhSCHmK<2$r78&l&H-17`@9ICKScZ>W|wEOl~;my>LuH_v!a9Uwncn*`O)c@8@CG8?ZE;4 z^pI29>ZOx>uPJOwi-Fe Ol(9U=|2tY+H&UIKUT$ g^rJQS zSr}tB;n{4~nlxd*f|hj$oPN4e2ln-RpPcmF=-0KBu8(B7Y=BGY5~ z_(P~J0yG|bFMRp*pk!#cQfhCr-0>KIJiY;KcG$B@>+3DFm+RvV6gq#}Iy9_G7qi =h&p|dH?wU}O3-dB?y*>|2^&|66U(IV_y7k;wxvn)?!p1ur zB5=W?{ziDxV|aH!{NNHiZrCKWT*36n>p0V!^YCZ !68Ozg4{HNfbQ*`jsIji1?_v27_>6ZA z+w&VY@{Zq^l6@j}&={$2Q7n;&=Y7$5n|!A+G8#} zeha|%L)(7?7KU&>txxk*vtTu@8lSah20ZIE6?@4wegmCxJTJrJ><^^zfy@i>^~;p- z J~>Tp;N>_@ zi;4c5v~$V57>$0(b9{=P5$-!tO?WRkKWivkEg6$X__QG`R#*nojn~{T!@n}b&CrlS zEH)CUnS9-o7}ey2Zk1SKU>`Y}`7jWA>mE?n-@T7~iLNHXw4 DX=AFff+pA70DlK@h+{@S~VW_j!i;bgyMeLN)2?T?qz zDK4$LQ|-sd6|H_pZm((#R*0N1XK%xEf6{ICsvGu&x-xI-cp|S%FChXos@;e8K$ft0 zJMQ$BR!mR;k)f&^zCC+E`0j?E>qpN)* FpWn@9o?^#oQU--QpYpp*tPV=6&m&XEM_bNTj1*Tv8`9F|lp< zv8OZ`b?fR)r5*9kBn`to>+lAU)3>1&86FuL8vXhbk8OeJLJMMLZP}0Qsz1hTYxCw% z-)c1oN^n+03SRwY%iO!#P*B?1lJzG6Q?l}vqPmPJ?a~yuwh5X2*9@DSKH?Ay`F8*I z8WNWdJtH;DSCN%&_gmXt$g5Z^5(cDj6qJ6Y`k7g`x5xPdu{xz(YZz&c+971?=pN|` zhuT)=k{WA;pv8=AGt>}O69iA@Fy07VW&NgPuXsoLRz(bykP$PhM0qUy_=7b9kgni^ z++-KL6(|z+Kx{X?Nc5v?tA^Oh)Y?{Z>T-?8T9;AHJ`~eqvOujAIr-xn{&zV!t#AcM z^-8r``8 @%(EnWGGHkIzHk;4cS-tlO52 zPq;pdrdc-8I&;A;&Kxad$hYj@O{NYB&K*|2#;uB8Wl>AYFG~A|%(!nW1az`;ad6qB z^H%FQVpCFcCF60Y-%14sDWKsET0UDe*U%MreUr18PyD3>HgK7P5WH-~9lHdN&U&^p z^JZ0Jwkabz7&ibw;rC~s1k+;%0GK5G-*eUeYlBYwR?4y{?b$zw)BBYz47})2_D)?u zs@j`>5D%ZNg8saCEUeX5yx$?a)kYzdylG>mhzh1mzQ*pPUa`=?j5=-kxb{8zerDTP z+@_g2Y(M5(erqoBeu4g^Pi6AxvD>HQg6>JSvHo!bqIGJE-C29FoSoFv&oyY`1vU%{ zkr8bg#ZtP#k*%P#xvx%J5^d>q#OYVV2MM&e=N5Y!MVHO<{Hj7@+L%!l4`vS?i7JPP z!(!Dt^SeJ@4!zXuCmA6}p{BGdO} #@YmTk@$6d%r0+CN!3safxocB!!0`Uw^sl=Q^B(}t52(5{`BKIw{ zObm)-^9`oYX-iBi=G%c&_1`0JhKh?9VAO}p4f}1JeKcK8Teq Z;P(4)A(07F-kvUVY=)pMxFrU&Nrt7iU8h&Sj~1=A`&hUCHG3r*l ns@+qA#_KO)mTdN@udsn@Y|j$pt|k z^toH0S>vT~JTqSuvWD$`oujYi*@_#lA6n|9k>sdTCuzux>sM|p@-M!-WMPReYo9Kr zcK12mG*l^P)&p8vV)qCE^)@| 9r;)zZN>-M;^ z%0GI{tXc=>{`oC{SlUURZ?ojdzLc?H#AHp~*Jt{+$G%>vsxa)hv6|jSDcsR=FpJLRgHoV^wO9?MPRo$N?0MgS}Zr&?q(QUmo-!RD` z+nzK~{(M~ql?##S;<@Bs0A|C?_DJoa5DPAbDFr^3(GcZS2U2{jcv0zq);i=Y`I&Eh zg_;?B%@I=sk8hDfLPru ?ZCC4_M;(2I~Kc^FZr3@{6ri ;R8ci4*>0IVY4B$Y=Ka2yx$1X^^}b=7m)~@1GH2C$uhEat-9L?c91G=o4?Va^<3n z+3p=3yOBYHWG{>bBv>=d^pm}XVJE@pKq5yjw%ekQ2)^|nhBh1{yJn6@9BP_&Eo^5V zJ4W^ki3}}%$lh(@?3wHP?5j-hHW`F=2f))g$3NlWIALk}LUfGx2={^;cf(qb7PBi2 zZI^3IuE(V03}WMD_apE;$0DNM$-J?Z-%BX7(gu;v60a+ `wJUciGGMS3ap4c=dae-=!>$ouBA;v-Mq !6>mk0R zGgfm$r55@;W@H~#I?v{Mn9}#+FT3x^1*g YdGO|EAGXUMuoRbFbd7O72qoy|#kgUkID5FAiqX zx>u{_A0s&IV}NT;8I={aK?lfXi}yWqa|!39+6wM}-ly=K(y-`oSFRrf8(Q4WtANNJ z=knh>slCqwRbIFZO@G#xeH&b 6q0OrSE+G{ry6Zn}~0~j_qjeAJk9)n0r&wNWunxzt5NCn!Ag;JN?6bo-c?&c@RQ` zlM?hSlL1g(mIN3~P~DMkZ2{PnPSBA5a|gY<07|0r-aT|yF)Lf^yor#u1x?$^!)I$E z$Bs|qi!UQT>-VXU^6gt~hqSUeFR0J`>fB1kPzZKa |vJiWRi#dw*9F zCAZS(kx}Rv_r1?`m-PkY^B&9LIikZg6b3FqxgqiL@d1MkFAT7Txbn>PjS(}(l&v+X zp6tK#={ehfZmgm7=7Zm?xl!7SWR{{wrisi7(LPC$2M0a5^pyWGMdh_wOwqH$J(Y_D z>w2p^1%LrTYd;v%`JXIL5sMe=LcqWjecL?|(=sj3O$8sqIW4*&NLpN6a-8~*%Qc(r zU^`Q3{`PO{(~7=2xE1TeiS^l-)#^MwZe}5`( ;^F+e=Zm!; z#_G$s!S96{8$-!K3f7$dU4KK${X3XMM$eNPHWx>xOTRcc>xR#wTql(A&X-SN$zO%% zPj*pK>8ZB5ie=Kq@~muCRsr*3;4$x4<*sG_-i~sfH&MkQ +Vjov*p$031uVLQ_c{n{D2gncQaKk39f=$pF`0V^yi!m#;VIIX#!G83 zhpyD~l0&{W+h|P8a^2c-rbsR%8wjOHt_!yC?3T-;R_CGclM&3#0w30pN3j~1AQJn= zvCWw#l;Dh9-MZ+1FlTGd3j1D9gEg$$=l*!)iR{Z#tYa(-z6gIG=r3M_+2Imc7w=G9 zGXlwFw-T51+Hj_b=|7M T)GW?zdU?MI?_3q2Wz+9LgOu`;3Xcz-U&@R zTVKnXlo$%bbja>WF*{F##{xXW#z~s7s(r+Aam3mnwIl|4EA35!zwMq=t#t!+^`MMh zC9h&()4TnmO8vKDbH73VBG?S3W#PIP*?2~fQst0AirY fy z`GafpS{qnD-v(;amU |U3P6)t(5Axo}KiX9fq|2#hhT57|#PI7sq^Qk)%iO7{_1f%vB!%8?8S0J`M08VG z3jAnMB)WKL_p6FLC#=WPQAj-s*eueUTFD68eG9QkchNrc;9^j&&r?OSTy078R}eI( ztW6j8X;s6c_{7rTotLW`MQ?R->KZXGsMQqB4ZL%< |E;wK8S!9;`?Y&>YIk0xOdKC4z% MPkRkN*6gI@ z4kzQ44Cl}vpbXwLY;VbpkvO^0SnX%fq_u%f;ulAYayy+ahl(6|+q(rX3oSXpBA5B! z9v#0iyso!%e{H^=yc>VjBGzRzc}Gk8*f!HQRaQ_abB)NjPs-j=`Z~#CvKrLp5qPJq zxzajA%Nkr^m=gY<2nQ)U;#Ev)l9L}@sO&T;(1(FM4mI(Q{W#TkFmk=;KKxd*S2#sZ z&IgEYy9?rBg>b n*6ijif(2qkY#mXyvC<6VeRE(`U) zBu3F~0%93UAAJ%^vuwSnw|f|BXTPR2{^PG*_tMUIqy9vhC3SZL@28kFDMB8wm$s;e z?wL9kv*Se!%GFy+1N49`D4Ch_ >0Tm$QMT;%QnNyrQQX**86j#bsX#TRF`o>HARc6EIH z4QI ZMo~J`$?BmbIoM+o}3Pm@^oxPRaQNW=i?5B^0Qc6WV6#EcM)|Z&M=)572Z8ENEm`Yv&DcU?bb_n^s+v;98(Wj;cBMB>5(fQOW@kGS+ zKD!de_VeEwRriBssBkfa<9=gEqP41!s04Iuh#pk>vkyuc398O3Rz%%Z`O_;|UgVMq zKf#cv)U^Uiq>%ikRzz{+{!~e^W%UJsIc{ gCYHObtXr+HyO_qd~3?fLp4m!B2cX?h*IU%z8%mqfTH$3?JC zEtviB`9UR8-Ew&f7iy~MBpoDw%_BQem1}BP$(r=d498juUa}hP$Xz)G$yAMia=h?7 z_{t9I`S;}3dbYbp^`l<8{l?rB !xY`f6(wysp fE3`#FOV;;9o6u-^oBdb}Q3j>?UUGV1{_I_JC zo5bd`wXmhub)JdTfFVH_`}H?L@%F~S=v-xTi{vRw5Z4PfqFk@b3h?z_iu+xTcOpL; zy)$bRkZmBXJj^9h pw39_OT?sX% zBt~8Vvt|{JqStv6VbP@yBlse}X~oy142uD%;ptkPjWrMPe6d2%H}Po j ==Z1jdw*|u0gZxi;1OtdWdWf|F_ zge4F6d@Pin@A*G0NeS-T?a$L71HWCwJzd}pKwao!v&q0wMpSD1dunyc07;iCh-`3S zB^ARvJX_}4uVg3K7~x0c1bA=|)DJ)@Z*bPI%J1~S;Z<@`znog^ND?NMewPuEEZ6IR zE#`>7req?%kmF-bW@|!4%=+BR)W3Y^g|Hm*D0FWY!s!z38%VSQazFQ66s8ARV+Dj5 zA9J}AUXJ~;F%3>1vJF9*x7EjWwH?{+BByupbo%0YEV|RC-v{0WgrXFQU)0i-cRN81 zQqpw7U$Q}}zA>1tk(p}+!=Mh)^^DfC{IE^VuNr=pFKyylw^G|x_{TL9H%n!i2>8!p z+SYK1tByLe+h4=spoV8Z1vwL^HSTbCrpPXWx7C`Rq8S$^Cr7gZ2(6l6yPT=)tAr+y z=S|k7Q&YYFKBskZHDr*-=uVB&&Sh1 _*V~o}5QBEJsP#WBY5(2Q_g}7? zB*r3%O7CK8E_?*Ill^U@=s?OxB;ScdY0w!neyOe}um8hbp-Pp8H6PiVNOAxX&&^Tr zvGYH3M&WOqSzf{wk`->FW==1urk_ZF9;BBrlBHAEU}$3iFl*{_ptvSsD+YkbKuSvL z2CVdTaOW}5e>?{haI%u?aa_Pl61x1c00Y40eNnSA eK a&q&^`L3Nadz<-2A0Wy*b5>;YG{{IJe7-kLt diff --git a/docs/images/custom-api-preview-1.png b/docs/images/custom-api-preview-1.png new file mode 100644 index 0000000000000000000000000000000000000000..4cf4c30f1329a9366a2e061cfc4c4ffc7437355b GIT binary patch literal 8068 zcmcI}Wl)^Ww(bBS2_D=-f(CcD5FiA1mjQwgFu@%X++7l62oM+`NYKG8xVyvPu0wDb z4*B-pf6k9nx9+*OtNQJySFe_LwbbgTBh*yna4;z_0RRAw{0A8g002en5tlwkef*kI zya; l$v<+tNBlSBB>@0Ck4pbZ|68Yk$D;UW zfG3ZdTs*v7DBu6p>favGzyGVH l0iw)ei8q?mm`C%@(BS_I0@sGAYtm8sIz9(ms!F| zgWrVv1h)r+ed+S@cpq&siWhW819;2(;tnuM^h6TChu)3{P?kDDd#m~XMa0kJb<4!L zyk`AQ`W55AmfmEz@&$TX(AFV39er+rVD+G8nvI-Q0*SxFuz^+7l=^jH=UkM`A`c zG3sLW8JhFd#K+Khtfr1verhANv8kHT=(OIUN3+)!5Q?R#ub+}h_1+uTWPKo(I-)T> zJzZ pRBw%c3Kn_LaTpAjSP_j3bhj@as8>sLVetEYr zh)rq=40KiIlLXAjC!CNEPj;tGg#8eAOQ?|g0V?Yu=;h0qkL>x^b9mz#NeV=V_Ih#Q zLn;bGe)HY?!hcY>#NOM_!n;5v<>g&8s)U?dd@L$l+_a>oHw8BeDZ7HK+=R8i |4sDaHw^=?A}e^VM&${%D5s5Kulb* z+HOWW6|A2)`zz8_gjzw~R?pR(4~eZt0mxM7{D()h__EClI(&2(DWt2|u=$D=vc<{@ z)jROeEMC*XA=xJR*4wWbZyGTg8n~V&MKDfj>FbeZ=Sm;0NtE%s|FNW;l3 zb7jdOteRc3N2#A^`NYJKRao1N)z{+>|5)$S&+2BKfxw~Nb+`T662r^&G^|XrxDgX6 zDB}4 SbdZ>_NGtq_$pPbqhep1 (QYiR+-4@=>n3ASaW iV(%eQL_1@%?{KyBa0}*VpTr%X;Fug*53BK7f-p$|T=Ox1gae$+ z-AiNdT?K@H+KNH6A-=%}rr^|Gib`OtKl1mYxf`V%wR0_JXf!tC3&@V3K#e(1$Hc=- z@1$BI|1GL8ZFryEB!A731Z#pWQC9VicZpHWAf@pMn&~9j?n)1Y!8-L yayPjg5(n@S$ zMjohU_=NPXt&nG}T{U`xTXEaAc*i_D!e36iVy8h;2dFpx!^~oO8-dK*XwvCcTqqUs zLPnPBmRxnhE9saVAKX^=ugSMn8EVN!fDLQ=txjwPJh5F%pw}c#@7~)>=Qkh%kIIP< z*{R%r21iMg?@FqmWz)qzoE?Jpt888451Cg{tiHH_yw2Xc5E_7KXN>O%9)Jx0e|0=h zvR=uTmy}Q?^;vM4c#Km40JJYooU*d0H}2HrDes(}F+Ep2+!3cZv{3*+IpOkHe?QN) zuaumes6HRP2F`7SM0Wf7=_>>ZnSf{As#I9m%a@-m#^OH^-(A_z9G~@(1KPMcr19|H zI$M4Cf$8sih2kdxphLwIXXdPKpYjLTU
|!yIAF03g?R) zxZi H?rni1tR`G^+^C;$u(kO*_SYa;V zVbO;X`QF#rUGt|_(T5&_LtB4Gk*NsM2~Z!ZZPR(X;7en{2Xglvp5^F>qWmFtRA&tI zikiH4mX3?c9KxLF)hz8bF|9Iruo?{?tGDr0{r6XcjLxU5Q^{`YMh7AEj*^Xcp@}Ie zDU4q(Km56)oz7{TS=j!wTcjpgySSuh3~2{*G`QTsf=*?!SBWTUz3;M;s3Bm{LLN_k zFQ?Uq7QI=8ra;uOlqKQCy$07r#;Pjj2Sn_l99CZ_&&i$n(3-qRq*D99PfQb FsBmFdup@6n2l`0qQk|ifrs6Fydnz_aS0d<>h3U710q?7(@iEmv2$6wIBNMC z#DYKVAAMXus-qpMn{<|avIJE-^v}pm)x!YJvLDZmmnMoD<&z(m>Ti9a$ge7TbA6d6 zs?mDRt@!IpOa}d=N=>^^eNj{k)_HEBakNCxb1i1~=&xOZQ^#``{Ld!TguM+e0l}87 zHou)Y>6&o)^xo7pDE_fJ_kB5vdemjSuolc7XQC3zxkn(gPj90Nyq>$|uzAx7_DOYO zu^*9Ly~v#hsaSs ISH6wj$sLlJu8P y!TI${#}1B8fWr>W9r=3 z1LANv^&?TG@?v;UdUfnnl|Rc5?wmXnJyO)e@)F+aBMSMswNa8ud|e*SE4a1}rr(}{ zCCV{WxZbr~3#icvdT%e!24iYlw_dA6cIvD?>-@!;7A$15E()Tdq6&O@)KK5NP=$w4 zqv^mke;IS8O@nM<;<<2Efle$kIL?#LOi=dnM^5;>$gv~3=b=@ t#v(IB36LH#$(hWFnufwmnKMA=~YC*F`vN5d2exG-ki;UUEJ%~{T)wo}} zO_Vo$f@)nASIGB60+NkSTs)jstg|FO6@8C3OeH4FnEwH`lIG}uAKeCYTR9D2ava8S zT9Bm+$9EB|l!y1d`zhkfp9WQJ=@|RC7o51ix_zphV##ozx>AW P+ZO+1v?V$d%)iC;Y}eWROL`^k1=|_tAI4P6EO^7(@1dUJ2y{I; zWrm9TAwTcz&~?MqfV%4^6~!fAH=x*lnxfA5p?#zb!Auqy9zP(K_M)G~y@FyYSJG0< z3WWkV?iOXbO5C-X1~8OI`UuByk$|%hL2*+5V6Kva93NMD)`2#qzyN$5{F+M##mY?j zm8A9S*hr?iE;kuv13MP+O}*>--owT+d{AnNr8y%?Ydj@Y{Yk!?+stx*+Fo*UduLeF zQjH+&w6|!wTVV{^T7}^^eJW=;G%AXEN*O& la{8U%d02doK?+ZSwutUJ4>L$2~$yuoT_8swxk> z1=e!!BWsc>p26;k+*;vDxZ(~t@6FcC_-f^jKd_3oJ|+9API8CQhqu7)n|f TRzuyNUtEC2D4mUr2XM%(2%1(>#Z%Kic1vor> zam07rZnst7MRO;^MxGaM%r6S_;KAk;^)hZt_3)@KC<`6;6F3i7IdHevDLBesD 7OsVfWE9J;@isSX`BtBM`q!1>GRIF*oxh9tQS$eDonEjO3 zVMku{ePB%nti&K(0`Ds0Jhg@~j!7&aNt2hMHoKHIs_%`B+p(hMkjs~E`_Bq7Yd@|C zN;H>keU^AXH|39VDOE9^3=7;szwuO^0m(-#o!u^3xt_e&y-lgFi0DwKTHu{U@p*Ht zXzR*dPj?!)*2J0iL`iVR*VP@K(77!mIU1ieVY<=p D z 3u6)v5vF*4QHz?^SfyPSl1^6(Te-vUGY3C z`J!b_*~r?x&3TPL7H(ThI{8NF9P|0tb@7FP0eN9L1Syg| $KDqm5PZ zwDtAFO#$_D{j~%%>w!_5c0@Bf A}|e@xJK7ltz5~ zyy*xDKklXn&c|soB;?`z9UQGSS5hC%R4WnTgB af*!MYZ5g cPG-J|!Sz8}>0&BTu5;m$BO^LQJmq(!Uv zBlq!0EXd8z OHZW0E_dVb04bEmGhnE@#mEJRbKXc`NM9} zO7|(JAuo`3h8&)Lo?M(aXF$hXpkLHTwqjOf8cP(bi9}dJ4=+q>C`!~|lS0JsC!_yJ z!OpFXgBH2{y@2fXRMsFD&c$TX@!qm&GHAAWBn#taq)_!+dn&=rW^NsJZ6_y17j&%) zyCBT}0?9_G&1fPgkDw7Jx9_SIn{O8$q=H1muv|`#vBat29i|(K3LFkFPQM>R5MWCm z27%uP&Kiw(u8Jb72dlk0M)qhHE*6O#xfH<{q(IIC!^R(RqaZHEs>^gXJy=JChYN7F zecw$7xxB^FM6k;Fb1JCy8j_dbVsG796b#)P&V0-CZ2^WbeA1;rLM8Y+H8{g-=M&p@ z)fM<+1T14Dy*poo*w!dm%O6~eOjAviN4f#OsGEM4Jp$v$VK?2+4q1bV6?#nvF0gC) zb?ut!z{f?mr8?m2;mMyOX&Un<^k-6QILUg`#Yh4LQ_1+~n`CnPB6Z7OvXVNa8Ih!x z97wCw!DjgH%bsQCDR&Ia^jSAv2^ug_WU8E~P=wR=4BGYkOw*{lC48@&<>jp*=rNIk zjhDi2_1l#U{J2>f2}~zmGc&f2f@TC8reQj?G${QbQ#PQ>Y1^0CPAG*65}AurYjV17 zjjNn?v07sxpzq0kBJk#BB!~rrCTGT+&Fa{4uHtcrWyaKpjgN&sd>i9!afaA11Ib!x zERWeg%({r=O$|DdRIDJHjUas%Kw26iP--*tg%BNN78G&q(p9h~TUc2qpu0svw4oy) zm||s}^FYqi>Gz4=>Q@S9%ga~+Ayxs78i=LcK40f#`hN`2S+F+s&0aL;_4$TW^|3z2 zDihLsvdrc^TaLY#S)RqFPK(W(Ax4U@c6tg~=Yc3*wi>(^axft|CY>gQ_h#Hd3iKBr z!~44STf(~N)6h=qaPcLBpAvKeBvXlQ5_jGe#ZyFxK-Mlf8$ODJ71$VM*y((FUp>UN z`YJ~$^vmgW?wj3a`co5$k=|)E+1AFSnuB#d#Dx;U+4co}^I=LPDY*rSZUnh~24%1{ zfUKMJLlS-}Ptf6LxN;Y$Fh9}_qakB;xbN^mh*?QpVF{r{4{H+ot?@W56(POmCNmsu z4fA`!a(l~6cc|*{d3E)8V-0D0iQ?v;KBI<9A_APgF EruBe 2O8QyPvY6e_YNx_>1Oo3a;3 zXrAe~kAg8(V7eT|M};Q@K<7%{^6EGZQ>!1~@dq5OU~>mKIILqS^;l3OSWLfFjA6@v z_jlK8KQ*+Q+KpqGgt8-_Gr-(jf%P`ArSCFM%#%A)NkJ# l!?W)aK(tZO @{YA2(cGyPO#OO>7k;}P&2?bT(|b7URQlDvNf!UW@`F3? zO>sFJySHw@Wj3vtkQd{5V;3t-Nsjk^IY^9-2QePH`2_?EUXj}vF39aH{OX?=m)=_C z-Q2j-+lR}rSEM@Iu=o9!Oy(M)=mm4Y1rk2pNC2#5IEoTtYC42${OjMS{w~`vS}?rU z=A8e^M{yG3;(XbT?c7Jk6Bw}ZTVrA(&0%AjycF9I3>m+tmH?QVcH2;J5?vQ7Md$DC z9DRgN=_Ni(z-v39D1x+ZgIBJUyL2z^^B#PJQ2{0b0uN23fLHvz%UA$1%>N@sq$mN) ze?P@cy;1shL;r0ET?)Ujr}#G#Mn)F 2M`C%@OA<_^MybAvnYb`&JTjJZ z@RHI*cKs-O1spp>3pbj~9Ymd`0UL^zUUbG8a^|^C&QIw2U$jIO6|;5!`ySqfbjOeW z#r?IRaqaZJ5w>1$r!w5HpYRYVKpk6D} zo=tMQZT+BNsFLuOLKE2JU7GQ3evBIb@gkNbRE49p_vrGBjbU%*c8A;67v+FR(n+$H zDg0WgfuCD9eDJzs!VkkZJFOAaLTA>@33Dy&h5S!7Jzy{TPWI*-xTHiAgopzs&n*;* zGh7VJ5%v{@nnKnGhS#g Zh1ZCUe*5rDXA&Q0AE$+oeld3AAIXOrMj!>tO%RVvr z5D^DqZB*N5ylC$|4ijLI@0Dp42M-rt8l8v7vMgArOIEK^H)$Ltr1*4oln|PsEk#+M zFg!J5I$ZoKgrN+KBP3BGAyt`vI|W%`z1lgV%UqVXeO3bhm?G)hMTXk@2P@af-!v&P z_ZvL%$+brIsJ50~*N}N1LArKtGcBzRJKdB;-d2VSSIVal;6e1P>d`s@sCs0B;3Skn z8hm1!WUZP12}0h`VF=sW kszBLbtlvC&`gT2^?k0^y gEnc R&y{meQZXdl1tPE#+SmTObrsnNPvN z30TPfP(~&Fk e*Aiz|;qE%@ZG11}U1_AH`Pf7$Sf)`??@uKeoT+ut?>#f3h< zp8{`JT+|gACH`7{H!Q?5@MvDw^DE)VQQp-ojR#QgDTfP#K}+RUecRwUTCx@;a7s|Z z&m^~Hpd3{Vnx|4*yg2TllxF<7@Wk*!tjs9ft6mqz^`6E+$v5?UCP A0?*Jvtdnzh$Y`RM`ACkdlSkpcdWwGT$^m!S@6&UHGfcCz!DplGl*d)S zg0D(usc$K2{rFH=zxm`y6NhrhZq?ykhyuvMetB&$d;M^#*(|8MS^UAIA~XuzW)vIO zBNH?K f9HVgjCL2nHH<)D2fX!2v90kB2I{+s~ltwUvsSB`gVw$IQJ2*l_E z8khaar{6)ic;aG!zTDRdEMKg3Nfn4$nV@YJJg<=`WG^2%Y^G>m@^3kpa1C@x%!e`# zX956MlZA!FNkH$n_9TQ|tCkxY;KwV6Kl0>vJG0VM{s6%5?Uc@} OQ2+n{ literal 0 HcmV?d00001 diff --git a/docs/images/custom-api-preview-2.png b/docs/images/custom-api-preview-2.png new file mode 100644 index 0000000000000000000000000000000000000000..481ef8536817027f9b92496a2c82246b12be53d4 GIT binary patch literal 5826 zcmcIoXH-+svOb6?AYBjv0a2t#2kG5VM0%5wgd);=@1RH#5R@*xgY+i7cd0_?gd%DP zU4f8L0(tS?`~JN3*8TC`y0g}tnc3%?*=?OYXHT?_mMS?ZBPjp? QkV4^4>PyxNfVcsR#gdA8uhSiSRaw+cOhS0HEmq%LK!&pI_k{ z?|La4d+EE{c==j-SOYqi_AXxhTFM6ZMfrvJg)ce?oA8(>YhyJVHMPe8G2S2o7zu~~ z0=)Jd&rJW)@uLB_2nhet{&ze=1lIs6yfnqLebn`Tv^(JSzhr^uzyAL%|3{|)Apm^5 z30%h`1cgNe3G)6K^{)p}-ajKH 0PZV1!7o?=0YFSe4k)~~!_QlZ z5TN=GK&E19`Ws0C9qYQe;TE*G^J!dt^5v~gq9bf@E)JqZo>}K)|E`wJ%6v~ZTJsmv zt;@5ciktHC>;=4>0vGCewO2=7&LcGEq6x0N6k?X8{ZyCdF85^lVty>jGM%h6_>@4P z%IcciBjNq_&9oZb>wTD^xxM$A{8o(PW3n+_`dZJ)e Z$e2!)3hf3P^wOhZVk&jU?#fkaEX5AJWT7IX#nxIz0 z&cTip79qGxbq@rxLT@C^u#b$5$eG&+jwa;>`hB|+NvnQl`U^E`wI|%W-cp5NU>=FM z*7@3`i@Et1wgh{NNZ1OafU`aLLhStr8FMnEeX{>K@i_DN8{JHWmcGB@ uRfY*8} V2MPB;3)$^VXmj+Qw_J}V1qxx*|qQOqX`hLr>`_xvoO zlctSHU0z<^x#2H8H@&O_hJtyL8XnRbW|}KWwh~WttfFFF8ky=kzho3V7+o9G*xDcA zDQ^+avnwwxotj!!Y#d|SQkzaPM1v(wx6{mJ5+9eS4swsA(?C5rJrQ5uiinHC_|)ay zG) Aldq8 zAwBoG*!JbmjRnc1hCs?o-GTrzK_Dlr|6@VN0}#$4Dba} &qxpRIFu4lT4F2b9_{+VX(cfvwnzuL|GM2?*0Mv zcq#lgB6VgxWY^WP0I76tg0bZQ7>{X{2n~a-f @AH?n(ZRR<=nA&6 zW#)#`&@=@|e#19KX zvQMQC7@tJgPPH<-irOP~w(KeW@4|viQ9Iolt${6hb;?@X9<#1Q#LT>BiN}G-OdRcU zmsJ|yCW}8f3FfxEJc0e;7qKt)^1i4mBgkVgr6#{en6G2!GB8u@g^CN`e42mQ|J&H} zItPmOJ<6L4nnNwi9Z)}dMXIY@0qr?vqd Gw897() zKKkePgI!aNYTqgaQKng*SV!p1NyhGk9f5 lq 3OJ;w(IGkOro zqnYR(+Y-J!)k2QD$*dQLX*o9q&dc^@DWgceRVE-B+M#NBZ?=AQwLs8}91r573N^tI zTL=8Q&T8r7vmxQ @HO5pYB2I%+$Fd E!1#r4vT8OovWjx zb^8;=Bx%~weIjTpBpw3X6-4c*)OexFRcl^5rE%B^Gj3fH2L!%x26})3BiR6=S4 PPLuDAEl{^92?3%8)QWPF8|>1cCN0rtOPy!S`E{$ce8;TBzrplTMol_=Qbn$ zS`mbYIaA@YUlJzr*D*O53|<_1`z~JcvRwSa7_lRsWc1sb6{GdN8+GYxhN_!Fa+&hf z?BOhCn$tCdDa%f)myXrgy}kCwav_$1k;#E4tusN#J0Dn2K2ts-Uaxm84BbGV?NWL( zP={Ba{m7P#zqYfppnrZS@Z@e8H k( zc5_pu>F}#WWaQ9Zzv>X;h&D#r>8Ij5&q-WPkj5j>2HlV4jLVrf4TwEE*GPe7^tNzw z+w7@8w m zRxme5$7L@M3+ycpy9Hr}gLLC{S${*sy^Z6FmKR%uJbm@V;PT0zxwA9adT+4~bjh{x zdE$`m2j=%x<(p@5KG!T;LuiOR5Vz_5Q1Shxu)RRq%@oZ9Kijq|C=aU&DVu=%#Ds ztKQd+u6J&%BNy}6NcuR>cIa6GY>$nGL)Fg%jwAac&gGJ9NY3x-9YQ7Lb?!?xmhK`q zs9wt2X4G8GvA!tVY1p`AkM0Q_h4|=<9L5=yeoA4!bc%YnZ=qCk5i6f^hA6il=2^_i zSJm8}H53gB`=F5c#hS2Pf#VK|N?dL^ BaI;(E;~ka;uA6E
!ei+U!qHx(F_rFBt)}9seCl MPXQ;RR`Oi{tR+P4>upqQ&~=b1q8U7hTcP z@Uv;}v@%SGrpW3JES}j$I)`gNI#R`b4Sx(V?QwRaH!yJe6Wrof!9J&+mW%m7QyUvO zNx^26sSf##pYn3<=L3hJb}?nC`iG!oD^yIGn792fWxaFm0#0V~^WN!X=XfF$bCQP? zhp8xlY47%eer9;^$1F9`L+TO2Z9GP|pvDMyOkYK8u^)Yd!)u|^R2bQ~>VI!tQvKS} zf!w2xZjU)8FwNo%@o=_X`KY*gquEsU!AfZ7Q757Grv7{|*2ONZp9&Ov-)kmHy#uc2 z8|0-oXUW|8vLtw-j5(KL5cHn1NOk*QJJ_zTgms%(=L*|mF9TQ8B|5BlQ3YvqxQyyv zJ2Ing4^9w; u#iS9R!hBTT3T8qs!DxKY@)E$4&aC3|MXB*|*JIL%gNL#WBq_ zYgnVifd{X&B&4MVBve9MgvMKBEa4Zv80NmPj+5h%tD@h9J)nE}UfHu`x+dn%1rIF{ zoMoa;Q87D$uUv)>ogICOxPxr?j$Yl&VRwFaBiE#cKX46q!09^!$_Dm1<0+!b%Q`R# ze#P~XFmb_`U=Ydibdy&R@7a2Voa9U}H5zgxaxs!xUwMJx$eRt^o+TH`cubm3)-tyO z*Zh#7g-Fv!^J6GT $V=W(PmdurUxH_!&1ij!ba9nlohIX7y?Pt>TiJ)`&~|i@rM#-|mBzsPkB1LW`IujP>#9db2%Y=iY-YCP zf2b>Bp!ZTr$YCC(<74*|Hf0Gbat6;t&ZnOrGIc|w6_I^L;LvK(1|8}h(YYsIbosmu zq5hEq%pmKKinf*!+xhyhYF60GVL!jPCS @ywVczJ|;XnQ Le+RgZO&_F*b=01mX37~gMb*d;_;A^OPn^SA)n&e9Icl3N zHTuRgQwAQv8P^sMvqf%wO13sYD({9H=^Aog33VgKZV2H&Q}CQwTANEvo4&x6)o Iz;7id z#_sO6U2#o|`z0Ct`s?9??M3`OPL6z#nH0Ed@$a*{LMFd|eYEjmL2ig6xSe0M`Rsh8 z< %88{p?OOFA~2J &c%gr*c`nZ zJi`=TcE0x;os)p_W0a+i-ybmAJO#UPm793+9z1K(kVGnu+ni@0y(xw`V$&m$v7t;x ztw^~3%G5$(Py{5HWo{nkbMX?pmXzY 6(&Sgj-JCw(@X^|Q{gR)LA6+j`Tt{jJ&4%$!n2L(Z_ohuw}CXQ~iNqOnEU9<>ar zi~TZGL+i@Nh@WKj)yd??8BS)N=NZW?O(+yzS2xV1e`MX0XfL!Q!l{+H__co-X4c zP*!$ELc-(b%*wP@1bkrDNeFtFqg_!NuD==K9s)nJhP95Z)TtAC>DQ=98;G!0zG4>Z zl?&T7dE{jSKh^ZDmQON;taEjJO3-!q^;0jsmXE(tsrAWHfaZ6b5cFWem*co<-6Xyv z5oOKf6T95V@WmGPwk8G!`oZyI9mCN@|14?mxU)g-+sN0t28yP2@A+ff{V<`F*c?-9 zdDoJ+^}J*?-|ac7MDGO5A!Abfw vg;VUvv;n<