From 42ae3a46930a5ff84ec8e4d45ab5a1d3fd409b90 Mon Sep 17 00:00:00 2001 From: ReenigneArcher <42013603+ReenigneArcher@users.noreply.github.com> Date: Thu, 19 Nov 2026 20:45:57 -0500 Subject: [PATCH 1/6] feat: introduce the Jackal Jekyll theme --- .github/workflows/ci.yml | 44 +++ .gitignore | 9 + Gemfile | 11 + README.md | 124 ++++++- _includes/jackal/actions.html | 10 + _includes/jackal/footer.html | 31 ++ _includes/jackal/head.html | 24 ++ _includes/jackal/header.html | 40 +++ _includes/jackal/hero.html | 14 + _includes/jackal/media.html | 13 + _includes/jackal/nav-link.html | 5 + _includes/jackal/page-header.html | 4 + _includes/jackal/post-grid.html | 12 + _includes/jackal/sections.html | 38 +++ _includes/jackal/url.html | 19 ++ _layouts/blog.html | 8 + _layouts/catalog.html | 7 + _layouts/home.html | 19 ++ _layouts/jackal.html | 18 + _layouts/page.html | 7 + _layouts/post.html | 11 + _layouts/product.html | 11 + assets/jackal/jackal.css | 317 ++++++++++++++++++ assets/jackal/theme.js | 37 ++ docs/jackal-preview.jpg | Bin 0 -> 123213 bytes example/_config.yml | 43 +++ example/_data/catalog.yml | 10 + example/_includes/koko-project.html | 3 + .../2026-01-01-a-home-for-each-project.md | 13 + example/_preview.yml | 7 + example/about.md | 9 + example/assets/example/catalog.js | 18 + example/assets/example/koko.css | 5 + example/assets/example/themerr.css | 5 + example/blog.md | 5 + example/catalog/index.html | 31 ++ example/catalog/index.json | 4 + example/index.md | 33 ++ example/koko.md | 23 ++ example/sunshine.md | 46 +++ example/themerr.md | 32 ++ jekyll-theme-jackal.gemspec | 14 + script/verify-preview.rb | 56 ++++ 43 files changed, 1185 insertions(+), 5 deletions(-) create mode 100644 .github/workflows/ci.yml create mode 100644 Gemfile create mode 100644 _includes/jackal/actions.html create mode 100644 _includes/jackal/footer.html create mode 100644 _includes/jackal/head.html create mode 100644 _includes/jackal/header.html create mode 100644 _includes/jackal/hero.html create mode 100644 _includes/jackal/media.html create mode 100644 _includes/jackal/nav-link.html create mode 100644 _includes/jackal/page-header.html create mode 100644 _includes/jackal/post-grid.html create mode 100644 _includes/jackal/sections.html create mode 100644 _includes/jackal/url.html create mode 100644 _layouts/blog.html create mode 100644 _layouts/catalog.html create mode 100644 _layouts/home.html create mode 100644 _layouts/jackal.html create mode 100644 _layouts/page.html create mode 100644 _layouts/post.html create mode 100644 _layouts/product.html create mode 100644 assets/jackal/jackal.css create mode 100644 assets/jackal/theme.js create mode 100644 docs/jackal-preview.jpg create mode 100644 example/_config.yml create mode 100644 example/_data/catalog.yml create mode 100644 example/_includes/koko-project.html create mode 100644 example/_posts/2026-01-01-a-home-for-each-project.md create mode 100644 example/_preview.yml create mode 100644 example/about.md create mode 100644 example/assets/example/catalog.js create mode 100644 example/assets/example/koko.css create mode 100644 example/assets/example/themerr.css create mode 100644 example/blog.md create mode 100644 example/catalog/index.html create mode 100644 example/catalog/index.json create mode 100644 example/index.md create mode 100644 example/koko.md create mode 100644 example/sunshine.md create mode 100644 example/themerr.md create mode 100644 jekyll-theme-jackal.gemspec create mode 100644 script/verify-preview.rb diff --git a/.github/workflows/ci.yml b/.github/workflows/ci.yml new file mode 100644 index 0000000..bf1f274 --- /dev/null +++ b/.github/workflows/ci.yml @@ -0,0 +1,44 @@ +--- +name: Theme CI +permissions: {} + +on: + pull_request: + push: + branches: + - master + workflow_dispatch: + +jobs: + build: + name: Build preview (Jekyll ${{ matrix.jekyll }}) + runs-on: ubuntu-latest + permissions: + contents: read + strategy: + matrix: + include: + - ruby: '3.1' + jekyll: '~> 3.10.0' + - ruby: '3.4' + jekyll: '~> 4.4.0' + env: + JEKYLL_VERSION: ${{ matrix.jekyll }} + steps: + - name: Checkout + uses: actions/checkout@3d3c42e5aac5ba805825da76410c181273ba90b1 # v7.0.1 + with: + persist-credentials: false + - name: Set up Ruby + uses: ruby/setup-ruby@20eb24b0d509e2b9ed9b6d42ddfeb992915e0564 # v1.341.0 + with: + ruby-version: ${{ matrix.ruby }} + bundler-cache: true + - name: Build and verify both URL layouts + run: | + bundle exec jekyll build --source example --destination _site/root --config example/_config.yml + ruby script/verify-preview.rb _site/root '' https://app.lizardbyte.dev/ https://example.org + bundle exec jekyll build --source example --destination _site/nested --config example/_config.yml,example/_preview.yml + ruby script/verify-preview.rb _site/nested /previews/42/ThemerrDB /previews/42 https://preview.example.org + - name: Build theme gem + run: gem build jekyll-theme-jackal.gemspec diff --git a/.gitignore b/.gitignore index e3f4af3..1196f87 100644 --- a/.gitignore +++ b/.gitignore @@ -1,2 +1,11 @@ # JetBrains IDEs .idea/ + +# Local builds and Bundler state +.bundle/ +.jekyll-cache/ +.jekyll-metadata +.sass-cache/ +_site/ +/Gemfile.lock +*.gem diff --git a/Gemfile b/Gemfile new file mode 100644 index 0000000..fa02953 --- /dev/null +++ b/Gemfile @@ -0,0 +1,11 @@ +source "https://rubygems.org" + +gemspec + +# Set JEKYLL_VERSION=~>3.10.0 to test the GitHub Pages generation of Jekyll. +gem "jekyll", ENV.fetch("JEKYLL_VERSION", "~> 4.4.0") +# These libraries moved out of the default gem set in Ruby 3.4. +gem "base64", "~> 0.3" +gem "bigdecimal", ">= 3.0", "< 5" +gem "kramdown-parser-gfm", "~> 1.1" +gem "webrick", "~> 1.9" diff --git a/README.md b/README.md index eaabf03..6281687 100644 --- a/README.md +++ b/README.md @@ -4,10 +4,124 @@ alt="LizardByte icon" width="256" /> -

repo-name

-

Repo description. This should exactly match the description in GitHub.

+

Jackal

+

A shared Jekyll theme for organizations and their project sites.

-
- SonarCloud -
+Jackal provides product landing pages, a project hub, articles, a blog index, and wide catalog pages. +Sites choose their own branding, navigation, content, and deployment paths. The theme provides +the shared page structure, responsive components, and system, light, and dark color modes. + +## Preview + +From the theme checkout, install Ruby and Bundler, then run: + +```sh +bundle install +bundle exec jekyll serve --source example --config example/_config.yml +``` + +Open the address printed by Jekyll to preview the Sunshine, Themerr, and Koko examples, +the blog, and the filterable release catalog. Product artwork in the examples is served +by the original sites. Example content and assets are separate from the theme package. + +## Use Jackal + +For a Jekyll build in GitHub Actions or on your machine, add Jackal to the site's +`Gemfile`. Use a tag or commit that contains the theme: + +```ruby +gem "jekyll-theme-jackal", git: "https://github.com/LizardByte/jackal.git", ref: "YOUR_THEME_REF" +``` + +Set `theme: jekyll-theme-jackal` in `_config.yml` and run `bundle install`. +During development, use `path: "../jackal"` in place of `git:` and `ref:`. + +GitHub Pages' branch builds can instead use +[`jekyll-remote-theme`](https://github.com/benbalter/jekyll-remote-theme). +Set `remote_theme: LizardByte/jackal@YOUR_THEME_REF`, enable `jekyll-remote-theme` +in `plugins`, and omit `theme`. Jackal's layouts require no custom plugins. + +## Configure a site + +```yaml +theme: jekyll-theme-jackal +title: ThemerrDB +description: Browse themes for your media library. +url: https://themerr.lizardbyte.dev +baseurl: /ThemerrDB + +jackal: + logo: /assets/project-logo.svg + icon: /assets/favicon.svg + styles: + - /assets/project.css + nav: + - label: Browse + url: / + - label: Resources + items: + - label: Themerr + url: https://themerr.lizardbyte.dev/ + - label: LizardByte blog + url: /blog/ + scope: umbrella + umbrella: + name: LizardByte + url: https://app.lizardbyte.dev/ + logo: /assets/lizardbyte-wordmark.svg + footer: + - label: Explore projects + url: / + scope: umbrella + - label: Get support + url: /support/ + scope: umbrella + copyright: LizardByte +``` + +- Use an empty `baseurl` for a domain root. Set a subpath such as `/ThemerrDB` for a + project site. Local links and assets automatically use the consumer's `baseurl`. +- Set `jackal.umbrella.url` to a full origin when the parent site is on another domain. + Use `/` for the root of the same origin, or a path such as `/previews/42` when a + preview hosts the umbrella site there. Links marked `scope: umbrella` use that + URL, independently of the project's own `baseurl`. +- `jackal.umbrella.logo` is a project asset unless it is an absolute URL or + `jackal.umbrella.logo_scope: umbrella` is set. If `jackal.umbrella` is omitted, + the footer displays the site's own name. +- Set `jackal.name` to override the displayed site name. Set `jackal.styles` and + `jackal.scripts` for site-wide assets. Pages can also specify their own + `styles` and `scripts` lists in front matter. +- Adjust the theme tokens in your stylesheet. Set `--jackal-accent`, + `--jackal-on-accent`, and `--jackal-accent-soft` together so buttons and links + remain readable in both modes. See [Themerr's example palette](example/assets/example/themerr.css). + +## Layouts + +- `home` displays a hero, content, sections, and recent posts. Set + `show_posts: false` to hide the post list, or use `posts_title` and + `posts_limit` to customize it. +- `product` displays a hero, page content, and reusable sections. Optional + `hero.image` fields include `dark_src`, `width`, `height`, and `caption`. + Set `alt` to describe informative images. +- `page` and `post` provide a reading layout. Use `blog` for a post index. +- `catalog` provides a full-width layout for a data browser. Catalogs can use the + theme's grid, table, and toolbar styles with their own data and JavaScript. +- `jackal` provides the base layout for a custom page. + +Product and home pages build their content using these section types: + +- `cards` for features, linked projects, or platform downloads. +- `gallery` for screenshots, with optional alternate images for dark mode. +- `faq` for expandable questions and answers. +- `callout` for a highlighted action such as sponsorship or installation help. +- `custom` for a site-owned template in `_includes`. Set `template` to its + filename and read any section fields with `include.section`. + +See the [Sunshine example](example/sunshine.md) and [Themerr example](example/themerr.md) +for concrete front matter. Use [the catalog example](example/catalog/index.html) +as a starting point for a project with its own generated data. + +When migrating a site, keep its existing `url`, `baseurl`, permalinks, feeds, and redirects. +Keep generated data, release assets, and downloads at their existing public paths. +Build and compare the new output before changing a site's publishing workflow. diff --git a/_includes/jackal/actions.html b/_includes/jackal/actions.html new file mode 100644 index 0000000..e3d5ad7 --- /dev/null +++ b/_includes/jackal/actions.html @@ -0,0 +1,10 @@ +{% if include.actions.size > 0 %} +
+ {% for jackal_action in include.actions %} + + {{- jackal_action.label | escape -}} + + {% endfor %} +
+{% endif %} diff --git a/_includes/jackal/footer.html b/_includes/jackal/footer.html new file mode 100644 index 0000000..6648f9f --- /dev/null +++ b/_includes/jackal/footer.html @@ -0,0 +1,31 @@ + diff --git a/_includes/jackal/head.html b/_includes/jackal/head.html new file mode 100644 index 0000000..421d964 --- /dev/null +++ b/_includes/jackal/head.html @@ -0,0 +1,24 @@ + + + + {% assign jackal_title = site.jackal.name | default: site.title %} + {% assign jackal_description = page.description | default: page.hero.description | default: site.description %} + {% if page.title and page.title != jackal_title %}{{ page.title | escape }} · {% endif %}{{ jackal_title | escape }} + {% if jackal_description %} + + {% endif %} + {% if site.url and site.url != empty %} + + {% endif %} + {% if site.jackal.icon %} + + {% endif %} + + + {% for jackal_style in site.jackal.styles %} + + {% endfor %} + {% for jackal_style in page.styles %} + + {% endfor %} + diff --git a/_includes/jackal/header.html b/_includes/jackal/header.html new file mode 100644 index 0000000..a17e93e --- /dev/null +++ b/_includes/jackal/header.html @@ -0,0 +1,40 @@ +
+
+ + {% if site.jackal.logo %} + + {% endif %} + {{ site.jackal.name | default: site.title | escape }} + + {% if site.jackal.nav.size > 0 %} + + {% endif %} + +
+
diff --git a/_includes/jackal/hero.html b/_includes/jackal/hero.html new file mode 100644 index 0000000..8af3515 --- /dev/null +++ b/_includes/jackal/hero.html @@ -0,0 +1,14 @@ +{% assign jackal_hero = include.hero %} +
+
+

{{ jackal_hero.title | default: page.title | default: site.title | escape }}

+ {% assign jackal_hero_description = jackal_hero.description | default: page.description %} + {% if jackal_hero_description %} +

{{ jackal_hero_description | escape }}

+ {% endif %} + {% include jackal/actions.html actions=jackal_hero.actions %} +
+ {% if jackal_hero.image.src %} + {% include jackal/media.html image=jackal_hero.image eager=true %} + {% endif %} +
diff --git a/_includes/jackal/media.html b/_includes/jackal/media.html new file mode 100644 index 0000000..58a5d72 --- /dev/null +++ b/_includes/jackal/media.html @@ -0,0 +1,13 @@ +{% assign jackal_image = include.image %} +
+ + {% if jackal_image.dark_src %} + {{ jackal_image.alt | escape }} + {% endif %} + {% if jackal_image.caption %}
{{ jackal_image.caption | escape }}
{% endif %} +
diff --git a/_includes/jackal/nav-link.html b/_includes/jackal/nav-link.html new file mode 100644 index 0000000..1a3fe28 --- /dev/null +++ b/_includes/jackal/nav-link.html @@ -0,0 +1,5 @@ +{%- capture jackal_nav_url -%}{% include jackal/url.html url=include.link.url scope=include.link.scope %}{%- endcapture -%} +{%- assign jackal_nav_current = page.url | relative_url | escape -%} + + {{- include.link.label | escape -}} + diff --git a/_includes/jackal/page-header.html b/_includes/jackal/page-header.html new file mode 100644 index 0000000..d0b816a --- /dev/null +++ b/_includes/jackal/page-header.html @@ -0,0 +1,4 @@ +
+

{{ page.title | default: site.title | escape }}

+ {% if page.description %}

{{ page.description | escape }}

{% endif %} +
diff --git a/_includes/jackal/post-grid.html b/_includes/jackal/post-grid.html new file mode 100644 index 0000000..009f4b3 --- /dev/null +++ b/_includes/jackal/post-grid.html @@ -0,0 +1,12 @@ +
+ {% assign jackal_post_limit = include.limit | default: include.posts.size %} + {% for jackal_post in include.posts limit: jackal_post_limit %} +
+ +

{{ jackal_post.title | escape }}

+

{{ jackal_post.description | default: jackal_post.excerpt | strip_html | strip_newlines | escape }}

+
+ {% endfor %} +
diff --git a/_includes/jackal/sections.html b/_includes/jackal/sections.html new file mode 100644 index 0000000..2e669b8 --- /dev/null +++ b/_includes/jackal/sections.html @@ -0,0 +1,38 @@ +{% for jackal_section in include.sections %} +
+ {% if jackal_section.title %}

{{ jackal_section.title | escape }}

{% endif %} + {% if jackal_section.description %}

{{ jackal_section.description | escape }}

{% endif %} + {% case jackal_section.type %} + {% when 'cards' %} +
+ {% for jackal_card in jackal_section.items %} +
+

{{ jackal_card.title | escape }}

+ {% if jackal_card.description %}
{{ jackal_card.description | markdownify }}
{% endif %} + {% include jackal/actions.html actions=jackal_card.actions %} +
+ {% endfor %} +
+ {% when 'gallery' %} +
+ {% for jackal_gallery_image in jackal_section.items %} + {% include jackal/media.html image=jackal_gallery_image %} + {% endfor %} +
+ {% when 'faq' %} +
+ {% for jackal_question in jackal_section.items %} +
+ {{ jackal_question.question | escape }} +
{{ jackal_question.answer | markdownify }}
+
+ {% endfor %} +
+ {% when 'callout' %} + {% include jackal/actions.html actions=jackal_section.actions %} + {% when 'custom' %} + {% include {{ jackal_section.template }} section=jackal_section %} + {% endcase %} +
+{% endfor %} diff --git a/_includes/jackal/url.html b/_includes/jackal/url.html new file mode 100644 index 0000000..e41372f --- /dev/null +++ b/_includes/jackal/url.html @@ -0,0 +1,19 @@ +{%- assign jackal_url = include.url | default: '' | strip -%} +{%- assign jackal_url_start = jackal_url | slice: 0, 1 -%} +{%- assign jackal_url_pair = jackal_url | slice: 0, 2 -%} +{%- assign jackal_url_scheme = jackal_url | split: ':' | first -%} +{%- if jackal_url == empty or jackal_url contains '://' or jackal_url_start == '#' or jackal_url_start == '?' + or jackal_url_pair == '//' or jackal_url_scheme == 'mailto' or jackal_url_scheme == 'tel' -%} + {{- jackal_url | escape -}} +{%- elsif include.scope == 'umbrella' -%} + {%- assign jackal_umbrella_root = site.jackal.umbrella.url | default: '/' | strip -%} + {%- assign jackal_umbrella_root_end = jackal_umbrella_root | slice: -1, 1 -%} + {%- if jackal_url_start == '/' -%} + {%- assign jackal_url = jackal_url | remove_first: '/' -%} + {%- endif -%} + {{- jackal_umbrella_root | escape -}} + {%- unless jackal_umbrella_root_end == '/' -%}/{%- endunless -%} + {{- jackal_url | escape -}} +{%- else -%} + {{- jackal_url | relative_url | escape -}} +{%- endif -%} diff --git a/_layouts/blog.html b/_layouts/blog.html new file mode 100644 index 0000000..5f8b1e0 --- /dev/null +++ b/_layouts/blog.html @@ -0,0 +1,8 @@ +--- +layout: jackal +--- +
+ {% include jackal/page-header.html %} +
{{ content }}
+ {% include jackal/post-grid.html posts=site.posts %} +
diff --git a/_layouts/catalog.html b/_layouts/catalog.html new file mode 100644 index 0000000..ff9ddb6 --- /dev/null +++ b/_layouts/catalog.html @@ -0,0 +1,7 @@ +--- +layout: jackal +--- +
+ {% include jackal/page-header.html %} + {{ content }} +
diff --git a/_layouts/home.html b/_layouts/home.html new file mode 100644 index 0000000..fb1f805 --- /dev/null +++ b/_layouts/home.html @@ -0,0 +1,19 @@ +--- +layout: jackal +--- +{% include jackal/hero.html hero=page.hero %} + +{% assign jackal_home_body = content | strip %} +{% if jackal_home_body != empty %} +
{{ content }}
+{% endif %} + +{% include jackal/sections.html sections=page.sections %} + +{% if site.posts.size > 0 and page.show_posts != false %} +
+

{{ page.posts_title | default: 'Latest news' | escape }}

+ {% assign jackal_home_post_limit = page.posts_limit | default: 3 %} + {% include jackal/post-grid.html posts=site.posts limit=jackal_home_post_limit %} +
+{% endif %} diff --git a/_layouts/jackal.html b/_layouts/jackal.html new file mode 100644 index 0000000..8d29d9f --- /dev/null +++ b/_layouts/jackal.html @@ -0,0 +1,18 @@ + + + {% include jackal/head.html %} + + Skip to content + {% include jackal/header.html %} +
+ {{ content }} +
+ {% include jackal/footer.html %} + {% for jackal_script in site.jackal.scripts %} + + {% endfor %} + {% for jackal_script in page.scripts %} + + {% endfor %} + + diff --git a/_layouts/page.html b/_layouts/page.html new file mode 100644 index 0000000..58ff34b --- /dev/null +++ b/_layouts/page.html @@ -0,0 +1,7 @@ +--- +layout: jackal +--- +
+ {% include jackal/page-header.html %} +
{{ content }}
+
diff --git a/_layouts/post.html b/_layouts/post.html new file mode 100644 index 0000000..00bd04d --- /dev/null +++ b/_layouts/post.html @@ -0,0 +1,11 @@ +--- +layout: jackal +--- +
+ {% include jackal/page-header.html %} +

+ + {% if page.author %} · {{ page.author | escape }}{% endif %} +

+
{{ content }}
+
diff --git a/_layouts/product.html b/_layouts/product.html new file mode 100644 index 0000000..56cce7a --- /dev/null +++ b/_layouts/product.html @@ -0,0 +1,11 @@ +--- +layout: jackal +--- +{% include jackal/hero.html hero=page.hero %} + +{% assign jackal_product_body = content | strip %} +{% if jackal_product_body != empty %} +
{{ content }}
+{% endif %} + +{% include jackal/sections.html sections=page.sections %} diff --git a/assets/jackal/jackal.css b/assets/jackal/jackal.css new file mode 100644 index 0000000..de56171 --- /dev/null +++ b/assets/jackal/jackal.css @@ -0,0 +1,317 @@ +:root { + color-scheme: light dark; + --jackal-paper: light-dark(#f7f5ee, #171715); + --jackal-surface: light-dark(#fffdf7, #232320); + --jackal-muted-surface: light-dark(#eeeae0, #292824); + --jackal-ink: light-dark(#22221e, #f5f1e8); + --jackal-muted: light-dark(#605d52, #c8c1b1); + --jackal-border: light-dark(#d6cfc0, #49463d); + --jackal-accent: light-dark(#9b3f1c, #ffb085); + --jackal-on-accent: light-dark(#fffdf7, #261106); + --jackal-accent-soft: light-dark(#f8e6da, #37271e); + --jackal-max-width: 74rem; + --jackal-prose-width: 67ch; + --jackal-gutter: clamp(1.25rem, 4vw, 3rem); + --jackal-radius: 1rem; + --jackal-font: system-ui, -apple-system, "Segoe UI", sans-serif; +} + +:root[data-jackal-theme="light"] { color-scheme: light; } +:root[data-jackal-theme="dark"] { color-scheme: dark; } + +body { + margin: 0; + min-width: 0; + background: var(--jackal-paper); + color: var(--jackal-ink); + font: 1rem/1.65 var(--jackal-font); +} + +body, .jackal-header, .jackal-main, .jackal-footer { box-sizing: border-box; } +a { color: var(--jackal-accent); text-underline-offset: 0.2em; } +a:hover { text-decoration-thickness: 0.13em; } +:focus-visible { outline: 2px solid var(--jackal-accent); outline-offset: 4px; } +[id] { scroll-margin-top: 2rem; } + +.jackal-wrap { + box-sizing: border-box; + width: min(100%, var(--jackal-max-width)); + margin-inline: auto; + padding-inline: var(--jackal-gutter); +} + +.jackal-main { min-height: 56vh; padding-bottom: clamp(3rem, 9vw, 8rem); } + +.jackal-sr-only, .jackal-skip:not(:focus) { + position: absolute; + width: 1px; + height: 1px; + overflow: hidden; + clip-path: inset(50%); + white-space: nowrap; +} + +.jackal-skip:focus { + position: absolute; + z-index: 3; + inset: 0 auto auto 0; + padding: 0.75rem 1rem; + background: var(--jackal-surface); +} + +.jackal-header { border-bottom: 1px solid var(--jackal-border); } + +.jackal-header__inner { + display: flex; + align-items: center; + flex-wrap: wrap; + gap: 0.6rem 1.5rem; + min-height: 4.75rem; + padding-block: 0.75rem; +} + +.jackal-brand { + display: inline-flex; + align-items: center; + gap: 0.65rem; + color: var(--jackal-ink); + font-size: 1.22rem; + font-weight: 800; + letter-spacing: -0.05em; + text-decoration: none; +} + +.jackal-brand img { object-fit: contain; } +.jackal-nav { margin-inline-start: auto; } + +.jackal-nav ul { + margin: 0; + padding: 0; + list-style: none; +} + +.jackal-nav__list { + display: flex; + align-items: baseline; + flex-wrap: wrap; + gap: 0.25rem 1.5rem; +} + +.jackal-nav a, .jackal-nav summary, .jackal-footer nav a { + color: var(--jackal-ink); + font-size: 0.9rem; + font-weight: 650; + text-decoration: none; +} + +.jackal-nav a:hover, .jackal-nav a[aria-current="page"], .jackal-footer nav a:hover { + color: var(--jackal-accent); + text-decoration: underline; +} + +.jackal-nav__group { position: relative; } +.jackal-nav summary, .jackal-faq summary { cursor: pointer; } + +.jackal-nav .jackal-nav__dropdown { + position: absolute; + z-index: 2; + top: calc(100% + 0.35rem); + inset-inline-end: 0; + width: max-content; + max-width: 80vw; + padding: 0.5rem; + border: 1px solid var(--jackal-border); + border-radius: 0.75rem; + background: var(--jackal-surface); +} + +.jackal-nav__dropdown a { display: block; padding: 0.4rem 0.65rem; } +.jackal-theme-control { margin-inline-start: auto; } +.jackal-nav + .jackal-theme-control { margin-inline-start: 0; } + +.jackal-theme-control select, .jackal-input { + box-sizing: border-box; + min-height: 2.25rem; + padding: 0.4rem 0.65rem; + border: 1px solid var(--jackal-border); + border-radius: 0.6rem; + background: var(--jackal-surface); + color: var(--jackal-ink); + font: inherit; +} + +.jackal-theme-control select { font-size: 0.85rem; } +.jackal-input { padding: 0.65rem 0.8rem; width: min(100%, 30rem); } + +.jackal-hero { + display: grid; + align-items: center; + gap: clamp(2rem, 5vw, 4.5rem); + padding-block: clamp(3.5rem, 8vw, 7rem); +} + +.jackal-hero--with-image { grid-template-columns: minmax(0, 0.95fr) minmax(0, 1.05fr); } + +.jackal-main h1, .jackal-main h2, .jackal-main h3 { + line-height: 1.05; + letter-spacing: -0.041em; + text-wrap: balance; +} + +.jackal-hero h1, .jackal-page-header h1 { margin: 0; font-size: clamp(2.85rem, 7vw, 5.8rem); } +.jackal-hero h1 { max-width: 15ch; } +.jackal-hero__copy > :last-child, .jackal-page-header > :last-child { margin-bottom: 0; } +.jackal-main h2 { margin: 0 0 1.4rem; font-size: clamp(1.85rem, 4.5vw, 3rem); } +.jackal-main h3 { margin: 0; font-size: 1.35rem; } + +.jackal-lede { + max-width: 56ch; + margin-block: 1.2rem 1.75rem; + color: var(--jackal-muted); + font-size: clamp(1.05rem, 2.4vw, 1.32rem); + line-height: 1.55; +} + +.jackal-actions { display: flex; flex-wrap: wrap; gap: 0.65rem; margin-top: 1.25rem; } + +.jackal-button { + display: inline-flex; + align-items: center; + justify-content: center; + box-sizing: border-box; + min-height: 2.75rem; + padding: 0.55rem 1.1rem; + border: 1px solid var(--jackal-border); + border-radius: 2rem; + background: var(--jackal-surface); + color: var(--jackal-ink); + font-size: 0.95rem; + font-weight: 680; + text-decoration: none; +} + +.jackal-button--primary { + border-color: var(--jackal-accent); + background: var(--jackal-accent); + color: var(--jackal-on-accent); +} + +.jackal-button:hover { text-decoration: underline; } + +.jackal-section + .jackal-section { margin-top: clamp(3rem, 7vw, 6rem); } +.jackal-section h2 + .jackal-lede { margin-top: -0.6rem; } + +.jackal-section--callout { + width: min(calc(100% - 2 * var(--jackal-gutter)), calc(var(--jackal-max-width) - 2 * var(--jackal-gutter))); + padding: clamp(1.5rem, 5vw, 3rem); + border: 1px solid var(--jackal-border); + border-radius: var(--jackal-radius); + background: var(--jackal-accent-soft); +} + +.jackal-grid { + display: grid; + grid-template-columns: repeat(auto-fit, minmax(min(100%, 16rem), 1fr)); + gap: 1rem; +} + +.jackal-card { + display: flex; + flex-direction: column; + align-items: start; + gap: 0.75rem; + min-width: 0; + padding: clamp(1rem, 3vw, 1.6rem); + border: 1px solid var(--jackal-border); + border-radius: var(--jackal-radius); + background: var(--jackal-surface); +} + +.jackal-card p { margin: 0; color: var(--jackal-muted); } +.jackal-card .jackal-actions { margin-top: auto; padding-top: 0.25rem; } +.jackal-card .jackal-prose > :first-child { margin-top: 0; } +.jackal-card .jackal-prose > :last-child { margin-bottom: 0; } + +.jackal-media { min-width: 0; margin: 0; } + +.jackal-media img { + display: block; + box-sizing: border-box; + width: 100%; + height: auto; + border: 1px solid var(--jackal-border); + border-radius: var(--jackal-radius); + background: var(--jackal-surface); +} + +.jackal-media img.jackal-media__dark { display: none; } + +:root[data-jackal-theme="dark"] .jackal-media img.jackal-media__light { display: none; } +:root[data-jackal-theme="dark"] .jackal-media img.jackal-media__dark { display: block; } + +@media (prefers-color-scheme: dark) { + :root:not([data-jackal-theme="light"]) .jackal-media img.jackal-media__light { display: none; } + :root:not([data-jackal-theme="light"]) .jackal-media img.jackal-media__dark { display: block; } +} + +.jackal-media figcaption, .jackal-meta { margin-top: 0.5rem; color: var(--jackal-muted); font-size: 0.9rem; } +.jackal-faq details { max-width: 52rem; padding-block: 0.8rem; border-bottom: 1px solid var(--jackal-border); } +.jackal-faq summary { font-weight: 700; } +.jackal-faq details > div { margin-inline-start: 1.15rem; } + +.jackal-reading { max-width: calc(51rem + 2 * var(--jackal-gutter)); } +.jackal-page-header { margin-block: clamp(2rem, 6vw, 4.75rem) 1.5rem; } +.jackal-page-header h1 { font-size: clamp(2.4rem, 6vw, 4.75rem); } +.jackal-prose { max-width: var(--jackal-prose-width); overflow-wrap: break-word; } +.jackal-prose > h2 { margin-top: 1.6em; font-size: clamp(1.6rem, 4vw, 2.25rem); } +.jackal-prose > h3 { margin-top: 1.55em; } +.jackal-prose > :last-child { margin-bottom: 0; } +.jackal-prose img { max-width: 100%; height: auto; } +.jackal-prose pre { padding: 1rem; overflow: auto; } + +.jackal-prose pre, .jackal-prose :not(pre) > code { + border-radius: 0.4rem; + background: var(--jackal-muted-surface); +} + +.jackal-prose :not(pre) > code { padding: 0.1em 0.28em; } +.jackal-prose blockquote { margin-inline: 0; padding-inline-start: 1rem; border-inline-start: 3px solid var(--jackal-accent); } +.jackal-catalog-toolbar { display: flex; flex-wrap: wrap; align-items: end; gap: 1rem; margin-block: 1.5rem; } +.jackal-catalog-toolbar[hidden] { display: none; } +.jackal-catalog-toolbar label { display: grid; gap: 0.25rem; flex: 1 1 18rem; } +.jackal-table-wrap { overflow-x: auto; border: 1px solid var(--jackal-border); border-radius: var(--jackal-radius); } + +.jackal-table { + width: 100%; + border-collapse: collapse; + background: var(--jackal-surface); + text-align: start; +} + +.jackal-table th, .jackal-table td { padding: 0.8rem 1rem; border-bottom: 1px solid var(--jackal-border); text-align: start; } +.jackal-table th { background: var(--jackal-muted-surface); } +.jackal-table tbody tr:last-child td { border-bottom: 0; } + +.jackal-footer { border-top: 1px solid var(--jackal-border); } + +.jackal-footer__inner { + display: grid; + justify-items: center; + gap: 1rem; + padding-block: 2.5rem; + text-align: center; +} + +.jackal-affiliation, .jackal-footer__name { margin: 0; font-weight: 700; } +.jackal-affiliation { display: flex; align-items: center; justify-content: center; flex-wrap: wrap; gap: 0.38rem; } +.jackal-affiliation img { display: block; width: auto; height: 1.5rem; max-width: 10rem; object-fit: contain; } +.jackal-footer nav { display: flex; justify-content: center; flex-wrap: wrap; gap: 0.45rem 1.15rem; } +.jackal-footer small { color: var(--jackal-muted); } + +@media (max-width: 46rem) { + .jackal-hero--with-image { grid-template-columns: minmax(0, 1fr); } + .jackal-theme-control, .jackal-nav + .jackal-theme-control { margin-inline-start: auto; } + .jackal-nav { order: 1; flex-basis: 100%; margin-inline-start: 0; } + .jackal-nav .jackal-nav__dropdown { position: static; margin-top: 0.4rem; } + .jackal-nav__list { gap: 0.3rem 1rem; } +} diff --git a/assets/jackal/theme.js b/assets/jackal/theme.js new file mode 100644 index 0000000..5f02501 --- /dev/null +++ b/assets/jackal/theme.js @@ -0,0 +1,37 @@ +(() => { + const modes = ['system', 'light', 'dark']; + const storageKey = 'jackal-color-mode'; + let mode = 'system'; + + try { + const saved = window.localStorage.getItem(storageKey); + if (modes.includes(saved)) mode = saved; + } catch { + // The control still works for this page if storage is unavailable. + } + + function applyMode(value) { + document.documentElement.dataset.jackalTheme = value; + } + + applyMode(mode); + document.addEventListener('DOMContentLoaded', () => { + const control = document.querySelector('[data-jackal-theme-control]'); + const selector = control?.querySelector('[data-jackal-theme]'); + if (!selector) return; + + selector.value = mode; + control.hidden = false; + selector.addEventListener('change', () => { + const next = selector.value; + if (!modes.includes(next)) return; + + applyMode(next); + try { + window.localStorage.setItem(storageKey, next); + } catch { + // Apply the selection even when it cannot be remembered. + } + }); + }); +})(); diff --git a/docs/jackal-preview.jpg b/docs/jackal-preview.jpg new file mode 100644 index 0000000000000000000000000000000000000000..97614f75f2f2ef602aafa45f48ebdfb3e43451e2 GIT binary patch literal 123213 zcmeFZcUV)~wl^FLqM)+rN)e?Kno^|%w$i(hgqna-6hf1Z)GbPvASLvol!PP{=^Zv8 zT|i3cMLLAurN2?nId^~ep8LGtec$^%-~Hnx&ok#*YpglO?>A;!Yt6CN`SAHSz;Eix zYRZ5M7XW|@q(9(%44?qGa+&N3+2t!&$gYr+U%5*08wJI+YZP=hsjmOVNO$WNBOL<+ z6Dt=R6Eg=31H)Z`yByp+d_cb2Y=ZX%dGB-a^6~yqa)F$joZ>14Ed>QFFB1b3?|=Ds z{wIL?D*1)Wo0l%I11?fuxI}&7{4;>{2T1ZCaR2eUc!>m;{OW~kB(c?RfD4x{UATPt z8aes3%jB0YQvojgkW*iwp}qHj{E=?&RXTP(@H3~VXnGOn*D)Up85l*y9=jHCNJv7> zT{4RM!~+_pZ*fBO-D3MuSu>kl4;3sd-!yJj_pFKHr~VZQM9-#<|NG;@WV zB$TJV0JsRaNb=ofz~w6!FOg2UKz;GvC7K71bT=RXRhG4& zcBrU1qWX3tKZ;hC@ikaO_Xb=HN>|h>E}N&)D&U|Zz6R+40$)N*zjFU!^0eNFC{$!} zw`y#@QYE!Y8B*9U$+GYfK2VE$D_ZG_jmRL|81AZ>rP%F9=gSg6@B z!eXVzNncm3I=w4$)^z$;Hj_&s_3@#qwrsSJ z0olHD@A1$nyRy`_A(VkTe5?k)WZyQ|y_Kf|+>o++rKOeoBC_j&NxIS~ax5Rmll4iL zsG&YKrli7Uuffz|rJBqPTaa?bO`u@xK&K9%u)y>94{K&ZF|LtW$fOMo{bly7=nU~G z<%RNa*bu*NTi)EfCZunY-n-?U20N;U)*TiS!u8u(l$-}B9$Dk&r<%WY{2TLxCkaJe92Fh8ZZJ*+aIWxMU$&Wcw1CA2tu?V-DcXM zB|{e2FNrpM6NMVy*&3gASMXsOXle3GR?6<5UeP^jxQfC#!YYrmV(!~j!V*TH z#M3nH#s{fZ+4Xz~J6g}ha39o5WIc0U?RtlBRF{NHnvd@rA76{l6Y^@$;!I(c|=i4OK$nKVTD0^JP85F>7d z)#+`|VB1{+!fu9p=o6XD;zVc4&jIlgH3o}L-7CyKa`EE|?n_B&%MJr{dyL|fu>5pj z15Y@6wrog(awTqFjX4mOF)Jm?EIM{JmDZeE=~BKm+EMa6KZEd6Upg+SE(nc;gk>P> zSifum(O{cOQ;HODXjB45B}rS0%N~o#!F|llNrTUHY1jn?O6XEkBAwHErWWJr=?wV7E&vvy%iXef_mi)MvUZ%F_`$cN+dnxUFJ9} zeEb>V?Q6SY3bZiDBXg`>sSv+0Qc_y7^~5v!38YU#A74gj=Z4`DXRs0JxiO3n4mQ)p zLvzwRT4U(@;X)i@Ey-?Y1Xp}5{BE4;Y*}AcxWpQ9BFmvq2uf=kV3E!#Y~T==tKXRi z7l<`TT((Br(Z}E7CG3_I0WF){E6hyg=&mpf|>B8JA8HJArg@KNwW;FdYCR60K12%DUI^nHG! zAt5Ym@kIf>Wz{;eA1m$?uTiR5HfAYSU?rkkY!%KAzQz*aT&3iN^O;lB+-arBNY2)v z%pLMNe#fYxvF6QuBoin>{OEoTP$~Kh?e5#u1{uM4Xm6HTV{CD2E`q*wiq>vmD4;Vn7}X9ntTJA-shHqn1A{r88%!Qq2LyhVlN0Pv+35$> zs#id|)vAlraT|-lfmw*NIN(|pB5B^S?_ku%D$ib`x%;(YvYa|@nyss?!to9;eAvvU zN~@fJQ1@mPjDON;y#M$pB1xD#+$$s}=FrGI1Nb5!!#$r4U2RR-wV~RBs6&kKJ5U<1 zLg**&w)L^TdsdCErW~y7aMA7-le`n|z-SM(t(n-9;dY~)MtLygJWW$+8BqGN2G5mh z!xuNxKGastZZZHD9pmKrB#rFzk9Y0wUqIbZu&G#ac+Xt}bKU=l?jKB&#_}%T-C}^q zeKhLYmO2MWN@<&}--g%NN>zzhjjhK^mADsR3!lKUjEKA^TBsXpj5690-4J~%nTMN; z4b;>pmBf?$`Ti%a;YyeSt@4T7gQev@)oHh0-eQ%KT}^+!G(J@0v{XhMUPTS+=5-Fx zGhFyIK8PHd_1l(5o1M?1n3*z!FKbga8vyf(>g`8D`Do*7y9>CaemHB93>;R+*`5ey zW(pbNVA;6mDa=x!|DaXEtMbe&oTDH$Jqf<<%VUV;6(|+cg*o(8m-b|%%fSN0QW1yU z`t$cANaNMv=C|xcMPkPd3!AuE1Ts5zYd|jj?9*opR9B0^ReV#VDdRxUry(YtZ3$K$ zZWLS_RW|$_W4S+O%TF+z?~GQi>{7n4FHL7_F+bW#EG$ zqe4zB?7=}p*9*$S*f#|rn|SS7y0V;8vwU$a*tdFhFC=rMH+TBKFALIo2OX( z*7E^}8U0GAJ3ZsWmX|4>x9p_P0boCbIB1f2P28shTG*uEj7*bI6R_pbg>FvkCMtbH zB7_)0VRmOxC4t&`m{KmXskx+THw#<#^yX-PzMPyi^-9{LMdT~z2cgm&(HL!_x&|^M z8n@w_bQ|G7sXQo7!^2)m!(B;R&YxB?-4xM)nqrfcPw&cILwcUcQ`UW4R_`&df!D-Okr%mo9l2OWhtjDZ__k@q95E_I7MTZJ!@%FDUk8JU?8V-9T!e2u=J1F5t7A z35$TtHa%Qvy*}nfr7Z3?WLvA04jwShan!UBat&2&kM@mQ&2LJnj1=q<*n;if3vms9 zitqOr2CFpVqP9nGJ4Tf-3=$Ls?3FB-mQ(86Wo~HV#G%x>;M;nd^DO?fi*TEuhdaeP z1LIZNryAJZJ^FSxzm7%>13<%@sQ0^_y zTlmzFp*Jbj{0)BVHbvJ(VN1aX=G3Y!M754p{S)>grr``VUBjBuePD)^)ZSjcv$=b# z?84;o(~>G8WNG%v_`M;$33O&oAhQ#?s7UIbEdg6t8S@O;vF0>tO1b*@tUC&ywG5m_ z>-8Fss#+6Pv0KnlHEMbfBs`Z>;~o2KShQI$NJ&3_AnrIW%NO2#s7tp;->En#E{O;W zi4t#1)o2B!JanoXv<{13nd*?{AH!xQh4SKZ22n+vU5c=0#7akc#HQxv;^&Iuca^7g zby()gspTa?eOim3%|is$IY8STd=40>I+&VRuU9z-bZeDWEllY^-7|86@(2>iwhmAs zTjrvDe)ms3{NWYO5XHT??4>af^_ij%{+M@)b<6SW_|*}p0Ke#Us+g+Po2oTuF8=P^v`)+&avOf`wnE!y5ao#MpzfiFS0e0I=R1m|9t1nJ{Fdrd1S7hUv5xjQXJ(~Q*x0~2a6Az4HSdH~^p`>$ z(2mDZq{+X(Z)`65fUEoY_+TBdZ7#c13(``{7foLJwPg`xxR4pY$lZZ+f;lO-)%kmT zta~*<4BN+$1GA!+V(pNX(yx=6BkfpC<;ViISruXC6PfAd3~%e;6-lma?Af&SMSu z>N5W$hl_t3<^HwxFAx071OM{Cf1d|#t?aeLSd0%5!)alJ#*A@x zC8h80LT0C~PTV_`%1eEj9r=99?aON8OS}5ADX+}>$vuW^uIGUH!6;K>bkjMY1m*5@)WmO_sWAy=`=Yto<|dT z!jjU|h*rp39EjR&)j3<^ff*dGhWc7i;$|AbjMI84x1`UGFaZyq_RJD&te&jUdH%SJ zZGJN998fF4cA80b6qf9O?=P1w(;IUfOzObQo7@0dI)jEa^O?eMFE8|`QA*1+3!hq=xz&aGG@d-M{A5 zG*y;7cj=c>*WT5!^~9XWYYhcGaZ_H4r?Upl95bkB<$1ez5EocVFE|<%-)jX?ghCs6 z#KFN;Rs?>$+g@XlG;T2f>2AXXVq&SdCF(S~4Dz&r=4<1%d=~-^bK*>P35sgPmOe$Jh%;piH z0|T1(vV0hJJwl9dZsK;HIr(42s@0kc*|$87yLDWAt;Wy}3D5edeA60-i3Q2>9iVXw zbdLbWq!teMeH+c}XJip1sU|wcVy}r$sZc!Xyk0e?uDEAemDJLTk*KQUgq#DYo2tU~ zOx?Kj2F!$@;zd?a$pWaYU-&C=kZOprhEiSNn9%+h9y(YZ$Z88t>hB(*mZR6JIPAaN z*Z-v*JLjWU=sZ-|F(mG-3y!Kf;$QAqw7~~W;W5$Ew$7O}*pugP2Ju~MYdv?GiChfC zPa5bnV3H>W6IIm2ue<8a$osQ1e40K>s?XL^JMKFNP>^}tmGigmSquz6_%8p&X7{oh z;DKMPe`c!2@!P3J3^@h2newB~v}^L+om1;-XXdxr0*8*7wf(jvH%l0n06q(nWG__r z+;4`6t)~`3q$!9A^Ks}5@urywD=!XX(gSK!*qq>}hxsa(cvKlo@~0cQ<)#&3&jHd#X$2m|kp?*>CN(*34#@>Mc68DKy+I)eoz1Y#yy7j_c;CsvZeC|l`p%KwCH`tq!DbM_z?Ua;86hC9rlG3~d0zz&s?@C( zGQF*&Xv)&9Qa$P5k$5oV9RYW()y_%m1A2?pkO@}f>}|6@L>b9t7b)*93=Mq_OV_KY zH2Kj;==Xm#653?!f?Y^D1$O6avW6~*OMxdlNtGwUJ(1HvzY;$hmhz+|?uhrM_Y!k9 zu`|1oRT77p>H*sI4$3cr+K;JBOHH#E@I6wJYyL!W`HAXHJ)ozYtHzPRF{DSDb|6+- z$FS3*3Z!?H7u^J2RGn8GvGqleYP0B|OhRhISv*e@hnuFRq*>7t7%At++Jy=^eJb6u ze^Jb=!nFIQkM+Q0u=W5LukslA1)?jZ$J>wRJJwh+mFrf%V=TC9Ds@}H-bcrFc&-yh z=m2`fhD=Ys^HQu@vaQhxc*Ru;TAmftb~juo5J$Ml45p@dGK->-NeemtZAZXDbBsQF zj~UJMI#hG@f&Yu!Gc`L650E0^uB<~(jPj_I;raVVj6f?IbaoUFbKDVJmb{m?nXjQW z7*J`_+^(V5?zA=nmGjl$SU_#7AIPcTD!ZNMq25qcEG8+=lhh(rpGW9^iI(Jt5!RHn zl`^K39${qfc&T6sWk=yk>+rSFz>xhfHH+bK2FI!uN~SfK+;LhBmfz}((uQXuaErB_ zZxKA=&{g(K!6B1*bZ;aoKbB5vepdW?xIE3rE|7rh?8_=>k6rIhUC?N=zI0&v5jStL8s^hXCxd0T0uGQc*7jR<&pKgCZGiE;ChX2F#EN*DZfuwFy1nD`hXsx-WUhqnExS^2 zR@aK&Uh!9gifa*!GZ4W-TYG-~-YA4E^LR~E=@yVQyfuhwaBkNb&G|&vIxp5jp$4T; zRZ2C-j89thidxavZVNcfEl9D1?|r;KQ%}A;AD(T?&k?6AqM{mU3(G-jjm1->zCchv z1^o8kH+%i(nx4WXZ0HC_G(~B*_VLU9D`FMez!xb0TrDN-pm>KY*yJcT$X~1k+r>4>x zBq^6ih&u*Jfc<&4BNY#$FpM%p&A3ZgS%%#=)&lfQaoEsVabh8OasL@&%Pg<`jE*KE z5$^yQWy~aYR6R^;vmd~+%KDlZDi?x?!4!i89k>w)3d@hnc##{eI^R)A8XduTHM|%f z_^tI(T&TF6rbnSf{Fb8B^~ar(OYx6-3QBoGH(1HYWb}-&qbbJY(@axq!Ulu2Do?)d zN`2(xGofmGpqZ0k#2u#s>Kw(Fet&jdvOy#&YU#MvnBDPt-UM!MI#-kDd+elTG)rrL zyh1FKU-$7D%CbwCSe@`&Q) z?WgfzPXR=zkg;=FlL333hHccQmFIeT8XGvuk3+?ka0*1|OvZnI@}-7u-dp-{ZUla= z?)9+u**o*a5L6WDd^7JzC6EHFR)( zwu!G@lXq3;O1P^loKbJ!K~A*3jzEux1M8=B7Y$B<$jz7i{OWmDquVHEc@UhY7*s8D zyA{tp(kJ2AzV^Vb#PP)9^9MWTiPY2@Zqax7p!sp?$6*IfVZAT%D+YwO#Xi-&@Ma3D z-{jXM$Ara$U3GF;x*bEK3JQA=!s8#DQjb=^J~e~mD`^E-9ICI@pwuARD<*yb?gi>| z^XiA_jVz5vWhMIb1FhI2Zi z<0Gbkz}Ri0zQUyhpFNt|9%OH=cvv&H=RDzS5Kp zw5NEid`0m0G^6Lt{@L~vRYyY(<;RU@RkF6F&5hp%svh>5xSElZge3%EG;9e&3M>3%{}Y z*cco4dYcJTe8^hj5KuM*Dz zp*!OnaK2O4QUA@h`i@7O4@J!S>PNHt)rN6y5}6;0d!KRRQ5-73m*y@8!dPm0zlY?*~V?*Tu8Ir_? z9=MD(h3}1=<(uM)9hIY^E|UwjtG=N)Y6Pn* zovbK&9Bj19ku4M_9kM#OKjxrio=f}q;2A6>stXE%n7wN4SN?A0qsLyl>Rj4JiZ1EN zSnQcF51D}bC}*&9xh{pInsq#UB+%4AtlWk3kBl}$?A6sS^_S9z)rZ}y^x-Xq#H9*r zSY$>SiT9G?xrA9eonns&x}Xqr$dbVkq~E`mXA_&?2^pv}jk0;_@g*n#l%CfEW$x+{ za|`~x_Lhmgv2*mHS7s1y&G>T?XotF8hiMBT&KT5(p*Qt$TASN>2Hx!|u=$3(>X_4( ziFgp94)nVk`c|hmRMkzp?yEcenH3hDn}M-6Z>bI|YYFAlX(dzPVR@0{3=RT5^93n> zQcsAM#IvM^g$GJ7E*5989XFfI-E(AyH1H30FbcEd4I28yD-xCw9D!Af;?4bybY^w<+$;f@5B zkwbYetg6b`VjO{Kn(Avg3$37FQs9e~Up5#){rg|zdjIoD`Tth35J_3TpPzg-<2duI zZ&Az>ehw&gojRcPr=`4Hxx1GC+CRfy{&egd@Wtsf#@?0kl-A}Pus(HW5za^H_!d>U zcgmpO&J69&N&*J9nhSNDc0U|HVsra|sWJiP@ZT=i0@G$h)#f=r)23f0R~@ph)d1TT zSd>vi2X-vllVmrY{hOs@9|?|qLwN;%-q2UOGmxXkY`|=goP;e}^}av#>g!^U2J2*9 zvunVtH7+`?jJ}ieh1ed@8Dd&uO5wmHe|1fbUepL`TiOHUmJEq}K9mQxO)tLqG}O@{ zVdKegm1G@6b62HPn`j;7Z?nza!R}4)%M5x~Znpc{cL=Jh=9MJTKy?fI0a3;c+<_=T zp=QRogf22xrN%M}bzU=&W{De+#;68Ex2h#zJapx!k=Z%0^^^ zU_D&P-IlT0;fZ8t>y24jtM>H~vs_0eyw*TbxUMk~J$_jaV+JKJH> z>Y_+k3W_TA%1G~oG?6r71&xW(c>q0`-i7X6or}uT)*4ls30=`V`uu*WJJI1c6R!sY zA_G#?oY}6|HBT1n+Z7M6P0FwG#rM(6?CwpFmTWFjxQq?oEi5y24sNj;h{J^r;@=Wm zG_OArT>BPtvRZpKm%eZ>>O0)Ouw-$A)}K<-rGe*g#QU^e{)+;~X4N^s!lq}E`-~yx zRppmfgr}UpVw}8X{X)e|aj7hue1-;Fk=YK+=w9LPS0MMbQwJ$(cC#l15Kwg7PA7v3?to3ja{z*< zvwrW4C*{bMF@WdTK+oTaYD>20JpsgTx=_FS#ydBaxR9+e9V*&TSmZ%C`)SYinL0>|Gd_h~UBGu9+LJ#u1?ic8*yLLMGU@5M^eJ{oo@6 zoc5j4=`CC;ZoXUu!X68{B!!;vuLBV^T-k2S(eauh(%BA7hy2i0#6FIL8VWMfvB`7; z4X)(mgUy76qm2-AkV*W@@lx7$M=Uk?j}Rl&hrdkC3IWKyzVzM+%sJqC_(>Lx!W*tr z{!^U2;}zj$b+!ralivs;XQ(rRMEM)W-E6A$7{9ArtN|`Pfm1|d+vE0gz!lc(f8C>D zikD!;emgv+F+7bv2PDmgbq{R%oP`SbwflEDS=}qtNgwSwoc29E^WS0dy&&grE58_c zaB%ozq`Heb_-M8a);ilwZ$vvz!+-xSPN*vdA4(^2B82mh?%)%(jr+(z|7Vp93V$cCI?U{p`(Gnr&7}EYS3ivlxwOg6AS{ZKW0nzba16-Jcuq zvSuW7Iy$}>v@eI{&frQ5y+ z1*eNIgjX+xS3NP!jI>!B3$sowWyzb5D+Peo{<}Xi&IgN6;|W$HlP?{ zpQk$_$KX?4KAG62B@1KG$QL~3l{xtDDK{{=dmhIVtoaj6?NBJY@@MVb9q1mrmBFy% zIpC_6nR8#PzCFh?TwJtRrUfRAhtwB&-VbKRgz-eQVCeE;|5 zFXTwOEp_h{tk}~U5$!i6qNQ%LLsj=lfq=M#5sT^@bre$aXGr7fqn4)q9sgxk>fW?; zT;J%Oq30E9mr;;h7tpBNyx&6UV(hs__ zYvTRYpgO{81~(xF6^LGZr%JwP*Y@jr zrZ?NHhcwQ;fy**N8IS5la2Tezo1{JLz|Dqjw@lX}Gz5`kNgHk%ndaPJUs2=yeQsww zQ6Wy+ZCNX6&^pf@5*4TZVhul;ER^HV=`Nj=@-n;?3BeZTbR#zvvz%41{PePchUQAG z#`eH7UY9U--1I~27%SPbjaY%oz)Prd;Sdx@=q6|j8n8dZuOfJcqBuES%X_V^)CEZ= zEU5E;xiNywd?D!VGlVgA7Z&R=<4Dg3U0$hD4_48!$K;ti$5B-D;oS})gDLnd zpF56wr4QP%2);Ga;t|XV#Ff}SoUjcZL$#VGZm9d-7%;Q1@|(zF7*kNPvwWuyY1_x6 zItbmyLskZqD6so$tN&*Y6SpkuQpmQpkCB$tA!FtnU%=s^ZJ!Z1A<=h7;hz|!l+JE? zRrWY%w=@O9&e9xDIV6@mKCYaF4Mt6@m&Rdjk}pT`+hj-ebVfaB_@dZ4==g`g2ZFEk z?ko49-Tjc&J-YjX9CNN|Vh80is^dRf*N6Xd>mnCMP?4`eo$6uurxk`{^jexR57@+V z=2WDhq9KP{(r+(xgYN7yV_g?YO5iK_+-VAwXP3&6i@t z%~vy?(x;vao>u7-RgB<^Fa0vzIvBpDB$hY!0pzH}&BwQtFGzF)X_%ZnZy&yEq%9o& z@rK_)Cfw4}W>LE6I!`6hD#^d0_feOLHZn=)1s#H?9O!nJ0nC8!-IU41 zilMk5QNNdHD0YMzN4kJ-jY2fpPg|uXW$%>QGpCguu9aWy^@+8_GZR48bBa2l+NBpe zoE#T4vTo%11SG6&b@=$-_AmS{OT@JnI-n$u?SOUqmPT1R7AA8ApM#BFTithvI1(*f zdI&qZQiq=9aJR}!rL_kaV%zifcXf~b8pl&HXWu>)}VAA|ihA?#~>u=zIn$~Q31T5Gg~s5NJ9TJ{ej+qk?eQA6ZhnP(Mj2#DJcKueZpi(*&21!?D71S?pHi)z=sEXpgWV%S|)M)mG+aEI=%cs%BGgY@mD(f zboR6L-WGLGNxIw?=}!JWpqT5J3O* z^`0aqa#GeSxxaPe&JV5+esaau%KGi}{3`JSfhLUpE_#b-MpEdxCrm2w6Ri0+ESY4a z-VsS*E7n)m?W;;CiGrJ5cu%*AF#+!=*>zcqf~Lt368RdJQ`Y zY5G~OMOHLc?csBYMr%O--G8*_|2G>qg*HQMllutMFoL4g21tDqk{qvuOT4{gLr8&lZe z5SB0zUc&7i5_B#yp^oZO(%;s1znE@Ie(YC8xB$A?X`9C$^-YK$k# zdFO(+@>BbFCuB6F;bNp94b~^8rojqt9tGW>ew%=>h*N1H=y&v_v~tsf{2E_b7kK&9 zI@-#4W$qU)%+^%%aCBug-7@EvtTo(3eAc<;bzuhE^%}DEI1K=xSNM|x0QmS#w(ZiN z6d%a{09^Q;ie8-}3rI%>kZpSccmg1!qT`$X9RQ`e@C|SQ0@x&F09lGV04M-JMQ6Fm z3*fy209yaBo$1U= z_3Xhuq4ai$5;q;`?XATZzg2R7L1>wlp1@W4u$;7S^A|bmnTga!{JA!B@l4- z4YFySELjJF8g^;+%RoW^{#vsIbQ@OJDkT3SjOJPTZUkY%eT8aR>l}b{ZFyhUfOYMv z+R}Q9%%_Vo4&Q;dcOAv^?Xk%tBRBO3Cb}@OX3Z2*5V}dWl4<_ceav{haojU@IGy<^ z7XocP!D{BIU%1mUU?uA~cL;CDsc4+d^HoJZah?j4!)=`^s9|i<6L^_x(py1&qS#J3+&uQ&f>*iE0R#!j$EjS1E?-|PvM#Kj3>OW;W(VA+Ce9z`DH+kr7{qf* zDMh$U4nDvwO1%sTZHBDh33h$s>JXfn5fy^k;duuwFx_hJJRNBCRf-LA0Em3}cTT(M zvkXS3DrJ>+HFnu&lxS$^6n@KEFG^DF)hy1hrPp5CEj?gmGH%x944d ziP7;f(_xniSCTByN`8f;A-6?bKV%?DmuclRBO_W;h{lvE!l2k5m)C>m;E+^WmcI&@ zcS(J3W{nfrmUTZ0`y=14&d zm7%Ad5zp>~~DHiD>P^!j_IN|S9V83rWP_xo)EXVgqM)T%}VS6LmW8ULZA z;@&>L!L?27yZVn2er@|hIw0`vZNvxY0mrtvWS7jVPi^mNjaRIpok4kuLgq5VxCFDD zo9lfBu>;c2M?6$z&03$@9p}~Ny+b>taQilofA;!&Xvr0r(qArW{#_dZ04@d{oVDYQ z$eh&NBKl1hkz$>b$-HT$;9&Kphb6Z*TSh`R9aY4U+@7WL3a~ueOf$jo*uA*r4T>~H zv7$Pw)40N^E$u71+pPW{%|glB+|GheRQ-7xj&!sl=RY*d+wA%kkZUe&ofImb4mYEN z^n1AM5g7#41Z50eL~Y!#lM+U@O3yTWj=YV$!NAAHa2ie`|&U9f6sr(|7P8~O=v1+=%?PlWmkWy*YR082axplQI^l`wSM&vC7;{t zBxRJF$kZQh_uU~m&Q6dgjAT9E^rv-)ADJ9=e?7_VX@|XMB(j7&H*vy!X#RapO?Rg;Y$Tr@b@%gU(;zWuA~~?$Na8NlN7r)z;m=W#3h_&r;yg-is=Svtc<;@FV4O0 z_gapVjU@h2GrwGCFy-|FTXC9Yji1&8i2VC|KP~u=%;y(1&;beCXz|6JLvhz1)%`1b ze8TgSIOzDN^bTWsJ03$~L_XKm|CQ(Sn`zJw(`p;FY{wj>&&d|IpD!=bk_wBu?q1uv z`(5WJue#&jb3l=dK2%m%1MQGTf+l;CP~|_;Px9+8^=5ucQzNW+USYEsNu6V9A60p7 zp}HRwt}WO9Xz_kOtG#e}*&=n#H58>iDYxE(aHoYv81AzqYqij`wsP%ko3D^elUyEN zaGEN|DZW{kUOZyH8jDQqt@B*7*gyv!j)h5Dxiphv(R!W{`yW?+(anE#$Vb{U@+aXr zx=eD3CfxU;kE&T9sV@+J^o3N$MdYyItc8WSc!YAP6gxLH6{Pk|6Yjsdy!CN$u6F3G zJDutFcLVM8lON6RAoEABC(X`g=(D~0FlNsou_}i}dQH9diyXIhUE*z|*ypw0`L&)r z=yjc7Q^|^uxZUK!Y@U8;FI6H^Bl7yvmg0N`fDPmGUpWPpnP1<`5hJ~qo+`Bw#1|4&xBUYkOEc=+X z2cA;(#=zu_#!OYu<{RAD%*aD^A24)Us?ea#`Is?yFf~|=$!h8#RYk$B56bkquXOi8 zzh@^)c*7DlF2mb7bT8$$S0%($XfK|r)gA&>U(PZ!iRbq49E#C*6}9eXo;S+Cdq3CQ zGBgTSPWw`Qa-}LvvXg`3M|_rU9)cSReRVf5ZfMh~cPiGaO9<+;X0m3OIHFAzzt6n) z48G^pT~a;1l)Hb3&qwL%^*v7XDXO+2)t9_(n5z-`?$@L%X-QZkx}|1Zew0A~2rSgG zFHTKMl(Nm9e2;hQI#c0{M0RQK*>lOgOqeg5TX8-e4=ouU_eyV+AgGB>_m?HE^CoJY zY>YqfwI1h3fvSPeoWH9eO1(&*IAAs!K!zCz*Lw!VV*-p5X9JRWI>nI6MGr^wT~M#s z*>V<+{&=XSyz4}VKvg*ecG85b5?4Nac zxtF%#!uR-;o>%FQIJh2A!WEYBcb(;=ZdE|czGDz>VS>B&d#i>pJ?*Jb=VCvt??a)T zRa2g4EmN0atLsB7$Bcpegquf&B)i6|~c>dn)GFkJr@|MOnM*{Fs? zPOs+4*E0==8ieP!u|oyh7dCB)Eh|V7*9$wx%KowfX7vqc7CIl;^%-ix?uV4xu>9&& z(y-rO=Q}vrJ=yW%cH`_=pqS(-xBn?AzV&9{AO5ivPBp;qHQFP>vyD=_BSG1Me?%I6G(nKEdYsb4*2Y078#YY^| zy>W?3=YUVm-)U5>{=CQ^?sKm`yLzaIZ9B=f!))-`k7ULp(@$8g`rFBNi$MeN+gVQ^+A)7zDs>dcS0#qOpxf} zut=MC&#|<#Fz{e1K#6WO!1b0=Wf2C| zW?*vC!?1KFhGUe;IwKRVy!#D2C&WZbW)Xk=R=|`J{=cn=@ZWB84tknOU(i3gdnZ8f- zOqJdG+$|i{Hn5NT_FmHecUHQFoZ+Nk-OmN3g~U#}ACTsNDw zF5SaKL@6+F7`BKr4Q9Bp^KkOIPUJIl1x(qY5fVVd+cfN6F=3~+C?Q2_&Otr!kY2l% z$z>?rHh1R?DrCP>hMqAX<~5mkSy0l*BQpBSf&p?30?z@3 zyJIJ+ijU6$!$#qk}GTSJZ*FbT)H-VKlKm5pML`G|HyyJ0QXbhTpI?E z&ic0#{znQf0P|>@f4nM8;ha&hXH@s5{$ffC*B=0@-~Zx)zi-k>c3O!Odq|%Tc|IWy z(GFAG16s&U76+7CAu(D+>0>2?zn~hhHN|J{G@b_wrrb;az1wuNW1hXz! zbH8KmG%uLDXJ}q{+)&Nh#nDq@X@m6bitSRExBjs{=S&Kl$jRrUifW>E|C7{@-*yyq zRC=Lkb74pZt3J{$BP9A zxPEaDsZtzwylskGALnO|Y|xriGkoeRu}t(;=AtZyYWR9`O<0EOn%b++kN0SfzIC)nSoOPk9O3qlFiHiH zO>k)UGDVT14p%Hy$FXVCjb;21WFWm(c=N-gfU)S|wE5{7)eh5-73jad77(q#xU6y{ zHBeunbpm|pGzsD*ebGib{@_}Dp!Q7xn#sw3`i4NO>^}{?luShDO;Gk6xUglFlq$#tsY`fwR;&7lJf9JBVjT5 z>rFU24hRHhV7L@4zAN}^cobO5&x;M|N;>F2FkseJ6zjaJ<%ZY2pM*X|8Xi7&++#34 zI_ivgJOBgYfEZI}9d=S2HEwSC>It)bK}7z^$6U<}VdC0`ki-T#s}yAv;lLzYn^8tU zUy-nX2(0%k#Rz@vgBTE+HIy!w(u-6-e@Ggex=lYTF1WQmV!c(Z^tIikMjY>hf8J5Z z$fv^wdbd~UH8c>q*0q}!+FzwEu5lxu!iXiob=-_UrqFb?`cCe*wssN4hqPuH=*j`! zoSZs&d9t%D4f{CdrdJ=`hA!V~{LUbTA3#p_>U&OJe-fc|T*wD_}9x)oXZN z{9Rtghv-EYAD7C4s3;Ie6M<1k3F5B%Dlz#;AuI-lV0~l+H{wn&f6@njq;@?lH|bSU zG<&9KacLl=WA7eL!(kqF>G3YAPuk3tYcdHbU9B}4lo8dZJQ^hB&c^=C_N3 z?bL3LVzH>2c?B11f+yslqw(~5I}mD z8hUTOah!S1GtZgtoag<1=Y79FzWqnC_iB5uz1QCBzVCJ2*S$BAi>KgYq+VoMLQS%Y z^=%Ub%0gwNYzPyBDhnga9J4Ugtd=xr`n{r1={2BDrFj|W9piRj$AMkkL%yXda8;I{ zQ(7w3cCO%#|0&iw4QS~>$0J6!i*X1EeZ98i5JZzHaIj&ofS6GB_671s!)_O{jc<>d zO+;nwutv$13J8Tl7JYD8gBX=dz&D^d);W9F0mIu&JDAT)zOYMi>oQ)v?OYD3$zuYs zNJ61g%N0gL(--i?G*`b;7raexiLM29^ntoSYP9GbfLYiOVHrr8j)k^OKfmZ@R#w4^ zh&RN|OcQ*-!iPem0-NE>b2e6T9*2A9KHB|klb^EWdRaKad`KVJt?TA76013s6uW1H z6B}qp-z-fWDAknCj-FHStyx5RRn9-_XAK;N^vF?B>u^`c74WUB4oOGgm#hUPbdw7u zR%e*N?HZj7NMaixUx#{;=^2VyO`H_(Xh`f4crZ(r6~l?~+ZDeoB=_l0fx4nYs+o)B zjn5jC1`v2fvA4t}Rb^I+j=NKtkpRFjLY}WDPp3tvC2tv3#TUjJ2ln7GC^zOqxH_m% z5-y7o>=FPMXOoLYPebGi)jrR;IC#^u4e)>;qAX;Yo?QNPS$n@fcw{KWmm9r`@+}%a zgDA=hN9AcnGJHVE!$!hN5( zBG|;GS^5mfoeq`P*&^i-g@Apb=A@zy@D!0Vxyjq4s7j+#BFe*xVpj+)r91cMO!MFU zbHh%ElAqisAaP9ogpMutJ;pDhf^s+eB9mEOs=Tj>hv@@yZ*8Wolr^UzYwW1ApH;XEWX>&IV85EniIRZiVdq3_W zIej3aumZCok~6#z?8*Pbvodv$U$*ebbnOnD_^dgsxbG<$cuf{5HLcj$CM_im?|aX{ zEB?a91^j7ySQqx*&^_43H^ z>!n*-PBdSFWw@~XD3CXhonih!ubS8m<{j-EHxOX`O2-H(qHekD9Ngrae`C)0R+JMX z!9!01)pM}e)GKE$k`y0l`xU)gSen->?7GMx94|P_gzqOI)|M2F>xHCE+Q)kE`HsE8Y%>zPV!UkfrJhKz4obB2ATb4ArQL1McyuYjCk z`Jiu@ue0|96Jhf`k3Or22LPfgB9^?> zt3zonr;R+lFNa`{*s18zBuOo=3sQX_t26<)<@*>!K}~MDXW*j$`3p**`K_j8YYS+- zrg3gF+3y7m)_StR)}wq$M^k_!2otTG->%o#R^d%gbEzY$En3!P+Sq4OfTE3<3_DGY zVOb%K9Qe6()Lp^~_Im8K{)+exSujj3EHECK71X{os8qEs;93*CB>4hXieW(p!*n2! zcCgkL0poD1PDSMU0omQK%2G~!MTg4olgIKl13DWlAnx!(| z9$?reXMoB5oWa&>T$YQo{B5<0wiKbAHP`_rpDXVhi01FNA1=~>sS9O$uR{Kuo599( zGWTyw=gvTl)x7BXD%CRp>X(&pKIA1B(-?EF!tFV$CR6X!S)_0e)d?j6@7RvjT?yiU zI)6~6r8{bl&&A@&8YC5ZLW^i_KSv>=0t7O?wX`U)_oEJUOBraKSU{$XP-)9!T*7vm z+!->y@y*n1MH{18tCzsZfH~#v(dI5ZF<-_VTpNI%7ULyl`f^&R-VU1;K;&zt<;$se zeYX8gh(DM4O>58d9lmYBD*$ZpBI@;Wrw%M6h`L`QIN5SC~;`Oo< zQu+-gJIDPo6L~o2GrAf(E9dzl)@)yb!Ejibrn04LhDyqn_AEuq&UJS3Oo8#e+Mb7z zmEwM}zN9*rz}+5t8v^KNe4%4TlaX)Y;%YHOh}!06mrJ5I@p{fcc?4+hi1 zW4Kl2$TRDVx5jCfxd9-z?VnYXcP1egH0@g|V{?%vi#^8EijDHjvOB%C}NbzL@Wu3tjEQKJMQ4!E4Q2= za4+)6f&=|~;AOmBgl(*~fJtogP)5~-^ufc9S7#!G#{v^(+5@lDG`B9<@GquMZSgZ+ z8ntt@RXO6wA9!%AI1b;^r7F5oV0d>m|G4?5nV;9~YWk@k-TK{nZDiTXoh3rf^;6hc zWTJ^rIyMOMvo=uOj~=y>hV-^}M=R2EnA<(AB99}?YlcU3c8|1yBK9{o0`ETj)ELJ;AIB9c}{SERJ5|RTipE2R3mJ=ig6g6madqb%JzuJbYZu^Cf?&l^TvvRUJxN~7;2Oy0@&Gw4k;Ag8X69vPUbTD1r zS|KIStSv9EI19x#!4;qRu%S@S)DX*w3{6dOCTI}^`ks-}1Jv8gGL^<4Hx(5p@QZ>b zuacEdmh}90T;vz--#e4vjkArnHW9*h*}slgTCUkD$qPlKt`R62Z|<*}lZ}&DMQ*gQ zzTklAN)XbbGnqUIb{rGsr!F~fFsOW`8@0K5()se3dvRPr)h^3Is51V7n%-vNCHgE| zd$>R_?(`Hi;5Qmv;8eR)kC)q=?g23_pc@W7vg?pz`$lBIgCN0-&)k1z#DzvD8`RU_ z`$B89)zJ^{AJNmcdm(f`e|uPEV}hks6n>_uQDq}mKO5vz+YszW+>ciYG*|=WLqUu- zXh4Kb`9U|Xq5vd8$2YJwdU>A3J#)IZ8-Tkr3*hncPTf`zD7GFJijn6Wdd3HXTv+sS zYtG*x@W7XZU!Pjn;<@ZRpQ3!rQq8DScvZLL3z@c#(6WB-M z8dzRs0q{rEQ?S>&64l(?p^o_cJ|%{It}cTNC#WJ-afe~l=e3zcxzcRCXDT;qr&yB+e5E-$aS7q ze(>Y8GJ+;fbQL9+uS?*(jZY(`(kKttwazI5hi*;=>ylT3m55P`Xv!pp&EMMjy_}jx z@}Q=mmZ?%W%&or{ES5U=0PKNnvCpv(zbBp23`(>gzvBT7tbLLf5$SQfS?V97lA1r& zhjIihD{@PM4adegl=G@sy-CBR6;?Mv%L1mQJ&GI;rEU(CMQ1o^-8^E_eyEZ8`SZG) z?b_tF+1dmmMluG0Us!mPoPC(n7J`q3%|*iV;w~=+*zGL(lG-IB8;stUcY3-pU3s13 zA{4X^Tqh%P2b`Ln)0>`zmOz(nBWyL5YVOS}LYvR=ndI6;c0p5KqkT+p6X@aR_zQJMamYv8& z%ga>U1IHC@)TMCBlII(Z{O!*mWr1kgZ5MWGxw&ZKb`DpiQ{ODN;?+D?E0=|wBv4>( zzN$sI!l7q_40?r}Yol>+UZ%OOvDyu*)~%|*m#C%)wmD9i%z(5>fxzmm^AIEaU7TvR zPlRcW{sAx5f*uCB+2*LIqp0=z_49C4TM}vmCE%FieFfI$SU;Ek)No3CIH&n7S&zmb z2(UtDWE51u9u^srT(tap@tLqr51cW~p9yvga8sD#Tx+QaAWkA>l!$C-O0y@x_kEd{ zq=L491zcHvexzU8xrIGddOJq{k;aFah(Zo!4%>EqFOD+|$ffw;qW zukAC)6@)K+WW!WD+p1g5-g1gYnw{}U1R9bgL-wgpoUyE|k?LoU(n?7n$@KxUe+>kk zNm8u$ju}ywt4;Qlm<`SMM;?mq{h+dRTyX=s9t4Yk-410?y&bmpT#i%7HY4>mmAi%q%dGSuU8ArM_PE~+1F1?Ph(Vr+O`>P^nvg}*`bg~ ziH*s~cabwgif}-0Ghum-e>nAUqjqD)GCO*c^=Ex|ZKbTkbpCvMDGM0nme#FBz|R%E zP__9f=RT@^Z3JVpob)z6JhSnvLoum zTAW~Zv&~7HpP5g?t~4SvxVJg=pb9QPBQ?$>LwX-^si1dMX1p@Hr88*jm-O_afv2!3 zPoA{3xkM|Xt#`nM6_`%=?R@?wsf`E8huW9bC!!*iivu>A-J<9pR?mG#!|w+qMVbv> zH2A{736pxt5PiG#kvdmZ%X`+WA!RDSX$S;W+y%TrF+vlDWC&>^SK);QeYPP3PibmF z&}74x?afw}(W&9ksgG% z4`W^C(CX2nuXOJkTyCZ-9q`0F*5@gG0@H>t#^f#TN8Lx~hGNbi#|U!eewW$)-wnq< z#@)FPlfyfjb&Wwx6F+9&y_61=!|z31Yu$tlrH9ZnlC@C+dVS3h0RAI^pY~p;jhm** zfIdF^lJfp2T55m8$7bwatxr13?n?lW3Fa8`xb^1Ias~6*j{cD3vW%#wKKl=Wt8Bmj z-qNBxa31O>rp|!0OegtQn7d-8jn{)VXZ8lFEo7g(^!Ny%@-XBf7{e~kwXPR|J zocchqr+q!&!O2YY@Z`xeE!VM=zc+W&c+~%XuN0~+ z#Yz%8uOfEJWVJv$5zh>~zuy3--){pD`~lt9Cc>@Ili4_=*e18XT>&i!THG6&oggIf zskJ$LYT0_S?V_J%{Zfw09HX6#r5ve*nD67M+KnN*Qg0%^9NX-L8b>wn7Vu;cLVkbK zgbSG{#Xx+502BSg43+w=IT~O2c5^TWD-a<|j9X9@f(c||-sq=gne78|m`ALnwR*AQ zV}X4)ye`Y>en#ftRc!d9vHJ8neS#Rj6*msydlicA!0Cp!r9&k@y|%;DvK+b|oX^TJ z2ZDR{Y5`oT^ur(X#@hBg>>)#+Svmj|JsXNBAMJi=%PK)iKIvY;6kPXvLg`Qja(9i;qg5aZ%Ex` z*5b3J0$Nd|veNTYuKifm%p{wUaFku9u7(_adnzCYl`3^3dX%~3B~FGXw5}IsJ!nmm zlnvba5N__yQ(v;yTtpRi0^~U$QMy#edUnQ-%Q>ECp?Ny=U*El8?e412pwtlaW7e8L z)em%Z=V5ELya~^Q@Y%6D3JKSK+ZhlU2UZ!w!t4}G59?`=sAW|sa z8ZE1%s=o2voMRdppCyfquixu&&_UH385Y^R4N8Y&nZOKJ2CBqOvE}?Qu+Fr5UA_7#A;fut1hq^VUQXim;|j zqs?-D_25>4KlfG?I~%4^lJCwb+)i(s!vuai%}-VD+3I*BOj~E zpX1^%O1>8wPY`A@I$^-p32(a}FVy){Z`DyOjOpQx)mv#sYz{-g&m*!NEFocajf8aY ziv`06l`nJ*?ZoG++A4-`K=4c+1(YO{+}x%7=Ny${nIG)Ef@cl&!H791=Mvx!&kENB z4bkI>4#_|0aOz3dc0CUR7Ap{MF)$e%h7DohB46p;`X(c(0Aa5v>4dKHm(`NZl!r@5 zX~PMy=5W9INqwzG&>)R8#KW6j%kb2+d+lh!{k#P4I18IYB#-m@a@!i$u)XU}MYN5b zD~t`_y0uX$>D~Qg!8quErKIS+x@TXk9VwrPRA&;e7_D!b8Y$aJ#kWMB?&8?(iBw2- zTfo^M^Caf&%8(wTg6bM6mtri$-hSb|BA1)gDHqU2qoq4=uNYqX`E~z&l553c_hZ3{b$1QNecos>DME?|3FdJ49p@c#Y@d$CPZQEMNfLA#<0tsMx! zX**290itqIy+-pgrW7f_D6IGSm9*YsxFcK|f?>v27j}h)ZKP zoPTPJOPp2Q!wC)@=f=m`yVwL*_E6 zhh?hQGhkcWL|tP}Fwf`W#kD*XPn*SuYB=eMz~g=!b}L1=oRC&dUCRRz7ZlK*!6KhF zoI9!aJ40j?>K^s5rzNCNJBtExOm0NW5GuH=;uDdRZTR0 z=Zcvkf)o~=K3CI>y*^o**J4^E|HJIIn^yx#yEB-GFIf?XVk6mhVqodzqdDK!$h-*Y zndTXFXB zt%pc&$U055`hp|NU*q^)g6J}hv*0#a&|ikUq{%>KLNq{Tv_h{CjYWe$U1@;#EKPwd zPm_`URKtmo1B03Sb(Z@wp320KnICwhvuZ+sVVBzbf|vL;T>;V&_5-IaTO4%Hv4i@C z8wT2pYvqqN84q`*KWsxm8dm309aC#JernNe&SxVKhr>6t_fyxE&WBOrGYxo=X3vt7 z+T&<^I(b3Qz+ieVC{l#$pekhA;;{;PmxrdJU)4VyK|o}pLI~BU)Vlo-sWNhgl(^6) z|5j0cC)N~l$1tMCle;u1H`RFdE8Qjoe~+cKA@7Y1EfCp4XA%`s2REym(QgPa<#AL4 zO?8PIbB&f(*$rw*X`SzqU)SO7A@}BCybd4Ih$65YP--!tO4=yj#635t{mGoXTQxn5 zfd+w-T097PwzQ|}QJ%4`v|`9o;n)Z3qTs*TxH6D(?4`3Cr4Heq8tigHEE=jwM7Tt4}c3Q*n zzzuk`<7E4Z6?&)|$Jh*syuwcdvrcFl-M*C=emw#0o@s!nFQgJIykbrZD4|E}wgFab z9$)Diw_A0hKoN+#+i*ei$8oaFtIQu-ZlCXpJc`g_V*pB-SCDdjR7C^*q};qVhcu(p z?KQLf5r4Xdapiu)3Y4 zy?2|$AhsDNH49m4J)=O-n``VuiC_B>!z;|^iwwX2(N7+U> z%j=7iU+Fjp`B^z{V!W$kp_Bc}T7&fYV>E|#u-^&{f;bQ1$vDON}krc5Zf zVx4~C$#5fy>1K+0AV{%`2_gI>_ovK90TPc2!qDgRt0M9`!T3NKE4|Jbv6ziuBn@Ol2-@74GJ zqxv7a|88|_yB~VuhSu>5LS=gVMwiuy^q&e1NN!AE&wS5Y5~TjP{^5@$F5q|JVdwIr z2(z$eZ*6U*Pi6~JWEb0ouXK9zLzl0XwTQtD#Y!7~$~>AF^BK}EHeTPauih_7x2%~f zo0Rd(AL#l@hd#J^P$e%^epz|{{r9}-%@>}V)(<(tMz|yRC;z^|eYr}`%H^L>sq z?n9TleJlT5|84?p;Cn3iZ*j%RBDr~5*{)^=ap)V2#=6O@p$Y>1 z()Jm$km%f`VohgLm?T^2zMR}b`Yxtfd@k@LZ6E$v*(E3mI{=V_F<_{BHnp@B;=t>( zX>zFO4&SnoH!xLxUh~$aL6q>7-MnfD#Cos*Fk_&ypi8tNr^uQ--<+5ih$rhmxQTzN zFTaHP5Fa<)VnIxw0BPqHz4|nu)@m;as2mD{CFj63wv7h>gcF`+8ms^-jTcz$6%&1; zToDTIk;lqKbTvN9ER(s`n;v7tHq1X`*#uMfvG>8Tk8Ov9^xHHPXtH{ z_Bkg9&4VLLB&<3S^r$b%pOv3F2hHU4ttDmo%B#8FuVA*!NWR5VgD)|m3=Z3m zxjDD6tz9=vmOn?*XR|XCDm`rjW(h4%382Z}5pw>4#w2gHzA`<>nfkAEcWFLi$)EOQ z7lwuaUb!L(l8WMXQ5aC<1$2^Dfxi4nME{+oDqO=I$5v<5^hkksYI%FYgUjm^Q35eK z;~9z@>?$oH2^V{Mi6~T} z_LC(3wltdVt;&+HyYC;Wt{YP(u}Tnt5crHREzT*N}DDDOut< zNr&PC7u*|<3Qjvi?1(2!+IjC>NwWtpbw~3HU?wcN-ox0Oxy#yk`k&TULJL*#t`_;- z7etPcZiS2KMVKc=g?|(J;k51 z^-mW{fEwzKT7)Fdw*;87Gyo;uoY6*0_QpQE>Vu<@)bb_kHi)X58%7`DU|*XYt(I=xaiS1$^UwLzI@Vd z!6^3$lL+|t1kC>91X)Fk3w2Kc94>}NNs1cLdOeC0i7(lUt?a5i2fNsu-Yu4jDG%6abh+O!oP;~vmz^rmOa9B&|<%4 z&C-ij>_^;qk@YNJF14f3SK1+ylrw~nzM(So!C*EXWPcax*E7wJmF4cdEQ*X5!V9ne zGJ{ivu?w)z5&+8?ybo2<^k7TxU5+}D{xah`?I%(DX_OP!I%>i(2QJ|0{E)3Ey^Mg4 zp>48jII08Au0$zEwhBPbg#ygZ%^2I6Zu`tkso{J3C0fCl7 zi6~gk1Tz=3Z!=kcTEUqNl^xT_*0TJpT;!5BhD01`C#tgc>-K(GJzrO{=dPA|JmfvpDqMD>;^v_jfS8=32^*{@ z_C{V^#x->Jxh5BTDKqc0tJz&{XZ0|rG#;Rbr<|aW!l){L#uPP78}8LCjmF1R@S&$Msn<=}qoGxh&bD#eRK}b*v(pnoY&Swc!jV z61-@+BuK0ARg^PGaX0yJleg#U@%UG|ahkBbeW9(j+c?b#Twr&j1!(kRwyM<$6$`1E zPdw8NO07e`}`O+i(p?Sqz)P~7&Q3&v*mU)KrAIe5C&>n#!>7y)Sqg3tn1=J zn;vT@Hy#LkPKWk6(w*XThMGCHGFotpMYdy?`36Hn3tgx+F+6No^Tx5=Oz zt4#gu)n~-HZk5Je0tchLo#rG*U+DTm7-!TXR%3frnvH=Z? zknq;o<<~GoZ0G62>$ax{KjBZZW^0t+`owm3V^c zEwcK>Bg@Q}mxG<^58>yxlP&t$>8-n3{UWL2S1mi#Gsh`zt2D5XNO6F#lIaisy<5Yd z0@|Mt%71dKqPaJm`(pv*yKweP2zktberTjIUQ(K!v1pb_T4^*}JFk+_UBK>g8&8W< zRscaF-(XM=145V;P|hS(4mGFbv_p5)b_FDDF7|<2i?NzBDR$HCk@w}>1w`V$(&;Bj z7+?^+YN-!pQ0L>ovA+FSUw=O5-fyH0(ueC;S#-nu47kv@OLa6$@3yQHPYD ze#%$}ffQ#u=tXZwSp9hUdsZL`p%R?Fo-rQs8ZBU%s zppoDO0tHq0ae5iWvHeC^mOX(=Rg^6oR= zg!#3y7*5MJUdowY9t>%ll-uzZjGTSFX)WhBS%R%|y#1mhYx^*`$Lsi=*Hwv_ffZKO zrQILq|7VL9@V@?Iu^04x{Tg)oyU;dF0L;GWO^~T{1tqh%e`qq!1|gXFeqWoi7`XHC za9|~xMttc)f3u|A)T1Q~8*lRyKjzA>F_3ZWuG|1I9)>E%d+}CrdoPm1_~YMfOMZD5 zJ|@tw?-)Vt^t?$G8)Vnej;nGa&*wWJtTErKb>*^{Cxj?ylnlV`iAh0O=rd9 zMXil8jWKJX5?4{mDr$c^!L6S&MSx`>qj|aDGz{goAz)rn_bcpl%xVYEQ?P5`BaO})gy=g1~JuDN4OkA zHkJ4R=`l5F7_r?tNjt5{G1_S|Eo(M_2HC~uGoPEuuxu0zkSZ)JZX(sMwVm*kcvWf` z6ldfvg;?D#y;5*UgtTn43ZL|IKN@$TBYSy0KqrgN=$fXMebHRYL0EFpN z^St{pMu)?7K{>G8+&ivs5u|nX3ST4fR}$JlM4!g-+-6;$CTg`o|#*%0nA`7ZbB{0QM)kpp|o2K5^d}Lh?8{;S7b+IaXQ5h1h#}~+p`Oc6F=zL^`RX|Rg zS#tVA<5I2Y8ZZ+VDq{l?6t@umVWrdZN7Wn$l8ugGJhfG`3NAXVO0I}NhxBOxB@$;R zhZG@Zlp;mVI}spK4oU{7T8b!F=1nZGmu4uC;_H$u*c@FwFVIJ?qYMx+kZQD-kPU)$ zqTlGAZDqSxxDA-K$#ga;*#*+eTi;J?<8?TN4erCgws@eU+dO|WiZg|EhslYB`~j;) zFR^132!hq;IK5Yp_`T0uU5F`V$L&NN!)?Rl6xVgKPfmV&w}*Wq1?Bl*r+W#b=U#mK z5wh=+H{0U;&AEq?b#5!?10(LFl3{~NH4Fj`d=<+tzBiSkDX_b&h#~-{(TTnp9D?mQ>${f?_j6nH7rHbsg)+{MN zZuJ}MPWDS~EuLUdopk4No1@mq0mirnA@IyqXu6TG$iGAQqHJ&BEH+#4fZyDElyhXa z0x>5HgP{mHc%ey3?L`?_KUGdY7nwPjJVhP3rNz$xM<3gtFp9T;YS;#rs(K&1Y_NPj zPll-_YIsIaX)gE!14FTlubzM(sVXy=<~$E&b0SLta}z<=AA9`Wn(DuH>HG2NKQwv{ z=989QhxNOP9(3~`{`&1Yt(;zpZRl;E$Q;_9gHOa1us7 z%|d9yJ65c$K*KSMfbz?p>B_+=9AHKOVdIsRZ)Xq0yu#mh~p5{XdK~cnibOIee8x)nZ?W*G!xcn?(cVu z&-vfi?OHMzf1WdZmJ&H2|`Ca8p@Mw{C)aa{nAHjkWXNp z;oPaL*SO&1c&vl?5AQgJ*D_ziL>{FjvQJ$qGh0Q8Eg|#9cgGQ)PJar8* zi5lY%Uz-c(Gkzu55#u(eUGsT(P>HkL8|>76u`4FZ>s`BJEh=0jHHTZG@{QS@LT%`R zL4M>@y;Lqx6pT=@sFDSPwmq#Di|y33&o!v>6;e-*(9f_%Qx@AeCeH7fNGmaSLOz{M z{6DsX?lT#JP&9s~`|F1QbXwRHFc-a(F=5|J9={$=*l51$lTX?G;R{vPXq|5qXH&~9 zw^0QddGP z4`c$%ArtS(q@PP;zeM=3-~b`Z+sk-#Gfzb^ukelhMk(z~FVQqx2Mg5)Jy=BB()8$I zI4hvRs|go{&WU<9kS81;cS}r|VrMdpO(TS^Nw@Fb z2(za%*xEiB$fZV<(})T3GEoGFTi6S!-C&Q5gSbl%jgwtY>pYYkU)v#&A&rYt0RO$W z5SDo^!_@rA}sec?c9^^Q9AXeD(!s5meY7W?dbbRcD( z!gAKFb*ljLOCMNvGf(1eS-z|amG)|*f^($e9S$fOHZ)m{7DHfkD7fDEd?Ver=m{^B ztoO45ya~F{;yDFSQxe!)BBr&A_^df&4c)yO#j+?cV+Y$`2@vG1R5U5S{P7Z8)#XJF z&}>&%y+jN;{ZNEM5OuINzyX*h-w%e;o$AfqW>41yd-Uy0Yb#z|&dZ0%z{-Fqy2&zdrv1n^E!(J!LnbL2VN(?lp^t-rShzQ-D zD3QqJdZG(K@N*Jg=LY8_Lx;@Y*4%F4MFJdk%zN(NOcx9brt$xYnDX8~_defWF71y0 z*wy2<%&&ABRSWjf;yHv0Qe}hddSzpT#pqsj;XZ$OK7yiEvc%W^KHTQAXU^6Out=HI zo3z&W-ohKIh;+pYsJ6kRoaGNR!zAfW&F6L5u}-J5^2pocJyt6}I{(PpeK4(Ua}K+7 zxmhOkW|EJvqIsTHA9B)ZN$Yko7i}p2_uIdNoV-4R;Z+=X8wl?P+J zi}&9A8Xu3<=S|w^;+%&*C@m6h=JkSz$i~B66dnu&BkGZJFa( z>Ast`l99lIVPA9rTCL3+R)15U0gq&hlH?1)DkQW*jk7v^72^?Q9-qAOyI5z+7Y<{= zqW2ec&dNn-8>Yl+ds6%^`*#DY4!^~gfIQ>KjAA07!eoXS(g2kmC@a-{d`7A z0B+FKhvCgQIiDywWROL817nOzR0Hdb*MC`4|O+@GY=4DPX ziuMi_>Wzaia!>R)sG~9&Z+OX$N{a;QrW88=LTzCf3f47P5GF5D#wog>=*+Z%q5%t* zG@3)#%;mci`MGHv6as;RyH=&+y+tI|k;#6_4;B^7?B^<#8gRn}mXPXTwiy<^{Wcxv?NAp`5hMKfGhu<9Z= z3K-Sg=bTDxrDs6n;}J5V{qcwHk+gtP{k@!SaRwo~Kv@_GhVp%8pMJ)dTaz72gism> z`Z_rA3#l{5tgN&rg{&4^l-w&ym-#i>z;jUi`a}Lqlysz7Ts{&<3*f5eIzTgVt6pEa z2rX@I3|Z>C2-ek7e}IS@S7i=31Z!UGosGw~^tg7i@JL7j=;QdBbLa_M?SE!?2t((`cS;o~}+4Qd{lJ zJ?brUx6D2_B8{?hy)w9Yj#r}Wq0X@i`sX;Ugl?7?XyJyQ9TU)z>{yh+$=PK&9LMl5 zFIMJ-_Gk&!RA*dhTU?A_K}t$g=Cy%G<49NbOAM_AciL=xD{s74)oR2@4W-gEoIET( zwH8>^J6b7P(ILiC{D}ivzpW(%g(|j?nV#rtSm4;$NVQR!!=#n=C z-#R?ds?~`n1XO8tz*RXdaM-vWrJW6DSd!vH?=<&M>_h753fgEZfpmqs97Pi#gLR#A z;r98vAA(`so%soh#sb2zg5cSs&`KdoNa{51=<}<44T+F|t2d{H{2NRy+>>Ad7x-gX? za!>BG?D?hL+|Sx3HNS*hTjnho%X}*5w|(kog}2x`uZY0yL&~}5SL(fv7bO@5R-bVE z-z&bJ4!rv9oI1k4{Hs3k-6(pYl(>*%0}*!qhRT=v?h+IAdY)8SF?vlnD(meipZ$}} zk;Rt}C0Yb@-R1Q9l;;2gUKIfIQdyNT{6h_FC8jpNX_^+2xs8O0@>dM5h)_*MQ;Y#A zssjz7-Lv^La#*TNaI%c|Xl-)k&GFJ^t&S|4!f+fVyJkVlGww5{}SeLk> z!n03ch~WZ9_G=tEIr(?}l*UAC%HjCq(Y4kCN$+zpQJ2y)-QR{v z)6x9^_>(~__fO|5(a>M%Zaw)=Rp|z5?r(YCu6^6w=6UPPP!w#dNd8N{XW>|Oz0)F8 zf?lY&abf&NiwH|o&NLQjiR7?Wm~@6P^9cBzOoHZ^c!yW_xZP&=M|72J^S+2ye^pFO zKic4G1~bbA*))L#d-2$9m#+P8Z5BBqRdE6-=l@AJxx#RfkSFMxQ4{VGp(Jf|u}^BU z1F?+jZkA;%jh*vl?zxfGy(wzDd+Py=SvV`nZPMK#y1IBM(L}!+e&rQEuqoa+n}*hi_lqf*2!RE#f7Gn|!glW<&?Ra1-y?Ym_es zYs%&}xvM?0to=QrtjqBAqifv^pgl_;9kM~ICaD@l1jJ?1+Y=sqU12n;#VIaWie$O{Mp=tU9 zVG}A#!K%p~e(S=x%j?SbI)`=$phnP2uyXy3v%wY!W)BI5@cA77IqT-U;ZFCEgA`?E zr$`KOWO)xV$l+Pvx+OLHU6JqUC^)RBYj+w9jAoIn?_RMFFA-&Kb@gYYHrh-7x_tFK zQGG>@MHS2d>wKMydGmobMHH-ar26S`oz>VA9wWi}FA&ezLOaWQ)fT2~!xdekWN$Tl zPCBO}S$k)y{EveZmJLS)aa|n8ul>_m{J(`gSExEsFQc*SS^G8BG~VkTzG0QcxMd>_ zNKt8)v<~YK!>IQQ;?CN*S87`Mc@GF1>~GYah&IK3JTNb*?dUN&NTWh+yjI-~h`_0Y2+_Ty|P07wSF_ zL7GS-n*nba)txk`?+C5jDA}KJJ^Mmr%Pd#kGv+8KCC7^uO25jRoe@e~X7;f~TENdY z`I^>ZS-j<(ttT-&c_J_+AWPDqalO7aws~v~0WywB;BN~?cz;GRICu!rrsB@ydXuK0 zSl7YqY61Vu#XCoj(%)^mB%9Qi9mu_*VQ_C9UF8A_YsqZBcR#qNJ#Kl#g1R+;y;#>B z;CCoF(bJ}2|AM8@U`f+jxm5Oe3>$65qa!GzDmwhO5pFgRAS944K1OsN{*bvG3Z$(@Id$?hkpEZA7Eg zbaDwN~~j zd$0BTmSmNQdBbuCcoOId_l4%sOcpo#e5!S%Ydq&j?Ta#9xeaCpMU^jZhs2GwgZuYi z#VACH9nM$jbx$o({fl+x1?9BU`(wjH62>lrgGd+*hz8g-M2yec?K+HFuqsSO_CfFsR^9b76Tfke8*dl->*Rvo} zIyMU$KDJmi5{-mMCj8usnUtRIsjg`lL|oi9iAWLmDg?iSd9H!{+h$n zbkCBCx#v0;Fr$<2A+>}yzbDu4&YIdb=>ETxJR$490KdMu5~;jx+nH$z=rB?wXPe7e zr`S7Y|7CHh=_jJH|Lv$p^F5O-RUyphtsMzy9}Hxpab~b5I{t2PbGRI{g;HgQCiq9A zM6ayRRgmz#oeKefjm3<)W5#VjT z;)$bR=K!j{L)u?fXlVhRAe_Y*T$dE&1P{9VzSDhxJtV5kV@!Nm#_}gWvzdEhigjG}IeATn(qdLw49?3vbebueJ5Q&=+^NZ8aL7h8mfU-Kom}@S z80$Q)dN;qU1f@Bs)AIwXjsj(X(+j*2B!ryL6T4@%p}D9BW3TCiw%mxslYWeEgr-D`sUoEua^_M^`Vn6Lmx zD_gcZrH{kpdVAzpK8fZZPym+nDE2yZ(jsE zjaw_pc1BPkx8lg9H3y*evuIJRPrcg(M)x$D+yFY`Ufing2)9rU#%ThL*%GJh31<); zwleCnMTCN*I9eeKFZ}MW7 z&H9u?Onaw9o8&yQDAGknI58B#0(rJHtja%fg0wZhaFQhWm zY`Kc`B*vT2tNxj}csShu_X+4Hmc=e96@l_5ud`5+1U@IkDbW(F@OJr3a)za7nER!U zKg(T;^G!El_#}q#(W9)%2!0tgQA@O#>zV<97{abC;iQ2ZFG&q=M(3D^ionXEnsN3< z@mp;*t|rleKI^ajrW5DJ!lmxG9W-u&J28x34-BO1tf!*8sPk4Wgt;E?f)o z%6=U_vg%9oM*zAd>>OGQvRG_gVA&BlxJuoFyvpIcsUkGCj_x>uW1*J(O17p#NDyBzp)yv`#13A_ToMD#~lo>Yh&JyPl5FO8cob zYM#R+!QwFAXyk|c=AMwioOQ4AjA2Xl+BIFB)Xw9;CKo9fe7k*l%y{GD^I7Ti#s~hi zvJ9s6x6EHE;)Srvf$9zbO6fShhbqYMtOZaZs4TdNSje9OkpKJRU!fwTXnShLmatF@ zzia;U%rsmE9*lN}jeXbmpLv-#e)8nX{=UtC<*p%xQ!NMTSWW0{HfSWks>lnQX=JM}~Myyfjo$Gc0|1 zMPx+ATi`^W7)P)8Rn8jJ&}>v-ADcLh-hP`gYYGI)gEac&i60_3xdoaj ztA@|N{q@T8|7gzt&fdvC?-2j`m46L-8O>OrcV9@-Ui!|LT1=utp)iA+3KFbE3?tW~ zTVWSE`6fj8U_gui``gsu6NG+p3Nc@@Yt+kAZ@r{bsqo|IJC#)l^f=@O=>&i-gW8!XTEIk%D9dst?k>-ppbI3{QU!3p&GmOu7@fG&u|Tyt#Lk{N>NTs#x>U)AiHPHu1fUudRQubyQ;hELO8! z#=FHt*>J1Ih7)>5%vT-;2ZB2uShwjPglxNCNK z`q9CivE}0BJf52VTIl31ulV*c;kPBN!h!U|({4t{+4}PzmHu}ASB+^?+h&iFiiHri zk4~BqdsT$C;EnJ8&y#Ah{m;l({lA9a9-;v~vt@yY&xn%Ge*Vmp&@YB1BmRQ=F;b#` zbzO)INc#lKs)`SM(`i3q7eDQ@o()_pN!8Qz<`kneboj&-m|rSAl&+1+>~<+{)HCh) ztXBzX4)%Q&%lm!E)~${0d`@Gxg{TMux~S{pp=u}>AfxhwZ}1!kP zQ(C=9ypa+2CrIu z_Aea|vO({+*1VTLN!j4JvjF|l1?(aOZPFh0%Tq0|rM2<-(J+{v!x+nRg?GfhDqanZLsxdA243WM%~J=dGyv#8Q}_&d(@fv8U45ev|(0C&}wH`kTjz~ zdM{da(6kg4*ZMIc;Lew>l;e2qn`#GP&8If@^Rx+#G^LHkB)Zq=MzL2B^2j5BIDy@_N42S-zsotZ_hpu^M(Y^bbZ@%`}p zt*WIPM7In#o+(_SOKOsiu?*)@mru5`>6(ja*7Jm>p=obSY|F_xNTG0HsQ+&nM1{S zi6p#XJ=^28dsWvZW=z9(_wJW|qcfkOmo^^*-acC1k@X3WObOU6Xw>Af{U{}K*rD|* zbVysC6*5OD>~J^FtK1Uk_~E&lNCVz|>YUw{~Q`U)QuCGQy*dbDuw&km9;xW!G{4q|WG#4N0@wKi$)fb-iu! z%IW#tJK1iLwA)9Q7rgSW+&&J!^TXe&XZ5%0^{gRnw`2ays^q)xrXIZw3oQvd8{QaM z{M$GGS@kpjR{g!t8JQ*<{e}zoWZ#K+ci)t!LaA2m&BSwZ_5+iTC&bBTpS-~pJPsMOK6`yK6j0ba`;JyS&{~|S{^PXy z`XzERCwnk4t1!a0Y0K(Rlk0hSD*>xNebde0X6dSKGKxY9K6(9ia!hG9I-+V^>s|<9 z{#(<_j*hb3s}XkIH~n#N>JIPMg_u=q>GCq?yjgMyHgqyYZJN)QQmg8$2k;EZO_ta( ztCG+v3C)($E%jh|R%_jI6|xwmlWF^v<9RD}TN1`%&!P9IbHR9H~R6uC?w4;J z)zRGnUpWeZ8e$Ko7}RmAn7!4!a0ghh+OD2zy`BUmhq^WIch4=pFcz`3aYxd3%m8w^ z&>=65_Szs?XPaG%WBJ_2g~mBxGt%aKICvy+9Bb)S{f9=DK!;%Kr=;%094OWr-n5Zf|YhCOoqj9!6RA}M!o9>%h zb1fxR$1vj%J1Y*ts(lzBn!E8b{$3c}*Q~$po+S0k0BZoHv`ee72s9r}E}6AKke1%1 zv{ZUx5efgsKxi15>xq(pimyrs`3#06+QJa(hFgICr&4gInIwyDq6?a)#a?pSyA#=H zKzkl*VnEEcSu1W#HMl`^sd$FJ=8}30*x$#0L1Y-*{y3y?ZgohbvuakWh;9RLEO}0u zAtyC?Vf7a|jzTduaTG$0gw!#Q)o*BiJ?TC1wQvoBA*p}%V;a`C2kj#l$^-#BkZvR^ zr{oaE<9^A(_+IARr7qA6Yz0f1yHSH5iJ6)=y&4XK?RNx_@vm{c$x|3kO8kKT_>4gw zDWs%#z3UmNu;xp)o-eY-5YTW#%*kApeGm@QSxsMQMqK>8z_Iy_tvEj%O*X`0S{x9C za1J-slAFdK*W4}cCQ}Q;Z(kXh!CK{kLlNa%2J%?X3?h)7hviYl&Ox4spSl0ulDCJf z;K7c&5L6_#YDIBPV64ib1nb9HV9A8$M|+K_Bc~{35%bCev)(By3FNwyi)62Za6FH&ICoKPR%ZtZiJe$%AVBj*3^>?$aVnIyTS?LtLR+ z4(kr`>%fpNHQoaB2i*9f%j@~n*4DX?mHDuF*HT(Q#^-f+3Bd4RjHI+pl5vHA!D0Gg zNYu10ej5URnJ%3~zue@vBe7SN$C2!pSDm;A+?pug!p(Fz`Fn;7DvV8#T>fAK_I+Ja zW8Q!rI0V%*vaQM;&_O4_{3QFZtKQAyE+{7U{RijIdppi!A(Vbgf6rDzLj@&bq640+ z+m{@A4L1FFjAHXz-L~=>En^;7Hb1{PHIUxj&(cH*dFhCJLjUpQoF%A$Cr~k-OO?4p zlRM1LE>qB8?SU54tUXKYGn}LEA&uJBb;23@WWj4VZ$ zN)6^rr3Eo{To2z)h;*=2vm^%m2^V|ERu%Ym51jYo*B?{GO2#mh1WnKgPfZ}F*2L%2 zYoHXD90}i=gspBvS9)}mVGYTXA&f(=7ZN6c*d*hoA7RsQlNu1iSN4)y-GmJeFY)!E zS4ZTwST|kRdW1+3g5F}Ouzzq=t4huf_=>%?rtT8_%+e9}HEWaFJeE13Qml zr~^7RM_c79dq9DWdER9VW8Y5*Cr_w(YuK>Wbg!!NfKKo2E9~CmX6V8cf}gR=^NQKjN{%JH`Lkt5kWz_W~=D+Xye07_2jZDE6OUV zyuuOA-rH-;?r-zL;YM{8Kjr#?7s)tv0FdkTf}VN8Rq@ zBG=~HaWZ+a;yirtvuCZ@1E?izqC<_SQwG90!i`A`Ag6Ul<(2PDS9xiQiwi~!URZ-LHT!*iM6P3cktMKWD9S zPQJ9Zv^w3yE$_usj3(ObwT6Ef*%Uo@m#Sb`Z)LqZpi0+C=s*gqU@Y z7sV|TQiGI`5Om3>{*svxXal=^x5yv{8pE#ey0DebJMul=Pf)N7?#b%tQ{LZk=YGx| zx%2fdNV+>yzaoMgzNO5x0bqA zIexVPe3LWPh!0mbsLT8rM--$Zas-(!m0<6zr3jm{&Q*@?=Cj-P2p_$ht6XNbvdwyJ z5<{~Ro}vUlz)dtbRk^I4e60c(O*9X^NX5u(RzjI_X=pG-cOJc@`hCJewnkChD1{i4D4VAEYF9ectq)YG(dS9CN-&1 zSF~-`^E8xMO-Jy3SfjXXiw9gCoPJO^L0E;Fn!=4Y&019#;#Sf;G5Fr*kH-m&&$GHG z>rPd?EStWP^-wa8C8b)_2p3yKoWqza)3BEjzOL-SVVs_!78|zR# zIKKi#tVrJ$D1?90A1lXLTd(BC`gWh&U5{Ft<=gYP3}O(rb@4Y71bg!F3%`8I)antG zv6ZhOmedbxU3#okm2Cwm@}(FqN-9yzc)dN4XkeRi?WMz+!4_SCkCIS6_G2soF zb0&0{poTkgK|e0!9H0|E2IDfud2JC&^R0%|DhWYQR6I%)Sz&oDKoK`A z#TW2WJ_%Vir=+NVgvjyOZ(lY1_1yI?K6ZIAi>Y@Gka7o(3u7kw@nbOxrVo6Y(3H^p ziRhYui8XzO#k_=LKuQF=<9?8!2Z>#EPyU(pkylYpBa-!scpq^N`ulD^Uzr{-oZNgt zOiYaVp-k~+%|Rt#-TuOG(vTPXrDyjaND-!`94M=Gkk-<^s?GfG;9FVUoKr*6=f<8F z>5c-$AL$gIeJkwtCG$$KmiIM2HS9AsJg4II0maG(9QU#zPN5cY>l6`oR7;qOugI_G z8!z*d2o>GW>2JE=dAr#r-EEpp`q|PyeWTy+^xaP}-$Tr5FE}pr@aT-W-@#jxNU{ld zI0J)!bWwg}bU;I)|D0(KCmgFM$2q(z+axg{pZ~N$YRn9wXLXNXVOz*p{;|$Du5>E7 z8=8av`O+mSu!>erhnsJSZ&@W}7d@ecIArjZrZ%(5p-*_DcOh?zJukbJn@>-?s0b(z z8S9NBcj=f&=`bkk72g|a$iaSL+5I_IYRay$mKJ}y7iY^}9rLE&Yn^@I>5%P3Bo#SK zN_(&?DZ&qzF1XOGwj?YqHO~vvJ-R!0qiLbO{nua&&gYkOXI-sK&s{Af>HidBaMO(g z*@_H){Nb<~j#`0xC_2ioo1DzRF@kfC|kaB%~9tn1iTVMi8 zHtUGQ#+t4@Pw>7*$y|0A5 z0vByC@$|9)g*nFzZi!p(uffcNz2L?lUu9_xc<0O;fh_e*5$Dx;dS@XVjymmj+?Vn` zpxEYhPa(xsPlU+!4@U|CJW1J2q<1i#cA+#r2uG{{(W54PRGtfLdL=Qs_tVUpU?E=~ zz6G0a`1AureC&-DNiDX6gCc~cr&8HbV>Ye{1MEK0Qci?v>xVPg*+5Pmrm>R2bN4wy z7p%|b0$;<;i_Y}o$H~RD@e=;@W!{)wg;{#yN(GzQq!pRQ+jggrR60)^RUQVOUY^M| zxdg`MTqwzLeG#7qj?U1nWFKm`Q_8Hk*b%Sz4J#m3ix}+NE*}e2kdvJjc~apgS_+pp zuBd~c?s@&XgzX>ph&6v#?=oj)|`YErvCCG4MurnE^pA#mt_ z5Z~DX2A>=05Ps7o{H(#6m(U5fU%rh#lveQ(iHeslE(wPMtk0R0I=~b07T6TrCvR`D~s)tii0KsbLKIb9DOhl@`XAYs~C zPhAveK!CtpmZ{_ zy0c!?jk{Z0-7|hT1m)Lpo#>5Y#z=x0L>bBDORYtcUG{n696|O7a9~hQtS%f?b|`7U zfvGee$fQF?fSgcO&|8WPl?GGVu)Nn@n}bVvn@lk8#;Kz0fi8K!_;i zmwzs|uE%dInyG7WJjt+LOKpRy#Y}tF4p|!+PPS6o08=xEC}6n`9FFpR_cSTn`yk#{ zVvl6HAI;UJ@WrdZz8Lceb6AfLUTO}jAZG)OuNz$PAG+yh%#52kCQ8gFE|Hrj`D18R z5U}+NZ%>kiHQckYA8PP!qm)MtsJ9f4??5ngOf6F_Da&IgG>JS3I>@`wYx{IFC;9P2 z;74bqY_qaZ-=t)`@_sNZx&;->$%d+Y=yzyK<4vL=Yh^Ws->fY+ zLB|jALE}v|C+1C&3^nYDK4mc}?v4WT*d>F9ikI7(wrCNvDs;y=I#oIO`**S1%tc(X zIsl)iHR+C-&p$88Adw6fZ6yal{-_iT1Rg|U2s%_}=Q6&wDo(JLA{9J@{ZDQlc&?oK zf~(fuxA=w8(>$N%D9JiD;^PAccw7qsHi3>iYNv->z<4D{Chg7`9ZV^kN~ zhsRo_8)LXHl_UBHB1R#F#dYoj!dsVI-7;XM(WfLKr7YYkPyH5X#f##sw%&fb<;v))Kt8QTfpb!qdmr%&mlP;?A-gdz9Y|K|H`VtF$R`le0v6OmqO8DyX z!^oFjwoOJ~E7%fOeQPJ$@rq8(olhqQP zlepo5t2U`Ln%6)$W9_72IMM|ToOU@apZ?{zs8n29ISCB$i{eR0a4-0_=(V22PdeaP z2zMG>zO|Aa2(6XrAIly*j%+KG$Lbn!IL0%>yuhRe7DbQ=65EtfV$5VhA#-F3fH$w} zCNngRZ$GX9NQX8a-+J0H1i2R&yrB|pz~q*4jMr5VVeEHR>7Rux~gCb@gS9y zl$Q|hum@bxZSu4koAy#AlKi3+N|&tz;Nfbr5{YMk1cbAzrHS~OG7E~1!NAzhI)OdW)xDw_ z$bO@O0IcS!e8YiZx96BNM?YvSZqdvk-twPyU{!6xjNYAbmT1i7i%5~EN$Wzigx4Er zKNKpwTan>RY@q2iiBX!NPV92iuNPFQ1r>=6ZwJ*ixRXqS!xU=`6Tm3b7~1lcYpFnw zq%beIo}kRlt+hO(an6ZFYst!olOwP`?oHOtZ%Fk_T=P}C^BRHSJg$sj`AQ?d_~iB_ zIOVfKXP-ALpq3e2lz$(5RgHm{Z42mh9=)Mah~U>J{-xh?9Uq3!%)xf^}Qn zpVV$F9PkfSeJJuYcob zrhPkeSdS&Xso`u3x-%o=%f@~0-^u=cL;lZuNYG}npU<>QHN)(>v|-Sg&JcPJZi5c_ z=D&2)|M-_aZXrcSxO(|Rog0O9Jj!tc48c|QUToZs3|c&Z&CH59R(mw2lq@v^Gd_ve zD7G$XT4y0c2%T>s(%IGJNg0nHR!*z|sP_JOOcqX^p^9+h1~mIm*syUmX-3Vu1Ps-U zN(g7O-w|2~OYsvGp7EnBkEc3m=0p*CYvUeG*Oht2+t2!amL7zv4j~US*+k{#r_%Jm zoczLyW3Q*8xP(2t;67u2+5ti83|6OKw@+ zaD5sfz(qJT6A-_p(;lw-Gg~I~92~a)3c~9cV@?(55rGV_?AkMOz%s5ytf@W<-^Z!> z08Ml!;b!H5teplw8oP=^Cb@-8Y|FC-kGQ0^`EG_%I6J5926gb1eSe`IMGPd&G7oB3 z$c8F)ZW@E+GzNSIx2PIaapg$#+p=#`#$9L6gHdz^tCI}1&@r>Ln7ZYwR5Jn%4x`hH; z*E)01oF1E1t2!RN6c!CGnX`ZBNf4!W1U?CwfPw0ux-^SBHKi|U#_Cbh+_7#JmlgaS zbzzy1D}gunI}|WP9HpmDg#oa8_#&sri!i`RLYucP@>+DauLFoea@9SmOHa3@e~wD7 zoi(t6=xG|O`;8d1Ji*|V_!C_&GzZC8KER9|h0<-4%!iqma7ji0JY+>=T)PjBa$<6grpu3&ghwAzUBHpN;T#H{eC|y21onZ&9VD5s~i4qnVTypUre#q_Q=@Vrjl_r5hP=++_;Nl1*e)vMoFl6H0-xBKswQAxxnE@fmaf$L)`qL8NmnbkQj>?Y>u zeA~Rr#r=qZkj#4Z}$RElo3mp zeqiLzLdOL~;DR9lx~AKJR&~n719;#~pd`7FwMS#WTBW<{ zjteKd|7g+`*?6nxMEBBJ7U^U@>#D=BsXmp=mqBIF>y+x`4D)UTn7EdXy>GK!u1<+a zF^DyYwYvOnvqt4WtwVHha_R$3A~eUUNwbRCgAyH89`d zeR?B2w+Z`3jLx-qBz&s;_-fmZ!I9T{iJ$*>8TqaqHt4|3Df=@ly3eZbGL8?MtOK(t zzKKk~XlIdzmZWmzs%z%=#Iev)3F$UsMFPM6e>T|oDo4T(kC{%^N(H_#YCWLH|OoeK0>HbLGaS%6iK#It7r3;pzph`jseL6kRH_5jDh9}rl9ZSXT7j* z8Ekj*iSNPvG#hf!>G?+LsjUm{1B%~#iUM$Oc8vK^NZQ!9T_~@`;$4fShME+gLw3uX zQ=V|ijhCIBo;mIk`J`pE#mKrhwa`-GCH{J&W|@EYh)D2@U%W4cUvG@612?Wy&=nKe zbtBzX?Hh!09T05BA3p`xSsIJ0?~%8rrRYAOcqq(>aRNqK#;Tz7LkSMPZ1XlRbLD<7 z4#~sAWl>X1zH5hq<)qCnB6sn_*6U7G&(+*dXFSFYJte#HZ-RErbAQ{YIAeDlcCz_ztPh2jmNJ-Ri(nM7_-iuU@}8 zYxJV#%S^Q~RB5i_MLE5Z6kt#U3mxWQ%*-qes7kB65Sb<&#Qa2jt zW^%k=s5vaLq`hvI7kyv_N5ppWmb232!gklt;(NoRS`tRKITKg6lcR1}yB$Gqyd|xiCBesP$;S1OH9k*~j+}(r_rdG^)SP)& zS5LD|ej#)l@{WQ_Jq)UJuGHTwf3{B{Q#qkB(SNy1S0F{@rMnK3vXs|ti#o-S(n{<) zRCT@roR=#Lg`StCMj|0+1 zU*21lJA#6HgAfjE#Bi~(o1%YV7gfRQgkQt0(CP{}aM$z&B`2o#62+y=zx@E0Y~o68 z0I7X6MP&z7zL|4qzh^9kgK)DLQ|}7QR<#OKt`RqW)6UIR3Y*p*2;SaMDM9+QKHmBy z1ihwtY}}}W@TlazbT~bFuN^zfQbWmOZx{Z;JFMqX|^k28LO=5 z9+=*9|2!di()hm^TY5AS!u4+uTiVC#~NPn@wB75aTG2o3Fz`RQWxvHmT z>4d9NP{Al6OFM3Z7^%QX{gBjIvRB>Zs|!`3;M!ImL#(Q20F&fCdEryt*4cJ`ItF9a zLFc$srrp^12b)0AYB=}|4mp2Mk0SIsZUsyZ@+g46k|D?9IZa6vpVPz?z}Bc&-ptsSqiua7DQ#UZ2#Rf~3{2%s069_QxI8#)od2dZZ~#0}u%F{pQH^+W4+d1wGq^nU2b<_`yjPMD z-Q<;hJiCAL)opj)_r%5kymZ#+aibMK@M@*|dIs8gU>QIm{8Ct72vMa5kr3nY$sdl7 zZC}J5y9@?yO;5~5bB^HX<_ty%0|6*>F2PsHv4jF*fp8UZn7{L{W6D^8_T;2-!$yBD zH@Q;60Dkdn*s&=x&K}Z5L}n_2YTwqm%r8n<*O{NdNd9@rF!M&G59qqJ4{%U71R)&P zv}H6s!7!A{pBu6dTg)r4MYL({*A$b_?6sda9G86QlX~#`KVGN)-*`f&EhG6Ky;%-`c?_X)$JF%TE?&!Xkh6AD<@$f_d?8RFgbhyKKUE;t~i( z>8O%xI!%N0F=a}Q_m`JRmz~kf;Lx`J=4*BG&-l>MI!O#)OBc zLwC!lfj6CSjhQPXk>39Td|Dc5u%{wWBKrjWQRG_B*T zCe3X!E{922eaUYPq>#X)+G#ix4dJ)k1@~$ArSq~HiY2Z6*P6+nM5G2f$-{)Xot(dd zGK`^Jc$Vrx#lTXZD%YpO@I#!{GRxM%RU{CkHRj=0r3YZiIzU+xTQN5Q$bG4dA=V0g}P$&$h-%k_|@N|u@*K0Hp&zAM?wdDUmBBT9sb<*}qv9~G1A z`!t61r^ePO)Ta+B6c6bcq5M}HH2~0Grp6(%$uJX%LmFaRRsb8KX05f-xB#IwG}L2- z-#ruj2)C&V3~9TX7j6>&BA?IQepY7aYw<`S7%Tf|`hqartAAL&%(^T>8)G;@Q6-n7 zh)XqW#`0!a#+g%}vGjLYa!wnkMzjpDN-e28|K4KJWkqaxn(B-m(^GK0 zGGtu!_5*=w-kKhvH2Q@oS;p7IfbjO?^9xn|e08_r*y()52EXdHhD~~G#W_X;C!#{Q zsQ`ootoxVMn@`!LR#k2aj|f)*;nScQ9X&zT^B7A~=uu^4*GoFeGVc$QQpS`Y&+T&Q z10)IrnESf|14Zp5IL`_QCG!KoNj5J?MBWO_(xG%OuCsbKH$19~0||^YIkDv685GJH z+Wecwd{OlA5t7B|?=-pmV;2Poi&UoX51<_P>_v9PDs;hr?kP4u4 ztAOjIIW!5hb}8udnr=$H*~B9A`UD&*B7__CN8BFduPUv{-oik!N2O^|gQ4I=L!0D) zycs0FsuV$adI{&0{DYAoRe(aFOfo%7IBksje0%dj&uhB4G7C&bElYD<$c+APsd*J} z6jNdxgYWCOoJZog)qY!r*SqYI^hWFhwKx6tQ=^@h>J+OxNki=*G!WtLt&x+b@SAMq zjH{$M#od#bp@!ta?C9NO>2y-N{#>{3!QpU;6h878oHb+u$yJ1OE2}=j!RI!h7OgEJ zywmJ;73sC5u8i{0srnE*>)^PM$9|#W=X3uz=Fxv##tjK^aq1%r3GsL2=(%Nl+)>3C zNlsb!#L$iJc$%oE>eqBbf9zQ3rPJ?&lDB*##p;ZCP(j*>uVohpGM;@c@t*Bx`Jq>h z+!KHIDkP{y!J)>_N$bIg!#GyZn zc;H$!E4jCW+;H23KrdCwv7-p|wKhwi^GO1Hs-1EP;G!PRgquTiY&`yKY(H1ht?7yC zEIpCk`;})6TEp`zk1k-e>qKYNn>`}EOluzh2ez&6D0!Fn&TJZ!e?f;W*5TAIys)Xe z=V;|r?=g<;?$p=00@wF@f6d_Mf0lv9ys{VtyJ})(Nb6}%{KxI~@3a5D1OL7Q|GoqN z;0`EeK6S1iLu!Tc2CQ~;&YDe|+pY+uxjR{<5XO6eD_*0yVbUzx_NeVIkzLVI$kUJ0 zEIYclf3VG!{=s&@nDsX0*-CW`2L;~q4`X0;f!sU8)Z<)=&;_P$nZxT^boF~ip{B=ZR*ApkL|S!W5CpZ0qqRTnF|?=d@r z4gAWexM{mn(E_dtW5xa_HuDW2`p0GPqbyRTsFx8HTs}fNQ8K zE{$YCa7-w1G@?JzA6o9S>Zd-PeuT9Om;x?PH^12)4x6b1mH!X+-ZQSrrEeGISxbFv zxE3OyG?#QjQA+4#DZLw#5J~_6X$he>DZ0c;Fd!{JXbK^ukRT=WvXmyF2_%%zq)7+q z2#6=|`#kHMcfb4DXYVijJ?F#zHuwDQdy<*|%ztM7bIo;0BHit3yGb7Df)jWXdJi%g z)R{NA{p+F!L8!fwMXPjKLcQb2RHaDUw(r%tu&ggs?gzHV{uyu!shCq|Q1XeN;)f;r zN>eFWJ)`*?BLfm8oWfVSQG)q#B%4iulHp+ z3%$*7E2D!1iP_!rk)?X?jq13BcZ-jIo1Bnyb|v~O&ef@fqEiy%MMT+t^YGn}+^5!4 zH65fF3E%}Jh-HVgOv{=Tj&3(gBG4dxM+FI?w8E1BXZ^5@gDW$l=w>_ycy#RA`oe8& zSMm~daf`6&2lJQ4XUIqNVm`7sIANb+(f>yYSze;P;cB(1;7tEps;om~a&L-}-Fqv3 zelr*|*EAQ=z&rl@Y3+gO6rKpBkD@}qhN%_Z&zjt;jo-hFoiM!=(SO22&7%QgVTi;$ zX&OH*9!~Y9dW6G7$cfNh+4@p;BD%i_K>vwCCf<0`&g07xE?1{`%Oz_5v~$U=A=1ow zj-v$mwghrzv-mri!_@SZqO_mEePdckmA-kKyaw4EG@U~*`%zLGLnXm9@JO>QTA}~X z0!rPd0Y`~C2-L7ET5PH=EF!h+)q-A2E?xg=Y(SDO&b{9}jT&6&S;~&aTTftX>-D;c zLINMahf*~^xE}re+e_c((*a9@#rx;<*Pje*^9euTe zhd)^kcSWGz5*r*8gk@LehX%>b`Nm(ke4(}Hu5*_HS1i|R#klZ}nzJ{wo6 z7TpQOW|@^`jbut?e24G)bSrxN&*2F*q*LOv0p`A(p=zp)B>0{kOR3kNLGLoWo>8rosrNS%<1R|`qLSiu(1&f~DE(3=L7H^pzm7?E$H3!+8e6*Phb z&L$eIOt=2IWAc>SnG<=kayngi9)N&i)%x4_y5zI14Bb(>ppf+a`wDgP!gPmeaiWOh z0?2_10xdiZ-ncHMhtnjT@J8%F2e_}B@|ywPJo82Rj=v%iU?@Mp7R2QmVsm*JWK?kv z(Uf+0pT0;gcJf&|0XK+wZUT>#TGFPgR&QQkEgm8w$dAr(o3qoxj0nAlF`FJja>AsY z^yU1(f(hG;Hw#5yuSFdWOYA6w0sXF;qs;^qlXTJr_HYf6U-xd{IGo%6V$S{FkaY?5 zwf;NOD)!tDE`AY-kbq}XD~`xTn}c`n%r`$L9gj6X-0S{_ej=$W}nHS z^=v5+4uKr`Bc~cEq=+jRj_Npt-RMk4O`W#_EIV@RhgN?e8JGyX)D_GxL+fzWJQh1<#@Z%VtOF4igwU zSeA0o;49?mF)V5;eHsD}TIlYG5v{YS@J-NlPPMgOHnsE2%PS0Ds0O@5vqp^|^J#F8 zEYS4d2QaB1-vd8K{~{#Mwwh!7fI5&P;=yf&H-h#F7hn4ML9OpsREkCEyd5?R>a)(j zukZN)_=8JDZz1-hTkI7(v*J2fIn~%BG%QaJaMNzc1F}!5JmwAEH9#n`pZkn6B8<~s zYl0VOpgzd1lwiIC?J%H9-)g5KIOWucUwL^QpY?TZhU=#IA6+pwmhUrj6&ypqD^seu z(fQ|?-{9!x;OcP?-OJYBWd}VaC05>HDA+0KVXX92xvQ4M*wBPdUv!q*O#If+f-nzn zXVPXs4Lx+j@Vn;VmECtzA1n_jvykl?&xcY((a7JSX0c0gWORO4s1r`6UuRWpb|yG0 z>FIo(wlTIpd=Ye6%TDh~$DV!b53a}PP^X_(TymRilk4vmL8=A5&S9W-vCD&6oc?BE z_2_~A=Rf67F0l0mqr%u55ruJdX5al^O|*Gd5o7?R3Kmx?A08xgEE7tnbwpOe9A!Qi znvcx+_5a!G!Pjj!Jtq5}4>TV8-0lDFqY6y|`RbNO2>s*74daxrfms`i#gNwdE^#a> zZM9oA)pQ5?UBb6?YUV^j9rh$($CdJ^G4=SVYN?UyfHCg-$<3MHm2aL+=pJ@SQ@q6? zdh_9_>{lo82%wa13GmG~4S^Dy=HcT#*WEvP zS?gi6iRmu17h{|9WvGvL^F90}CW^y`sqZLcQ{a-h!_-oqLNS4y_W#uST5;SaT>RnISscd0rOjFa5olSM8W;H4tMTkOYTy5v z;@)?d?d#FSFQJ#szo`XXE_AKPi(!FZh-w%(?QoE$KESFsg`VksDPy;VaGg1A{=4fC z80W~)@N;~Jh^HRDV!U$y&fXcOvZ+TsT%sg7p(Rd(_r)9Iiej9O(KmPN$DjL$bvd7ECUafs~W$fnPoQ!y63(>zr>w%Iu5`%7kxO zGDG;*8I&B>=NiN5JYh4(-aerBld8npJ8dC8lF5=CtMrXv@5z_>4i=xc2Sh52VQ`<) z0j=}r=RC&l4#^FuSL^gE*Km}3mVfq$G+snraTIf!XqvDva5WL<^~XtIB#=26NU-$j zFX)86$E7iR&3HuqxWtLnHEEj(z{p0Or@WSbafjUl!NY$W^RJLF877+(z?{vvcms1F z_sEo`Ut@M`DTG<4%O6%)JJF$u1%r{#?iXcg(gVL}YHCuLM3;*{7bzweEFKp09x?=2 z{dRT6j55v3rhDOmRHM%g!*S$jQ|dYD;Ta~@q)Rth=)oI*=;fPI;lsm4q^lng3L+FBgOrKXvaWLQ;BClIoROdXVa8Q&=7-~E-R(hqxKIiaY zR25J=@eva~7&4UWy9|-fJEz~AKJB4%ZFzYvesOq0$i5YRl5~y(!`4*L zvkY;7AT%sY#{&!4v(*U-&p zuHzVCFwHk$lmuqW$g`sgJDh}1lvEcxfYcVwCF{!g^sV&hvke>>@Eolt`}RM$Fvhdd z;GOjEHxM?*cOK1xsg+5_buI};{bOW#CQuQZO9AP;qYs$w1_+=4o*Lv?;krb#CAq^p z%=`n6vV41Sn4|tE#C2Td;I7%FGYtbVNn|?WnD>!yW>3!JBP-~dP5_0CdR zC5z1vcxV(TGS^dh%Y50+PpnZ4vX$N9InoXST^Wc~U1~~1?O}&~RvOhAipe}OBtQy5 zo&KN{Xy-AOSaN0Jj9%#$46i2E+^T09os(bDFdDAcfcjfpDC+(b&<^Y`sQbe7mATO5Uu>8Y%L)4G6bvcLFHF})b{K42cbi!#^@VAxMcBp ze>4|Sei=+XuI6pH(OgtNTz-8E$5Xl6@q-JRZL_}fsCCf(K+hM=4Jys%WAigX1HUh4 z+&NK5{z!a@&h^dk7Ku~~=WLFaD}29CCLQ41PR{H19lbaa{lT?;l@E7dvACijg^t@m zRSkfkgAiq4n5tD0D$&RiASM+^%v`5?M**41 zRgNYJLCsHuP{;Q| zqJ-^gZhb+Y$^ z>sb8<*Ov@A{U<2Gx#Z#KUC;Zz9qxH&-sdC8%`Ym>9R0*_RBg|$^o>T`9U;2oi;WnC z8nr9zg_{C5sgTl|PXpsb@50hJEwlr>Bt=#TTPr}iOFShgclSVJ6bW!vNZEj*JTkPi z+|8d?Gba_`(NG)JA6!o`xWuCJ$qhc36fmR?Em4eYw4RyoD7!oPXO%5(?6!s9+vn&h z8xf#{!bqab*mJtBDKZgzD3yShOXo)VH%s+cUH&k?iQ3y#N&8+kd(CCi>k}8!|7D#* zLSZLOMWJv0+A_Oc{Ma?59tnkl7qm5@*1d*J8CtRlc)&`mqw_;699G@%-%B9Z+Kl-t zbyR0n{4Us4pobP)MC1 z3y*P%t*(s!PMFOo8M$}yLV;e=BXunM&?fB!v`NZVoJv>^4;=RpvhK7R*f)NZV^}54 zn39gfZvWt7ajfB_&-vksl`nqx&NMEL6+Ze%y%|w)Oqp%cThNZ3Icl7ADBBLt&~5ni zA++?##z(=FvG8NUX42){)b$1fj{wh*R~rJN^Xh-{%d<-@*9_^)PwN z3LYKYR1y1!YJC(}`Fs3|LK=OmsF&nW9fZ4*Y(G>hO!eRapRHMg?(XtU@P%rBJ58Lc zJFcHS3SEB^HWOXq2@1)r4iA1`^@q%@_2fgn%9Uk+kKzF9&LK?mQ>XO~hm+ZIo{x`D z<3{EmnrsevJl4n_2p+v|tM^#AX(w6#=idfJe{l>R0}1b=8TAz-wG*0`ujZ~HJi9i9 z@Ena~uwMa*Zsv!>N;}QP-wQoEuHtcZ)X>`OiLrBokiy__lZDG0BEBei{suNn%I+}v z-kRYvJZXmhJUzzMjJfmGvFb%Nh+uQ%DSN7%tMl}5{1 zov#51(-@bOtKn7Een_>lSJO%4^Bn zag-JwO~PvRW|5#pZ7Yf)Y>6W5YjhfZ+3;JsdQwQvL~eDERng&K*)7jE_5*?fZvr}< z9sCD!V= zTmw-*zbWlhaJn6RT(H^97m^V&qup3SciOH_NQ`|Ndt*oFn+F9M@F-1BdRF`T#{=xP zwy>^h~T^$lFWuoBuLtON-w9V{fQq5N3_+CpZpW_uMxu7uwH_P0mG z+T+@-=X<&LCJqQI*Fs>LV-eY1XNI{5vIG9Fk81|X9U7ur!{_hUul4Q=$>sR1sc$Oz z$JdD;Pq{3wUspJO+x#S`e$#5GFD)TwtzM^|o5(f%U2F$byxZCdvm5nU_nF8SB0!9y zq$Q#NZX<^oLrBP1@1zImEF1gnZQH4isRqubt^aoiOSwYpL~88yL1>2`kwV0ldU~b2 z?U}8}apU1V*A^X1Kyc*0{>3ctzc1@DV)ypA1MaFAT@apg*D@*OP-Q%|);! zyi8iYN18ln=(nhg>X2&bAG>6Yf(N_a<^BCXz4%}8co8rKn-NTKw(|?naeik}mV@$p zpW{tQ#$_5-LM@z1;c0`b%=d!7*V9j+wz**L?V7LCLuOeovl2xyZoTgP4;@+MEVBq) zn?$&8ithX!rqsC4s?^ZNHM{wsoC0#t`;a=sdE$m5eRM6}6()QR1ZaAD!$XivWEw#@ z_n2?m>3U{^?y|c2FZj$92JW5B zYq>$InRxpgQ&|NeQPRmvPP3*T-?nSWv1*}=uPxCJuFikS+t?CKqty&rL7fet!mL*W zud&VYIjC_pjsVu!eZ8!%SGRAbJ23WuRAynEAfl@i>{)^Gj3{w0SnxiZ4d+cN$yU@l zPHZYwrFuktLl#CT>8q}E#L9g@WluDJT+IVI!K6^FM# zjH+4`4rb$+Sd8~WEXXN$`^{>@YYE`EEVM22VK9kYefgl=kzX>~Eu80w>6}Y*=n&>t z>(HN<_6~R@NAL2#G{EZgnNqM5`f$1x-Gd)9euVVaP!QB(6_Sh5v-jfkMF>zfH2G+8 zoJe)9stw5lmNxL+lH*(+6^gXlLuW<<>RRBK~oyJ zgi^d2TT=y9kAdA}%vN8O5^31BNbry;b3TFMmPBX6W`O=hy^}+ef-Lr2=C|=0tQnAO zQY@p`Tiw_Rb*zlWnpMtijgJ?n&fiS!dZFj3+e9w4aoMQcV*3NFsN~H$U*ET59(y>Z zUF~=#k#uCgrl7VG)}|Vsg+>TIhqOhR5t2ez+b34hG)OzB0gT=Sob7Fzw6lioZm`T8TjFgeS^3>GkH z%ej0(A`)H@4T8OUVQb5@Dyhubye&8V-2C4tIG|-;H6 zi`sk^s+frNDtxzZmOcW3a0u$t$OUR0+MNvPJOD20kl`FlnyDJY))lQ4g?AO1X13#z zZM_f|9q`$gjj_+1!^y?OegV03RFOoOaKdS5Q-oN7X%a#%{2h_h#wTzZg~mnFX@ope z&-=WRYU?ISpwbpTfeW2M%SsmM<&B5h@H-5_Vk=Nc%;X{nJXQva9cz0dU z)rI!>IgT)*BiTD13n&mHbMCW|NmRe875R80D^LNzy;htPbXvAFY_mk^N9U#o04+UX z?>NvmiJgHDWUATK5=NNkEx3cR*$d5{1a&AJv4k(J9FZuYE5W?NNPfZQOsG+aI0RmN zx*f`AHZ0I&8zC+L85uWNL;tTd)*GzvBRuseUN7Gk)Nce=bKtn}T8TLol<76O;O zRuk|0nH?7sh)l7;F(K_7lUU&24LN@9S51uHYDy_EVd_ayvIJ|Bpp0E9=U1sq?V1a2 zAmO7{ zJRspcgxK?l>5DUcr@zN|Hs~{&@_uavN`@hK6w1kK=C5nhLj$bFyR`8LO-f~xxgxA0 zsq&-jt|aniC`2GyWzmDiHup_=TRz`ox!TC1lioqSTLG6K)-4`c-sPyAE3ry@yRXE19B!gnxs#0}6%eAzkU3(v?g4jE7BGwe5Y?6gI}p zS)PUTEU%k3Gu=&e7%D15={9R}j)KF>x)OPHer8Gh z8Xat@sMLyHJ*)``r&`#csCn6Ku2vvR4n8|0o))Z0Gxkop@}VGzr(APECw{6==fk`& zlaJSV0$D$Xor0H@d@A%ZE6jRX14SnDq5+#mcRJ71Q*iAWSbIsQ`~DDOGQg>_)dV1y zIg!)ITbkjjbHAi$GvTD9ptgt`DssB+ntcb2p0IGSFmjqQ9A6ch6q(VAAd@CctVj8=z~ohU^M!XgP|dAg4Z%zj zt@f*zl-EtN4$L&nqsgMt!ofcl*gh!OsViQ@x!C3jXCeDF3JO9vyoXhrkG^SJwS;e? zzHEmaW4EtPYLfayoSbuw^|{NNj`&G6W)=#U$CqqVQqDgeP4z4ZM(OH%D@I5zD-7d~ zp7oj7I^B3T;Q-?$je#19AxJgRaSCkjpx7?b6ZVrDbNAtcacd{7<7TSe9e8Y#saDdEecz)XbB17{RO+`06L`iAxfPyvc z^9fz&(q`^1-_Ltu&sJPAa)6mK9+2iX?d@PnUC;a-a{_BzBok>p2DeFyTT`kNMgw_O zuGa{pxGZnGc@kYHS)&>qxIE*fW-`^$@9p=!LEx|lWn<$}4bL)B86Z$)<{rZ?8*<`Z z!kHh|0CGWz*ZP!?JSbG^+bKA;%Rd)Rd@bLT9v+pUFx^o>Z1d-DKh7dt9`nMY`6mj9 zu__*n)^UACl)6l=d1Kc5T*2AiMQh>Bd+#O!C<8_)abNM2^t5hBJd#gvNFJTdv`We$ z9qG|LrLybbzKAeYyKDp6FP;MrBw*IB>6>azf?$g_f(J6-o5K`vlEmg`4m!Mp*9yMTqW2~R*d+aCsk7ij6<1>vOv=LMhD{yuys zowop@MRJ)7))x}e)=5ni(1j-ql`y#nE1BS?tX*y*8Ku@GaLEcEJkNU}efm}4LO0!q z`+K7tl`j-pX3ijeF`GD#zv+>WrMPxNK@UPc7r9gw;mB6HHF0JsawW=U@7ls!Kq486 znqq-7roFemH)MEKPppX+P{Y~>je;wv7k5{*3hj!@<%9&q3ckrc>wVz;T&pY2d7JF& zH6FuOrA(pr8l5UClI%iK`b(~XEn?nH-YX=Q#9;Caq%2eXk0-20ag+NCcY!i9*JkxO4{B@bQp%F}zk+2|r%19w9 z98FeCkj7(i;ZOx#u&sbGaTgl$HCyLkUUyzTZO6B$a!v9}PXsoSI8u_A`1g{u0dXEa zsms-51_~f2y@*Qjn}+f-tRGnGJDA*l;FxiQ`#rGVwp4g1<7#%XL!F^*5uV(YY<%aDI(||xT6A8>F>ute(8xt++Qj2Vw zA;MFnL+(AfsXz;5;>6vXlK9={o35OId!Em-ZMb}9Z_B&*@|yV`fyy^^BM60Xl-3IT z5+xRA*D1jbVP}z9NLKBa4Oy6odtDR;99+?6g{rZ&1+kQ?9<1E6=bX)Ou9QaBa#8kUU*58a5#(Sv@p#cYKsLTR}ojx%GfewW}qy@qo`Kd<;;RTNT7Q;rCy9SJ_zT zR=Zul+$g$V>qvuG1}=ZDolSE&MGTYtAcQ$3kS+G%$GjKLXyec+^&s=)!ZQe>TK*2F;<4W?d;bC3f$eaUj z+`ND<6spqZy!{{?tCD#XfnV*SrgxG3FORP?)hI#~scKV9G`2__ne3Qo38-FBgerAp z@L8X}InNvz9oROxpXa3Gll?7U#eOeL-!s!0kN65@1j7YHZd&Q6uYn{!bqR++%ld0q zAtr<+61LRQ`^8Tk1_31j2CPtPJkh)Z%mn^sKhXe%HJ{_qbu+HjzEWq2avQn;Ry+j~ zW(Kqp^Crxf4-eZZ(~nC{2i=r1YP+@_v#g7tP|F(zqEr+R$O?ccgP>#XX7i6zB!~yY z+KL`E-hj-R_-FEUd5lDA8GOZW%h|^bzlp$knN&+4YU~=X^#s-$bzE-hxA7^io&flS z7D09O*2H71i;T@6tZyHa$@3tMkajC~baV4`j!IapYx+z_aJ^l3zKlb*k>x@4t8_Xl zLoSVTg2sE{S>MIC(YJJ^uQ02JkCUt-34?0{XbP?|5upYrFzzI6)q3k1dmyOa?o4sR z5+DN`yxO?TJ&6F}2Ug3MO&m+OjQ%SE8vpt?EW6ZK5+RjRj;b$IY<5ae@aXY9|hxxaJ1`kPn% zT^9tP8r#JT4Wy{q$;ynW3G^DVjSe$pTz==z)%Ntno!bT}I6GS=0F5k(FPB6~iDvJ4 zcy7JSNqBeqzc?WFpR4)*{qtt8aj|IA+4vqCQ<4KcE4L?7oteM=6Mu(FU6x?fLFvR~ zbWO%U#~yML`cpr`xwQ$aU*WR(SJvN*ND-G0?N555+h<%Yu8)>JfSl$p8n;;TI09}6 z#mCA&@@kyFd&My$=w?yU>TrX<$RDkN|4aY|xpZ*cKAP!D)J!SZ%7!N67clUm25L&kR_V|KF)`TTS zHwL!8q5DsJ03Q3$75`zT$iK4wC}7tA!%VaPG!gly1l#q0mAzS0pOM6IME_M@M<+By zos=R?iTnP2-u{XshGrstiFQ7r=ND6QRz-YvkA^nq=J<`@{*@Ew_0@;ISXBQi$xHf2 zLI%eL_*XCft2_zT2}S)=#AkD9=syx>Vo%vNEVo1M<8y|~|44BC|Es(|{sm&;Z(6Cl z_79&t`pN9CMEskd3XMbiBkO%1rd2vKE)>P6AxJ{pR&oH**Y#e8Y?z9+9JW!b`F@9v z_-^b;wnK*jVI6i}0|l`nQ8vw{1U*nAffD<7(Z}2s)5@eVMqi zhD$w8 zw{l8d&Q^^-l^BgU-=-y6=->R?R!URvZFhNS~fh{3)g0#^DfA$K1)X9wp8fVtk#U z)^r|%ea|yHF-0&Z2pw1hM}HrD@wD&pqbjAKBrVSgo?%;N=te2>GwIom&Er9}&?rAS zwUK&<`By=mW!DDwp2YUZ2$5tXmcL_)?#J^#Y8V~qDAmwx8aodsAKF-5H&eZm0t)!8 z7|BN)510)}7V6<~Nbm6eiPp5=-<^BT0EK_^4ES&j1CtcnsIK>|oX@^$NA`X`ENS>Y zv+Il~@m2L&`dE?xyf?bafJmf2LsvtXOAN$L?3X;<)wH8x!nNl#5Mv_!^Ow@oF833p z8U|st>+jg>uktK7V)F5I$s|EBGGM;PF!+I7TdgMhYlb3bWk-s`6=uxr@k+slYYO;s zIO|N=>urWHW+yXP^8-MXIzG-M02-!-icG$oI^2Fu0Hx1|rQBsGOiPrCKiEk7J} zO~6Yn1sJp-ifg(a#aGfVg}6iGoU2!9e4uP?`@V~_*NkTFvpHx7Kju*8dbk#z{5Ba% zO~3lZ6BI~#AqI#}3~%sZD=1Is2UaW}L6e}PYh@*s8IlO#da!1%-I_OmyieevusW^i zpS((FLyoe;azz)f&}D58(!Uy)+&?g;ZSq8IkrO&_H{Y>L))Pf5dsg%Gup@u`tnjaV z%Rln|k}@#+4<6>9j^&)hfABE!f~ofQm8`J3#C>=gT|i)c30J0j)Zxi{4GHBK7Ht&noYT3@9)=d3S6L@#{)n?SL zp+&?}@9WSid=ZUU;qqIaAisP%;7gMv<|UduZ&IMxcY5~Yn~I&%f|~+9RP535Wjph= zmm`aKOlgFzcn%Xm-VK`Zsa>A=^c}F1s(>A{T#j<`s1CIdb=#V@qnz+oz<{X5rSJm7=L%0TpaG>tjB9opGz1hh+H$G|eAS!3^LSoA*o#gN zZ}nWc&|6v^`nX?LQmrt_0g4cmVvH;=QPfx@dgrZ$`nb}I1P0;m8&=~DXL?>^wF7Zi zWe0;Uz+D@)O|%2lZi*il7tkNjdexE}v@J5MM5IQ6O_@(DecFh1R1_^wPhEm!sOM$Xyu7?yJAVm+UzH(O@D0Q#vfdsZ~n(afa?^wndNnO z>6p{u|4Q7=H9IWPzuo*;;-3i)z~Hp;>#vwbXOueTau>9>?pZpYt(w=M^+5{6#OP@_ zg8)WvuYuimifuedpE5M)P){qqtdFgEQL)sj2dL2xKw4k=({?^?&@@yvbXb>Lr*{+$ z$jaOI&@c=IQ2wMWMc^AH$%iUT{;|_z?JE%=v-(Zn!Y$j#t=bSCt-+Fx6a9v7K%S%7 zB~j&GdBJ*P-)uEp#qFrnw&f*U)jqQv8d|n+c0tqe<{y*!U@xCX7EQgy0S=sW<#+Cu+fQ_^IYbs5CSd9BZ109H zIicR&Z7~zEN-Pqxu@F=u@7pqR1amZ|HKZK|h1c42f;d}uIho}aUFtU@TIIZd8j)E! zEK)D2RVzUnH_g_77;Qo8EqXL>nEYZ^XN;g2X)BJTtiD`UsPn~*Cc{fCHSJ&K*#d$f zN1qm~l&GuBMlP3~mbu*FT3501+}D~POJKlo*2ip_moIA>3opbfz!m|NMT^1}onPx> z!5~20WU}IQL3x@HbQdtqqYc(CmjXmJ2gFW!lX!#j59`Uf;x;9IP{DE(&<0*U`Nn^| za`m~1gzr;$?c&7KFFC`wf)HI+-G>&u>~uD0ys+RtgCwX)i_U-L&5Z!ilyjZE2w(ll zae3S1wTLRsy1w>Yh5P08ikx#K=RDzL2D!1`w248>0kZt_hUy-&Y@E4Ma6ZoR)ft@I z63IX~k?H{zc=39CHtEXhY*rVH>YMLGb^ABL*jRK3==-DYq6rZd+615J#JTF9?OQ*Yk4&y)qNYG4y;V}0w(Y3oD@P_ zV6e$c=VdQ)Wr9aBp5?ehOn5VIy2@abtRQDQ}@rB36U<}^Su4K5L>)MU2 zD$v4dB?Rlqdcf%)OP>Bo@Yngc%4Klo-L z|Fx)LLY^JmDT!Nf3c#9oC~e?#H|0{@A^~);47{>8xo%M_3n)cgy0jKnIWX8b2xgXh zEAfCAJR*;0nJlG^3$48w@1%clJ+D8w@&XiUaPQM0FL+`N7-2?sMW*nfEX!&$gXyp* z_N=~BE1Ip#(`^YW)0a{ON8Y*3a_E|RQ+8qp2)Ofd^V;*o$Gh?-N~?yLEOrR1$Iy$1 z++?Q_Bsp>j>d)wEL4|ki>ahC4yTn7T3+hG-E&v7RR}G<^1rh_H@t@mHvxohj4Z}WG zK%r_94p@nFj{0a>8bVB6Cg&Eqv8Za`$iJj&$->IU)W)3r;H{?!9T!#-tBNL$2RMEy zAViYag4%;p@otz0Egz71(ZU;hE3whJB4jPI0WFuAG=Z*h)!j@Z`)r~45S1>Z8>M3R zGpmUQS3tVgpDySPVuJ3DUsu*5Kd1JW^>mw6l82?jgB!jD%^@j3Mzm7PQD%jdqsizm1%=7rbI*)+Z`e?&YGcMPK4G4(C=B#~Tpd)rQ?l+s5)k~g zJlWO|8_BLdod;r>Ek}hHdk;4z`aD98yxg^puRYAKSw;$&4{00c4?_h9&?NiiHZu{O zAVXTqc1EKhaZ=MnY^zUCdGTgcDxUVbRE?b*rk85&;4C63tQd-v5~hwCB1bFd+F<}n zN1R7`%09SgiN2S4%;Y#IG(!j+uvqD|NljBF5+JeUFHgFzRmgtmtcV9TZz`6fdfLMzewj zr8Jq7U(VBti7D#cZ6V=mUsuTmHzlEasX#*Bl0c!h_dH)c9Of!3J3e*oc?Ig@5V^qH zZ6gZc3E~5Rz&hGs7ld~D5T%ft8%&hUT|>{_P21{84|(Iiav=}#vfeZguNGmct7uP` zO3k?sCC21m&3p*^Cx;^z+0{xes%71+E)PG(Ho|pRLd^}$z2R@K8Fbr-1 zTLJt!FLs-hEsaoJ&OgnzB2Rc1IU|7|E(^80I##{CcPIZ+>)p`Mr1o zZqT>-Q^`v}NJrmUSpsF7(jv2G`gkMY-Y$PTceRvIDLDDG9Fe~C5$nhH1aa%b>@F;_x~>aFYNVKI6)%ypK*nse7J~jYDTFMT4>*OJ2s$p zDVKgK{Z};;!&;**Cc607IZc}aGp^d{av^*f?`sD;S ziFUQU@F05PwJ)w*{9}#J`=U$-HWAh1mv3gxLb@|NMk^EI-c}t-jUC^vOj|N2tKSTb zuW!s(_rBUeB%k7^Sm%^G5MrtlfK_oYg7BfEogvM}kP31-H>Klk~+Yq|d><8Oe{U5BP8&73&I zUx_Qywht-4d3z>LpqHOv$17?Ap;|*Tg*YJ?#mq}LavvCKC=wF!04?t+byoDsx}|gw0{r% zt|Ti`!5v%?)1db7p;~R=!pFolFZ!f|km4R2uxGqRP$QpVymDc(jXtD*zF@I45x>o{ zJW?p*z=i9GQ3LI?tQ?&TnhySRjzHPjiF*}#z1R#kYMri*22oY`ugvCWVe(=ggecy- z0QJu)huPW=42@Fhs+B}c+%=N@-kq13h91yclV@|{)AqEjfIa(yNau^NzgL7W6PHFt z;p1X{lzwH>Q|oKXcV@V%CszM`h(-Q2#2|kSv2qj^^ua ztAIC!)u0ZOfTChN9>aI-6c66dA13#_z)gdUJrucFyeQWY{=5xAC}Ge}1WiY!VEJkB zDO(qsdW*;##eNxCSqd|KsM7TK=X&Jylv>gVdJZlM51mL{IISumr%+B4yl?kjc&F^+ zNODjb0sv4?30}RkdR9R#SKXt+a;b#VCr{C=GW4)mjU3VlnRy55k}{Z1rA z7k?^0ipm=cf6V7dt?sw`dC`ijeQq1rCpZC_h*}A2CrbdSztUenOD&VY=J7 zSX*c8Mc~S33&yumufqkD@&`!zuO>Qo%~btxe(Ri|lkl+=>|9Tv`;gH0Uh;|sM5?s5$1i>4=%ns(~r)llp3!K){?2gx^N;1dpwcW{(z=T=g(&K z&N_oE4=G_H;E3kkb4z%$8AGVCK48bpu|Yt=&{{{}kDL>h^&+dly!NdIaW?x+6b@6KWYz8e2U3 zN=a5vOIf-dO_=nG#;4Mup{#jgi|*3ukd)syZk@+;@@DbocX;yEn-ggU%Z;l&rFl*?5XmX@t8X2~~D2ET=t;WrSq z$&^&zkC}{u5Qt@Q<2iyj(YA~|^KmTXO` zo`;rMy1XXox096axYlK>sF-{$w}|1v&9;{7J1efSfZ@&1wd?-dOO~tRj$iG7nbm3N zhxFf~B?-@#J51!#>yek`a_9VNp~QI(W%sMEZ|cX_)59%LR!zI8^m6zcj5Pk);xN6} zU+~LDa3<85K&FAOs~SgZ)wf4o@SOR4WQ305obqSA#VC&qhNtKTzKlL;89(k zsMxK+-z$a{s%Q>&GH&RzQ|HyZ8wFo3$mL=Q52giPD2m5k%)H8m)38T{GPJ}3k~!K} z>Nz4Zm%pp9-SG=$A`KD@004p^?|t7kFUw934rnU4eh2b9#tX;K^p2RU-Aq3&a1)vP zrU5l%yLjY9p9#IF=xh;&e&Y77-y$e+bqqOt>AsE8hr(oK^5pqk|CxmD#Q8^cj+fVL zoMxbWsylMdHmV>!HBFvyD9ydG>wQq0NSgrVCzS>A@uldMw#>MWuv%zaOw}04?o8yo zu3>`2E7+>$%bvWmbBqTTX-A*h{W4Z^n~m6B6e7ygIkZ00b!LFEIM@Z#Ttnt8-NLw> zt6+6%BrMdhM}B`l#}bI7(l41C>lJ7*q9O^nM1=i7LZFlTl1)`K!VBBwDBO8Z zGAS|c|6=bwpqk9~eqlys98sJ>j3~uICjk^NbaWI#4-k?NN`MhWB=pdm%rJrw1SAlU z&?G=eAs}D^p{evDASLwPyNH0IqF+5WuT%m%Yda9Jd#PXOqFwznZk&=?^ zWN!nyCvPVD?Ga<^&0xXgz+h@n-;nJXZm`wNoIwU{-o5 z?`Ztil`a$ws36F>mKJI=V))SiS#bf;b;dWFZC&#djqH;MS;(muvJYhUsx@zrxFA%o zx~_SW4;Lm=)GE-zE3u&^B<9Z63M+_>_(b5I(D!!O=PH*k4C$*&73mbIWy*Idb$4@ z2XVqrZjexZvt6C0=Bxmjt+QTJ>b&=)E#3Rn&0_-NB2TOcq(uitT5ivh80cV|h;jv9AlfXErN8rhY3tCl7R1O;>n zWQzxu9$`R{THZT8s@&jHAgu^4-rr}MkkpPP72c$^ij%tmlvp-$9VQqsXoebi_42+I zMr71&_c>gOE$b*@sp%#j+Ll}#+k~yV5RL2(41}LsYJ7-FfIEscEC9-n>O4EC?^SO` zq1dLc=M$)s_e>)-1XP%3ZokB2wfK<3QK8D8kczD4%`$X)HdkPU)TLP!n9qq4nUZ_Z5NGLin>>YUpUQ@WLdSE;?d_s z_VWE$s+$V z5zZJKxqD912d?vm68*-Vn-S8kpPy_SKSpSEO75hu0zX62J`85}TQu8AOx)1HsD)&w zc{D!^=Wx*&uEe*V+Fx4sn_2B@NAx!$4@;BNH1ZDl>zi*TzO>V6>4KtACQ?#* z4?AbVkTebiF+UG!n3GHGKHYTnpwE~e;FOqCLOizUzBSa>j+E#XeXcCa5v2~6bPHA_ z9hukn{FOhnvupOPVk)hW78T!eJ4eIG{}k8aD!hY4jA7^~S6R+%d>860&`X##O+ao| zTGrpCELvM;utqZ+Eg0zQf=a6A24iuF3(atCk!9D5%}(_w6RKn$K2-QjL5&g|`SVU1 zStk`4j`fs4vys~{`a@qt`(iYH<#IX(%((|WdR@5x!# zUoI1TS_2EQPVVyl(JPp6%Bp+<8;(e$8DAHwFoKJmkuFH4UEc|Dnse1g3WV%t)Ru&P zD(%HA=4a;=*AloA>#CcSURhH!Rt;ky0S8v;b?nk;mvCdHm3P{25tmaz(7=Sqlqj|Q z>3b`;A)_du20(bTpaq_RsUMsuA>N5vxE!ZEg+!T1$n~jtJ3GBB>6SCsDFI@bcai^eC<(HmlxI8EkDWa z_6WA-!UzKEQCgbxl!a1W+jntI1ma|@7}fb+K|jwYP;29`$r}qOytAjq(g1X~yWOVa za(3Bj*Kfbqpsa!k^2bkmvW<{1sAQRCCrl(ru`wrEr4zlcZc0{Z4)%TS=1#EhNDM;t zUz59)(W`0zZ$D%DwM$ zbja<#Q8>LYiaNNe`MtT+yQX_i%=29DeMfxrI0yow4Ryq`n|Z&j8#p zCABfh&HhHYaaj?M%@eBWut6Ix3{wftZN;s!A6_2gmbJ@;%PMpxT*Q!kP#Xbz$0_V3 zkS2S&L%O8kH&-LtlZ0QKj8w;CGg&1*ORjhy2hecgO+~m|Gyk`JNbGKETc(^8KI6lB z_r6I9l><0)J9{Uk@71V!hU7B_cY&NEZnQOzJdo>j6RJ#?Zl|iQFUjuSDWKWL0;fH8 zDh#eFcE3tyi*n`?`C=}g7&6$2hMhv`&K|pQx?b^VT`*`eOS@L0Jj*`O+SI4rr05Np zvvY>11=XpJv2mM1s#NklZ5jw=3b&0e(r6{9CFv`*+gw$#^mTp6#|ocYOila>zp&o0 z>;yJ(MXVZPUl6xEZy?dDlD36aRIZxMGGQdnpg%Qt4EY6It*|VY%K&SeC6qYtrSJ`D z3?r;AJDx_&OK9)UEqW}i*Q%0^BI>g%^qD6xI=vDpZVdDcQiG%@G!DJ8wy5vX)of(R^iM(D0H}zzD!pAV*+4G= zwX_T~t-Vh#G&$2f7>+*9mhRKiC zba?M;IBm1+%Ei^PtpPr~*Wsd)TbuLoQ(eoPPgM6RUoZt(rm+jVh9p9q9q*6$1q#Q` z&n>uWSNZ;aDR~{IW+XvuQ37=PrT-9{#X)SJbIv(qa^fLghAG-wh8+^$Mj#er0K8C6 zdV~WL>Cd^E+MAzg`r$ld?qr|%9f+Q})&oM%ZzvD;xYscQ$Xyp+L8m8CWY_k?IW5Jp zHA>~Gbya#J4q9k+X(6ISf6wcsMo!xA{DB44P=2y-u! zofn@8t#Z-GF{hL~8>m#jjXUNpi11_lR3}e@{Q9;ZOx>AZZO{-FDQ;DMD!- zoXdcU1xOOgVXer+ba9N%ma3l3SepTP(h{LKc20PIeVTdvmI86l2Z2O>Y6 zW!NvSxJNV)pEuE@6QgWbL-OK!nPZ}WM6QP3Wy?13g{-~|?5{v^Y^Q1L>dX+Bh>M4h z{$jyhZtOo2rP%jzE2p6);PvLq9w9POatY9+3lF@7SzTIFX=V6F7jOXMJ{6 zpOEhJU8KM}@6{@#k-7Y+viD4*d&1mATfK9S17P;Gqm5_^Zr-b5S30!4N2ds`#QWQ2 z6?%YhzIb!ZjFA^vG?3_x822D#ejqU~}CCTjg z0IgPO(7H!4s3)2Gigh-3x$Ds}WF)O?N9@BXBhKFohEI5Y{bQl}FaOL64y-ObnR&TdO`QdG`@+0LV-VQti*E&<~+D>xfF$L$29eS`6^ z-4VQ5F(#jz51uf=q&!9em(J~`ZyBG#xdY2{fCwA7fhsQVMzw?!eL~l ze2QBM*R>m1MTg7MsLj4nELNwHox>`vARPA*)mty+c&WDzW}j2LwW0V6p(f{0|J{oE z(K6D6BEX{g{H8ihOqdzhC~Di}mwxOa8#UFGYv&$SK4)MDDll@hlQ^4z7(s-JD+Y&F z0jABu3_G1V&tw-Qj@-@jNZDlIl?{>TOfxGkx1P^j5B*T$i(&U^I;{$YGBO)dK0>vA zdrIqvb&xeD5GJ5qXt~1&7l}7|$txv)`n~XnS~Da*d1C@Z?SFK9j zt`Q1iB;9H5Qb9?q*%iq!WH&)TFe&97N;GA)!AF?~x+kx^f>Y~n7m=aikc@zEzp^fa zW>9)!H~ee^?G`K;xFk6=oO$)?dT}X(77jM0dz8}!Iu^IRgaxOflnXnZNsj_#@(NZdItmj5@qC&WK~96&{uL;&|7zhAyETy_+Jj6 z=}QY_@b=lRx-!!>3K2ya06^-dAE6kr+TEX>=vJ9XDt`cNHrJ6@DlKIsCip@5O@qvzCJ9WfkjS}c_}=g^H^W&97Mm2LZ5%P$eyJ)o*F5X%kXp& zbO%|=x*Fq95|0xLvB1(tHQMkFMB`qS;)z&*xZItzhEbgAOM6FqD+V>OP>Nuk_{z%w zT;&d&elXm*lwsUa#M~b8R0&_ekbBnG z#l@wsB($hB;;11<&c1ubkbl%!M=y@>Ae^AR<@kvJ4O`ZkZ3!5a-@~&!W?(1{Mb@Z> z>|EF#291&2J!%6~RnAhnuMcME?On3wQ>w|qlS}t+f=jDzm^d8F?`*MSTd)6+X=4RS zSuEl&R@Csde9PS;E@5a-vU@zhN}57!TG!<^bnd7XTgLP=L`C^ zkBqI_x@u%rRcWXOD*@UcT<%69TCat)|NJnni{TZ>LiUFz-!<9sZMWta8&SE0EdEBS zSqHOa%2QHE;Up}OeI+|1!YtQ)69D#47yc-O^!U&yH{O+j6#U_hT%uLUl?+Ug9OibCD6!f&W69ib=JcX^pKLDOPN93Mj|17tZ{`QDgC3mct1WAy)Y;C~ zz?(%=phq6P8kr@EWmip38fO|(YB}npcZxg}Id_^_IlU*q$X$_^09qs~R_47B{(E{Nt;K-z7l` z<$kFgTcKjseu+5ILlnO6CngTsV zH6L^Yx&62VLlbv(>DpLos{2*G+}aM@0L0Ow1N1DqnM!cOvdy_jQ6Nz1!u^gJKu0vB zykD%koP`O+MdN6YjDgJ&>*3v&{>=Fe-&QH4IShM9S>_6l#UCQ)U-k*>f?4NEPglxl z>gD9fU2=xOU0|ym^j3Fx>e`0n;D{R?M5YtoN#c8}47JzM1uhhGS4cH4wKiI*UMJU%(?JFZ zJt&O}s_d)B=LSh3A!ryG+X+^xP&*qNUQZVVq{*d(zMG3KRFN#|eLtl722c@;iyl9jp9}tN)PbKv^$v%TyTzeG`2wall&01`0cgOdLlwKJpQ7JKjHy`N~4_m!z zLLv-YXte-TJW?o5_e?6esIanC*T&9B=eWISfRaYM#N&mIvbIG!I-}vOH?Llcdd5!| z%T=JgEaDGo#t*J(vWBj?Y5?AuW_!;h>coEgJif^~?r~*ebyLAVUdI&Hv_~U%NB}w> z&t&bp4-KOZW$hPNDrgw_1aSI|w5%3PJ8W2@api*>x9n1<>uullz%*y>#IQU`Zn4gm{wx6_4R;YxN^&rHD%;|vc`c1i*s89c;RpC< zu27xA1TwqNVS!9^7EI_|Ln-PMHwdTPcAvHaTBAr(-0dt-Ws?g3! zM=t-I$x947qC7M-z#@~ShjiJLXk6EW8QMV58G3SC{6N)o21H5=db8EiNY~y@7iMlc z3f(y_TwGSUnBTkZ$E6`7&2R-x`ZO<*Ukh@`?vzwU{UwzpC;E1|&IVSa2Wd(x8B3=p zRc+fHx1yDk(`M`qU`Q3|uo>&2c;{ig#>do$T&&RA;PfZF{5fO%wB*-6uSlZW_6zV3 zh<_4xp&KnO?t;RL%TV%Cps;IEG{S9)UJjK*1v$iiC`5K>;NlvOcWUg;*Yn7G_CKoD zd?Q+1Tuh<==H>`fE<4{w5NgMO85m!rVAK#HGu(}+;Y8T;(}L8ncDOTf5S1o#b@ zbj6cW!wM6?>0V9KqND7$G--`(_lJQgX4f=mvL$Ee321Xhcvp^AW`=38f9Bniq)=R< z>03P~5-oJwa3Xxs?BkNu>O}YiG%}(uf1l5GrzrZAcFpnAn1>j!@&Zc3Cku&1UwUpw zCgl|3JIf9y<6D*`J&Lh&{MMYB5Hwj(6#H1oJtwCMsuOS%ZX#h9?CCC!E5h!R##O@~VQVV&jAav3a&?yVoba-N&#x zsWN@R)!X}FY4Jc{B@7CGo?ING7yY*Wm(i@c8;G6_IwJL(OU{U+b1~u(F zodd2?LAi?sc3POKxtAKg^G>O0nrY!rKhmXIY(t5UC8MsV!Z`B7u02L#GDjtn)jhWz z_^2;3V6JtD{?XMuU|bg$DSM_jRe%a9$oN2dS|%! zoq@*6&2!`I7Z>!wNWsCXo6-)9&3p#U_`abmq1|G^JtZh6KRt?!iXv?-;XCPf*X}Tk zHclg7u~qqFK`TXZ#TZ&?GU)spx!5X4;=*iILuwFCqhR3K;O>Z@Vz0980A|Z;28OPy zy4P>Bep5fhuS*dBr8;qx04*|d4aXH@=yHXAXP4$&O0a4!G`87EgoE6urA>f~SWC{_ z)!rTh!0B?OH#z6da@3azw12iCNX6?va%4j;hOz)F`uA*`7~tS2x@=F#!7m?v|>GfjE_q%Xw2!p zAfk%h+j5knP}k&s2p_+jM<)>~;HCp%=O>>zehC454=$W$ z+cKV=wtVe!K}WYJC46e$wlwT<)f|(VY9?CI)NcGg85V!#&Hk6O4F6|i?jQI5SI6G} z_Upm=$J~A?r7#i_ZK=J&`xhi~C5^;e#6O||w&v-;K73$k=pUStK=!jHG% zsk3XT2Ym0$)dq8($o$Ip&tLFgH3}R#WjNe_8DZ9AP58t=oq;V8&Zg;#+JRWRqsbvP zUycpmKktoxt|~+eED`+TTJ!DUFJ1i(7u)0NRl2L`iv2r!JTz zgu4}T3aM?6&CPRgTm0BRaAfQ64#dBDlYez#{5i@6B#S`at@uyg}h5ebjYpz{HK2St4`qg zb2FZQMB@HONG|Lu55mYh-D20l6q>qM3gDvLs;B(8;`-6;v#i-gCdTuINB@~Puk?;w zKwg~fP-l(bRtZ|>dr~QQUBOnjfd6ta(3RX@d3Sa7qLa>Bc}u;GtU1{v43Hc`b3JGJ zPWS8<;Y;jh@KSxzR~|6=7=Oz<&mqn74XPdVd_~?CJY7@2^fx~xmliOHJ{CBkt8w9I)!%VF=+YM&tBzW(bE zEe4qOr)y5$=@X}6vEoIi9q#(QH{c8rJ2Ws8#lNs$+TEezSyMU_9KW(pOnY*3wb$H9 z1jMV4EEHApQ+e;?CbU07Z1`LVz7<1xl9RU!tzxjt4e^Gt9E#!8eLcNtM#F}T1HUO^ zV59RZk2jZOTGe%7b@i!VTHbS%>dS)S_fWXjrgaZWsbrR z6Tyn)(z+@6G@1_7@pi@MXaG_Q+OW>r2TBIZyx8GWbTk*U|HgqvLDeuoR}fXf#~U($=2FtA#IjgY9oH=aXr4Z>)$&|;zoD5 z2u0;7rs;P8zymUC`_?^ekO#JH+ z9~dW$2kY&}a-*>`>R>=f=`Bp3*hRO9TW}rK>>2|U?6AO_I48V}$I>~yFz$w>3$EVb zN<7g-b|4V;dSqtn7rme^Ma8XTX#;qrQDJtuZ+7`KVk;TE=Im zm_pie;jo`-G60^E4B#4rbaSh(mDCQxI;}RGdAs?>z@`M&{^lk2i3npp8z*N1!#_n+%Eo?v=E|ft z3Y3+G*+5d(J}UL4Yi65BIK=@^(Q@>LYTY`MCxDuopA3fDqUGuSM zFEs!hvAKVn30uW{lFFUu`jLQMLN1l_Do!%eh9Lw7nf34U3*otrsL{%wmipt!g%WOiVd)^iO!x2zwg?)ZRCP67yUvwCD} z0muByRWWy6?hJMgCqhet5o^0Cdd;_!)y@!1>D431jxuEZrlarGl%qnXb;e(LK8Q!Y z$b#_j{*z(H^OtM&&Hr)R#RKI5oU&UO&_SgLx^P*eBd5(I8$a57Ax82E#wyryk<>l< zRpY#Zs<|>Rq04s5$(|Djxg;xw;6Bqa8@Ebq(3aRyENbP<+GFY zBI70f3e}9;(AhE}zIiXdhg&@o8O$@(dc@s>3xTBr1o`}Z4XYA-)UFt>f0B{t#QRiS zIVqp(WTMgHJ8|hP@Yh;JVPfGQqu!c8QFo$P*&J}3$bx-={tLFbTuBQuuB&4%z?v5P zD$p@s?UR?f-iOfYv(3&cM@@}%&8<6g+=@!~mDN7f)*}rv60*1xF|-Rn4#@V@f8NjB zqc3m7Di>iXfc;P0fiPA0k_ZHrh{w0XK@2l;=CdX+CoUe$h*|oG)nQ zCFlAHC)b6;vS~3TJ0o_Im<5B`gtM6fyAp&0w?u7A_T7=YE1<$-f-rlz&C@%l5SA^g z8xIidfj2>?r%MgDapU0wdMZH=>}am#;^CvE6Z9dmcV;ma=;b$7G&@4M=PtnHlwrY$ z)do035g-6xyZLNMy_8d_f7ir{#7PJ7=8#`8@#D_L<0eQ89JPF9BFBguoZjQ5WU>#X zf@_6RzGL{oLpjvlrRK|X_)*b{rXLNMi z>)v?DK4Tl^o8^bTROr7~Oskvr+v&=-| z@pxUg;Z&U-vZaB34>JRg%Tn=;G(XOjf%WxDCm-<^8JXBzOMlkoM~R}bjIF2Sx5V?M zuuLIO3I!KiyDxJMGCU|tB|CX3NMDfJHW-M1mec%|C&#EM?F&=pwfF3-FX7J;YYVHfzKZol>=oG@5z-0(3?>hx zYieRTP(V-~C9YfvDI}N12B^#NLdg?Id#D}!h7s6B(el`QbO~Pm-7uDHw+k>$Q~TV? zoGh@sqHt9c)9jr_wmq&;PBc!V%Yt}7&2R%!Z3L%c5_HIr~FmN8R*?g!;TZd`HrT|#`hfaXXdeH*7MQwqiUwm zBR@fl~(gKhB5Ue4(7oed|3xgL&9nY@Dtr@PG zWQ&1aKm@?+0lks4wD{CcG%o9O6uIAvRzhY_pA-D2W{JCQ}MSBMuUaJC-dAh&28?u9G8A(SK#u!HmsEFRCxVz@7A`4j6C*cnx_a^ zI_d}M{xq9Qzq<#BEIV1X5<1q&-GZQIAIIMyS$Arq8bybvbKN?Df>Nf`}*CuPB zo<_Ug@oApaD$9!eJZ0@HT52TK(uc)hy+5~!M`u=za?qt<2adz-UwFP5L;w2o7benU z1G%)u9T9H)&EE^(ecOvfZu@bmTwPYm>kC&u`)eLDAQerZWkfUK|rdAo}Gd7Nw56M z2;S6SfX9DKBzeo_0~KX>L3QA(9kN%G2trA5g^jvZZ;sDEqGfEU_V%tU6sM0fG)7s) zP*Ip1wgy}};esZOm zjmQxn)hw`<1rkF*saTp(z(rn5^OJ(6{)50x}faYU5Q@ z$r)i(yoS&DK@~t^r_oCDO!%>vsAN@lg%XUdrW@m#B^<^sCC6=nZ4NQ7aGad^5!|Vc z{thCg!-^qRlUX^5L|{jD_UH9D2Hrlk!Bay}vDFG1S*od8g&F%yNE)z!y{?yj$@U~2 z9Z;6Pwc%pC?>XAZ_JI~oQ&U``EJs_-3*~)nHUir{Qwa#xAUKtZJnmw>2NMv*%};NN zzRsD@xa}eEVhqf@lo%;|+s(Kut!qU<>3-xMJKe%2Gt&@=Y<4;lF|392NNggM-Zzc_-WT~Pu(p#T-an601J)~`lF2&&fcsjl9YRX@7*2BP0f zi|&p#?8;b%#Xb3pG5i-}_rEvqdw#R?ANkBD!^8J0&kq+wF1#Ba3WG~tQ#hKJG;{Or zMZ)as(6e7opa1*uAyoX0W#FR+;Vw-v+(kAQOy1mX(jUy$d&6n|37=68-MFZu9fC*U3c_v{Yd2b*E;yd?AEuR zLHbv1cNjH>BpxV!{@1^GuK%kH`%gc%>bKnHs4quIvOE|6YnyLJd_kMpH9_CAvCX@s z7TVmHi~MAO5cTI`UP0LUbUQk3xEB6qHjJrOXnvn%`Sf%cJQVRke_)buO~3{8oxvaV zp3oKe%$fhoPrhw?zZG7BST{TN-uH|p@WC7V8t*eq?Cx%ng|?nPi3=&}g+fgb?^ZIpQkWYq%no!&s0x-v>U@bc+TA96Onb*MsWG4J_5I{J@JwlRJI z`=egu+b;n5zx<>&R_F5t5J5{YDqn=y?}wwcb_1%Wyd#P`yx~GtwT-zJ(~adlr|Sliagq} zVAeF98zkT&PPw-`#(L|Hy6k8haJWeiBMuf2(0sJ>>z{?ozia;81OM)UKlgyHWI{rX zIa+2`&q8Oc9kAA}t~Ts`vs4smjDQ#}x1Y9{pLQR_cC~jySC-RehmXWjQa)tNQBChfn_c z=XU?cYks(MAovBBeriH(Id=z9mHA?+fam+HKR?-_i656Ub}XvWmLv6gNHMdA1#)l}r8v7?Y}~P6NX_TaRTa^52)1jf)%p$FuzJ{*LkPy}nHKRp`GL_mu}? z5?6aN^k*Kowm;uS;q{leT*&b_uLnD(A7x!dN)mqJX?()N;}-ctc7$V*995oWlnu49 zZcej}Q9R%F?!JDhC2c9`>dWerpAcUNM22{8@uQ0e4@McA zCy(S6+XZ~gVV2#x-~Rp@nPg)1_8c4{L9k8e2H3{GL+6ydlFRvk>}aR& zyeiWW6IogCLucQmHAAGy{`LJJ|3~UeKM$^n)aPUxFISPB?Nw;Bq8Pn|KqNQyua3)^ z+wSlK+p?A7A)J3>;#Nd6!D^MQ{DF2Ub7?N;JZFiELzNC^=#W1K{RDQ@_X&>`)Ik|iRYCI~8*1SBVs(I9Yfz>H^%WL;dR9+(fsu@$i=34!^mzg`4`kLD>`w#M) zprl+B;CRi@jBKW)a_^=)m-)pxu1 z82$d$cBXJdyDpa*X@mQwc#Tcu_Bbu>Ar}gJ7nlwQ8TBDJn(ttP?VkPbfy)AkL?Y4X zagr$$$v~RU(SLjOQLW&>hFY!nv>&aQ=yIC*&;SlE6L%tqa3^9Y0g+$j59NlzN#^Cy z()b)xY_ygV-BR3Lmt1NzATw*=<`@nvyta2tHcqf^i11?>P|FvKr^v=2nv@xV{2r8_?LuX zqbyDX`@>SRx{Rc7(31n3Fy;-1cyChTo%}f$bhiN=sT?1}9PTNN`(?%56uFY%=^H~< zlLG7Yp&lFr-u#4u;fRfSbSPL|dQ2#nDYObN@x8!o zmCGG}mtP+b*2k|%ciH(A;xIo8l8hAIWc4;1*wb!l$-JUA5tvL1!go+zy{x?)<3TpIfE-Sr+SUn%fsc zI#`K3B6*8VE_0?-dK}i@;W|7xeO(7#LR)!cO{Ll?&vfHzdpXmUQXyGwTOl>RGIE~= zI%B3?qx8t41b>5>CNZ#0Jqf)MVMBJm#o!1GsD`Ek%c-1WKz4gG+!KHl8ud#2T~nV< z?Nb|m({F@QAo5agmup=Pw|105hR}e14pSCc8a8J)F?O#-?d>UGN25^^D0HxGY0!`n zlPqODouFQ-i00-cEuaQn4FIDDNf z;4mZ(oTF@Ip0;0qc;P4J1zxmk+!<`1aJ% z3&Glv#%Vp9i(F5*!TswyRKG8q7q(wl2wi>U^ibXF((uLkPS0!gL!mcgrixa`iH%;- za(i}KPM*5`I2w)S8O9}#ZIBPD*^C|F`)EXyMSheZ^@tAG1- z%`DmN*;gKeR3c7xObQZiYHP@i=zilB{4rUXzP_8aaktXlEWH!}WOh?L9ME_~M{&^u z?PTHDs%{POFr%}c)K(kavX`xZ_~Pmd13oX9@#kSu?h=ICWQvy$8#6b;rK6)iTb(!; z`8&cbK4LaQ)dqgPKO<{hLtW#!B?<4-`v5Rs$MeJMKQD9tOErhiJ?GMVk_wwDp&w-q z0E*IE8Y?{C6qo=sZ=OLOmHWK4ac9s)0OnOTZ?w~kQN3ctw2>OOsz=BjmeQvQ@@Sfo)>)r+~` zVgAuHE;TT@Y66%QFF||-rnUooUo!Msoy4w;d-^u3yE<#HU=Lu_YL(aTjeCHFYubL- z&yI!#+R}IDq@Aa8sN4E^rf;X3KPyW6=k<0$FYB^GkNeppkuLV@RAFFo?D`u3brsoD z#;?>nSy#Pmyc)OR8FiN?oIpI*i!5oCGW`~%7coBuI38M6V&~k@xwyh5IJv;}X9Mbw zU+D7G{nQ!x>%f7G16YybQelBnKL<6kOiGM71Gb%rnL*D(kZ2%Vo%XiXNyPa-R_J56 z2E9qGyILoFyXcHwv)E-vdl85DcH44kY!Fdg{FeHq7eBq!fsQ<~6la)L9Az)#_<&<nWv8LNLg#D;3rb6{Iun@Kmbtf< z7x?Z!*j5}a9hv&D?e)p`=|<@XVZZ!|TU39sdb{lMjFb`D;&|K0C^uVW0J4a~4c)r; z+(F%Lcd)W<=QsbtfR_)ynD1+b+FB`g081@hkm%a)OE+1}d@DjI|E|($L0`SfyWL8uR^dGA*lRb3nJZ2x*x5Z^)LVnhvmvun4yWzMrObpg0y}$4oQXRS z3^#i)?c|9D2we%1>h2zy+f>+DN226=dbL{4qyT*wUHq{FU7&m;AYKt0>{3b4*6VN zxs=*GP>UE^OZ;APUzHrX2d~D9$w?e}RLiP+AuCTbAuNO&(7Z=FSkC{x{dc3(rkXb4#yqn}o3^`(bicxaqPJJ$ zL}r)gM^T=x8pwCh94Du2Cojb_6E~cgt0G~PQiR1I{IXbvU_6RR@1n1n%H@58EDHmT zg)`IeG(!7vD+7xG#Xg!0U^udZ>X*}hD!1Uku>cI6P0V53E=**35^b0FMhC{w&gxic z&14wwry?D@AQlu-;YGULWp&Ni8l5zPXdr=d*27@R{ts0|M9Z8SwXC1(Yo=A0tbqdT zB}+UkjfXK3kQqrY1O#GUr*jwOKZ(l*Vos3AcQ9Xh4p@W({=3K1iU$0_eQ+Z{TAEdt zg6>#MdpUd98$&A+#a=#tig>4FsyI8$LouL!x+M}A_Yx1T0dgD)5qeyrjbY534K5pX z)8C0wciycT(h>a7vEhOAPJ3&?0pwHPmmh8mi*RX?Tq@vhpIpQg!ZJT+D{jlw>n{X@ z1xlc$mcP8%_0;J|w?vEAYhhOEP>2%0g_;h>R?1_iLSLu2Sbrho>j(DoQ{%mnd}o8A zUYXvjtZG{%)oTJq9A4G2RnDhIeyp~6&L(|1t#pCcdx_Bh9`Hpq<#Tz(=e)978434~ zYR=;sejq2S(mSv=ck}OYXG?-SO>V%mo1x5G_cUg@^&FcQrnx3=R5%i%j zb&KiC=!Z1&vuoURTLWL%iCU(J3s4W$a{ss^}n1fX)X~9;y?xp#SMt>ZcIp>4R5b^8Z;i!Bx z1lk`*9dO*A3))ObRr?c4Tq&&4;n9vE(xzPIe3^iNYS!~mwvYYu_Ke3#a|#JFH*9zt z?B#3>52{0PHc|-_3~U+9wDsj3X*FH6lsil^A}qOk4WX}c0ryzwKD5l^nJ{p;)aVTU zw=H`A9--z3n#Yg4&lmZ<-@N(q{i(=!*ymxjXggsdt9u6{k*!Cek3Fd2z4tq|^mnTw zhy#E4@cS#IEykAsn@FtVoMpw0$XyT4^-1W5E0Jk}pZglM&tESzaeeO>nU>#h;Uj|m zl_%)O{kwl%>-bLPi-G=*lHjG~=jM{0`uWtoAu&t|5~)#CR5fdUGr8!Z;zy&L2JD^O2UwSEYB^j3U)E)EKS@W zDNt^m{qj{9tgU{)@(S;7qnAxIK6&+9K_YbupTu8paJai7NBPC$G-9j2VG`EVBGyL<9WGgiDBDb97qLn#_Znr>6i9!6CAJ(JZILJiT%Nb_&4r(+?>vux3oZ$vYg;= zF*B#ngt_G4Nm`KV#3&5`^j_bK;pEOlOoCp!uXb4A@Z!=r)9)HIo%c7~xSVR2xDx;5 zc(vP_!swmOfM<4e7tE~-aMO0txDBivc_Zh?dWo=ts(Wy6HNc77pxLvdBUr6-lRgVQ z-@garyq$BBPBh&iaM5qYv@RAz$zF82Ro2wxZktnJ_Jdz(bkZld*;gJvwYOK7-=Y1> zdXtt8(I(V7zVgU?$UOflnDyS<4HmvPmwctm#Cmo%FDY2LzY*2j)xbw_CLSHqxxfuS z1-C!#=8Jy`rF!(UOb}~aQXo%K2AuCB#!7#|+#PmY2vRMxed;B+V&TUNlL*a-#if9U zOzJ~Vt*)gMB|$Y%3{d4567d@OVi`Dt3wC(yk5v-o?2%G#0Gx~ZgfT>aVy?N(Yz93Q zuPIBMcf?$+=ix0`<077ijOmQ_c$Q=^hK+!3HlXCX*b)fZ*Ro{Ho5ZqIO&c>ZH!$TO zJrHkIRmDsHpZ4B6s>!Tx7iMO3W<+rYA%K85LsJrplu(5kl_H%0A(RB9gc1ls=uKxB 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 +

See the source code and current work on the Koko repository.

+ diff --git a/example/_posts/2026-01-01-a-home-for-each-project.md b/example/_posts/2026-01-01-a-home-for-each-project.md new file mode 100644 index 0000000..bb43fc4 --- /dev/null +++ b/example/_posts/2026-01-01-a-home-for-each-project.md @@ -0,0 +1,13 @@ +--- +layout: post +title: A home for each project +description: How Jackal brings the project sites together. +author: LizardByte +--- + +Each project can publish its own website and choose its own colors, navigation, and content. +Jackal provides the shared layouts used for the home page, the blog, and the catalog. + +## Find a project + +Visit the [project index]({{ '/' | relative_url }}) to explore the three example sites. diff --git a/example/_preview.yml b/example/_preview.yml new file mode 100644 index 0000000..d4db822 --- /dev/null +++ b/example/_preview.yml @@ -0,0 +1,7 @@ +--- +url: https://preview.example.org +baseurl: /previews/42/ThemerrDB + +jackal: + umbrella: + url: /previews/42 diff --git a/example/about.md b/example/about.md new file mode 100644 index 0000000..ebbf3a7 --- /dev/null +++ b/example/about.md @@ -0,0 +1,9 @@ +--- +layout: page +title: About this preview +permalink: /about/ +--- + +This site demonstrates Jackal's layouts with sample content for LizardByte projects. + +Live builds, releases, and documentation are maintained by the individual projects. diff --git a/example/assets/example/catalog.js b/example/assets/example/catalog.js new file mode 100644 index 0000000..c94e392 --- /dev/null +++ b/example/assets/example/catalog.js @@ -0,0 +1,18 @@ +const toolbar = document.querySelector('[data-catalog-toolbar]'); +const search = toolbar.querySelector('[data-catalog-search]'); +const status = toolbar.querySelector('[data-catalog-status]'); +const rows = [...document.querySelectorAll('[data-catalog-row]')]; + +function updateCatalog() { + const query = search.value.trim().toLowerCase(); + let matches = 0; + for (const row of rows) { + row.hidden = !row.textContent.toLowerCase().includes(query); + if (!row.hidden) matches += 1; + } + status.textContent = matches === 1 ? '1 result' : `${matches} results`; +} + +search.addEventListener('input', updateCatalog); +updateCatalog(); +toolbar.hidden = false; diff --git a/example/assets/example/koko.css b/example/assets/example/koko.css new file mode 100644 index 0000000..d5e5163 --- /dev/null +++ b/example/assets/example/koko.css @@ -0,0 +1,5 @@ +:root { + --jackal-accent: light-dark(#3b3e97, #b9baff); + --jackal-on-accent: light-dark(#f9f9ff, #1a1843); + --jackal-accent-soft: light-dark(#e9e8fb, #2c284a); +} diff --git a/example/assets/example/themerr.css b/example/assets/example/themerr.css new file mode 100644 index 0000000..32910e8 --- /dev/null +++ b/example/assets/example/themerr.css @@ -0,0 +1,5 @@ +:root { + --jackal-accent: light-dark(#961c43, #ff9cb3); + --jackal-on-accent: light-dark(#fff8fa, #300713); + --jackal-accent-soft: light-dark(#f7e5eb, #3a2032); +} diff --git a/example/blog.md b/example/blog.md new file mode 100644 index 0000000..c52352c --- /dev/null +++ b/example/blog.md @@ -0,0 +1,5 @@ +--- +layout: blog +title: Blog +permalink: /blog/ +--- diff --git a/example/catalog/index.html b/example/catalog/index.html new file mode 100644 index 0000000..4b429ad --- /dev/null +++ b/example/catalog/index.html @@ -0,0 +1,31 @@ +--- +layout: catalog +title: Release catalog +description: Browse releases across the LizardByte project organizations. +scripts: + - /assets/example/catalog.js +--- + +
+ + + + + + + {% for project in site.data.catalog %} + + + + + + {% endfor %} + +
Project release links
ProjectOrganizationReleases
{{ project.name | escape }}{{ project.organization | escape }}View {{ project.name | escape }} releases
+
+

Download catalog JSON

diff --git a/example/catalog/index.json b/example/catalog/index.json new file mode 100644 index 0000000..94fb9a5 --- /dev/null +++ b/example/catalog/index.json @@ -0,0 +1,4 @@ +--- +layout: null +--- +{{ site.data.catalog | jsonify }} diff --git a/example/index.md b/example/index.md new file mode 100644 index 0000000..bc55749 --- /dev/null +++ b/example/index.md @@ -0,0 +1,33 @@ +--- +layout: home +title: Jackal +hero: + title: A shared home for LizardByte projects. + description: Explore our self-hosted software, read project news, and browse releases. + actions: + - label: Explore projects + url: '#projects' + primary: true + - label: Browse releases + url: /catalog/ +sections: + - type: cards + id: projects + title: Projects + items: + - title: Sunshine + description: Stream games and apps from your own computer with Moonlight. + actions: + - label: Explore Sunshine + url: /sunshine/ + - title: Themerr + description: Add theme music to your Plex or Jellyfin library. + actions: + - label: Explore Themerr + url: /themerr/ + - title: Koko + description: Bring movies, music, books, and more together in a self-hosted media server. + actions: + - label: Explore Koko + url: /koko/ +--- diff --git a/example/koko.md b/example/koko.md new file mode 100644 index 0000000..3de1b1a --- /dev/null +++ b/example/koko.md @@ -0,0 +1,23 @@ +--- +layout: product +title: Koko +permalink: /koko/ +styles: + - /assets/example/koko.css +hero: + title: Your media. At home. + description: Koko is a self-hosted media server in development for movies, shows, music, books, and podcasts. + actions: + - label: Follow development + url: https://github.com/KokoStreamTV/Koko + primary: true + image: + src: https://koko.lizardbyte.dev/assets/collection.svg + alt: An illustrated movie cover, vinyl record, and book. + width: 680 + height: 580 +sections: + - type: custom + title: Explore the project + template: koko-project.html +--- diff --git a/example/sunshine.md b/example/sunshine.md new file mode 100644 index 0000000..d51facf --- /dev/null +++ b/example/sunshine.md @@ -0,0 +1,46 @@ +--- +layout: product +title: Sunshine +permalink: /sunshine/ +hero: + title: Your games. Your PC. Every screen. + description: Turn your PC into your own game streaming host, then play through Moonlight. + actions: + - label: Get Sunshine + url: '#download' + primary: true + - label: Read the docs + url: https://docs.lizardbyte.dev/projects/sunshine/latest/ + image: + src: https://sunshine.lizardbyte.dev/assets/sunshine-web-ui-light.jpg + dark_src: https://sunshine.lizardbyte.dev/assets/sunshine-web-ui-dark.jpg + alt: Sunshine's welcome screen in a web browser. +sections: + - type: cards + id: download + title: Download Sunshine + description: Install Sunshine on the computer that runs your games. + items: + - title: Windows + description: Get the installer for your host computer. + actions: + - label: Releases + url: https://github.com/SunshineStream/Sunshine/releases/latest + - title: macOS + description: Use a DMG package from the latest release. + actions: + - label: Releases + url: https://github.com/SunshineStream/Sunshine/releases/latest + - title: Linux and FreeBSD + description: Find the installation instructions for your system. + actions: + - label: Installation guide + url: https://docs.lizardbyte.dev/projects/sunshine/latest/ + - type: callout + title: Support Sunshine + description: Help fund ongoing development through LizardByte. + actions: + - label: GitHub Sponsors + url: https://github.com/sponsors/LizardByte + primary: true +--- diff --git a/example/themerr.md b/example/themerr.md new file mode 100644 index 0000000..85d307b --- /dev/null +++ b/example/themerr.md @@ -0,0 +1,32 @@ +--- +layout: product +title: Themerr +permalink: /themerr/ +styles: + - /assets/example/themerr.css +hero: + title: Give your library a soundtrack. + description: Bring theme music to movies and shows in your Plex or Jellyfin library. + actions: + - label: Get Themerr + url: https://github.com/Themerr/Themerr/releases + primary: true + - label: Explore ThemerrDB + url: https://themerr.lizardbyte.dev/ThemerrDB/ + image: + src: https://themerr.lizardbyte.dev/assets/themerr-icon.png + alt: Themerr logo. +sections: + - type: cards + title: Media server support + items: + - title: Plex + description: Add theme music to movies and shows in Plex. + - title: Jellyfin + description: Add theme music to your Jellyfin library. + - type: faq + title: About ThemerrDB + items: + - question: Where do themes come from? + answer: Browse the shared catalog in [ThemerrDB](https://themerr.lizardbyte.dev/ThemerrDB/). +--- diff --git a/jekyll-theme-jackal.gemspec b/jekyll-theme-jackal.gemspec new file mode 100644 index 0000000..2f146a3 --- /dev/null +++ b/jekyll-theme-jackal.gemspec @@ -0,0 +1,14 @@ +# frozen_string_literal: true + +Gem::Specification.new do |spec| + spec.name = "jekyll-theme-jackal" + spec.version = "0.1.0" + spec.authors = ["LizardByte"] + spec.summary = "A shared Jekyll theme for organizations and their project sites." + spec.homepage = "https://github.com/LizardByte/jackal" + spec.files = Dir.chdir(__dir__) do + Dir.glob("{_layouts,_includes,assets}/**/*").select { |path| File.file?(path) } + %w[README.md LICENSE] + end + spec.required_ruby_version = ">= 2.7" + spec.add_runtime_dependency "jekyll", ">= 3.10", "< 5" +end diff --git a/script/verify-preview.rb b/script/verify-preview.rb new file mode 100644 index 0000000..f706969 --- /dev/null +++ b/script/verify-preview.rb @@ -0,0 +1,56 @@ +# frozen_string_literal: true + +require "json" + +site_dir, baseurl, umbrella_url, origin = ARGV +abort "Usage: ruby script/verify-preview.rb SITE_DIR BASEURL UMBRELLA_URL ORIGIN" unless origin + +def require_fragment(html, fragment) + abort "Missing rendered fragment: #{fragment}" unless html.include?(fragment) +end + +def read_page(site_dir, path) + html = File.read(File.join(site_dir, path), encoding: "UTF-8") + abort "Unexpected source markup in #{path}" if html.include?("Liquid Exception:") || html.include?("{% include") + html +end + +pages = %w[index.html sunshine/index.html themerr/index.html koko/index.html catalog/index.html + blog/index.html 2026-01-01-a-home-for-each-project/index.html about/index.html] + +pages.each do |path| + html = read_page(site_dir, path) + require_fragment(html, %(href="#{baseurl}/assets/jackal/jackal.css")) + require_fragment(html, %(src="#{baseurl}/assets/jackal/theme.js")) + require_fragment(html, %(href="#{umbrella_url.sub(%r{/$}, "")}/support/")) + public_path = path.delete_suffix("index.html") + require_fragment(html, %(rel="canonical" href="#{origin}#{baseurl}/#{public_path}")) +end + +home = read_page(site_dir, "index.html") +require_fragment(home, %(href="#projects")) +require_fragment(home, %(href="#{baseurl}/sunshine/")) + +sunshine = read_page(site_dir, "sunshine/index.html") +require_fragment(sunshine, "sunshine-web-ui-dark.jpg") +require_fragment(sunshine, %(href="#download")) + +themerr = read_page(site_dir, "themerr/index.html") +require_fragment(themerr, %(href="#{baseurl}/assets/example/themerr.css")) +require_fragment(themerr, %(href="https://themerr.lizardbyte.dev/ThemerrDB/")) + +koko = read_page(site_dir, "koko/index.html") +require_fragment(koko, "See the source code and current work") + +catalog = read_page(site_dir, "catalog/index.html") +require_fragment(catalog, %(src="#{baseurl}/assets/example/catalog.js")) +require_fragment(catalog, %(href="#{baseurl}/catalog/index.json")) + +orgs = JSON.parse(File.read(File.join(site_dir, "catalog/index.json"))).map { |entry| entry.fetch("organization") } +abort "Catalog JSON contains unexpected organizations" unless orgs.sort == %w[KokoStreamTV SunshineStream Themerr] + +%w[assets/jackal/theme.js assets/jackal/jackal.css assets/example/catalog.js].each do |path| + abort "Missing static asset #{path}" unless File.file?(File.join(site_dir, path)) +end + +puts "Verified #{pages.size} pages, their URLs and assets, and the catalog JSON." From 79c182ffc8ab3eb98938867df5a662c3ba7c5fa9 Mon Sep 17 00:00:00 2001 From: ReenigneArcher <42013603+ReenigneArcher@users.noreply.github.com> Date: Thu, 19 Nov 2026 21:05:22 -0500 Subject: [PATCH 2/6] ci: build Jackal sites and serve exact PR previews --- .github/workflows/ci.yml | 87 ++++++++++-- .github/workflows/jekyll-build.yml | 140 +++++++++++++++++++ .github/workflows/jekyll-preview-comment.yml | 38 +++++ README.md | 4 + docs/build-and-preview.md | 108 ++++++++++++++ script/build-site.rb | 49 +++++++ script/prepare-site-input.py | 61 ++++++++ script/preview.cjs | 110 +++++++++++++++ script/preview.test.cjs | 91 ++++++++++++ 9 files changed, 673 insertions(+), 15 deletions(-) create mode 100644 .github/workflows/jekyll-build.yml create mode 100644 .github/workflows/jekyll-preview-comment.yml create mode 100644 docs/build-and-preview.md create mode 100644 script/build-site.rb create mode 100644 script/prepare-site-input.py create mode 100644 script/preview.cjs create mode 100644 script/preview.test.cjs diff --git a/.github/workflows/ci.yml b/.github/workflows/ci.yml index bf1f274..f41f3d0 100644 --- a/.github/workflows/ci.yml +++ b/.github/workflows/ci.yml @@ -9,36 +9,93 @@ on: - master workflow_dispatch: +concurrency: + group: ${{ github.workflow }}-${{ github.ref }} + cancel-in-progress: true + jobs: - build: - name: Build preview (Jekyll ${{ matrix.jekyll }}) + site: + name: Build the example site + uses: ./.github/workflows/jekyll-build.yml + permissions: + contents: read + with: + source_dir: example + config_files: example/_config.yml,example/_preview.yml + + verify-preview: + name: Verify the rendered preview + if: github.event_name == 'pull_request' + needs: site + runs-on: ubuntu-latest + permissions: + contents: read + steps: + - name: Checkout validation script + uses: actions/checkout@3d3c42e5aac5ba805825da76410c181273ba90b1 # v7.0.1 + with: + ref: ${{ github.event.pull_request.head.sha }} + persist-credentials: false + + - name: Download the same files offered to reviewers + uses: actions/download-artifact@9000827ccba6bdab643e8b6fd33ac0654aef8333 # v8.0.2 + with: + name: ${{ needs.site.outputs.preview_artifact }} + path: ${{ runner.temp }}/preview + + - name: Verify the published paths + run: | + ruby script/verify-preview.rb "$RUNNER_TEMP/preview/previews/42/ThemerrDB" \ + /previews/42/ThemerrDB /previews/42 https://preview.example.org + + - name: Test the Docker preview + run: | + container=$(docker run --rm -d -p 127.0.0.1:8080:80 \ + --mount "type=bind,source=$RUNNER_TEMP/preview,target=/usr/share/nginx/html,readonly" nginx:alpine) + trap 'docker stop "$container" >/dev/null' EXIT + curl --retry 5 --retry-connrefused -fsS http://127.0.0.1:8080/ | grep 'url=/previews/42/ThemerrDB/' + curl -fsS http://127.0.0.1:8080/previews/42/ThemerrDB/catalog/index.json | grep 'SunshineStream' + + comment-preview: + name: Post the preview command + if: >- + github.event_name == 'pull_request' && + github.event.pull_request.head.repo.id == github.event.pull_request.base.repo.id + needs: verify-preview + uses: ./.github/workflows/jekyll-preview-comment.yml + permissions: + contents: read + actions: read + pull-requests: write + + compatibility: + name: Check Jekyll 3 compatibility runs-on: ubuntu-latest permissions: contents: read - strategy: - matrix: - include: - - ruby: '3.1' - jekyll: '~> 3.10.0' - - ruby: '3.4' - jekyll: '~> 4.4.0' env: - JEKYLL_VERSION: ${{ matrix.jekyll }} + JEKYLL_VERSION: '~> 3.10.0' steps: - name: Checkout uses: actions/checkout@3d3c42e5aac5ba805825da76410c181273ba90b1 # v7.0.1 with: persist-credentials: false + - name: Set up Ruby - uses: ruby/setup-ruby@20eb24b0d509e2b9ed9b6d42ddfeb992915e0564 # v1.341.0 + uses: ruby/setup-ruby@f9c4492e86def3e644ab32a0ef185eda5b0c20d0 # v1.342.0 with: - ruby-version: ${{ matrix.ruby }} + ruby-version: '3.3' bundler-cache: true + - name: Build and verify both URL layouts run: | bundle exec jekyll build --source example --destination _site/root --config example/_config.yml ruby script/verify-preview.rb _site/root '' https://app.lizardbyte.dev/ https://example.org - bundle exec jekyll build --source example --destination _site/nested --config example/_config.yml,example/_preview.yml + bundle exec jekyll build --source example --destination _site/nested \ + --config example/_config.yml,example/_preview.yml ruby script/verify-preview.rb _site/nested /previews/42/ThemerrDB /previews/42 https://preview.example.org - - name: Build theme gem - run: gem build jekyll-theme-jackal.gemspec + + - name: Check the preview comment and build the gem + run: | + node --test script/preview.test.cjs + gem build jekyll-theme-jackal.gemspec diff --git a/.github/workflows/jekyll-build.yml b/.github/workflows/jekyll-build.yml new file mode 100644 index 0000000..3d3eaee --- /dev/null +++ b/.github/workflows/jekyll-build.yml @@ -0,0 +1,140 @@ +--- +name: Build Jekyll site +permissions: {} + +on: + workflow_call: + inputs: + ruby_version: + description: Ruby version for the site build + type: string + default: '4.0' + source_dir: + description: Jekyll source directory, relative to the caller's checkout + type: string + default: '.' + bundle_dir: + description: Directory containing the site's Gemfile, relative to the caller's checkout + type: string + default: '.' + config_files: + description: Optional comma-separated Jekyll config files, relative to bundle_dir + type: string + default: '' + site_artifact: + description: Optional input artifact from an earlier job in this run, overlaid on source_dir + type: string + default: '' + extract_archive: + description: Optional ZIP, TAR, or TAR.GZ filename inside site_artifact + type: string + default: '' + upload_pages: + description: Package the rendered site for GitHub Pages on non-PR runs + type: boolean + default: false + outputs: + preview_artifact: + description: Name of the PR preview artifact + value: ${{ jobs.build.outputs.preview_artifact }} + pages_artifact: + description: Name of the GitHub Pages artifact + value: ${{ jobs.build.outputs.pages_artifact }} + +jobs: + build: + name: Build site + runs-on: ubuntu-latest + permissions: + contents: read + outputs: + preview_artifact: ${{ steps.names.outputs.preview }} + pages_artifact: ${{ steps.names.outputs.pages }} + env: + SITE_SOURCE: ${{ inputs.source_dir }} + BUNDLE_DIR: ${{ inputs.bundle_dir }} + CONFIG_FILES: ${{ inputs.config_files }} + SITE_ARTIFACT: ${{ inputs.site_artifact }} + EXTRACT_ARCHIVE: ${{ inputs.extract_archive }} + BUILD_SHA: ${{ github.event.pull_request.head.sha || github.sha }} + PREVIEW: ${{ github.event_name == 'pull_request' }} + UPLOAD_PAGES: >- + ${{ inputs.upload_pages && github.ref_name == github.event.repository.default_branch && + contains(fromJSON('["push","schedule","workflow_dispatch"]'), github.event_name) }} + steps: + - name: Checkout site at the build commit + uses: actions/checkout@3d3c42e5aac5ba805825da76410c181273ba90b1 # v7.0.1 + with: + ref: ${{ env.BUILD_SHA }} + path: project + persist-credentials: false + + - name: Checkout the reusable workflow tools + uses: actions/checkout@3d3c42e5aac5ba805825da76410c181273ba90b1 # v7.0.1 + with: + repository: ${{ job.workflow_repository }} + ref: ${{ job.workflow_sha }} + path: jackal-tools + persist-credentials: false + + - name: Download generated site input + if: inputs.site_artifact != '' + uses: actions/download-artifact@9000827ccba6bdab643e8b6fd33ac0654aef8333 # v8.0.2 + with: + name: ${{ inputs.site_artifact }} + path: ${{ runner.temp }}/jackal-generated + + - name: Prepare Jekyll input + id: prepare + run: python3 jackal-tools/script/prepare-site-input.py + + - name: Set up Ruby + uses: ruby/setup-ruby@f9c4492e86def3e644ab32a0ef185eda5b0c20d0 # v1.342.0 + with: + ruby-version: ${{ inputs.ruby_version }} + working-directory: ${{ steps.prepare.outputs.bundle_dir }} + bundler-cache: true + + - name: Build with the site's bundle + working-directory: ${{ steps.prepare.outputs.bundle_dir }} + env: + JEKYLL_ENV: production + JEKYLL_SOURCE: ${{ steps.prepare.outputs.source_dir }} + run: bundle exec ruby "$GITHUB_WORKSPACE/jackal-tools/script/build-site.rb" + + - name: Name the build artifacts + id: names + run: | + if [[ "$PREVIEW" == 'true' ]]; then + echo "preview=jackal-preview-${BUILD_SHA}-${GITHUB_RUN_ATTEMPT}" >> "$GITHUB_OUTPUT" + fi + if [[ "$UPLOAD_PAGES" == 'true' ]]; then + echo "pages=github-pages-${GITHUB_RUN_ATTEMPT}" >> "$GITHUB_OUTPUT" + fi + + - name: Upload the rendered preview + if: steps.names.outputs.preview != '' + uses: actions/upload-artifact@cf430e030ddbb5b0abf93d22962f4752f3646cd9 # v7.0.2 + with: + name: ${{ steps.names.outputs.preview }} + path: ${{ runner.temp }}/jackal-preview/ + include-hidden-files: true + if-no-files-found: error + retention-days: 14 + + - name: Write the preview command to the run summary + if: steps.names.outputs.preview != '' + uses: actions/github-script@3a2844b7e9c422d3c10d287c895573f7108da1b3 # v9.0.0 + with: + script: | + const { formatPreview } = require('./jackal-tools/script/preview.cjs') + await core.summary.addRaw(formatPreview(context.repo, context.runId, + process.env.BUILD_SHA, process.env.GITHUB_RUN_ATTEMPT)).write() + + - name: Package the site for GitHub Pages + if: steps.names.outputs.pages != '' + uses: actions/upload-pages-artifact@fc324d3547104276b827a68afc52ff2a11cc49c9 # v5.0.0 + with: + name: ${{ steps.names.outputs.pages }} + path: ${{ runner.temp }}/jackal-site + include-hidden-files: true diff --git a/.github/workflows/jekyll-preview-comment.yml b/.github/workflows/jekyll-preview-comment.yml new file mode 100644 index 0000000..30e7f5f --- /dev/null +++ b/.github/workflows/jekyll-preview-comment.yml @@ -0,0 +1,38 @@ +--- +name: Comment with the Jekyll preview +permissions: {} + +on: + workflow_call: + workflow_run: + workflows: [Theme CI] + types: [completed] + +jobs: + comment: + if: >- + (github.event_name == 'pull_request' && + github.event.pull_request.head.repo.id == github.event.pull_request.base.repo.id) || + (github.event_name == 'workflow_run' && + github.event.workflow_run.event == 'pull_request' && + github.event.workflow_run.conclusion == 'success') + runs-on: ubuntu-latest + permissions: + contents: read + actions: read + pull-requests: write + steps: + - name: Checkout the comment workflow tools + uses: actions/checkout@3d3c42e5aac5ba805825da76410c181273ba90b1 # v7.0.1 + with: + repository: ${{ job.workflow_repository }} + ref: ${{ job.workflow_sha }} + path: jackal-tools + persist-credentials: false + + - name: Post or update the preview comment + uses: actions/github-script@3a2844b7e9c422d3c10d287c895573f7108da1b3 # v9.0.0 + with: + script: | + const { reportPreview } = require('./jackal-tools/script/preview.cjs') + await reportPreview({ github, context }) diff --git a/README.md b/README.md index 6281687..6a5a6f9 100644 --- a/README.md +++ b/README.md @@ -25,6 +25,10 @@ Open the address printed by Jekyll to preview the Sunshine, Themerr, and Koko ex the blog, and the filterable release catalog. Product artwork in the examples is served by the original sites. Example content and assets are separate from the theme package. +For a PR, copy the preview command from the CI run summary or preview comment. +It serves the files GitHub already built. See [Build and preview a Jackal site](docs/build-and-preview.md) +for the reusable workflow, GitHub Pages publishing, and generated catalogs. + ## Use Jackal For a Jekyll build in GitHub Actions or on your machine, add Jackal to the site's diff --git a/docs/build-and-preview.md b/docs/build-and-preview.md new file mode 100644 index 0000000..4b28781 --- /dev/null +++ b/docs/build-and-preview.md @@ -0,0 +1,108 @@ +# Build and preview a Jackal site + +Call Jackal's [Jekyll build workflow](../.github/workflows/jekyll-build.yml) from the site repository. +Pin `REF` to a Jackal release or commit. The workflow uses Ruby 4.0 by default and builds +with the site's own Gemfile and lockfile, so each site can select the latest Jekyll and plugins +it supports. Set `ruby_version` if a site needs a different Ruby version. + +## Build and publish + +This example builds a site on pushes to its default branch, on PRs, and when dispatched +manually. The repository must have **Settings → Pages → Source** set to **GitHub Actions** +to publish. Set `url` to the site's domain and `baseurl` to the public path in the +site's Jekyll config. For example, ThemerrDB uses `url: https://themerr.lizardbyte.dev` +and `baseurl: /ThemerrDB`. Leave `baseurl` empty for a domain root. + +```yaml +name: Website +permissions: {} + +on: + pull_request: + push: + branches: [master] + workflow_dispatch: + +jobs: + site: + uses: LizardByte/jackal/.github/workflows/jekyll-build.yml@REF + permissions: + contents: read + with: + upload_pages: true + + deploy: + if: needs.site.outputs.pages_artifact != '' + needs: site + runs-on: ubuntu-latest + permissions: + actions: read + pages: write + id-token: write + environment: + name: github-pages + url: ${{ steps.deployment.outputs.page_url }} + steps: + - name: Deploy the built files + id: deployment + uses: actions/deploy-pages@368f82528645a54fb793d4d04e342629a3f51346 # v5.0.1 + with: + artifact_name: ${{ needs.site.outputs.pages_artifact }} +``` + +The workflow produces a Pages artifact only for pushes, scheduled runs, or manual +runs on the default branch, with `upload_pages: true`. Add a `schedule` trigger if the +site has a scheduled data update. + +Set `source_dir` for a site located below the checkout root. Use `bundle_dir` if its +Gemfile is in a different directory. Optional `config_files` paths are relative to +the bundle directory and apply from left to right. + +### Generated sites and catalogs + +Have an earlier job build the project data and upload an Actions artifact. Set +`needs` to that job and pass its artifact name to `site_artifact`. The workflow +overlays the contents onto `source_dir` before Jekyll builds. For an artifact that +contains a single archive, set `extract_archive` to its filename. Supported +formats are ZIP, TAR, and compressed TAR (`.tar.gz` or `.tgz`). If the generator +checks out the repository on a PR, use `${{ github.event.pull_request.head.sha || github.sha }}` +as its checkout ref so its data comes from the same commit as the site. + +## Preview a pull request + +Open the CI run summary and copy the PowerShell or Bash/Zsh command. GitHub CLI +downloads the files built from the exact PR head commit and run attempt. Docker +serves those files through Nginx at `http://127.0.0.1:8080`. For projects with a +`baseurl`, the local root redirects to the same subpath used on Pages. Stop the +container with Ctrl+C. The downloaded files remain in the temporary directory +named by the command's `preview` variable. Artifacts are available for up to +14 days. + +### Put the command on the PR + +Add this second workflow to the site's default branch. Set `workflows` to the +first workflow's `name`. The reporter looks up the rendered artifact and +updates one comment on the matching PR. It uses the default-branch workflow, +including when the build came from a fork. + +```yaml +name: Website preview comment +permissions: {} + +on: + workflow_run: + workflows: [Website] + types: [completed] + +jobs: + comment: + if: github.event.workflow_run.event == 'pull_request' && github.event.workflow_run.conclusion == 'success' + uses: LizardByte/jackal/.github/workflows/jekyll-preview-comment.yml@REF + permissions: + actions: read + contents: read + pull-requests: write +``` + +The build runs with read access. The comment job reads Actions metadata and +never downloads or executes the files being reviewed. diff --git a/script/build-site.rb b/script/build-site.rb new file mode 100644 index 0000000..713fcf6 --- /dev/null +++ b/script/build-site.rb @@ -0,0 +1,49 @@ +# frozen_string_literal: true + +require "fileutils" +require "jekyll" + +# Load Bundler's Jekyll plugins as the Jekyll executable does. +Jekyll::PluginManager.require_from_bundler + +temp = ENV.fetch("RUNNER_TEMP") +destination = File.join(temp, "jackal-site") +options = { + "source" => ENV.fetch("JEKYLL_SOURCE"), + "destination" => destination, + "incremental" => false, + "strict_front_matter" => true, +} +config_files = ENV.fetch("CONFIG_FILES", "").split(",").map(&:strip) +options["config"] = config_files unless config_files.empty? +site = Jekyll::Site.new(Jekyll.configuration(options)) +Jekyll::Commands::Build.build(site, site.config) + +return unless ENV["PREVIEW"] == "true" + +# GitHub Pages supplies the mount path in production. Replicate that path +# locally without changing the rendered site or its configured URLs. +baseurl = site.config["baseurl"].to_s.sub(%r{/\z}, "") +segments = baseurl.split("/").drop(1) +valid_segment = ->(part) { part.match?(/\A[A-Za-z0-9._~-]+\z/) && !%w[. ..].include?(part) } +unless baseurl.empty? || (baseurl.start_with?("/") && segments.all?(&valid_segment)) + abort "baseurl must be an empty string or a URL path with simple segments" +end + +preview = File.join(temp, "jackal-preview") +if baseurl.empty? + FileUtils.mv(destination, preview) +else + site_path = File.join(preview, *segments) + FileUtils.mkdir_p(File.dirname(site_path)) + FileUtils.mv(destination, site_path) + File.write(File.join(preview, "index.html"), <<~HTML) + + + + Jackal preview + + Open the preview + + HTML +end diff --git a/script/prepare-site-input.py b/script/prepare-site-input.py new file mode 100644 index 0000000..a81862e --- /dev/null +++ b/script/prepare-site-input.py @@ -0,0 +1,61 @@ +"""Prepare checkout and generated artifact inputs for the Jekyll build.""" + +import os +import shutil +from pathlib import Path + + +def directory_inside(root, value): + """Resolve an existing directory relative to the checkout.""" + path = (root / value).resolve() + if "\n" in str(path) or "\r" in str(path) or not path.is_relative_to(root) or not path.is_dir(): + raise SystemExit(f"Expected a directory inside the checkout: {value!r}") + return path + + +def overlay_generated(source, generated): + """Copy generated regular files into the site's source tree.""" + entries = list(generated.rglob("*")) + for entry in entries: + relative = entry.relative_to(generated) + target = (source / relative).resolve() + if entry.is_symlink() or not target.is_relative_to(source): + raise SystemExit(f"Unsupported generated path: {relative}") + if ".git" in relative.parts or ".git" in target.relative_to(source).parts: + raise SystemExit(f"Unsupported generated path: {relative}") + shutil.copytree(generated, source, dirs_exist_ok=True) + + +def main(): + """Validate paths and optionally unpack and overlay a same-run artifact.""" + checkout = (Path(os.environ["GITHUB_WORKSPACE"]) / "project").resolve() + source = directory_inside(checkout, os.environ["SITE_SOURCE"]) + bundle = directory_inside(checkout, os.environ["BUNDLE_DIR"]) + archive_name = os.environ["EXTRACT_ARCHIVE"] + temp = Path(os.environ["RUNNER_TEMP"]) + + if os.environ["SITE_ARTIFACT"]: + generated = temp / "jackal-generated" + if archive_name: + archive = generated / archive_name + if Path(archive_name).name != archive_name or not archive.is_file() or archive.is_symlink(): + raise SystemExit("extract_archive must name a file at the root of site_artifact") + generated = temp / "jackal-extracted" + if archive.suffix.lower() == ".zip": + shutil.unpack_archive(archive, generated, format="zip") + elif archive.name.endswith((".tar", ".tar.gz", ".tgz")): + shutil.unpack_archive(archive, generated, filter="data") + else: + raise SystemExit("extract_archive must use ZIP, TAR or TAR.GZ") + overlay_generated(source, generated) + elif archive_name: + raise SystemExit("extract_archive requires site_artifact") + + if not (bundle / "Gemfile").is_file(): + raise SystemExit(f"No Gemfile found in {bundle.relative_to(checkout)}") + with open(os.environ["GITHUB_OUTPUT"], "a", encoding="utf-8") as output: + output.write(f"source_dir={source}\nbundle_dir={bundle}\n") + + +if __name__ == "__main__": + main() diff --git a/script/preview.cjs b/script/preview.cjs new file mode 100644 index 0000000..7fb11df --- /dev/null +++ b/script/preview.cjs @@ -0,0 +1,110 @@ +const OWNER_REPO = /^[A-Za-z0-9_.-]+$/; +const SHA = /^[a-f0-9]{40}$/; +const POSITIVE_INTEGER = /^[1-9][0-9]*$/; +const MARKER = ''; + +function getMainArtifact(sha, attempt) { + if (!SHA.test(sha) || !POSITIVE_INTEGER.test(attempt)) { + throw new Error('Invalid build commit or run attempt'); + } + return `jackal-preview-${sha}-${attempt}`; +} + +function formatPreview({ owner, repo }, runId, sha, attempt) { + if (!OWNER_REPO.test(owner) || !OWNER_REPO.test(repo) || !POSITIVE_INTEGER.test(runId)) { + throw new Error('Invalid repository or run ID'); + } + const artifact = getMainArtifact(sha, attempt); + const download = `gh run download ${runId} --repo ${owner}/${repo} --name ${artifact}`; + const serve = 'docker run --rm -p 127.0.0.1:8080:80 ' + + '--mount "type=bind,source=$preview,target=/usr/share/nginx/html,readonly" nginx:alpine'; + + return [ + MARKER, + '### Preview this build', + '', + `Commit \`${sha}\` · [CI run ${runId}, attempt ${attempt}](https://github.com/${owner}/${repo}/actions/runs/${runId})`, + '', + 'With Docker running and GitHub CLI signed in, paste one command:', + '', + '**PowerShell**', + '', + '```powershell', + '$preview = Join-Path ([IO.Path]::GetTempPath()) ("jackal-" + [guid]::NewGuid()); ' + + `${download} --dir "$preview"; if ($LASTEXITCODE -eq 0) { ${serve} }`, + '```', + '', + '**Bash or Zsh**', + '', + '```sh', + `preview="$(mktemp -d)" && ${download} --dir "$preview" && ${serve}`, + '```', + '', + 'Open [localhost:8080](http://127.0.0.1:8080). Stop the server with Ctrl+C.', + 'The download is retained by GitHub Actions for up to 14 days.', + '', + ].join('\n'); +} + +function sameHead(pull, headRepository, sha) { + return pull.state === 'open' && pull.head.repo?.id === headRepository && pull.head.sha === sha; +} + +async function findPreviewAttempt(github, repository, runId, sha, attempt) { + const exact = getMainArtifact(sha, attempt); + const params = { ...repository, run_id: runId }; + const artifacts = github.rest.actions.listWorkflowRunArtifacts; + const current = await github.paginate(artifacts, { ...params, name: exact }); + if (current.some(item => item.name === exact && !item.expired)) return attempt; + + // Rerunning only failed jobs can reuse the successful build from an + // earlier attempt. Report the attempt that actually produced its files. + const prefix = `jackal-preview-${sha}-`; + const earlier = await github.paginate(artifacts, params); + return earlier.reduce((latest, item) => { + if (item.expired || !item.name.startsWith(prefix)) return latest; + const suffix = item.name.slice(prefix.length); + if (!POSITIVE_INTEGER.test(suffix) || Number(suffix) >= Number(attempt)) return latest; + return Math.max(latest, Number(suffix)); + }, 0); +} + +async function reportPreview({ github, context }) { + const { repo: repository, payload, runId: currentRunId } = context; + const run = payload.workflow_run; + const pull = payload.pull_request; + if (run && (run.event !== 'pull_request' || run.conclusion !== 'success')) return; + if (!run && (!pull || pull.head.repo.id !== pull.base.repo.id)) return; + + const headRepository = run ? run.head_repository : pull.head.repo; + if (!headRepository) return; + const sha = run?.head_sha ?? pull.head.sha; + const runId = run?.id ?? currentRunId; + const attempt = await findPreviewAttempt(github, repository, runId, sha, + run?.run_attempt ?? process.env.GITHUB_RUN_ATTEMPT); + if (!attempt) return; + + // Fork PRs can be absent from workflow_run.pull_requests. Resolve them by + // the actual head repository, branch and commit, never by an artifact field. + const head = run?.head_branch ?? pull.head.ref; + const candidates = pull ? [pull] : await github.paginate(github.rest.pulls.list, { + ...repository, state: 'open', head: `${headRepository.owner.login}:${head}`, + }); + const body = formatPreview(repository, runId, sha, attempt); + for (const candidate of candidates.filter(item => sameHead(item, headRepository.id, sha))) { + const params = { ...repository, issue_number: candidate.number }; + const comments = await github.paginate(github.rest.issues.listComments, params); + const existing = comments.find(comment => + comment.user?.type === 'Bot' && comment.user.login === 'github-actions[bot]' && comment.body?.startsWith(MARKER), + ); + const { data: current } = await github.rest.pulls.get({ ...repository, pull_number: candidate.number }); + if (!sameHead(current, headRepository.id, sha) || existing?.body.trimEnd() === body.trimEnd()) continue; + if (existing) { + await github.rest.issues.updateComment({ ...repository, comment_id: existing.id, body }); + } else { + await github.rest.issues.createComment({ ...params, body }); + } + } +} + +module.exports = { formatPreview, reportPreview }; diff --git a/script/preview.test.cjs b/script/preview.test.cjs new file mode 100644 index 0000000..a102437 --- /dev/null +++ b/script/preview.test.cjs @@ -0,0 +1,91 @@ +const assert = require('node:assert/strict'); +const test = require('node:test'); +const { formatPreview, reportPreview } = require('./preview.cjs'); + +const commit = 'a'.repeat(40); +const repository = { owner: 'Themerr', repo: 'ThemerrDB' }; +const fork = { id: 7, owner: { login: 'contributor' } }; +const pull = { number: 12, state: 'open', head: { repo: fork, sha: commit, ref: 'add-data' } }; +const run = { + event: 'pull_request', conclusion: 'success', id: 45, run_attempt: 2, + head_sha: commit, head_branch: 'add-data', head_repository: fork, pull_requests: [], +}; +const artifact = `jackal-preview-${commit}-2`; + +function workflowRun({ artifacts = [{ name: artifact, expired: false }], comments = [], current = pull } = {}) { + const calls = []; + const context = { repo: repository, payload: { workflow_run: run } }; + const github = { + rest: { + actions: { listWorkflowRunArtifacts: () => {} }, + pulls: { list: () => {}, get: async () => ({ data: current }) }, + issues: { + listComments: () => {}, + createComment: async args => calls.push(['create', args]), + updateComment: async args => calls.push(['update', args]), + }, + }, + async paginate(endpoint, args) { + if (endpoint === this.rest.actions.listWorkflowRunArtifacts) { + assert.equal(args.run_id, 45); + assert.ok(!args.name || args.name === artifact); + return args.name ? artifacts.filter(item => item.name === args.name) : artifacts; + } + if (endpoint === this.rest.pulls.list) { + assert.equal(args.head, 'contributor:add-data'); + return [pull, { ...pull, number: 13, head: { ...pull.head, repo: { id: 8 } } }]; + } + assert.equal(args.issue_number, 12); + return comments; + }, + }; + return { github, context, calls }; +} + +test('the local commands download one specific run attempt and mount it read-only', () => { + const body = formatPreview(repository, 45, commit, 2); + const command = `gh run download 45 --repo Themerr/ThemerrDB --name ${artifact}`; + assert.equal(body.split(command).length - 1, 2); + assert.match(body, /\b127\.0\.0\.1:8080:80\b/); + assert.match(body, /target=\/usr\/share\/nginx\/html,readonly/); + assert.throws(() => formatPreview(repository, '45; echo wrong', commit, 2), /Invalid repository or run ID/); +}); + +test('a fork build can report to the correct PR without PR numbers in the workflow event', async () => { + const inputs = workflowRun(); + await reportPreview(inputs); + assert.equal(inputs.calls.length, 1); + assert.equal(inputs.calls[0][0], 'create'); + assert.equal(inputs.calls[0][1].issue_number, 12); + assert.match(inputs.calls[0][1].body, new RegExp(artifact)); +}); + +test('a run for an outdated head or missing exact artifact does not post a preview', async () => { + for (const options of [ + { current: { ...pull, head: { ...pull.head, sha: 'b'.repeat(40) } } }, + { artifacts: [{ name: `jackal-preview-${'b'.repeat(40)}-2`, expired: false }] }, + { artifacts: [{ name: artifact, expired: true }] }, + ]) { + const inputs = workflowRun(options); + await reportPreview(inputs); + assert.deepEqual(inputs.calls, []); + } +}); + +test('a retry of downstream jobs can report the artifact from the prior build attempt', async () => { + const inputs = workflowRun({ artifacts: [{ name: `jackal-preview-${commit}-1`, expired: false }] }); + await reportPreview(inputs); + assert.match(inputs.calls[0][1].body, new RegExp(`jackal-preview-${commit}-1`)); +}); + +test('only a previous preview comment owned by GitHub Actions is updated', async () => { + const body = '\nPrevious preview'; + const inputs = workflowRun({ comments: [ + { id: 1, user: { type: 'User', login: 'reviewer' }, body }, + { id: 2, user: { type: 'Bot', login: 'github-actions[bot]' }, body }, + ] }); + await reportPreview(inputs); + assert.equal(inputs.calls.length, 1); + assert.equal(inputs.calls[0][0], 'update'); + assert.equal(inputs.calls[0][1].comment_id, 2); +}); From 93fd699bef604687b2d8cf3d2aec0fbcd87183d4 Mon Sep 17 00:00:00 2001 From: ReenigneArcher <42013603+ReenigneArcher@users.noreply.github.com> Date: Thu, 19 Nov 2026 21:08:23 -0500 Subject: [PATCH 3/6] ci: keep the Jackal workflows compatible with common lint --- .github/actionlint.yml | 6 ++++++ script/prepare-site-input.py | 15 ++++++++++----- 2 files changed, 16 insertions(+), 5 deletions(-) create mode 100644 .github/actionlint.yml diff --git a/.github/actionlint.yml b/.github/actionlint.yml new file mode 100644 index 0000000..e4b77a0 --- /dev/null +++ b/.github/actionlint.yml @@ -0,0 +1,6 @@ +--- +paths: + # GitHub exposes both fields. Remove this when actionlint's schema includes them. + .github/workflows/jekyll-{build,preview-comment}.yml: + ignore: + - 'property "workflow_(repository|sha)" is not defined' diff --git a/script/prepare-site-input.py b/script/prepare-site-input.py index a81862e..28bdb20 100644 --- a/script/prepare-site-input.py +++ b/script/prepare-site-input.py @@ -8,8 +8,10 @@ def directory_inside(root, value): """Resolve an existing directory relative to the checkout.""" path = (root / value).resolve() - if "\n" in str(path) or "\r" in str(path) or not path.is_relative_to(root) or not path.is_dir(): - raise SystemExit(f"Expected a directory inside the checkout: {value!r}") + if "\n" in str(path) or "\r" in str(path): + raise SystemExit("A directory path cannot contain line breaks") + if not path.is_relative_to(root) or not path.is_dir(): + raise SystemExit(f"Not a directory inside the checkout: {value!r}") return path @@ -21,7 +23,8 @@ def overlay_generated(source, generated): target = (source / relative).resolve() if entry.is_symlink() or not target.is_relative_to(source): raise SystemExit(f"Unsupported generated path: {relative}") - if ".git" in relative.parts or ".git" in target.relative_to(source).parts: + target_parts = target.relative_to(source).parts + if ".git" in relative.parts or ".git" in target_parts: raise SystemExit(f"Unsupported generated path: {relative}") shutil.copytree(generated, source, dirs_exist_ok=True) @@ -38,8 +41,10 @@ def main(): generated = temp / "jackal-generated" if archive_name: archive = generated / archive_name - if Path(archive_name).name != archive_name or not archive.is_file() or archive.is_symlink(): - raise SystemExit("extract_archive must name a file at the root of site_artifact") + if Path(archive_name).name != archive_name: + raise SystemExit("extract_archive must be a filename") + if not archive.is_file() or archive.is_symlink(): + raise SystemExit("Archive not found at the root of site_artifact") generated = temp / "jackal-extracted" if archive.suffix.lower() == ".zip": shutil.unpack_archive(archive, generated, format="zip") From 63cd1a29a2004f7c7adbfa704dec3954fcd8481e Mon Sep 17 00:00:00 2001 From: ReenigneArcher <42013603+ReenigneArcher@users.noreply.github.com> Date: Thu, 19 Nov 2026 21:09:34 -0500 Subject: [PATCH 4/6] style: wrap the archive validation error --- script/prepare-site-input.py | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/script/prepare-site-input.py b/script/prepare-site-input.py index 28bdb20..3fb96cc 100644 --- a/script/prepare-site-input.py +++ b/script/prepare-site-input.py @@ -44,7 +44,7 @@ def main(): if Path(archive_name).name != archive_name: raise SystemExit("extract_archive must be a filename") if not archive.is_file() or archive.is_symlink(): - raise SystemExit("Archive not found at the root of site_artifact") + raise SystemExit("Archive not found at the artifact root") generated = temp / "jackal-extracted" if archive.suffix.lower() == ".zip": shutil.unpack_archive(archive, generated, format="zip") From a4419cbd147e1c6137649325ede0d7e26d367b88 Mon Sep 17 00:00:00 2001 From: ReenigneArcher <42013603+ReenigneArcher@users.noreply.github.com> Date: Thu, 19 Nov 2026 21:11:53 -0500 Subject: [PATCH 5/6] ci: wait for the Jackal preview server to start --- .github/workflows/ci.yml | 3 ++- 1 file changed, 2 insertions(+), 1 deletion(-) diff --git a/.github/workflows/ci.yml b/.github/workflows/ci.yml index f41f3d0..6e3bbc7 100644 --- a/.github/workflows/ci.yml +++ b/.github/workflows/ci.yml @@ -53,7 +53,8 @@ jobs: container=$(docker run --rm -d -p 127.0.0.1:8080:80 \ --mount "type=bind,source=$RUNNER_TEMP/preview,target=/usr/share/nginx/html,readonly" nginx:alpine) trap 'docker stop "$container" >/dev/null' EXIT - curl --retry 5 --retry-connrefused -fsS http://127.0.0.1:8080/ | grep 'url=/previews/42/ThemerrDB/' + curl --retry 5 --retry-all-errors -fsS http://127.0.0.1:8080/ -o "$RUNNER_TEMP/preview-index.html" + grep 'url=/previews/42/ThemerrDB/' "$RUNNER_TEMP/preview-index.html" curl -fsS http://127.0.0.1:8080/previews/42/ThemerrDB/catalog/index.json | grep 'SunshineStream' comment-preview: From 5aea3f57c24908fb2700285b60c8b5b244751af1 Mon Sep 17 00:00:00 2001 From: ReenigneArcher <42013603+ReenigneArcher@users.noreply.github.com> Date: Thu, 19 Nov 2026 21:44:34 -0500 Subject: [PATCH 6/6] ci: open the Jackal PR preview at the site root --- .github/workflows/ci.yml | 26 +++++++++++++++++--------- 1 file changed, 17 insertions(+), 9 deletions(-) diff --git a/.github/workflows/ci.yml b/.github/workflows/ci.yml index 6e3bbc7..ecddcd5 100644 --- a/.github/workflows/ci.yml +++ b/.github/workflows/ci.yml @@ -21,7 +21,7 @@ jobs: contents: read with: source_dir: example - config_files: example/_config.yml,example/_preview.yml + config_files: example/_config.yml verify-preview: name: Verify the rendered preview @@ -45,8 +45,8 @@ jobs: - name: Verify the published paths run: | - ruby script/verify-preview.rb "$RUNNER_TEMP/preview/previews/42/ThemerrDB" \ - /previews/42/ThemerrDB /previews/42 https://preview.example.org + ruby script/verify-preview.rb "$RUNNER_TEMP/preview" '' \ + https://app.lizardbyte.dev/ https://example.org - name: Test the Docker preview run: | @@ -54,8 +54,8 @@ jobs: --mount "type=bind,source=$RUNNER_TEMP/preview,target=/usr/share/nginx/html,readonly" nginx:alpine) trap 'docker stop "$container" >/dev/null' EXIT curl --retry 5 --retry-all-errors -fsS http://127.0.0.1:8080/ -o "$RUNNER_TEMP/preview-index.html" - grep 'url=/previews/42/ThemerrDB/' "$RUNNER_TEMP/preview-index.html" - curl -fsS http://127.0.0.1:8080/previews/42/ThemerrDB/catalog/index.json | grep 'SunshineStream' + grep -F 'href="#projects"' "$RUNNER_TEMP/preview-index.html" + curl -fsS http://127.0.0.1:8080/catalog/index.json | grep 'SunshineStream' comment-preview: name: Post the preview command @@ -88,13 +88,21 @@ jobs: ruby-version: '3.3' bundler-cache: true - - name: Build and verify both URL layouts + - name: Build and verify the root site run: | bundle exec jekyll build --source example --destination _site/root --config example/_config.yml ruby script/verify-preview.rb _site/root '' https://app.lizardbyte.dev/ https://example.org - bundle exec jekyll build --source example --destination _site/nested \ - --config example/_config.yml,example/_preview.yml - ruby script/verify-preview.rb _site/nested /previews/42/ThemerrDB /previews/42 https://preview.example.org + + - name: Build and verify a nested preview + env: + JEKYLL_SOURCE: ${{ github.workspace }}/example + CONFIG_FILES: example/_config.yml,example/_preview.yml + PREVIEW: 'true' + run: | + bundle exec ruby script/build-site.rb + ruby script/verify-preview.rb "$RUNNER_TEMP/jackal-preview/previews/42/ThemerrDB" \ + /previews/42/ThemerrDB /previews/42 https://preview.example.org + grep -F 'url=/previews/42/ThemerrDB/' "$RUNNER_TEMP/jackal-preview/index.html" - name: Check the preview comment and build the gem run: |