<?xml version="1.0" encoding="utf-8"?>
<feed xmlns="http://www.w3.org/2005/Atom" xmlns:mosaic="tag:silasjelley.com,2026:mosaic-feed">

<title>Silas Jelley&#39;s Corner of the Web / Changelogs</title>
<link rel="self" type="application/atom+xml" href="https://silasjelley.com/feeds/changelogs" />
<link href="https://silasjelley.com/" />
<id>https://silasjelley.com/feeds/changelogs/</id>
<icon>/icon/48.ico</icon>
<author>
  <name>Silas Jelley</name>
  <email>reply@silasjelley.com</email>
</author>

<updated>2025-11-06T14:31:46+05:00</updated>
<entry>
  <title>Add @collection() shortcode</title>
  <link rel="alternate" type="text/html" href="https://silasjelley.com/2025/11/06/143146" />
  <id>tag:silasjelley.com,2020-08-20:1c1c8fae-67a6-4bf0-88c8-a6fd2988d395</id>
  <published>2025-11-06T14:31:46+05:00</published>
  <updated>2025-11-06T14:31:46+05:00</updated>
  <category term="notes" />
  <category term="changelogs" />
  <summary>I wanted a more flexible way to show lists of related posts. The old way involved adding a collection block to a page’s front matter, like this:</summary>
<mosaic:place>Atyrau, Atyrau Oblisi, Kazakhstan</mosaic:place>
<content type="html">
    &lt;p&gt;I wanted a more flexible way to show lists of related posts. The old way involved adding a collection block to a page’s front matter, like this:&lt;/p&gt;&lt;div class=&#34;code-block&#34; data-lang=&#34;toml&#34;&gt;&lt;div class=&#34;code-header&#34; data-mosaic-chrome=&#34;&#34;&gt;&lt;span class=&#34;code-lang&#34;&gt;toml&lt;/span&gt;&lt;button class=&#34;code-copy&#34; aria-label=&#34;Copy code&#34; type=&#34;button&#34;&gt;Copy&lt;/button&gt;&lt;/div&gt;&lt;pre&gt;&lt;code data-lang=&#34;toml&#34;&gt;[&lt;span style=&#34;color: #4b69c6&#34;&gt;collection&lt;/span&gt;]
&lt;span style=&#34;color: #4b69c6&#34;&gt;include&lt;/span&gt; = [&lt;span style=&#34;color: #198810&#34;&gt;&amp;#34;&lt;/span&gt;&lt;span style=&#34;color: #198810&#34;&gt;essays&lt;/span&gt;&lt;span style=&#34;color: #198810&#34;&gt;&amp;#34;&lt;/span&gt;]&lt;/code&gt;&lt;/pre&gt;&lt;/div&gt;&lt;p&gt;This worked, but it had big limitations: you could only have one collection, and it always appeared at the bottom of the page. The new &lt;code&gt;\#collection()&lt;/code&gt; shortcode lets me drop collections (as many as I want) anywhere in any document, directly from the body of the document. I also added much improved sorting and filtering options.&lt;/p&gt;&lt;p&gt;So, TLDR, to show the 5 most recent quotes I’ve saved that are tagged favourite:&lt;/p&gt;&lt;div class=&#34;code-block&#34;&gt;&lt;div class=&#34;code-header&#34; data-mosaic-chrome=&#34;&#34;&gt;&lt;button class=&#34;code-copy&#34; aria-label=&#34;Copy code&#34; type=&#34;button&#34;&gt;Copy&lt;/button&gt;&lt;/div&gt;&lt;pre&gt;&lt;code&gt;\#collection(from: &amp;#34;quotes&amp;#34;, limit: 5, tags: &amp;#34;favourite&amp;#34;)&lt;/code&gt;&lt;/pre&gt;&lt;/div&gt;&lt;p&gt;Which would render as:&lt;/p&gt;&lt;section data-pagefind-ignore=&#34;&#34; class=&#34;collection-section&#34;&gt;

&lt;article class=&#34;collection title&#34;&gt;
    &lt;header&gt;
        &lt;h2 class=&#34;item-title&#34;&gt;&lt;a href=&#34;/2026/02/07/085232&#34; data-preview=&#34;/previews/26fd59f6-1600-41db-9ff4-90bf3c8b936f.html&#34;&gt;Theodore Roosevelt, Citizenship in a Republic, 1910&lt;/a&gt;&lt;/h2&gt;&lt;time datetime=&#34;2026-02-07T08:53:20+00:00&#34;&gt;
        &lt;a href=&#34;/2026/02/07/085232&#34;&gt;
        Feb 7, 2026&lt;/a&gt;
    &lt;/time&gt;&lt;/header&gt;
&lt;/article&gt;

&lt;article class=&#34;collection title&#34;&gt;
    &lt;header&gt;
        &lt;h2 class=&#34;item-title&#34;&gt;&lt;a href=&#34;/2026/01/30/154005&#34; data-preview=&#34;/previews/b5d49ee0-138d-4945-8ac1-4623ec793822.html&#34;&gt;Anne Frank, The Diary of a Young Girl, 1947&lt;/a&gt;&lt;/h2&gt;&lt;time datetime=&#34;2026-01-30T15:40:05+00:00&#34;&gt;
        &lt;a href=&#34;/2026/01/30/154005&#34;&gt;
        Jan 30, 2026&lt;/a&gt;
    &lt;/time&gt;&lt;/header&gt;
&lt;/article&gt;

&lt;article class=&#34;collection title&#34;&gt;
    &lt;header&gt;
        &lt;h2 class=&#34;item-title&#34;&gt;&lt;a href=&#34;/2026/01/28/214251&#34; data-preview=&#34;/previews/72dcddcb-4384-49dc-bed0-bbee488fe45f.html&#34;&gt;Anne Morriss, Starbucks &amp;#34;The Way I See It&amp;#34; cup #76, 2009&lt;/a&gt;&lt;/h2&gt;&lt;time datetime=&#34;2026-01-28T21:42:51+00:00&#34;&gt;
        &lt;a href=&#34;/2026/01/28/214251&#34;&gt;
        Jan 28, 2026&lt;/a&gt;
    &lt;/time&gt;&lt;/header&gt;
&lt;/article&gt;

&lt;article class=&#34;collection title&#34;&gt;
    &lt;header&gt;
        &lt;h2 class=&#34;item-title&#34;&gt;&lt;a href=&#34;/2026/01/04/210609&#34; data-preview=&#34;/previews/5e0489d2-4d98-49b3-837b-22a27c973394.html&#34;&gt;William H. Whyte, “Is Anybody Listening?”, 1950&lt;/a&gt;&lt;/h2&gt;&lt;time datetime=&#34;2026-01-04T21:06:09+00:00&#34;&gt;
        &lt;a href=&#34;/2026/01/04/210609&#34;&gt;
        Jan 4, 2026&lt;/a&gt;
    &lt;/time&gt;&lt;/header&gt;
&lt;/article&gt;

&lt;article class=&#34;collection title&#34;&gt;
    &lt;header&gt;
        &lt;h2 class=&#34;item-title&#34;&gt;&lt;a href=&#34;/2025/11/13/112802&#34; data-preview=&#34;/previews/bc6dacda-0c14-479d-86ec-435869370bc6.html&#34;&gt;Geoff Manaugh, “Seer”, 2025&lt;/a&gt;&lt;/h2&gt;&lt;time datetime=&#34;2025-11-13T11:28:02+05:00&#34;&gt;
        &lt;a href=&#34;/2025/11/13/112802&#34;&gt;
        Nov 13, 2025&lt;/a&gt;
    &lt;/time&gt;&lt;/header&gt;
&lt;/article&gt;
&lt;/section&gt;
&lt;p&gt;My first effort had a circular dependency problem: how can you generate a page that needs a list of other pages, when those other pages might not have been generated yet? The solution is necessarily two-pass, and so while sharing its syntax with the other shortcodes, it does not run until later in the build.&lt;/p&gt;&lt;ol&gt;&lt;li value=&#34;1&#34;&gt;&lt;p&gt;First Pass: When the site generator sees a &lt;code&gt;\#collection()&lt;/code&gt; shortcode, it doesn’t build the list right away. Instead, it leaves a unique placeholder and makes a note of the document and the parameters that were used.&lt;/p&gt;&lt;/li&gt;&lt;li value=&#34;2&#34;&gt;&lt;p&gt;Second Pass: After all the pages have had their main content generated, a final step loops over the documents it made a note of.&lt;/p&gt;&lt;/li&gt;&lt;/ol&gt;&lt;p&gt;It now has all the data it needs to build the collection, so it renders the list into HTML and swaps it with the placeholder.&lt;/p&gt;&lt;p&gt;Despite being two pass, it’s pretty efficient as it only re-visits the pages that actually need it.&lt;/p&gt;&lt;p&gt;Collections exclude the current page unless the &lt;code&gt;include_self=True&lt;/code&gt; boolean is passed, such as for a series table of contents.&lt;/p&gt;&lt;p&gt;Collections can contain documents that themselves contain collections, even wehn rendering the whole child document (e.g. &lt;code&gt;style=&amp;#34;body&amp;#34;&lt;/code&gt;). This is achieved through iterative.&lt;/p&gt;&lt;hr/&gt;&lt;p&gt;Filtering:&lt;/p&gt;&lt;ul&gt;&lt;li&gt;&lt;p&gt;&lt;code&gt;include=&amp;#34;[tags]&amp;#34;&lt;/code&gt;: Includes documents matching a comma-separated list of categories or tags.&lt;/p&gt;&lt;ul&gt;&lt;li&gt;&lt;code&gt;\#collection(from: (&amp;#34;essays&amp;#34;, &amp;#34;wandering&amp;#34;))&lt;/code&gt;&lt;/li&gt;&lt;/ul&gt;&lt;/li&gt;&lt;li&gt;&lt;p&gt;&lt;code&gt;exclude=&amp;#34;[tags]&amp;#34;&lt;/code&gt;: Excludes documents from the included set.&lt;/p&gt;&lt;/li&gt;&lt;/ul&gt;&lt;p&gt;k&lt;/p&gt;&lt;ul&gt;&lt;li&gt;&lt;p&gt;&lt;code&gt;\#collection(from: &amp;#34;essays&amp;#34;, except: &amp;#34;personal&amp;#34;)&lt;/code&gt;&lt;/p&gt;&lt;/li&gt;&lt;li&gt;&lt;p&gt;&lt;code&gt;filter=&amp;#34;[filters]&amp;#34;&lt;/code&gt;: Filters documents by metadata fields. Supports . for nested fields (e.g., available.year) and checks for list membership (e.g., tags=…).&lt;/p&gt;&lt;ul&gt;&lt;li&gt;&lt;code&gt;\#collection(where: (favourite: true))&lt;/code&gt;&lt;/li&gt;&lt;li&gt;&lt;code&gt;\#collection(where: (creator: &amp;#34;Silas Jelley&amp;#34;), query: &amp;#34;after:2024 before:2025&amp;#34;)&lt;/code&gt;&lt;/li&gt;&lt;li&gt;&lt;code&gt;\#collection(from: &amp;#34;notes&amp;#34;, tags: &amp;#34;python&amp;#34;)&lt;/code&gt;&lt;/li&gt;&lt;/ul&gt;&lt;/li&gt;&lt;/ul&gt;&lt;p&gt;Sorting &amp;amp; Slicing:&lt;/p&gt;&lt;ul&gt;&lt;li&gt;&lt;p&gt;&lt;code&gt;order=&amp;#34;[order]&amp;#34;&lt;/code&gt;: Sets the sort order.&lt;/p&gt;&lt;ul&gt;&lt;li&gt;reverse-chronological (default), chronological, alphabetical.&lt;/li&gt;&lt;li&gt;&lt;code&gt;\#collection(from: &amp;#34;pearls&amp;#34;, order: &amp;#34;alphabetical&amp;#34;)&lt;/code&gt;&lt;/li&gt;&lt;/ul&gt;&lt;/li&gt;&lt;li&gt;&lt;p&gt;&lt;code&gt;limit=&amp;#34;[int]&amp;#34;&lt;/code&gt;: Limits the number of documents displayed.&lt;/p&gt;&lt;ul&gt;&lt;li&gt;&lt;p&gt;&lt;code&gt;\#collection(from: &amp;#34;main&amp;#34;, limit: 5)&lt;/code&gt;&lt;/p&gt;&lt;/li&gt;&lt;li&gt;&lt;p&gt;&lt;code&gt;offset=&amp;#34;[int]&amp;#34;&lt;/code&gt;: Skips the first N documents.&lt;/p&gt;&lt;ul&gt;&lt;li&gt;&lt;code&gt;\#collection(from: &amp;#34;main&amp;#34;, limit: 5, offset: 5)&lt;/code&gt;&lt;/li&gt;&lt;/ul&gt;&lt;/li&gt;&lt;li&gt;&lt;p&gt;Paginate collections: &lt;code&gt;\#collection(from: &amp;#34;photos&amp;#34;, limit: 10, offset: 20)&lt;/code&gt; shows the third page of photos if you’re showing 10 per page.&lt;/p&gt;&lt;/li&gt;&lt;/ul&gt;&lt;/li&gt;&lt;/ul&gt;&lt;p&gt;Display Styles:&lt;/p&gt;&lt;ul&gt;&lt;li&gt;&lt;p&gt;&lt;code&gt;style=&amp;#34;[style]&amp;#34;&lt;/code&gt;: Controls the appearance.&lt;/p&gt;&lt;ul&gt;&lt;li&gt;title (default): A simple list of linked titles and dates.&lt;/li&gt;&lt;li&gt;summary: Titles, dates, and a short summary of the content.&lt;/li&gt;&lt;li&gt;body: The full rendered HTML body of each document.&lt;/li&gt;&lt;li&gt;&lt;code&gt;\#collection(from: &amp;#34;changelogs&amp;#34;, style: &amp;#34;body&amp;#34;)&lt;/code&gt;&lt;/li&gt;&lt;/ul&gt;&lt;/li&gt;&lt;li&gt;&lt;p&gt;&lt;code&gt;numbered=True&lt;/code&gt;: Renders a title style collection as a numbered list (&amp;lt;ol&amp;gt;).&lt;/p&gt;&lt;ul&gt;&lt;li&gt;&lt;code&gt;\#collection(from: &amp;#34;series-a&amp;#34;, order: &amp;#34;chronological&amp;#34;, numbered: true)&lt;/code&gt;&lt;/li&gt;&lt;/ul&gt;&lt;/li&gt;&lt;li&gt;&lt;p&gt;&lt;code&gt;show_date=False&lt;/code&gt;: Hides the date in title and summary styles.&lt;/p&gt;&lt;ul&gt;&lt;li&gt;&lt;code&gt;\#collection(from: &amp;#34;essays&amp;#34;, show-date: false)&lt;/code&gt;&lt;/li&gt;&lt;/ul&gt;&lt;/li&gt;&lt;/ul&gt;&lt;p&gt;Behavior:&lt;/p&gt;&lt;ul&gt;&lt;li&gt;&lt;p&gt;&lt;code&gt;include_self=True&lt;/code&gt;: Includes the current document in the list if it matches the filters. The default (False) is to exclude it to prevent circular references.&lt;/p&gt;&lt;ul&gt;&lt;li&gt;&lt;code&gt;\#collection(from: &amp;#34;series-a&amp;#34;, include-self: true)&lt;/code&gt;&lt;/li&gt;&lt;/ul&gt;&lt;/li&gt;&lt;/ul&gt;&lt;hr/&gt;&lt;p&gt;This change completely removes the old front matter based collection system.&lt;/p&gt;2:31pm on November 6, 2025 from Atyrau, Atyrau Oblisi, Kazakhstan&lt;p&gt;&lt;a href=&#34;mailto:reply@silasjelley.com?subject=Reply%20to%3A%20%E2%80%9CAdd%20%40collection%28%29%20shortcode%E2%80%9D&#34;&gt;Reply via email&lt;/a&gt;&lt;/p&gt;
</content>
</entry>
<entry>
  <title>Fail build on unencoded parentheses in URLs</title>
  <link rel="alternate" type="text/html" href="https://silasjelley.com/2025/10/23/205446" />
  <id>tag:silasjelley.com,2020-08-20:b6863e79-27a9-4bec-b49e-7412959b99f3</id>
  <published>2025-10-23T20:54:46+04:00</published>
  <updated>2025-10-23T20:54:46+04:00</updated>
  <category term="notes" />
  <category term="changelogs" />
  <summary>One of the outputs of this site is a plaintext file containing all the external links I reference across the site. I noticed recently that a couple of the Wikipedia links in there were incorrect.…</summary>
<mosaic:place>Astrakhan, Astrakhan Oblast, Russia</mosaic:place>
<content type="html">
    &lt;p&gt;One of the outputs of this site is &lt;a href=&#34;/links.txt&#34;&gt;a plaintext file containing all the external links&lt;/a&gt; I reference across the site. I noticed recently that a couple of the Wikipedia links in there were incorrect. Wikipedia is one of the few websites that uses parentheses “()” in URLs, and my naive link extracting regex would finish looking at the first closing parenthesis because it took that to mean it was inside &lt;a href=&#34;https://htmlpreview.github.io/?https://github.com/jgm/djot/blob/master/doc/syntax.html#link&#34;&gt;a Djot format link&lt;/a&gt; and shouldn’t include the bracket.&lt;/p&gt;&lt;p&gt;The result, a URL like &lt;code&gt;https://en.wikipedia.org/wiki/Cardinality_(data_modeling)&lt;/code&gt; would lose it’s last parenthesis and be rendered invalid.&lt;/p&gt;&lt;p&gt;I first concocted a bit of clever parsing to handle this, and then I decided that the most robust thing to do would be throw away that cleverness and fail loudly if any such URL was found. Now, if I save a URL with unencoded parentheses into one of my markup files, it’ll raise a &lt;code&gt;ValueError&lt;/code&gt; and print a helpful error like so:&lt;/p&gt;&lt;div class=&#34;code-block&#34;&gt;&lt;div class=&#34;code-header&#34; data-mosaic-chrome=&#34;&#34;&gt;&lt;button class=&#34;code-copy&#34; aria-label=&#34;Copy code&#34; type=&#34;button&#34;&gt;Copy&lt;/button&gt;&lt;/div&gt;&lt;pre&gt;&lt;code&gt;  ERROR: Document contains URL with improperly encoded characters:
      Title: We shape our software; thereafter our software shapes us
      File:  /home/silas/notes/essays/software-shapes-us.md

      Replace with:
            #link(&amp;#34;https://en.wikipedia.org/wiki/Ontology_%28information_science%29&amp;#34;)[ontlogies]&lt;/code&gt;&lt;/pre&gt;&lt;/div&gt;&lt;p&gt;(I’ve hidden the link that includes the link in the error output, else that would raise an error here :D)&lt;/p&gt;&lt;p&gt;This involved changes to &lt;code&gt;extract_external_links()&lt;/code&gt; and &lt;code&gt;process_documents()&lt;/code&gt;.&lt;/p&gt;&lt;div class=&#34;code-block&#34; data-lang=&#34;python&#34;&gt;&lt;div class=&#34;code-header&#34; data-mosaic-chrome=&#34;&#34;&gt;&lt;span class=&#34;code-lang&#34;&gt;python&lt;/span&gt;&lt;button class=&#34;code-copy&#34; aria-label=&#34;Copy code&#34; type=&#34;button&#34;&gt;Copy&lt;/button&gt;&lt;/div&gt;&lt;pre&gt;&lt;code data-lang=&#34;python&#34;&gt;
&lt;span style=&#34;color: #d73948&#34;&gt;def&lt;/span&gt; &lt;span style=&#34;color: #4b69c6&#34;&gt;extract_external_links&lt;/span&gt;(
    text: &lt;span style=&#34;color: #4b69c6&#34;&gt;str&lt;/span&gt;, site, status
) -&amp;gt; Tuple[List, Optional[Tuple[&lt;span style=&#34;color: #4b69c6&#34;&gt;str&lt;/span&gt;, &lt;span style=&#34;color: #4b69c6&#34;&gt;str&lt;/span&gt;]]]:
    &lt;span style=&#34;color: #74747c&#34;&gt;&amp;#34;&amp;#34;&amp;#34;&lt;/span&gt;&lt;span style=&#34;color: #74747c&#34;&gt;Extract external links from text.&lt;/span&gt;

&lt;span style=&#34;color: #74747c&#34;&gt;    Returns:&lt;/span&gt;
&lt;span style=&#34;color: #74747c&#34;&gt;        Tuple of (sorted external links list, optional (link_text, url) tuple if problematic link found)&lt;/span&gt;
&lt;span style=&#34;color: #74747c&#34;&gt;    &lt;/span&gt;&lt;span style=&#34;color: #74747c&#34;&gt;&amp;#34;&amp;#34;&amp;#34;&lt;/span&gt;
    &lt;span style=&#34;color: #74747c&#34;&gt;#&lt;/span&gt;&lt;span style=&#34;color: #74747c&#34;&gt; Pattern that captures markdown links with URLs containing unencoded parens&lt;/span&gt;
    markdown_link_pattern &lt;span style=&#34;color: #d73948&#34;&gt;=&lt;/span&gt; &lt;span style=&#34;color: #d73948&#34;&gt;r&lt;/span&gt;&lt;span style=&#34;color: #198810&#34;&gt;&amp;#34;&lt;/span&gt;&lt;span style=&#34;color: #1d6c76&#34;&gt;\[&lt;/span&gt;&lt;span style=&#34;color: #198810&#34;&gt;(&lt;/span&gt;&lt;span style=&#34;color: #b60157&#34;&gt;[&lt;/span&gt;&lt;span style=&#34;color: #d73948&#34;&gt;^&lt;/span&gt;&lt;span style=&#34;color: #1d6c76&#34;&gt;\]&lt;/span&gt;&lt;span style=&#34;color: #b60157&#34;&gt;]&lt;/span&gt;&lt;span style=&#34;color: #d73948&#34;&gt;+&lt;/span&gt;&lt;span style=&#34;color: #198810&#34;&gt;)&lt;/span&gt;&lt;span style=&#34;color: #1d6c76&#34;&gt;\]&lt;/span&gt;&lt;span style=&#34;color: #1d6c76&#34;&gt;\(&lt;/span&gt;&lt;span style=&#34;color: #198810&#34;&gt;(&lt;/span&gt;&lt;span style=&#34;color: #198810&#34;&gt;https&lt;/span&gt;&lt;span style=&#34;color: #d73948&#34;&gt;?&lt;/span&gt;&lt;span style=&#34;color: #198810&#34;&gt;://&lt;/span&gt;&lt;span style=&#34;color: #b60157&#34;&gt;[&lt;/span&gt;&lt;span style=&#34;color: #d73948&#34;&gt;^&lt;/span&gt;&lt;span style=&#34;color: #b60157&#34;&gt;)&lt;/span&gt;&lt;span style=&#34;color: #b60157&#34;&gt;]&lt;/span&gt;&lt;span style=&#34;color: #d73948&#34;&gt;*&lt;/span&gt;&lt;span style=&#34;color: #1d6c76&#34;&gt;\(&lt;/span&gt;&lt;span style=&#34;color: #b60157&#34;&gt;[&lt;/span&gt;&lt;span style=&#34;color: #d73948&#34;&gt;^&lt;/span&gt;&lt;span style=&#34;color: #b60157&#34;&gt;)&lt;/span&gt;&lt;span style=&#34;color: #b60157&#34;&gt;]&lt;/span&gt;&lt;span style=&#34;color: #d73948&#34;&gt;*&lt;/span&gt;&lt;span style=&#34;color: #1d6c76&#34;&gt;\)&lt;/span&gt;&lt;span style=&#34;color: #198810&#34;&gt;)&lt;/span&gt;&lt;span style=&#34;color: #1d6c76&#34;&gt;\)&lt;/span&gt;&lt;span style=&#34;color: #198810&#34;&gt;&amp;#34;&lt;/span&gt;

    &lt;span style=&#34;color: #74747c&#34;&gt;#&lt;/span&gt;&lt;span style=&#34;color: #74747c&#34;&gt; Check for markdown links with unencoded parentheses in URL&lt;/span&gt;
    problematic_links &lt;span style=&#34;color: #d73948&#34;&gt;=&lt;/span&gt; re.&lt;span style=&#34;color: #4b69c6&#34;&gt;findall&lt;/span&gt;(markdown_link_pattern, text)
    &lt;span style=&#34;color: #d73948&#34;&gt;if&lt;/span&gt; problematic_links:
        &lt;span style=&#34;color: #d73948&#34;&gt;return&lt;/span&gt; [], problematic_links[&lt;span style=&#34;color: #b60157&#34;&gt;0&lt;/span&gt;]  &lt;span style=&#34;color: #74747c&#34;&gt;#&lt;/span&gt;&lt;span style=&#34;color: #74747c&#34;&gt; Return first problematic link&lt;/span&gt;

    &lt;span style=&#34;color: #74747c&#34;&gt;#&lt;/span&gt;&lt;span style=&#34;color: #74747c&#34;&gt; Pattern that handles URLs (now assumes parens are encoded)&lt;/span&gt;
    url_pattern &lt;span style=&#34;color: #d73948&#34;&gt;=&lt;/span&gt; (
        &lt;span style=&#34;color: #d73948&#34;&gt;r&lt;/span&gt;&lt;span style=&#34;color: #198810&#34;&gt;&amp;#34;&lt;/span&gt;&lt;span style=&#34;color: #198810&#34;&gt;https&lt;/span&gt;&lt;span style=&#34;color: #d73948&#34;&gt;?&lt;/span&gt;&lt;span style=&#34;color: #198810&#34;&gt;://&lt;/span&gt;&lt;span style=&#34;color: #198810&#34;&gt;(&lt;/span&gt;&lt;span style=&#34;color: #198810&#34;&gt;?:&lt;/span&gt;&lt;span style=&#34;color: #b60157&#34;&gt;[&lt;/span&gt;&lt;span style=&#34;color: #b60157&#34;&gt;-&lt;/span&gt;&lt;span style=&#34;color: #b60157&#34;&gt;\w&lt;/span&gt;&lt;span style=&#34;color: #b60157&#34;&gt;.&lt;/span&gt;&lt;span style=&#34;color: #b60157&#34;&gt;]&lt;/span&gt;&lt;span style=&#34;color: #d73948&#34;&gt;|&lt;/span&gt;&lt;span style=&#34;color: #198810&#34;&gt;(&lt;/span&gt;&lt;span style=&#34;color: #198810&#34;&gt;?:&lt;/span&gt;&lt;span style=&#34;color: #198810&#34;&gt;%&lt;/span&gt;&lt;span style=&#34;color: #b60157&#34;&gt;[&lt;/span&gt;&lt;span style=&#34;color: #b60157&#34;&gt;\d&lt;/span&gt;&lt;span style=&#34;color: #b60157&#34;&gt;a-f&lt;/span&gt;&lt;span style=&#34;color: #b60157&#34;&gt;A-F&lt;/span&gt;&lt;span style=&#34;color: #b60157&#34;&gt;]&lt;/span&gt;&lt;span style=&#34;color: #d73948&#34;&gt;{2}&lt;/span&gt;&lt;span style=&#34;color: #198810&#34;&gt;)&lt;/span&gt;&lt;span style=&#34;color: #198810&#34;&gt;)&lt;/span&gt;&lt;span style=&#34;color: #d73948&#34;&gt;+&lt;/span&gt;&lt;span style=&#34;color: #198810&#34;&gt;&amp;#34;&lt;/span&gt;  &lt;span style=&#34;color: #74747c&#34;&gt;#&lt;/span&gt;&lt;span style=&#34;color: #74747c&#34;&gt; domain&lt;/span&gt;
        &lt;span style=&#34;color: #d73948&#34;&gt;r&lt;/span&gt;&lt;span style=&#34;color: #198810&#34;&gt;&amp;#34;&lt;/span&gt;&lt;span style=&#34;color: #198810&#34;&gt;(&lt;/span&gt;&lt;span style=&#34;color: #198810&#34;&gt;?:&lt;/span&gt;&lt;span style=&#34;color: #198810&#34;&gt;/&lt;/span&gt;&lt;span style=&#34;color: #b60157&#34;&gt;[&lt;/span&gt;&lt;span style=&#34;color: #d73948&#34;&gt;^&lt;/span&gt;&lt;span style=&#34;color: #b60157&#34;&gt;\s&lt;/span&gt;&lt;span style=&#34;color: #1d6c76&#34;&gt;\&amp;#34;&lt;/span&gt;&lt;span style=&#34;color: #b60157&#34;&gt;&amp;#39;&amp;lt;&amp;gt;)&lt;/span&gt;&lt;span style=&#34;color: #b60157&#34;&gt;]&lt;/span&gt;&lt;span style=&#34;color: #d73948&#34;&gt;*&lt;/span&gt;&lt;span style=&#34;color: #198810&#34;&gt;)&lt;/span&gt;&lt;span style=&#34;color: #d73948&#34;&gt;?&lt;/span&gt;&lt;span style=&#34;color: #198810&#34;&gt;&amp;#34;&lt;/span&gt;  &lt;span style=&#34;color: #74747c&#34;&gt;#&lt;/span&gt;&lt;span style=&#34;color: #74747c&#34;&gt; path (no unencoded parens allowed)&lt;/span&gt;
    )
    matches &lt;span style=&#34;color: #d73948&#34;&gt;=&lt;/span&gt; re.&lt;span style=&#34;color: #4b69c6&#34;&gt;findall&lt;/span&gt;(url_pattern, text)

    external_links &lt;span style=&#34;color: #d73948&#34;&gt;=&lt;/span&gt; &lt;span style=&#34;color: #4b69c6&#34;&gt;set&lt;/span&gt;()
    &lt;span style=&#34;color: #d73948&#34;&gt;for&lt;/span&gt; url &lt;span style=&#34;color: #d73948&#34;&gt;in&lt;/span&gt; matches:
        &lt;span style=&#34;color: #74747c&#34;&gt;#&lt;/span&gt;&lt;span style=&#34;color: #74747c&#34;&gt; Clean up any trailing punctuation that might have been caught&lt;/span&gt;
        url &lt;span style=&#34;color: #d73948&#34;&gt;=&lt;/span&gt; url.&lt;span style=&#34;color: #4b69c6&#34;&gt;rstrip&lt;/span&gt;(&lt;span style=&#34;color: #198810&#34;&gt;&amp;#34;&lt;/span&gt;&lt;span style=&#34;color: #198810&#34;&gt;.,;:!?&lt;/span&gt;&lt;span style=&#34;color: #198810&#34;&gt;&amp;#34;&lt;/span&gt;)

        parsed_url &lt;span style=&#34;color: #d73948&#34;&gt;=&lt;/span&gt; &lt;span style=&#34;color: #4b69c6&#34;&gt;urlparse&lt;/span&gt;(url)
        &lt;span style=&#34;color: #d73948&#34;&gt;if&lt;/span&gt; parsed_url.netloc.&lt;span style=&#34;color: #4b69c6&#34;&gt;lower&lt;/span&gt;() &lt;span style=&#34;color: #d73948&#34;&gt;!=&lt;/span&gt; &lt;span style=&#34;color: #198810&#34;&gt;&amp;#34;&lt;/span&gt;&lt;span style=&#34;color: #198810&#34;&gt;silasjelley.com&lt;/span&gt;&lt;span style=&#34;color: #198810&#34;&gt;&amp;#34;&lt;/span&gt;:
            external_links.&lt;span style=&#34;color: #4b69c6&#34;&gt;add&lt;/span&gt;(url)

            &lt;span style=&#34;color: #74747c&#34;&gt;#&lt;/span&gt;&lt;span style=&#34;color: #74747c&#34;&gt; Only add to site.links if not a draft&lt;/span&gt;
            &lt;span style=&#34;color: #d73948&#34;&gt;if&lt;/span&gt; status &lt;span style=&#34;color: #d73948&#34;&gt;!=&lt;/span&gt; &lt;span style=&#34;color: #198810&#34;&gt;&amp;#34;&lt;/span&gt;&lt;span style=&#34;color: #198810&#34;&gt;draft&lt;/span&gt;&lt;span style=&#34;color: #198810&#34;&gt;&amp;#34;&lt;/span&gt;:
                site.links[&lt;span style=&#34;color: #198810&#34;&gt;&amp;#34;&lt;/span&gt;&lt;span style=&#34;color: #198810&#34;&gt;external&lt;/span&gt;&lt;span style=&#34;color: #198810&#34;&gt;&amp;#34;&lt;/span&gt;].&lt;span style=&#34;color: #4b69c6&#34;&gt;add&lt;/span&gt;(url)

    &lt;span style=&#34;color: #d73948&#34;&gt;return&lt;/span&gt; &lt;span style=&#34;color: #4b69c6&#34;&gt;sorted&lt;/span&gt;(external_links), &lt;span style=&#34;color: #d73948&#34;&gt;None&lt;/span&gt;


&lt;span style=&#34;color: #d73948&#34;&gt;async&lt;/span&gt; &lt;span style=&#34;color: #d73948&#34;&gt;def&lt;/span&gt; &lt;span style=&#34;color: #4b69c6&#34;&gt;process_document&lt;/span&gt;(
    filepath: Path, site: SiteMetadata
) -&amp;gt; Tuple[&lt;span style=&#34;color: #4b69c6&#34;&gt;str&lt;/span&gt;, DocumentMetadata]:
    &lt;span style=&#34;color: #74747c&#34;&gt;&amp;#34;&amp;#34;&amp;#34;&lt;/span&gt;&lt;span style=&#34;color: #74747c&#34;&gt;Process a document file and return its UID and metadata.&lt;/span&gt;&lt;span style=&#34;color: #74747c&#34;&gt;&amp;#34;&amp;#34;&amp;#34;&lt;/span&gt;

    &lt;span style=&#34;color: #d73948&#34;&gt;with&lt;/span&gt; &lt;span style=&#34;color: #4b69c6&#34;&gt;open&lt;/span&gt;(filepath, &lt;span style=&#34;color: #198810&#34;&gt;&amp;#34;&lt;/span&gt;&lt;span style=&#34;color: #198810&#34;&gt;rb&lt;/span&gt;&lt;span style=&#34;color: #198810&#34;&gt;&amp;#34;&lt;/span&gt;) &lt;span style=&#34;color: #d73948&#34;&gt;as&lt;/span&gt; f:
        &lt;span style=&#34;color: #d73948&#34;&gt;try&lt;/span&gt;:
            parsed_toml &lt;span style=&#34;color: #d73948&#34;&gt;=&lt;/span&gt; tomllib.&lt;span style=&#34;color: #4b69c6&#34;&gt;load&lt;/span&gt;(f)
        &lt;span style=&#34;color: #d73948&#34;&gt;except&lt;/span&gt;:
            logger.&lt;span style=&#34;color: #4b69c6&#34;&gt;error&lt;/span&gt;(&lt;span style=&#34;color: #d73948&#34;&gt;f&lt;/span&gt;&lt;span style=&#34;color: #198810&#34;&gt;&amp;#34;&lt;/span&gt;&lt;span style=&#34;color: #198810&#34;&gt;Error while processing document: &lt;/span&gt;&lt;span style=&#34;color: #8b41b1&#34;&gt;{&lt;/span&gt;&lt;span style=&#34;color: #8b41b1&#34;&gt;filepath&lt;/span&gt;&lt;span style=&#34;color: #8b41b1&#34;&gt;}&lt;/span&gt;&lt;span style=&#34;color: #198810&#34;&gt;&amp;#34;&lt;/span&gt;)
            &lt;span style=&#34;color: #d73948&#34;&gt;import&lt;/span&gt; sys

            sys.&lt;span style=&#34;color: #4b69c6&#34;&gt;exit&lt;/span&gt;(&lt;span style=&#34;color: #b60157&#34;&gt;1&lt;/span&gt;)

    &lt;span style=&#34;color: #74747c&#34;&gt;#&lt;/span&gt;&lt;span style=&#34;color: #74747c&#34;&gt; The UID is now the top-level table name&lt;/span&gt;
    uid &lt;span style=&#34;color: #d73948&#34;&gt;=&lt;/span&gt; parsed_toml[&lt;span style=&#34;color: #198810&#34;&gt;&amp;#34;&lt;/span&gt;&lt;span style=&#34;color: #198810&#34;&gt;uid&lt;/span&gt;&lt;span style=&#34;color: #198810&#34;&gt;&amp;#34;&lt;/span&gt;]

    &lt;span style=&#34;color: #74747c&#34;&gt;#&lt;/span&gt;&lt;span style=&#34;color: #74747c&#34;&gt; Process metadata into DocumentMetadata instance&lt;/span&gt;
    document &lt;span style=&#34;color: #d73948&#34;&gt;=&lt;/span&gt; &lt;span style=&#34;color: #4b69c6&#34;&gt;preprocess_metadata&lt;/span&gt;(filepath, parsed_toml)

    &lt;span style=&#34;color: #74747c&#34;&gt;#&lt;/span&gt;&lt;span style=&#34;color: #74747c&#34;&gt; Extract external links from the plain text content&lt;/span&gt;
    &lt;span style=&#34;color: #d73948&#34;&gt;try&lt;/span&gt;:
        plain_text &lt;span style=&#34;color: #d73948&#34;&gt;=&lt;/span&gt; (
            document.content.&lt;span style=&#34;color: #4b69c6&#34;&gt;get&lt;/span&gt;(&lt;span style=&#34;color: #198810&#34;&gt;&amp;#34;&lt;/span&gt;&lt;span style=&#34;color: #198810&#34;&gt;plain&lt;/span&gt;&lt;span style=&#34;color: #198810&#34;&gt;&amp;#34;&lt;/span&gt;, &lt;span style=&#34;color: #198810&#34;&gt;&amp;#34;&lt;/span&gt;&lt;span style=&#34;color: #198810&#34;&gt;&amp;#34;&lt;/span&gt;)
            &lt;span style=&#34;color: #d73948&#34;&gt;+&lt;/span&gt; &lt;span style=&#34;color: #198810&#34;&gt;&amp;#34;&lt;/span&gt;&lt;span style=&#34;color: #198810&#34;&gt; &lt;/span&gt;&lt;span style=&#34;color: #198810&#34;&gt;&amp;#34;&lt;/span&gt;
            &lt;span style=&#34;color: #d73948&#34;&gt;+&lt;/span&gt; document.source.&lt;span style=&#34;color: #4b69c6&#34;&gt;get&lt;/span&gt;(&lt;span style=&#34;color: #198810&#34;&gt;&amp;#34;&lt;/span&gt;&lt;span style=&#34;color: #198810&#34;&gt;url&lt;/span&gt;&lt;span style=&#34;color: #198810&#34;&gt;&amp;#34;&lt;/span&gt;, &lt;span style=&#34;color: #198810&#34;&gt;&amp;#34;&lt;/span&gt;&lt;span style=&#34;color: #198810&#34;&gt;&amp;#34;&lt;/span&gt;)
            &lt;span style=&#34;color: #d73948&#34;&gt;+&lt;/span&gt; &lt;span style=&#34;color: #198810&#34;&gt;&amp;#34;&lt;/span&gt;&lt;span style=&#34;color: #198810&#34;&gt; &lt;/span&gt;&lt;span style=&#34;color: #198810&#34;&gt;&amp;#34;&lt;/span&gt;
            &lt;span style=&#34;color: #d73948&#34;&gt;+&lt;/span&gt; document.via.&lt;span style=&#34;color: #4b69c6&#34;&gt;get&lt;/span&gt;(&lt;span style=&#34;color: #198810&#34;&gt;&amp;#34;&lt;/span&gt;&lt;span style=&#34;color: #198810&#34;&gt;url&lt;/span&gt;&lt;span style=&#34;color: #198810&#34;&gt;&amp;#34;&lt;/span&gt;, &lt;span style=&#34;color: #198810&#34;&gt;&amp;#34;&lt;/span&gt;&lt;span style=&#34;color: #198810&#34;&gt;&amp;#34;&lt;/span&gt;)
        )

        status &lt;span style=&#34;color: #d73948&#34;&gt;=&lt;/span&gt; document.status &lt;span style=&#34;color: #d73948&#34;&gt;if&lt;/span&gt; document.status &lt;span style=&#34;color: #d73948&#34;&gt;else&lt;/span&gt; &lt;span style=&#34;color: #198810&#34;&gt;&amp;#34;&lt;/span&gt;&lt;span style=&#34;color: #198810&#34;&gt;&amp;#34;&lt;/span&gt;
        external_links, problematic &lt;span style=&#34;color: #d73948&#34;&gt;=&lt;/span&gt; &lt;span style=&#34;color: #4b69c6&#34;&gt;extract_external_links&lt;/span&gt;(plain_text, site, status)

        &lt;span style=&#34;color: #d73948&#34;&gt;if&lt;/span&gt; problematic:
            link_text, url &lt;span style=&#34;color: #d73948&#34;&gt;=&lt;/span&gt; problematic
            encoded_url &lt;span style=&#34;color: #d73948&#34;&gt;=&lt;/span&gt; url.&lt;span style=&#34;color: #4b69c6&#34;&gt;replace&lt;/span&gt;(&lt;span style=&#34;color: #198810&#34;&gt;&amp;#34;&lt;/span&gt;&lt;span style=&#34;color: #198810&#34;&gt;(&lt;/span&gt;&lt;span style=&#34;color: #198810&#34;&gt;&amp;#34;&lt;/span&gt;, &lt;span style=&#34;color: #198810&#34;&gt;&amp;#34;&lt;/span&gt;&lt;span style=&#34;color: #198810&#34;&gt;%28&lt;/span&gt;&lt;span style=&#34;color: #198810&#34;&gt;&amp;#34;&lt;/span&gt;).&lt;span style=&#34;color: #4b69c6&#34;&gt;replace&lt;/span&gt;(&lt;span style=&#34;color: #198810&#34;&gt;&amp;#34;&lt;/span&gt;&lt;span style=&#34;color: #198810&#34;&gt;)&lt;/span&gt;&lt;span style=&#34;color: #198810&#34;&gt;&amp;#34;&lt;/span&gt;, &lt;span style=&#34;color: #198810&#34;&gt;&amp;#34;&lt;/span&gt;&lt;span style=&#34;color: #198810&#34;&gt;%29&lt;/span&gt;&lt;span style=&#34;color: #198810&#34;&gt;&amp;#34;&lt;/span&gt;)
            &lt;span style=&#34;color: #d73948&#34;&gt;raise&lt;/span&gt; &lt;span style=&#34;color: #4b69c6&#34;&gt;ValueError&lt;/span&gt;(
                &lt;span style=&#34;color: #d73948&#34;&gt;f&lt;/span&gt;&lt;span style=&#34;color: #198810&#34;&gt;&amp;#34;&lt;/span&gt;&lt;span style=&#34;color: #1d6c76&#34;&gt;\n&lt;/span&gt;&lt;span style=&#34;color: #1d6c76&#34;&gt;\n&lt;/span&gt;&lt;span style=&#34;color: #198810&#34;&gt;  URL contains unencoded parentheses in document:&lt;/span&gt;&lt;span style=&#34;color: #1d6c76&#34;&gt;\n&lt;/span&gt;&lt;span style=&#34;color: #198810&#34;&gt;&amp;#34;&lt;/span&gt;
                &lt;span style=&#34;color: #d73948&#34;&gt;f&lt;/span&gt;&lt;span style=&#34;color: #198810&#34;&gt;&amp;#34;&lt;/span&gt;&lt;span style=&#34;color: #198810&#34;&gt;      Title: &lt;/span&gt;&lt;span style=&#34;color: #8b41b1&#34;&gt;{&lt;/span&gt;&lt;span style=&#34;color: #8b41b1&#34;&gt;document&lt;/span&gt;&lt;span style=&#34;color: #8b41b1&#34;&gt;.&lt;/span&gt;&lt;span style=&#34;color: #8b41b1&#34;&gt;title&lt;/span&gt;&lt;span style=&#34;color: #8b41b1&#34;&gt;}&lt;/span&gt;&lt;span style=&#34;color: #1d6c76&#34;&gt;\n&lt;/span&gt;&lt;span style=&#34;color: #198810&#34;&gt;&amp;#34;&lt;/span&gt;
                &lt;span style=&#34;color: #d73948&#34;&gt;f&lt;/span&gt;&lt;span style=&#34;color: #198810&#34;&gt;&amp;#34;&lt;/span&gt;&lt;span style=&#34;color: #198810&#34;&gt;      File:  &lt;/span&gt;&lt;span style=&#34;color: #8b41b1&#34;&gt;{&lt;/span&gt;&lt;span style=&#34;color: #8b41b1&#34;&gt;filepath&lt;/span&gt;&lt;span style=&#34;color: #8b41b1&#34;&gt;}&lt;/span&gt;&lt;span style=&#34;color: #1d6c76&#34;&gt;\n&lt;/span&gt;&lt;span style=&#34;color: #198810&#34;&gt;&amp;#34;&lt;/span&gt;
                &lt;span style=&#34;color: #d73948&#34;&gt;f&lt;/span&gt;&lt;span style=&#34;color: #198810&#34;&gt;&amp;#34;&lt;/span&gt;&lt;span style=&#34;color: #198810&#34;&gt;      Link:  #link(&lt;/span&gt;&lt;span style=&#34;color: #198810&#34;&gt;&amp;#34;&lt;/span&gt;{url}&lt;span style=&#34;color: #198810&#34;&gt;&amp;#34;&lt;/span&gt;&lt;span style=&#34;color: #198810&#34;&gt;)[&lt;/span&gt;&lt;span style=&#34;color: #b60157&#34;&gt;{&lt;/span&gt;&lt;span style=&#34;color: #b60157&#34;&gt;link_text&lt;/span&gt;&lt;span style=&#34;color: #b60157&#34;&gt;}&lt;/span&gt;&lt;span style=&#34;color: #198810&#34;&gt;]&lt;/span&gt;&lt;span style=&#34;color: #1d6c76&#34;&gt;\n&lt;/span&gt;&lt;span style=&#34;color: #1d6c76&#34;&gt;\n&lt;/span&gt;&lt;span style=&#34;color: #198810&#34;&gt;&amp;#34;&lt;/span&gt;
                &lt;span style=&#34;color: #d73948&#34;&gt;f&lt;/span&gt;&lt;span style=&#34;color: #198810&#34;&gt;&amp;#34;&lt;/span&gt;&lt;span style=&#34;color: #198810&#34;&gt;      Replace with:&lt;/span&gt;&lt;span style=&#34;color: #1d6c76&#34;&gt;\n&lt;/span&gt;&lt;span style=&#34;color: #198810&#34;&gt;&amp;#34;&lt;/span&gt;
                &lt;span style=&#34;color: #d73948&#34;&gt;f&lt;/span&gt;&lt;span style=&#34;color: #198810&#34;&gt;&amp;#34;&lt;/span&gt;&lt;span style=&#34;color: #198810&#34;&gt;            #link(&lt;/span&gt;&lt;span style=&#34;color: #198810&#34;&gt;&amp;#34;&lt;/span&gt;{encoded_url}&lt;span style=&#34;color: #198810&#34;&gt;&amp;#34;&lt;/span&gt;&lt;span style=&#34;color: #198810&#34;&gt;)[&lt;/span&gt;&lt;span style=&#34;color: #b60157&#34;&gt;{&lt;/span&gt;&lt;span style=&#34;color: #b60157&#34;&gt;link_text&lt;/span&gt;&lt;span style=&#34;color: #b60157&#34;&gt;}&lt;/span&gt;&lt;span style=&#34;color: #198810&#34;&gt;]&lt;/span&gt;&lt;span style=&#34;color: #1d6c76&#34;&gt;\n&lt;/span&gt;&lt;span style=&#34;color: #1d6c76&#34;&gt;\n&lt;/span&gt;&lt;span style=&#34;color: #198810&#34;&gt;&amp;#34;&lt;/span&gt;
            )

        document.links[&lt;span style=&#34;color: #198810&#34;&gt;&amp;#34;&lt;/span&gt;&lt;span style=&#34;color: #198810&#34;&gt;external&lt;/span&gt;&lt;span style=&#34;color: #198810&#34;&gt;&amp;#34;&lt;/span&gt;] &lt;span style=&#34;color: #d73948&#34;&gt;=&lt;/span&gt; external_links
    &lt;span style=&#34;color: #d73948&#34;&gt;except&lt;/span&gt; &lt;span style=&#34;color: #4b69c6&#34;&gt;KeyError&lt;/span&gt;:
        logger.&lt;span style=&#34;color: #4b69c6&#34;&gt;warn&lt;/span&gt;(&lt;span style=&#34;color: #d73948&#34;&gt;f&lt;/span&gt;&lt;span style=&#34;color: #198810&#34;&gt;&amp;#34;&lt;/span&gt;&lt;span style=&#34;color: #198810&#34;&gt;KeyError while compiling external links from &lt;/span&gt;&lt;span style=&#34;color: #8b41b1&#34;&gt;{&lt;/span&gt;&lt;span style=&#34;color: #8b41b1&#34;&gt;document&lt;/span&gt;&lt;span style=&#34;color: #8b41b1&#34;&gt;.&lt;/span&gt;&lt;span style=&#34;color: #8b41b1&#34;&gt;filepath&lt;/span&gt;&lt;span style=&#34;color: #8b41b1&#34;&gt;}&lt;/span&gt;&lt;span style=&#34;color: #198810&#34;&gt;&amp;#34;&lt;/span&gt;)
        &lt;span style=&#34;color: #d73948&#34;&gt;pass&lt;/span&gt;

    &lt;span style=&#34;color: #d73948&#34;&gt;return&lt;/span&gt; uid, document
&lt;/code&gt;&lt;/pre&gt;&lt;/div&gt;8:54pm on October 23, 2025 from Astrakhan, Astrakhan Oblast, Russia&lt;p&gt;&lt;a href=&#34;mailto:reply@silasjelley.com?subject=Reply%20to%3A%20%E2%80%9CFail%20build%20on%20unencoded%20parentheses%20in%20URLs%E2%80%9D&#34;&gt;Reply via email&lt;/a&gt;&lt;/p&gt;
</content>
</entry>
<entry>
  <title>Trim redundant CSS with PurgeCSS</title>
  <link rel="alternate" type="text/html" href="https://silasjelley.com/2025/10/23/192356" />
  <id>tag:silasjelley.com,2020-08-20:b21b87ee-3bbc-48a6-8d26-e614c8ceca74</id>
  <published>2025-10-23T19:23:56+04:00</published>
  <updated>2025-10-23T19:23:56+04:00</updated>
  <category term="notes" />
  <category term="changelogs" />
  <summary>I figured it made good sense to see if there were any old skeletons lingering in stylesheet before I switch to inlining the core of my styles into the page head. Easily done with PurgeCSS so long as…</summary>
<mosaic:place>Astrakhan, Astrakhan Oblast, Russia</mosaic:place>
<content type="html">
    &lt;p&gt;I figured it made good sense to see if there were any old skeletons lingering in stylesheet before I switch to inlining the core of my styles into the page head. Easily done with PurgeCSS so long as you can stomach another Node package in your filesystem.&lt;/p&gt;&lt;p&gt;&lt;code&gt;npx&lt;/code&gt; makes it trivial.&lt;/p&gt;&lt;div class=&#34;code-block&#34; data-lang=&#34;sh&#34;&gt;&lt;div class=&#34;code-header&#34; data-mosaic-chrome=&#34;&#34;&gt;&lt;span class=&#34;code-lang&#34;&gt;sh&lt;/span&gt;&lt;button class=&#34;code-copy&#34; aria-label=&#34;Copy code&#34; type=&#34;button&#34;&gt;Copy&lt;/button&gt;&lt;/div&gt;&lt;pre&gt;&lt;code data-lang=&#34;sh&#34;&gt;&lt;span style=&#34;color: #4b69c6&#34;&gt;npx&lt;/span&gt; purgecss --css /tmp/silasjelley.com/styles.css --content /tmp/silasjelley.com/&lt;span style=&#34;color: #d73948&#34;&gt;*&lt;/span&gt;&lt;span style=&#34;color: #d73948&#34;&gt;*&lt;/span&gt;.html --output /tmp/purge.css&lt;/code&gt;&lt;/pre&gt;&lt;/div&gt;&lt;p&gt;Diffing the two stylesheets (I use &lt;a href=&#34;https://meldmerge.org/&#34;&gt;Meld&lt;/a&gt;) showed up a handful of old CSS id’s and classes that I was no longer using, shaving a little off that all importing render blocking cascade.&lt;/p&gt;7:23pm on October 23, 2025 from Astrakhan, Astrakhan Oblast, Russia&lt;p&gt;&lt;a href=&#34;mailto:reply@silasjelley.com?subject=Reply%20to%3A%20%E2%80%9CTrim%20redundant%20CSS%20with%20PurgeCSS%E2%80%9D&#34;&gt;Reply via email&lt;/a&gt;&lt;/p&gt;
</content>
</entry>
<entry>
  <title>Preloading fonts to reduce request chaining</title>
  <link rel="alternate" type="text/html" href="https://silasjelley.com/2025/10/23/190913" />
  <id>tag:silasjelley.com,2020-08-20:27362b37-54ed-40b3-981b-a3ea059bbc0b</id>
  <published>2025-10-23T19:09:13+04:00</published>
  <updated>2025-10-23T19:09:13+04:00</updated>
  <category term="notes" />
  <category term="changelogs" />
  <summary>Added the right incantation to get fonts to pre-load, reducing request chaining by one hop. Note, crossorigin is required even though it’s from the same domain, else the browser will not use them and…</summary>
<mosaic:place>Astrakhan, Astrakhan Oblast, Russia</mosaic:place>
<content type="html">
    &lt;p&gt;Added the right incantation to get fonts to pre-load, reducing request chaining by one hop.&lt;/p&gt;&lt;p&gt;Note, &lt;code&gt;crossorigin&lt;/code&gt; is required even though it’s from the same domain, else the browser will not use them and redownload them when the stylesheet arrives.&lt;/p&gt;&lt;div class=&#34;code-block&#34; data-lang=&#34;html&#34;&gt;&lt;div class=&#34;code-header&#34; data-mosaic-chrome=&#34;&#34;&gt;&lt;span class=&#34;code-lang&#34;&gt;html&lt;/span&gt;&lt;button class=&#34;code-copy&#34; aria-label=&#34;Copy code&#34; type=&#34;button&#34;&gt;Copy&lt;/button&gt;&lt;/div&gt;&lt;pre&gt;&lt;code data-lang=&#34;html&#34;&gt;    \&amp;lt;&lt;span style=&#34;color: #4b69c6&#34;&gt;link&lt;/span&gt; &lt;span style=&#34;color: #8b41b1&#34;&gt;rel&lt;/span&gt;=&lt;span style=&#34;color: #198810&#34;&gt;&amp;#34;&lt;/span&gt;&lt;span style=&#34;color: #198810&#34;&gt;preload&lt;/span&gt;&lt;span style=&#34;color: #198810&#34;&gt;&amp;#34;&lt;/span&gt; &lt;span style=&#34;color: #8b41b1&#34;&gt;href&lt;/span&gt;=&lt;span style=&#34;color: #198810&#34;&gt;&amp;#34;&lt;/span&gt;&lt;span style=&#34;color: #198810&#34;&gt;/library/misc/fonts/Inter/Regular.woff2&lt;/span&gt;&lt;span style=&#34;color: #198810&#34;&gt;&amp;#34;&lt;/span&gt; &lt;span style=&#34;color: #8b41b1&#34;&gt;as&lt;/span&gt;=&lt;span style=&#34;color: #198810&#34;&gt;&amp;#34;&lt;/span&gt;&lt;span style=&#34;color: #198810&#34;&gt;font&lt;/span&gt;&lt;span style=&#34;color: #198810&#34;&gt;&amp;#34;&lt;/span&gt; &lt;span style=&#34;color: #8b41b1&#34;&gt;type&lt;/span&gt;=&lt;span style=&#34;color: #198810&#34;&gt;&amp;#34;&lt;/span&gt;&lt;span style=&#34;color: #198810&#34;&gt;font/woff2&lt;/span&gt;&lt;span style=&#34;color: #198810&#34;&gt;&amp;#34;&lt;/span&gt; &lt;span style=&#34;color: #8b41b1&#34;&gt;crossorigin&lt;/span&gt;&amp;gt;
    \&amp;lt;&lt;span style=&#34;color: #4b69c6&#34;&gt;link&lt;/span&gt; &lt;span style=&#34;color: #8b41b1&#34;&gt;rel&lt;/span&gt;=&lt;span style=&#34;color: #198810&#34;&gt;&amp;#34;&lt;/span&gt;&lt;span style=&#34;color: #198810&#34;&gt;preload&lt;/span&gt;&lt;span style=&#34;color: #198810&#34;&gt;&amp;#34;&lt;/span&gt; &lt;span style=&#34;color: #8b41b1&#34;&gt;href&lt;/span&gt;=&lt;span style=&#34;color: #198810&#34;&gt;&amp;#34;&lt;/span&gt;&lt;span style=&#34;color: #198810&#34;&gt;/library/misc/fonts/Inter/Bold.woff2&lt;/span&gt;&lt;span style=&#34;color: #198810&#34;&gt;&amp;#34;&lt;/span&gt; &lt;span style=&#34;color: #8b41b1&#34;&gt;as&lt;/span&gt;=&lt;span style=&#34;color: #198810&#34;&gt;&amp;#34;&lt;/span&gt;&lt;span style=&#34;color: #198810&#34;&gt;font&lt;/span&gt;&lt;span style=&#34;color: #198810&#34;&gt;&amp;#34;&lt;/span&gt; &lt;span style=&#34;color: #8b41b1&#34;&gt;type&lt;/span&gt;=&lt;span style=&#34;color: #198810&#34;&gt;&amp;#34;&lt;/span&gt;&lt;span style=&#34;color: #198810&#34;&gt;font/woff2&lt;/span&gt;&lt;span style=&#34;color: #198810&#34;&gt;&amp;#34;&lt;/span&gt; &lt;span style=&#34;color: #8b41b1&#34;&gt;crossorigin&lt;/span&gt;&amp;gt;
    \&amp;lt;&lt;span style=&#34;color: #4b69c6&#34;&gt;link&lt;/span&gt; &lt;span style=&#34;color: #8b41b1&#34;&gt;rel&lt;/span&gt;=&lt;span style=&#34;color: #198810&#34;&gt;&amp;#34;&lt;/span&gt;&lt;span style=&#34;color: #198810&#34;&gt;preload&lt;/span&gt;&lt;span style=&#34;color: #198810&#34;&gt;&amp;#34;&lt;/span&gt; &lt;span style=&#34;color: #8b41b1&#34;&gt;href&lt;/span&gt;=&lt;span style=&#34;color: #198810&#34;&gt;&amp;#34;&lt;/span&gt;&lt;span style=&#34;color: #198810&#34;&gt;/library/misc/fonts/Source_Serif/Regular.woff2&lt;/span&gt;&lt;span style=&#34;color: #198810&#34;&gt;&amp;#34;&lt;/span&gt; &lt;span style=&#34;color: #8b41b1&#34;&gt;as&lt;/span&gt;=&lt;span style=&#34;color: #198810&#34;&gt;&amp;#34;&lt;/span&gt;&lt;span style=&#34;color: #198810&#34;&gt;font&lt;/span&gt;&lt;span style=&#34;color: #198810&#34;&gt;&amp;#34;&lt;/span&gt; &lt;span style=&#34;color: #8b41b1&#34;&gt;type&lt;/span&gt;=&lt;span style=&#34;color: #198810&#34;&gt;&amp;#34;&lt;/span&gt;&lt;span style=&#34;color: #198810&#34;&gt;font/woff2&lt;/span&gt;&lt;span style=&#34;color: #198810&#34;&gt;&amp;#34;&lt;/span&gt; &lt;span style=&#34;color: #8b41b1&#34;&gt;crossorigin&lt;/span&gt;&amp;gt;
    \&amp;lt;&lt;span style=&#34;color: #4b69c6&#34;&gt;link&lt;/span&gt; &lt;span style=&#34;color: #8b41b1&#34;&gt;rel&lt;/span&gt;=&lt;span style=&#34;color: #198810&#34;&gt;&amp;#34;&lt;/span&gt;&lt;span style=&#34;color: #198810&#34;&gt;preload&lt;/span&gt;&lt;span style=&#34;color: #198810&#34;&gt;&amp;#34;&lt;/span&gt; &lt;span style=&#34;color: #8b41b1&#34;&gt;href&lt;/span&gt;=&lt;span style=&#34;color: #198810&#34;&gt;&amp;#34;&lt;/span&gt;&lt;span style=&#34;color: #198810&#34;&gt;/library/misc/fonts/Source_Serif/Italic.woff2&lt;/span&gt;&lt;span style=&#34;color: #198810&#34;&gt;&amp;#34;&lt;/span&gt; &lt;span style=&#34;color: #8b41b1&#34;&gt;as&lt;/span&gt;=&lt;span style=&#34;color: #198810&#34;&gt;&amp;#34;&lt;/span&gt;&lt;span style=&#34;color: #198810&#34;&gt;font&lt;/span&gt;&lt;span style=&#34;color: #198810&#34;&gt;&amp;#34;&lt;/span&gt; &lt;span style=&#34;color: #8b41b1&#34;&gt;type&lt;/span&gt;=&lt;span style=&#34;color: #198810&#34;&gt;&amp;#34;&lt;/span&gt;&lt;span style=&#34;color: #198810&#34;&gt;font/woff2&lt;/span&gt;&lt;span style=&#34;color: #198810&#34;&gt;&amp;#34;&lt;/span&gt; &lt;span style=&#34;color: #8b41b1&#34;&gt;crossorigin&lt;/span&gt;&amp;gt;&lt;/code&gt;&lt;/pre&gt;&lt;/div&gt;7:09pm on October 23, 2025 from Astrakhan, Astrakhan Oblast, Russia&lt;p&gt;&lt;a href=&#34;mailto:reply@silasjelley.com?subject=Reply%20to%3A%20%E2%80%9CPreloading%20fonts%20to%20reduce%20request%20chaining%E2%80%9D&#34;&gt;Reply via email&lt;/a&gt;&lt;/p&gt;
</content>
</entry>
<entry>
  <title>Cache all image assets in Caddy with a Cache-Control directive</title>
  <link rel="alternate" type="text/html" href="https://silasjelley.com/2025/10/23/183953" />
  <id>tag:silasjelley.com,2020-08-20:da507ef4-6d86-43fd-95f8-61028987ab05</id>
  <published>2025-10-23T18:39:53+04:00</published>
  <updated>2025-10-23T18:39:53+04:00</updated>
  <category term="notes" />
  <category term="changelogs" />
  <summary>Turns out AVIF images, which I serve to all modern browsers visiting my site, weren’t included in the cache TTL that I use for all my static assets, oops. Here’s the updated cache control header for…</summary>
<mosaic:place>Astrakhan, Astrakhan Oblast, Russia</mosaic:place>
<content type="html">
    &lt;p&gt;Turns out AVIF images, which I serve to all modern browsers visiting my site, weren’t included in the cache TTL that I use for all my static assets, oops.&lt;/p&gt;&lt;p&gt;Here’s the updated cache control header for my caddy webserver:&lt;/p&gt;&lt;div class=&#34;code-block&#34; data-lang=&#34;caddyfile&#34;&gt;&lt;div class=&#34;code-header&#34; data-mosaic-chrome=&#34;&#34;&gt;&lt;span class=&#34;code-lang&#34;&gt;caddyfile&lt;/span&gt;&lt;button class=&#34;code-copy&#34; aria-label=&#34;Copy code&#34; type=&#34;button&#34;&gt;Copy&lt;/button&gt;&lt;/div&gt;&lt;pre&gt;&lt;code data-lang=&#34;caddyfile&#34;&gt;# Cache Control
# The &amp;#39;file&amp;#39; directive ensures that cache-control is only set for files that actually exist

@static {
  file
  path *.avif *.ico *.css *.js *.gif *.jpg *.jpeg *.png *.svg *.woff *.woff2 *.gpx
}
header @static Cache-Control max-age=5184000
&lt;/code&gt;&lt;/pre&gt;&lt;/div&gt;6:39pm on October 23, 2025 from Astrakhan, Astrakhan Oblast, Russia&lt;p&gt;&lt;a href=&#34;mailto:reply@silasjelley.com?subject=Reply%20to%3A%20%E2%80%9CCache%20all%20image%20assets%20in%20Caddy%20with%20a%20Cache-Control%20directive%E2%80%9D&#34;&gt;Reply via email&lt;/a&gt;&lt;/p&gt;
</content>
</entry>
<entry>
  <title>Validating HTML with html5validator</title>
  <link rel="alternate" type="text/html" href="https://silasjelley.com/2025/10/21/230131" />
  <id>tag:silasjelley.com,2020-08-20:444e7809-f476-449e-919c-778f7bb0baee</id>
  <published>2025-10-21T23:01:31+04:00</published>
  <updated>2025-10-21T23:01:31+04:00</updated>
  <category term="notes" />
  <category term="changelogs" />
  <summary>html5validator is turning up a whole littany of validation errors. There all pretty minor, but I like for everything I emit to be well formed.</summary>
<mosaic:place>Astrakhan, Astrakhan Oblast, Russia</mosaic:place>
<content type="html">
    &lt;p&gt;html5validator is turning up a whole littany of validation errors. There all pretty minor, but I like for &lt;a href=&#34;https://en.wikipedia.org/wiki/Robustness_principle&#34;&gt;everything I emit to be well formed&lt;/a&gt;.&lt;/p&gt;&lt;div class=&#34;code-block&#34; data-lang=&#34;sh&#34;&gt;&lt;div class=&#34;code-header&#34; data-mosaic-chrome=&#34;&#34;&gt;&lt;span class=&#34;code-lang&#34;&gt;sh&lt;/span&gt;&lt;button class=&#34;code-copy&#34; aria-label=&#34;Copy code&#34; type=&#34;button&#34;&gt;Copy&lt;/button&gt;&lt;/div&gt;&lt;pre&gt;&lt;code data-lang=&#34;sh&#34;&gt;&lt;span style=&#34;color: #4b69c6&#34;&gt;uvx&lt;/span&gt; html5validator --root /tmp/silasjelley.com&lt;/code&gt;&lt;/pre&gt;&lt;/div&gt;&lt;p&gt;Non exhaustively:&lt;/p&gt;&lt;ul&gt;&lt;li&gt;&lt;p&gt;Figcaption apparently invalid in blockquotes, have replaced with the &amp;lt;cite&amp;gt; element across src/{attribution,shortcodes} (quotes), templates/{collection,default}&lt;/p&gt;&lt;/li&gt;&lt;li&gt;&lt;p&gt;Tweaked tests/html_validation.py to ignore the unnamed &amp;lt;meta charset&amp;gt; declaration as this is correct HTML5 as far as I know.&lt;/p&gt;&lt;/li&gt;&lt;li&gt;&lt;p&gt;Added alt text to tracking pixel to suppress that warning&lt;/p&gt;&lt;/li&gt;&lt;li&gt;&lt;p&gt;Now stripping the &amp;lt;p&amp;gt; and &amp;lt;/p&amp;gt; opening and closing tags from the Jotdown/Djot formatted attribution string, which I’m glad to have done anyway.&lt;/p&gt;&lt;/li&gt;&lt;li&gt;&lt;p&gt;Found and removed an erroneous/left-over trailing &amp;lt;/ul&amp;gt; tag from template/default&lt;/p&gt;&lt;/li&gt;&lt;li&gt;&lt;p&gt;Removed invalid &amp;lt;hr&amp;gt; from &amp;lt;summary&amp;gt; element in template/base&lt;/p&gt;&lt;/li&gt;&lt;li&gt;&lt;p&gt;Fixed alert template using paragraph inside a &amp;lt;span&amp;gt;&lt;/p&gt;&lt;/li&gt;&lt;li&gt;&lt;p&gt;Fixed formatting of datetime attribute on some &amp;lt;time&amp;gt; elements in templates/collection&lt;/p&gt;&lt;/li&gt;&lt;li&gt;&lt;p&gt;Fixed @aside(…) shortcodes not adding datetime to the &amp;lt;time&amp;gt; element&lt;/p&gt;&lt;/li&gt;&lt;li&gt;&lt;p&gt;Fixed an issue where my external links finder regex was being over greedy&lt;/p&gt;&lt;p&gt;The regex, &lt;code&gt;r&amp;#34;(https?://(?:[-\w.]|(?:%[\da-fA-F]{2}))+(?:/[^)\s]*)?)&amp;#34;&lt;/code&gt; would match some html elements, eg: ‘&lt;a href=&#34;https://player.vimeo.com/api/player.js&#34;&gt;https://player.vimeo.com/api/player.js&lt;/a&gt;“&amp;gt;&amp;lt;/script&amp;gt;‘ and a few other edge cases.&lt;/p&gt;&lt;p&gt;Have replaced with a more robust regex: &lt;code&gt;r&amp;#34;https?://(?:[-\w.]|(?:%[\da-fA-F]{2}))+(?:/[^\s\&amp;#34;&amp;#39;&amp;lt;&amp;gt;)]*)?(?=[\s\&amp;#34;&amp;#39;&amp;lt;&amp;gt;)]|\$)&amp;#34;&lt;/code&gt;&lt;/p&gt;&lt;p&gt;During this checking of external links via the /links.txt file in the output_dir I noticed a minor privacy leak in that external links in draft documents were leaking to the /links.txt file. Not major, but now patched.&lt;/p&gt;&lt;/li&gt;&lt;li&gt;&lt;p&gt;Fixed a sneaky HTML escaping issue in templates/collection (&lt;code&gt;{{ item.content.html|striptags|truncate(210) }}&lt;/code&gt;) where the use of striptags can, inadvertently, actually create tags, ie if item.content includes for example “&amp;lt;code&amp;gt;&amp;amp;lt;head&amp;amp;gt;&amp;lt;/code&amp;gt;”, then once the &amp;lt;code&amp;gt; tags have been stripped, a &amp;lt;head&amp;gt; reaches the final output.&lt;/p&gt;&lt;/li&gt;&lt;li&gt;&lt;p&gt;Fixed the technically invalid use of an unamed &amp;lt;meta&amp;gt; property in the &amp;lt;head&amp;gt; for pagefind’s default image (the favicon) by simply shifting it to the favicon link itself:&lt;/p&gt;&lt;p&gt;Previously: &amp;lt;meta data-pagefind-default-meta=“image[content]” content=“/favicon.png” /&amp;gt; Now: &amp;lt;link rel=“icon” type=“image/png” href=“/favicon.png” data-pagefind-default-meta=“image[href]” /&amp;gt;&lt;/p&gt;&lt;/li&gt;&lt;li&gt;&lt;p&gt;Numerous fixes in my source texts in  /notes, such as:&lt;/p&gt;&lt;ul&gt;&lt;li&gt;Having tags closing in the wrong order: &amp;lt;pre&amp;gt;&amp;lt;code&amp;gt;…&amp;lt;/pre&amp;gt;&amp;lt;/code&amp;gt;, things that browsers will tolerate fine, but not correct&lt;/li&gt;&lt;li&gt;One case of an audio tag not being closed&lt;/li&gt;&lt;li&gt;Replaced an obselete “frameborder” attribute on an iframe with border:none style&lt;/li&gt;&lt;li&gt;Cleaned up URLs where trailing ‘?ref=…’ parameters had been left on&lt;/li&gt;&lt;li&gt;Moved invalid &amp;lt;style&amp;gt; blocks inside body into inline styles&lt;/li&gt;&lt;li&gt;Replace Djot inline raw &amp;lt;details&amp;gt; elements with block raw to prevent them being wrapping in &amp;lt;p&amp;gt; tags&lt;/li&gt;&lt;/ul&gt;&lt;/li&gt;&lt;/ul&gt;11:01pm on October 21, 2025 from Astrakhan, Astrakhan Oblast, Russia&lt;p&gt;&lt;a href=&#34;mailto:reply@silasjelley.com?subject=Reply%20to%3A%20%E2%80%9CValidating%20HTML%20with%20html5validator%E2%80%9D&#34;&gt;Reply via email&lt;/a&gt;&lt;/p&gt;
</content>
</entry>
<entry>
  <title>September 25, 2025 12.09AM</title>
  <link rel="alternate" type="text/html" href="https://silasjelley.com/2025/09/25/000956" />
  <id>tag:silasjelley.com,2020-08-20:58d17e36-c7fb-47fd-8ecf-ddf4217b8367</id>
  <published>2025-09-25T00:09:56+01:00</published>
  <updated>2025-09-25T00:09:56+01:00</updated>
  <category term="notes" />
  <category term="changelogs" />
  <summary>Fixed a bug where code blocks were inadvertently being double subtracted from site.words.self (the wordcount of my own written prose), where they should only have been subtracted once.</summary>
<mosaic:place>Appledore, England, United Kingdom</mosaic:place>
<content type="html">
    &lt;p&gt;Fixed a bug where code blocks were inadvertently being double subtracted from &lt;code&gt;site.words.self&lt;/code&gt; (the wordcount of my own written prose), where they should only have been subtracted once.&lt;/p&gt;12:09am on September 25, 2025 from Appledore, England, United Kingdom&lt;p&gt;&lt;a href=&#34;mailto:reply@silasjelley.com?subject=Reply%20to%3A%20%E2%80%9CSeptember%2025%2C%202025%2012.09AM%E2%80%9D&#34;&gt;Reply via email&lt;/a&gt;&lt;/p&gt;
</content>
</entry>
<entry>
  <title>Added incremental generation of HTML output</title>
  <link rel="alternate" type="text/html" href="https://silasjelley.com/2025/09/24/034006" />
  <id>tag:silasjelley.com,2020-08-20:6f697035-19d7-46df-81c4-5466cb0cb803</id>
  <published>2025-09-24T03:40:06+01:00</published>
  <updated>2025-09-24T03:40:06+01:00</updated>
  <category term="notes" />
  <category term="changelogs" />
  <summary>Took a simple approach to speeding up rebuilds of the site that I’ve been meaning to crack on with for a while. Ripped out the old output_html function and replaced it with one that natively supports…</summary>
<mosaic:place>Appledore, South West England, United Kingdom</mosaic:place>
<content type="html">
    &lt;p&gt;Took a simple approach to speeding up rebuilds of the site that I’ve been meaning to crack on with for a while. Ripped out the old output_html function and replaced it with one that natively supports incremental builds.&lt;/p&gt;&lt;p&gt;May tweak the state that gets hashed for each document if the cache doesn’t stay as warm as it can, but initial results show lots of cache hits, with the &lt;code&gt;Generate Hypertext&lt;/code&gt; build step on a typical rebuild having been cut from around 10 seconds, to 300 milliseconds!&lt;/p&gt;&lt;p&gt;That’s more than half the total build time gone in most cases :)&lt;/p&gt;&lt;p&gt;Here’s the bulk of the code:&lt;/p&gt;&lt;div class=&#34;code-block&#34; data-lang=&#34;python&#34;&gt;&lt;div class=&#34;code-header&#34; data-mosaic-chrome=&#34;&#34;&gt;&lt;span class=&#34;code-lang&#34;&gt;python&lt;/span&gt;&lt;button class=&#34;code-copy&#34; aria-label=&#34;Copy code&#34; type=&#34;button&#34;&gt;Copy&lt;/button&gt;&lt;/div&gt;&lt;pre&gt;&lt;code data-lang=&#34;python&#34;&gt;&lt;span style=&#34;color: #d73948&#34;&gt;import&lt;/span&gt; json
&lt;span style=&#34;color: #d73948&#34;&gt;import&lt;/span&gt; logging
&lt;span style=&#34;color: #d73948&#34;&gt;from&lt;/span&gt; dataclasses &lt;span style=&#34;color: #d73948&#34;&gt;import&lt;/span&gt; asdict
&lt;span style=&#34;color: #d73948&#34;&gt;from&lt;/span&gt; hashlib &lt;span style=&#34;color: #d73948&#34;&gt;import&lt;/span&gt; md5
&lt;span style=&#34;color: #d73948&#34;&gt;from&lt;/span&gt; pathlib &lt;span style=&#34;color: #d73948&#34;&gt;import&lt;/span&gt; Path
&lt;span style=&#34;color: #d73948&#34;&gt;from&lt;/span&gt; typing &lt;span style=&#34;color: #d73948&#34;&gt;import&lt;/span&gt; Dict, Any, TYPE_CHECKING

&lt;span style=&#34;color: #74747c&#34;&gt;#&lt;/span&gt;&lt;span style=&#34;color: #74747c&#34;&gt; Import types only for type hints, avoiding circular imports&lt;/span&gt;
&lt;span style=&#34;color: #d73948&#34;&gt;if&lt;/span&gt; TYPE_CHECKING:
    &lt;span style=&#34;color: #d73948&#34;&gt;from&lt;/span&gt; jinja2 &lt;span style=&#34;color: #d73948&#34;&gt;import&lt;/span&gt; Environment
    &lt;span style=&#34;color: #d73948&#34;&gt;from&lt;/span&gt; build &lt;span style=&#34;color: #d73948&#34;&gt;import&lt;/span&gt; DocumentMetadata, AssetMetadata, SiteMetadata

logger &lt;span style=&#34;color: #d73948&#34;&gt;=&lt;/span&gt; logging.&lt;span style=&#34;color: #4b69c6&#34;&gt;getLogger&lt;/span&gt;(&lt;span style=&#34;color: #4b69c6&#34;&gt;__name__&lt;/span&gt;)


&lt;span style=&#34;color: #d73948&#34;&gt;def&lt;/span&gt; &lt;span style=&#34;color: #4b69c6&#34;&gt;calculate_content_hash&lt;/span&gt;(
    page: &lt;span style=&#34;color: #198810&#34;&gt;&amp;#34;&lt;/span&gt;&lt;span style=&#34;color: #198810&#34;&gt;DocumentMetadata&lt;/span&gt;&lt;span style=&#34;color: #198810&#34;&gt;&amp;#34;&lt;/span&gt;, collections: Dict, site: &lt;span style=&#34;color: #198810&#34;&gt;&amp;#34;&lt;/span&gt;&lt;span style=&#34;color: #198810&#34;&gt;SiteMetadata&lt;/span&gt;&lt;span style=&#34;color: #198810&#34;&gt;&amp;#34;&lt;/span&gt;
) -&amp;gt; &lt;span style=&#34;color: #4b69c6&#34;&gt;str&lt;/span&gt;:
    &lt;span style=&#34;color: #74747c&#34;&gt;&amp;#34;&amp;#34;&amp;#34;&lt;/span&gt;&lt;span style=&#34;color: #74747c&#34;&gt;Calculate a hash representing all content that could affect this page&amp;#39;s output.&lt;/span&gt;&lt;span style=&#34;color: #74747c&#34;&gt;&amp;#34;&amp;#34;&amp;#34;&lt;/span&gt;
    &lt;span style=&#34;color: #74747c&#34;&gt;#&lt;/span&gt;&lt;span style=&#34;color: #74747c&#34;&gt; Convert page data to string, excluding volatile fields like backlinks&lt;/span&gt;
    page_dict &lt;span style=&#34;color: #d73948&#34;&gt;=&lt;/span&gt; &lt;span style=&#34;color: #4b69c6&#34;&gt;asdict&lt;/span&gt;(page)

    &lt;span style=&#34;color: #74747c&#34;&gt;#&lt;/span&gt;&lt;span style=&#34;color: #74747c&#34;&gt; Remove volatile fields that change frequently but don&amp;#39;t affect content&lt;/span&gt;
    volatile_fields &lt;span style=&#34;color: #d73948&#34;&gt;=&lt;/span&gt; [&lt;span style=&#34;color: #198810&#34;&gt;&amp;#34;&lt;/span&gt;&lt;span style=&#34;color: #198810&#34;&gt;links&lt;/span&gt;&lt;span style=&#34;color: #198810&#34;&gt;&amp;#34;&lt;/span&gt;]  &lt;span style=&#34;color: #74747c&#34;&gt;#&lt;/span&gt;&lt;span style=&#34;color: #74747c&#34;&gt; Remove if backlinks change shouldn&amp;#39;t trigger rebuild&lt;/span&gt;
    &lt;span style=&#34;color: #d73948&#34;&gt;for&lt;/span&gt; field &lt;span style=&#34;color: #d73948&#34;&gt;in&lt;/span&gt; volatile_fields:
        page_dict.&lt;span style=&#34;color: #4b69c6&#34;&gt;pop&lt;/span&gt;(field, &lt;span style=&#34;color: #d73948&#34;&gt;None&lt;/span&gt;)

    &lt;span style=&#34;color: #74747c&#34;&gt;#&lt;/span&gt;&lt;span style=&#34;color: #74747c&#34;&gt; Include relevant collection data (for pages that use collections)&lt;/span&gt;
    collection_data &lt;span style=&#34;color: #d73948&#34;&gt;=&lt;/span&gt; &lt;span style=&#34;color: #198810&#34;&gt;&amp;#34;&lt;/span&gt;&lt;span style=&#34;color: #198810&#34;&gt;&amp;#34;&lt;/span&gt;
    &lt;span style=&#34;color: #d73948&#34;&gt;if&lt;/span&gt; page.collection.&lt;span style=&#34;color: #4b69c6&#34;&gt;get&lt;/span&gt;(&lt;span style=&#34;color: #198810&#34;&gt;&amp;#34;&lt;/span&gt;&lt;span style=&#34;color: #198810&#34;&gt;include&lt;/span&gt;&lt;span style=&#34;color: #198810&#34;&gt;&amp;#34;&lt;/span&gt;):
        &lt;span style=&#34;color: #d73948&#34;&gt;for&lt;/span&gt; include &lt;span style=&#34;color: #d73948&#34;&gt;in&lt;/span&gt; page.collection[&lt;span style=&#34;color: #198810&#34;&gt;&amp;#34;&lt;/span&gt;&lt;span style=&#34;color: #198810&#34;&gt;include&lt;/span&gt;&lt;span style=&#34;color: #198810&#34;&gt;&amp;#34;&lt;/span&gt;]:
            &lt;span style=&#34;color: #d73948&#34;&gt;if&lt;/span&gt; include &lt;span style=&#34;color: #d73948&#34;&gt;in&lt;/span&gt; collections:
                &lt;span style=&#34;color: #74747c&#34;&gt;#&lt;/span&gt;&lt;span style=&#34;color: #74747c&#34;&gt; Hash just the UIDs and titles of collection items to detect changes&lt;/span&gt;
                collection_items &lt;span style=&#34;color: #d73948&#34;&gt;=&lt;/span&gt; [
                    (item.uid, item.title, item.updated.&lt;span style=&#34;color: #4b69c6&#34;&gt;isoformat&lt;/span&gt;())
                    &lt;span style=&#34;color: #d73948&#34;&gt;for&lt;/span&gt; item &lt;span style=&#34;color: #d73948&#34;&gt;in&lt;/span&gt; collections[include][:&lt;span style=&#34;color: #b60157&#34;&gt;20&lt;/span&gt;]
                ]  &lt;span style=&#34;color: #74747c&#34;&gt;#&lt;/span&gt;&lt;span style=&#34;color: #74747c&#34;&gt; Limit to avoid huge hashes&lt;/span&gt;
                collection_data &lt;span style=&#34;color: #d73948&#34;&gt;+=&lt;/span&gt; &lt;span style=&#34;color: #4b69c6&#34;&gt;str&lt;/span&gt;(collection_items)

    &lt;span style=&#34;color: #74747c&#34;&gt;#&lt;/span&gt;&lt;span style=&#34;color: #74747c&#34;&gt; Include site metadata that might affect rendering&lt;/span&gt;
    site_data &lt;span style=&#34;color: #d73948&#34;&gt;=&lt;/span&gt; {
        &lt;span style=&#34;color: #198810&#34;&gt;&amp;#34;&lt;/span&gt;&lt;span style=&#34;color: #198810&#34;&gt;stylesheet_hash&lt;/span&gt;&lt;span style=&#34;color: #198810&#34;&gt;&amp;#34;&lt;/span&gt;: site.stylesheet_hash,
        &lt;span style=&#34;color: #198810&#34;&gt;&amp;#34;&lt;/span&gt;&lt;span style=&#34;color: #198810&#34;&gt;name&lt;/span&gt;&lt;span style=&#34;color: #198810&#34;&gt;&amp;#34;&lt;/span&gt;: site.name,
        &lt;span style=&#34;color: #198810&#34;&gt;&amp;#34;&lt;/span&gt;&lt;span style=&#34;color: #198810&#34;&gt;url&lt;/span&gt;&lt;span style=&#34;color: #198810&#34;&gt;&amp;#34;&lt;/span&gt;: site.url,
        &lt;span style=&#34;color: #198810&#34;&gt;&amp;#34;&lt;/span&gt;&lt;span style=&#34;color: #198810&#34;&gt;baseurl&lt;/span&gt;&lt;span style=&#34;color: #198810&#34;&gt;&amp;#34;&lt;/span&gt;: site.baseurl,
    }

    &lt;span style=&#34;color: #74747c&#34;&gt;#&lt;/span&gt;&lt;span style=&#34;color: #74747c&#34;&gt; Combine all data and hash&lt;/span&gt;
    combined_data &lt;span style=&#34;color: #d73948&#34;&gt;=&lt;/span&gt; json.&lt;span style=&#34;color: #4b69c6&#34;&gt;dumps&lt;/span&gt;(
        [page_dict, collection_data, site_data], sort_keys&lt;span style=&#34;color: #d73948&#34;&gt;=&lt;/span&gt;&lt;span style=&#34;color: #d73948&#34;&gt;True&lt;/span&gt;, default&lt;span style=&#34;color: #d73948&#34;&gt;=&lt;/span&gt;&lt;span style=&#34;color: #4b69c6&#34;&gt;str&lt;/span&gt;
    )
    &lt;span style=&#34;color: #d73948&#34;&gt;return&lt;/span&gt; &lt;span style=&#34;color: #4b69c6&#34;&gt;md5&lt;/span&gt;(combined_data.&lt;span style=&#34;color: #4b69c6&#34;&gt;encode&lt;/span&gt;()).&lt;span style=&#34;color: #4b69c6&#34;&gt;hexdigest&lt;/span&gt;()


&lt;span style=&#34;color: #d73948&#34;&gt;def&lt;/span&gt; &lt;span style=&#34;color: #4b69c6&#34;&gt;load_build_cache&lt;/span&gt;(output_dir: Path) -&amp;gt; Dict[&lt;span style=&#34;color: #4b69c6&#34;&gt;str&lt;/span&gt;, Dict[&lt;span style=&#34;color: #4b69c6&#34;&gt;str&lt;/span&gt;, Any]]:
    &lt;span style=&#34;color: #74747c&#34;&gt;&amp;#34;&amp;#34;&amp;#34;&lt;/span&gt;&lt;span style=&#34;color: #74747c&#34;&gt;Load the build cache from previous run.&lt;/span&gt;&lt;span style=&#34;color: #74747c&#34;&gt;&amp;#34;&amp;#34;&amp;#34;&lt;/span&gt;
    cache_file &lt;span style=&#34;color: #d73948&#34;&gt;=&lt;/span&gt; output_dir &lt;span style=&#34;color: #d73948&#34;&gt;/&lt;/span&gt; &lt;span style=&#34;color: #198810&#34;&gt;&amp;#34;&lt;/span&gt;&lt;span style=&#34;color: #198810&#34;&gt;.build_cache.json&lt;/span&gt;&lt;span style=&#34;color: #198810&#34;&gt;&amp;#34;&lt;/span&gt;
    &lt;span style=&#34;color: #d73948&#34;&gt;if&lt;/span&gt; cache_file.&lt;span style=&#34;color: #4b69c6&#34;&gt;exists&lt;/span&gt;():
        &lt;span style=&#34;color: #d73948&#34;&gt;try&lt;/span&gt;:
            &lt;span style=&#34;color: #d73948&#34;&gt;with&lt;/span&gt; &lt;span style=&#34;color: #4b69c6&#34;&gt;open&lt;/span&gt;(cache_file, &lt;span style=&#34;color: #198810&#34;&gt;&amp;#34;&lt;/span&gt;&lt;span style=&#34;color: #198810&#34;&gt;r&lt;/span&gt;&lt;span style=&#34;color: #198810&#34;&gt;&amp;#34;&lt;/span&gt;) &lt;span style=&#34;color: #d73948&#34;&gt;as&lt;/span&gt; f:
                &lt;span style=&#34;color: #d73948&#34;&gt;return&lt;/span&gt; json.&lt;span style=&#34;color: #4b69c6&#34;&gt;load&lt;/span&gt;(f)
        &lt;span style=&#34;color: #d73948&#34;&gt;except&lt;/span&gt; (json.JSONDecodeError, &lt;span style=&#34;color: #4b69c6&#34;&gt;IOError&lt;/span&gt;):
            logger.&lt;span style=&#34;color: #4b69c6&#34;&gt;warning&lt;/span&gt;(&lt;span style=&#34;color: #198810&#34;&gt;&amp;#34;&lt;/span&gt;&lt;span style=&#34;color: #198810&#34;&gt;Could not load build cache, rebuilding all files&lt;/span&gt;&lt;span style=&#34;color: #198810&#34;&gt;&amp;#34;&lt;/span&gt;)
    &lt;span style=&#34;color: #d73948&#34;&gt;return&lt;/span&gt; {}


&lt;span style=&#34;color: #d73948&#34;&gt;def&lt;/span&gt; &lt;span style=&#34;color: #4b69c6&#34;&gt;save_build_cache&lt;/span&gt;(cache: Dict[&lt;span style=&#34;color: #4b69c6&#34;&gt;str&lt;/span&gt;, Dict[&lt;span style=&#34;color: #4b69c6&#34;&gt;str&lt;/span&gt;, Any]], output_dir: Path):
    &lt;span style=&#34;color: #74747c&#34;&gt;&amp;#34;&amp;#34;&amp;#34;&lt;/span&gt;&lt;span style=&#34;color: #74747c&#34;&gt;Save the build cache for next run.&lt;/span&gt;&lt;span style=&#34;color: #74747c&#34;&gt;&amp;#34;&amp;#34;&amp;#34;&lt;/span&gt;
    cache_file &lt;span style=&#34;color: #d73948&#34;&gt;=&lt;/span&gt; output_dir &lt;span style=&#34;color: #d73948&#34;&gt;/&lt;/span&gt; &lt;span style=&#34;color: #198810&#34;&gt;&amp;#34;&lt;/span&gt;&lt;span style=&#34;color: #198810&#34;&gt;.build_cache.json&lt;/span&gt;&lt;span style=&#34;color: #198810&#34;&gt;&amp;#34;&lt;/span&gt;
    &lt;span style=&#34;color: #d73948&#34;&gt;try&lt;/span&gt;:
        &lt;span style=&#34;color: #d73948&#34;&gt;with&lt;/span&gt; &lt;span style=&#34;color: #4b69c6&#34;&gt;open&lt;/span&gt;(cache_file, &lt;span style=&#34;color: #198810&#34;&gt;&amp;#34;&lt;/span&gt;&lt;span style=&#34;color: #198810&#34;&gt;w&lt;/span&gt;&lt;span style=&#34;color: #198810&#34;&gt;&amp;#34;&lt;/span&gt;) &lt;span style=&#34;color: #d73948&#34;&gt;as&lt;/span&gt; f:
            json.&lt;span style=&#34;color: #4b69c6&#34;&gt;dump&lt;/span&gt;(cache, f)
    &lt;span style=&#34;color: #d73948&#34;&gt;except&lt;/span&gt; &lt;span style=&#34;color: #4b69c6&#34;&gt;IOError&lt;/span&gt; &lt;span style=&#34;color: #d73948&#34;&gt;as&lt;/span&gt; e:
        logger.&lt;span style=&#34;color: #4b69c6&#34;&gt;warning&lt;/span&gt;(&lt;span style=&#34;color: #d73948&#34;&gt;f&lt;/span&gt;&lt;span style=&#34;color: #198810&#34;&gt;&amp;#34;&lt;/span&gt;&lt;span style=&#34;color: #198810&#34;&gt;Could not save build cache: &lt;/span&gt;&lt;span style=&#34;color: #8b41b1&#34;&gt;{&lt;/span&gt;&lt;span style=&#34;color: #8b41b1&#34;&gt;e&lt;/span&gt;&lt;span style=&#34;color: #8b41b1&#34;&gt;}&lt;/span&gt;&lt;span style=&#34;color: #198810&#34;&gt;&amp;#34;&lt;/span&gt;)


&lt;span style=&#34;color: #d73948&#34;&gt;def&lt;/span&gt; &lt;span style=&#34;color: #4b69c6&#34;&gt;needs_rebuild&lt;/span&gt;(
    page: &lt;span style=&#34;color: #198810&#34;&gt;&amp;#34;&lt;/span&gt;&lt;span style=&#34;color: #198810&#34;&gt;DocumentMetadata&lt;/span&gt;&lt;span style=&#34;color: #198810&#34;&gt;&amp;#34;&lt;/span&gt;,
    collections: Dict,
    site: &lt;span style=&#34;color: #198810&#34;&gt;&amp;#34;&lt;/span&gt;&lt;span style=&#34;color: #198810&#34;&gt;SiteMetadata&lt;/span&gt;&lt;span style=&#34;color: #198810&#34;&gt;&amp;#34;&lt;/span&gt;,
    output_path: Path,
    cache: Dict[&lt;span style=&#34;color: #4b69c6&#34;&gt;str&lt;/span&gt;, Dict[&lt;span style=&#34;color: #4b69c6&#34;&gt;str&lt;/span&gt;, Any]],
    template_file: &lt;span style=&#34;color: #4b69c6&#34;&gt;str&lt;/span&gt;,
    env: &lt;span style=&#34;color: #198810&#34;&gt;&amp;#34;&lt;/span&gt;&lt;span style=&#34;color: #198810&#34;&gt;Environment&lt;/span&gt;&lt;span style=&#34;color: #198810&#34;&gt;&amp;#34;&lt;/span&gt;,
) -&amp;gt; &lt;span style=&#34;color: #4b69c6&#34;&gt;bool&lt;/span&gt;:
    &lt;span style=&#34;color: #74747c&#34;&gt;&amp;#34;&amp;#34;&amp;#34;&lt;/span&gt;&lt;span style=&#34;color: #74747c&#34;&gt;Determine if a page needs to be rebuilt.&lt;/span&gt;&lt;span style=&#34;color: #74747c&#34;&gt;&amp;#34;&amp;#34;&amp;#34;&lt;/span&gt;

    &lt;span style=&#34;color: #74747c&#34;&gt;#&lt;/span&gt;&lt;span style=&#34;color: #74747c&#34;&gt; Always rebuild if output doesn&amp;#39;t exist&lt;/span&gt;
    &lt;span style=&#34;color: #d73948&#34;&gt;if&lt;/span&gt; &lt;span style=&#34;color: #d73948&#34;&gt;not&lt;/span&gt; output_path.&lt;span style=&#34;color: #4b69c6&#34;&gt;exists&lt;/span&gt;():
        &lt;span style=&#34;color: #d73948&#34;&gt;return&lt;/span&gt; &lt;span style=&#34;color: #d73948&#34;&gt;True&lt;/span&gt;

    page_key &lt;span style=&#34;color: #d73948&#34;&gt;=&lt;/span&gt; page.uid
    current_hash &lt;span style=&#34;color: #d73948&#34;&gt;=&lt;/span&gt; &lt;span style=&#34;color: #4b69c6&#34;&gt;calculate_content_hash&lt;/span&gt;(page, collections, site)

    &lt;span style=&#34;color: #d73948&#34;&gt;if&lt;/span&gt; page_key &lt;span style=&#34;color: #d73948&#34;&gt;not&lt;/span&gt; &lt;span style=&#34;color: #d73948&#34;&gt;in&lt;/span&gt; cache:
        &lt;span style=&#34;color: #d73948&#34;&gt;return&lt;/span&gt; &lt;span style=&#34;color: #d73948&#34;&gt;True&lt;/span&gt;

    cached_data &lt;span style=&#34;color: #d73948&#34;&gt;=&lt;/span&gt; cache[page_key]

    &lt;span style=&#34;color: #d73948&#34;&gt;if&lt;/span&gt; cached_data.&lt;span style=&#34;color: #4b69c6&#34;&gt;get&lt;/span&gt;(&lt;span style=&#34;color: #198810&#34;&gt;&amp;#34;&lt;/span&gt;&lt;span style=&#34;color: #198810&#34;&gt;content_hash&lt;/span&gt;&lt;span style=&#34;color: #198810&#34;&gt;&amp;#34;&lt;/span&gt;) &lt;span style=&#34;color: #d73948&#34;&gt;!=&lt;/span&gt; current_hash:
        &lt;span style=&#34;color: #d73948&#34;&gt;return&lt;/span&gt; &lt;span style=&#34;color: #d73948&#34;&gt;True&lt;/span&gt;

    &lt;span style=&#34;color: #74747c&#34;&gt;#&lt;/span&gt;&lt;span style=&#34;color: #74747c&#34;&gt; Check template modification time&lt;/span&gt;
    &lt;span style=&#34;color: #d73948&#34;&gt;try&lt;/span&gt;:
        template_path &lt;span style=&#34;color: #d73948&#34;&gt;=&lt;/span&gt; env.loader.&lt;span style=&#34;color: #4b69c6&#34;&gt;get_source&lt;/span&gt;(env, template_file)[&lt;span style=&#34;color: #b60157&#34;&gt;1&lt;/span&gt;]
        &lt;span style=&#34;color: #d73948&#34;&gt;if&lt;/span&gt; template_path:
            template_mtime &lt;span style=&#34;color: #d73948&#34;&gt;=&lt;/span&gt; &lt;span style=&#34;color: #4b69c6&#34;&gt;Path&lt;/span&gt;(template_path).&lt;span style=&#34;color: #4b69c6&#34;&gt;stat&lt;/span&gt;().st_mtime
            &lt;span style=&#34;color: #d73948&#34;&gt;if&lt;/span&gt; cached_data.&lt;span style=&#34;color: #4b69c6&#34;&gt;get&lt;/span&gt;(&lt;span style=&#34;color: #198810&#34;&gt;&amp;#34;&lt;/span&gt;&lt;span style=&#34;color: #198810&#34;&gt;template_mtime&lt;/span&gt;&lt;span style=&#34;color: #198810&#34;&gt;&amp;#34;&lt;/span&gt;, &lt;span style=&#34;color: #b60157&#34;&gt;0&lt;/span&gt;) &lt;span style=&#34;color: #d73948&#34;&gt;&amp;lt;&lt;/span&gt; template_mtime:
                &lt;span style=&#34;color: #d73948&#34;&gt;return&lt;/span&gt; &lt;span style=&#34;color: #d73948&#34;&gt;True&lt;/span&gt;
    &lt;span style=&#34;color: #d73948&#34;&gt;except&lt;/span&gt; &lt;span style=&#34;color: #4b69c6&#34;&gt;Exception&lt;/span&gt;:
        &lt;span style=&#34;color: #74747c&#34;&gt;#&lt;/span&gt;&lt;span style=&#34;color: #74747c&#34;&gt; If we can&amp;#39;t check template mtime, rebuild to be safe&lt;/span&gt;
        &lt;span style=&#34;color: #d73948&#34;&gt;return&lt;/span&gt; &lt;span style=&#34;color: #d73948&#34;&gt;True&lt;/span&gt;

    &lt;span style=&#34;color: #74747c&#34;&gt;#&lt;/span&gt;&lt;span style=&#34;color: #74747c&#34;&gt; Check source file modification time&lt;/span&gt;
    source_mtime &lt;span style=&#34;color: #d73948&#34;&gt;=&lt;/span&gt; page.filepath.&lt;span style=&#34;color: #4b69c6&#34;&gt;stat&lt;/span&gt;().st_mtime
    &lt;span style=&#34;color: #d73948&#34;&gt;if&lt;/span&gt; cached_data.&lt;span style=&#34;color: #4b69c6&#34;&gt;get&lt;/span&gt;(&lt;span style=&#34;color: #198810&#34;&gt;&amp;#34;&lt;/span&gt;&lt;span style=&#34;color: #198810&#34;&gt;source_mtime&lt;/span&gt;&lt;span style=&#34;color: #198810&#34;&gt;&amp;#34;&lt;/span&gt;, &lt;span style=&#34;color: #b60157&#34;&gt;0&lt;/span&gt;) &lt;span style=&#34;color: #d73948&#34;&gt;&amp;lt;&lt;/span&gt; source_mtime:
        &lt;span style=&#34;color: #d73948&#34;&gt;return&lt;/span&gt; &lt;span style=&#34;color: #d73948&#34;&gt;True&lt;/span&gt;

    &lt;span style=&#34;color: #d73948&#34;&gt;return&lt;/span&gt; &lt;span style=&#34;color: #d73948&#34;&gt;False&lt;/span&gt;


&lt;span style=&#34;color: #d73948&#34;&gt;def&lt;/span&gt; &lt;span style=&#34;color: #4b69c6&#34;&gt;output_html_incremental&lt;/span&gt;(
    assets: Dict[&lt;span style=&#34;color: #4b69c6&#34;&gt;str&lt;/span&gt;, &lt;span style=&#34;color: #198810&#34;&gt;&amp;#34;&lt;/span&gt;&lt;span style=&#34;color: #198810&#34;&gt;AssetMetadata&lt;/span&gt;&lt;span style=&#34;color: #198810&#34;&gt;&amp;#34;&lt;/span&gt;],
    documents: Dict[&lt;span style=&#34;color: #4b69c6&#34;&gt;str&lt;/span&gt;, &lt;span style=&#34;color: #198810&#34;&gt;&amp;#34;&lt;/span&gt;&lt;span style=&#34;color: #198810&#34;&gt;DocumentMetadata&lt;/span&gt;&lt;span style=&#34;color: #198810&#34;&gt;&amp;#34;&lt;/span&gt;],
    collections: Dict[&lt;span style=&#34;color: #4b69c6&#34;&gt;str&lt;/span&gt;, Any],
    site: &lt;span style=&#34;color: #198810&#34;&gt;&amp;#34;&lt;/span&gt;&lt;span style=&#34;color: #198810&#34;&gt;SiteMetadata&lt;/span&gt;&lt;span style=&#34;color: #198810&#34;&gt;&amp;#34;&lt;/span&gt;,
    env: &lt;span style=&#34;color: #198810&#34;&gt;&amp;#34;&lt;/span&gt;&lt;span style=&#34;color: #198810&#34;&gt;Environment&lt;/span&gt;&lt;span style=&#34;color: #198810&#34;&gt;&amp;#34;&lt;/span&gt;,
    output_dir: Path,
    build_page_collection_func,  &lt;span style=&#34;color: #74747c&#34;&gt;#&lt;/span&gt;&lt;span style=&#34;color: #74747c&#34;&gt; Function to build page collections&lt;/span&gt;
) -&amp;gt; &lt;span style=&#34;color: #d73948&#34;&gt;None&lt;/span&gt;:
    logger.&lt;span style=&#34;color: #4b69c6&#34;&gt;info&lt;/span&gt;(&lt;span style=&#34;color: #198810&#34;&gt;&amp;#34;&lt;/span&gt;&lt;span style=&#34;color: #198810&#34;&gt;Generating Hypertext (incremental)&lt;/span&gt;&lt;span style=&#34;color: #198810&#34;&gt;&amp;#34;&lt;/span&gt;)

    &lt;span style=&#34;color: #74747c&#34;&gt;#&lt;/span&gt;&lt;span style=&#34;color: #74747c&#34;&gt; Load build cache&lt;/span&gt;
    cache &lt;span style=&#34;color: #d73948&#34;&gt;=&lt;/span&gt; &lt;span style=&#34;color: #4b69c6&#34;&gt;load_build_cache&lt;/span&gt;(output_dir)
    new_cache &lt;span style=&#34;color: #d73948&#34;&gt;=&lt;/span&gt; {}

    built_count &lt;span style=&#34;color: #d73948&#34;&gt;=&lt;/span&gt; &lt;span style=&#34;color: #b60157&#34;&gt;0&lt;/span&gt;
    skipped_count &lt;span style=&#34;color: #d73948&#34;&gt;=&lt;/span&gt; &lt;span style=&#34;color: #b60157&#34;&gt;0&lt;/span&gt;

    &lt;span style=&#34;color: #d73948&#34;&gt;for&lt;/span&gt; key, page &lt;span style=&#34;color: #d73948&#34;&gt;in&lt;/span&gt; documents.&lt;span style=&#34;color: #4b69c6&#34;&gt;items&lt;/span&gt;():
        template_file &lt;span style=&#34;color: #d73948&#34;&gt;=&lt;/span&gt; page.layout
        output_path &lt;span style=&#34;color: #d73948&#34;&gt;=&lt;/span&gt; output_dir &lt;span style=&#34;color: #d73948&#34;&gt;/&lt;/span&gt; page.slug &lt;span style=&#34;color: #d73948&#34;&gt;/&lt;/span&gt; &lt;span style=&#34;color: #198810&#34;&gt;&amp;#34;&lt;/span&gt;&lt;span style=&#34;color: #198810&#34;&gt;index.html&lt;/span&gt;&lt;span style=&#34;color: #198810&#34;&gt;&amp;#34;&lt;/span&gt;

        &lt;span style=&#34;color: #74747c&#34;&gt;#&lt;/span&gt;&lt;span style=&#34;color: #74747c&#34;&gt; Check if rebuild is needed&lt;/span&gt;
        &lt;span style=&#34;color: #d73948&#34;&gt;if&lt;/span&gt; &lt;span style=&#34;color: #d73948&#34;&gt;not&lt;/span&gt; &lt;span style=&#34;color: #4b69c6&#34;&gt;needs_rebuild&lt;/span&gt;(
            page, collections, site, output_path, cache, template_file, env
        ):
            &lt;span style=&#34;color: #74747c&#34;&gt;#&lt;/span&gt;&lt;span style=&#34;color: #74747c&#34;&gt; Copy cache entry to new cache&lt;/span&gt;
            new_cache[key] &lt;span style=&#34;color: #d73948&#34;&gt;=&lt;/span&gt; cache[key]
            skipped_count &lt;span style=&#34;color: #d73948&#34;&gt;+=&lt;/span&gt; &lt;span style=&#34;color: #b60157&#34;&gt;1&lt;/span&gt;
            logger.&lt;span style=&#34;color: #4b69c6&#34;&gt;debug&lt;/span&gt;(&lt;span style=&#34;color: #d73948&#34;&gt;f&lt;/span&gt;&lt;span style=&#34;color: #198810&#34;&gt;&amp;#34;&lt;/span&gt;&lt;span style=&#34;color: #198810&#34;&gt;  SKIP: &lt;/span&gt;&lt;span style=&#34;color: #8b41b1&#34;&gt;{&lt;/span&gt;&lt;span style=&#34;color: #8b41b1&#34;&gt;page&lt;/span&gt;&lt;span style=&#34;color: #8b41b1&#34;&gt;.&lt;/span&gt;&lt;span style=&#34;color: #8b41b1&#34;&gt;filepath&lt;/span&gt;&lt;span style=&#34;color: #8b41b1&#34;&gt;}&lt;/span&gt;&lt;span style=&#34;color: #198810&#34;&gt;&amp;#34;&lt;/span&gt;)
            &lt;span style=&#34;color: #d73948&#34;&gt;continue&lt;/span&gt;

        &lt;span style=&#34;color: #74747c&#34;&gt;#&lt;/span&gt;&lt;span style=&#34;color: #74747c&#34;&gt; Rebuild the page&lt;/span&gt;
        template &lt;span style=&#34;color: #d73948&#34;&gt;=&lt;/span&gt; env.&lt;span style=&#34;color: #4b69c6&#34;&gt;get_template&lt;/span&gt;(template_file)
        collection &lt;span style=&#34;color: #d73948&#34;&gt;=&lt;/span&gt; &lt;span style=&#34;color: #4b69c6&#34;&gt;build_page_collection_func&lt;/span&gt;(page, collections)

        output &lt;span style=&#34;color: #d73948&#34;&gt;=&lt;/span&gt; template.&lt;span style=&#34;color: #4b69c6&#34;&gt;render&lt;/span&gt;(
            documents&lt;span style=&#34;color: #d73948&#34;&gt;=&lt;/span&gt;documents,
            assets&lt;span style=&#34;color: #d73948&#34;&gt;=&lt;/span&gt;assets,
            collections&lt;span style=&#34;color: #d73948&#34;&gt;=&lt;/span&gt;collections,
            collection&lt;span style=&#34;color: #d73948&#34;&gt;=&lt;/span&gt;collection,
            page&lt;span style=&#34;color: #d73948&#34;&gt;=&lt;/span&gt;&lt;span style=&#34;color: #4b69c6&#34;&gt;asdict&lt;/span&gt;(page),
            site&lt;span style=&#34;color: #d73948&#34;&gt;=&lt;/span&gt;site,
        )

        &lt;span style=&#34;color: #74747c&#34;&gt;#&lt;/span&gt;&lt;span style=&#34;color: #74747c&#34;&gt; Ensure output directory exists&lt;/span&gt;
        output_path.parent.&lt;span style=&#34;color: #4b69c6&#34;&gt;mkdir&lt;/span&gt;(parents&lt;span style=&#34;color: #d73948&#34;&gt;=&lt;/span&gt;&lt;span style=&#34;color: #d73948&#34;&gt;True&lt;/span&gt;, exist_ok&lt;span style=&#34;color: #d73948&#34;&gt;=&lt;/span&gt;&lt;span style=&#34;color: #d73948&#34;&gt;True&lt;/span&gt;)

        &lt;span style=&#34;color: #74747c&#34;&gt;#&lt;/span&gt;&lt;span style=&#34;color: #74747c&#34;&gt; Write the file&lt;/span&gt;
        &lt;span style=&#34;color: #d73948&#34;&gt;with&lt;/span&gt; &lt;span style=&#34;color: #4b69c6&#34;&gt;open&lt;/span&gt;(output_path, &lt;span style=&#34;color: #198810&#34;&gt;&amp;#34;&lt;/span&gt;&lt;span style=&#34;color: #198810&#34;&gt;w&lt;/span&gt;&lt;span style=&#34;color: #198810&#34;&gt;&amp;#34;&lt;/span&gt;) &lt;span style=&#34;color: #d73948&#34;&gt;as&lt;/span&gt; f:
            f.&lt;span style=&#34;color: #4b69c6&#34;&gt;write&lt;/span&gt;(output)

        &lt;span style=&#34;color: #74747c&#34;&gt;#&lt;/span&gt;&lt;span style=&#34;color: #74747c&#34;&gt; Update cache&lt;/span&gt;
        current_hash &lt;span style=&#34;color: #d73948&#34;&gt;=&lt;/span&gt; &lt;span style=&#34;color: #4b69c6&#34;&gt;calculate_content_hash&lt;/span&gt;(page, collections, site)
        template_mtime &lt;span style=&#34;color: #d73948&#34;&gt;=&lt;/span&gt; &lt;span style=&#34;color: #b60157&#34;&gt;0&lt;/span&gt;
        &lt;span style=&#34;color: #d73948&#34;&gt;try&lt;/span&gt;:
            template_path &lt;span style=&#34;color: #d73948&#34;&gt;=&lt;/span&gt; env.loader.&lt;span style=&#34;color: #4b69c6&#34;&gt;get_source&lt;/span&gt;(env, template_file)[&lt;span style=&#34;color: #b60157&#34;&gt;1&lt;/span&gt;]
            &lt;span style=&#34;color: #d73948&#34;&gt;if&lt;/span&gt; template_path:
                template_mtime &lt;span style=&#34;color: #d73948&#34;&gt;=&lt;/span&gt; &lt;span style=&#34;color: #4b69c6&#34;&gt;Path&lt;/span&gt;(template_path).&lt;span style=&#34;color: #4b69c6&#34;&gt;stat&lt;/span&gt;().st_mtime
        &lt;span style=&#34;color: #d73948&#34;&gt;except&lt;/span&gt; &lt;span style=&#34;color: #4b69c6&#34;&gt;Exception&lt;/span&gt;:
            &lt;span style=&#34;color: #d73948&#34;&gt;pass&lt;/span&gt;

        new_cache[key] &lt;span style=&#34;color: #d73948&#34;&gt;=&lt;/span&gt; {
            &lt;span style=&#34;color: #198810&#34;&gt;&amp;#34;&lt;/span&gt;&lt;span style=&#34;color: #198810&#34;&gt;content_hash&lt;/span&gt;&lt;span style=&#34;color: #198810&#34;&gt;&amp;#34;&lt;/span&gt;: current_hash,
            &lt;span style=&#34;color: #198810&#34;&gt;&amp;#34;&lt;/span&gt;&lt;span style=&#34;color: #198810&#34;&gt;template_mtime&lt;/span&gt;&lt;span style=&#34;color: #198810&#34;&gt;&amp;#34;&lt;/span&gt;: template_mtime,
            &lt;span style=&#34;color: #198810&#34;&gt;&amp;#34;&lt;/span&gt;&lt;span style=&#34;color: #198810&#34;&gt;source_mtime&lt;/span&gt;&lt;span style=&#34;color: #198810&#34;&gt;&amp;#34;&lt;/span&gt;: page.filepath.&lt;span style=&#34;color: #4b69c6&#34;&gt;stat&lt;/span&gt;().st_mtime,
            &lt;span style=&#34;color: #198810&#34;&gt;&amp;#34;&lt;/span&gt;&lt;span style=&#34;color: #198810&#34;&gt;output_path&lt;/span&gt;&lt;span style=&#34;color: #198810&#34;&gt;&amp;#34;&lt;/span&gt;: &lt;span style=&#34;color: #4b69c6&#34;&gt;str&lt;/span&gt;(output_path),
        }

        built_count &lt;span style=&#34;color: #d73948&#34;&gt;+=&lt;/span&gt; &lt;span style=&#34;color: #b60157&#34;&gt;1&lt;/span&gt;
        logger.&lt;span style=&#34;color: #4b69c6&#34;&gt;debug&lt;/span&gt;(&lt;span style=&#34;color: #d73948&#34;&gt;f&lt;/span&gt;&lt;span style=&#34;color: #198810&#34;&gt;&amp;#34;&lt;/span&gt;&lt;span style=&#34;color: #198810&#34;&gt;  BUILD: &lt;/span&gt;&lt;span style=&#34;color: #8b41b1&#34;&gt;{&lt;/span&gt;&lt;span style=&#34;color: #8b41b1&#34;&gt;page&lt;/span&gt;&lt;span style=&#34;color: #8b41b1&#34;&gt;.&lt;/span&gt;&lt;span style=&#34;color: #8b41b1&#34;&gt;filepath&lt;/span&gt;&lt;span style=&#34;color: #8b41b1&#34;&gt;}&lt;/span&gt;&lt;span style=&#34;color: #198810&#34;&gt; &amp;gt;&amp;gt; &lt;/span&gt;&lt;span style=&#34;color: #8b41b1&#34;&gt;{&lt;/span&gt;&lt;span style=&#34;color: #8b41b1&#34;&gt;output_path&lt;/span&gt;&lt;span style=&#34;color: #8b41b1&#34;&gt;}&lt;/span&gt;&lt;span style=&#34;color: #198810&#34;&gt;&amp;#34;&lt;/span&gt;)

    &lt;span style=&#34;color: #74747c&#34;&gt;#&lt;/span&gt;&lt;span style=&#34;color: #74747c&#34;&gt; Save updated cache&lt;/span&gt;
    &lt;span style=&#34;color: #4b69c6&#34;&gt;save_build_cache&lt;/span&gt;(new_cache, output_dir)

    logger.&lt;span style=&#34;color: #4b69c6&#34;&gt;info&lt;/span&gt;(&lt;span style=&#34;color: #d73948&#34;&gt;f&lt;/span&gt;&lt;span style=&#34;color: #198810&#34;&gt;&amp;#34;&lt;/span&gt;&lt;span style=&#34;color: #198810&#34;&gt;Built: &lt;/span&gt;&lt;span style=&#34;color: #8b41b1&#34;&gt;{&lt;/span&gt;&lt;span style=&#34;color: #8b41b1&#34;&gt;built_count&lt;/span&gt;&lt;span style=&#34;color: #8b41b1&#34;&gt;}&lt;/span&gt;&lt;span style=&#34;color: #198810&#34;&gt;, Skipped: &lt;/span&gt;&lt;span style=&#34;color: #8b41b1&#34;&gt;{&lt;/span&gt;&lt;span style=&#34;color: #8b41b1&#34;&gt;skipped_count&lt;/span&gt;&lt;span style=&#34;color: #8b41b1&#34;&gt;}&lt;/span&gt;&lt;span style=&#34;color: #198810&#34;&gt;&amp;#34;&lt;/span&gt;)


&lt;span style=&#34;color: #d73948&#34;&gt;def&lt;/span&gt; &lt;span style=&#34;color: #4b69c6&#34;&gt;clear_build_cache&lt;/span&gt;(output_dir: Path) -&amp;gt; &lt;span style=&#34;color: #d73948&#34;&gt;None&lt;/span&gt;:
    &lt;span style=&#34;color: #74747c&#34;&gt;&amp;#34;&amp;#34;&amp;#34;&lt;/span&gt;&lt;span style=&#34;color: #74747c&#34;&gt;Clear the build cache to force a full rebuild.&lt;/span&gt;&lt;span style=&#34;color: #74747c&#34;&gt;&amp;#34;&amp;#34;&amp;#34;&lt;/span&gt;
    cache_file &lt;span style=&#34;color: #d73948&#34;&gt;=&lt;/span&gt; output_dir &lt;span style=&#34;color: #d73948&#34;&gt;/&lt;/span&gt; &lt;span style=&#34;color: #198810&#34;&gt;&amp;#34;&lt;/span&gt;&lt;span style=&#34;color: #198810&#34;&gt;.build_cache.json&lt;/span&gt;&lt;span style=&#34;color: #198810&#34;&gt;&amp;#34;&lt;/span&gt;
    &lt;span style=&#34;color: #d73948&#34;&gt;if&lt;/span&gt; cache_file.&lt;span style=&#34;color: #4b69c6&#34;&gt;exists&lt;/span&gt;():
        cache_file.&lt;span style=&#34;color: #4b69c6&#34;&gt;unlink&lt;/span&gt;()
        logger.&lt;span style=&#34;color: #4b69c6&#34;&gt;info&lt;/span&gt;(&lt;span style=&#34;color: #198810&#34;&gt;&amp;#34;&lt;/span&gt;&lt;span style=&#34;color: #198810&#34;&gt;Build cache cleared&lt;/span&gt;&lt;span style=&#34;color: #198810&#34;&gt;&amp;#34;&lt;/span&gt;)&lt;/code&gt;&lt;/pre&gt;&lt;/div&gt;3:40am on September 24, 2025 from Appledore, South West England, United Kingdom&lt;p&gt;&lt;a href=&#34;mailto:reply@silasjelley.com?subject=Reply%20to%3A%20%E2%80%9CAdded%20incremental%20generation%20of%20HTML%20output%E2%80%9D&#34;&gt;Reply via email&lt;/a&gt;&lt;/p&gt;
</content>
</entry>
<entry>
  <title>Improved rendering of justified text</title>
  <link rel="alternate" type="text/html" href="https://silasjelley.com/2025/01/15/121447" />
  <id>tag:silasjelley.com,2020-08-20:3661f564-715a-4ced-a2ca-3c9c8556d17a</id>
  <published>2025-01-15T12:14:47-08:00</published>
  <updated>2025-01-15T12:14:47-08:00</updated>
  <category term="notes" />
  <category term="changelogs" />
  <summary>For a while I’ve been using justified text to give blockquotes on the site a distinct visual language, I like it, even though algorithmically justified text on the web is far from perfect, with…</summary>
<mosaic:place>Yaletown, Vancouver, British Columbia, Canada</mosaic:place>
<content type="html">
    &lt;p&gt;For a while I’ve been using justified text to give blockquotes on the site a distinct visual language, I like it, even though algorithmically justified text on the web is far from perfect, with certain viewport widths yielding ugly rivers in a text block.&lt;/p&gt;&lt;p&gt;Last night I came across a post from Tyler Sticka — &lt;a href=&#34;https://cloudfour.com/thinks/justified-text-better-than-expected/&#34;&gt;Justified Text: Better Than Expected?&lt;/a&gt; — that introduced me to a couple of CSS properties that improve rendering,&lt;/p&gt;&lt;div class=&#34;code-block&#34; data-lang=&#34;css&#34;&gt;&lt;div class=&#34;code-header&#34; data-mosaic-chrome=&#34;&#34;&gt;&lt;span class=&#34;code-lang&#34;&gt;css&lt;/span&gt;&lt;button class=&#34;code-copy&#34; aria-label=&#34;Copy code&#34; type=&#34;button&#34;&gt;Copy&lt;/button&gt;&lt;/div&gt;&lt;pre&gt;&lt;code data-lang=&#34;css&#34;&gt;&lt;span style=&#34;color: #4b69c6&#34;&gt;blockquote&lt;/span&gt; {
  &lt;span style=&#34;color: #4b69c6&#34;&gt;hyphens&lt;/span&gt;: &lt;span style=&#34;color: #4b69c6&#34;&gt;auto&lt;/span&gt;;
  hyphenate-limit-chars: &lt;span style=&#34;color: #b60157&#34;&gt;7&lt;/span&gt;;
}&lt;/code&gt;&lt;/pre&gt;&lt;/div&gt;&lt;p&gt;Here’s what I use for blockquotes now,&lt;/p&gt;&lt;div class=&#34;code-block&#34; data-lang=&#34;css&#34;&gt;&lt;div class=&#34;code-header&#34; data-mosaic-chrome=&#34;&#34;&gt;&lt;span class=&#34;code-lang&#34;&gt;css&lt;/span&gt;&lt;button class=&#34;code-copy&#34; aria-label=&#34;Copy code&#34; type=&#34;button&#34;&gt;Copy&lt;/button&gt;&lt;/div&gt;&lt;pre&gt;&lt;code data-lang=&#34;css&#34;&gt;&lt;span style=&#34;color: #4b69c6&#34;&gt;blockquote&lt;/span&gt; {
  &lt;span style=&#34;color: #4b69c6&#34;&gt;padding&lt;/span&gt;: &lt;span style=&#34;color: #b60157&#34;&gt;0&lt;/span&gt; &lt;span style=&#34;color: #b60157&#34;&gt;1&lt;/span&gt;&lt;span style=&#34;color: #d73948&#34;&gt;em&lt;/span&gt; &lt;span style=&#34;color: #b60157&#34;&gt;0&lt;/span&gt; &lt;span style=&#34;color: #b60157&#34;&gt;2&lt;/span&gt;&lt;span style=&#34;color: #d73948&#34;&gt;em&lt;/span&gt;;
  &lt;span style=&#34;color: #4b69c6&#34;&gt;margin&lt;/span&gt;: &lt;span style=&#34;color: #b60157&#34;&gt;1&lt;/span&gt;&lt;span style=&#34;color: #b60157&#34;&gt;.&lt;/span&gt;&lt;span style=&#34;color: #b60157&#34;&gt;4&lt;/span&gt;&lt;span style=&#34;color: #d73948&#34;&gt;em&lt;/span&gt; &lt;span style=&#34;color: #b60157&#34;&gt;0&lt;/span&gt;;
  &lt;span style=&#34;color: #4b69c6&#34;&gt;position&lt;/span&gt;: &lt;span style=&#34;color: #4b69c6&#34;&gt;relative&lt;/span&gt;;
  &lt;span style=&#34;color: #4b69c6&#34;&gt;color&lt;/span&gt;: &lt;span style=&#34;color: #4b69c6&#34;&gt;var&lt;/span&gt;(&lt;span style=&#34;color: #4b69c6&#34;&gt;--&lt;/span&gt;&lt;span style=&#34;color: #4b69c6&#34;&gt;blockquote-foreground&lt;/span&gt;);
}

&lt;span style=&#34;color: #4b69c6&#34;&gt;blockquote&lt;/span&gt; &lt;span style=&#34;color: #4b69c6&#34;&gt;p&lt;/span&gt; {
  &lt;span style=&#34;color: #4b69c6&#34;&gt;text-align&lt;/span&gt;: &lt;span style=&#34;color: #4b69c6&#34;&gt;justify&lt;/span&gt;;
  &lt;span style=&#34;color: #4b69c6&#34;&gt;hyphens&lt;/span&gt;: &lt;span style=&#34;color: #4b69c6&#34;&gt;auto&lt;/span&gt;;
  hyphenate-limit-chars: &lt;span style=&#34;color: #b60157&#34;&gt;7&lt;/span&gt;;
  &lt;span style=&#34;color: #4b69c6&#34;&gt;margin&lt;/span&gt;: &lt;span style=&#34;color: #b60157&#34;&gt;1&lt;/span&gt;&lt;span style=&#34;color: #d73948&#34;&gt;em&lt;/span&gt; &lt;span style=&#34;color: #b60157&#34;&gt;0&lt;/span&gt; &lt;span style=&#34;color: #b60157&#34;&gt;0&lt;/span&gt; &lt;span style=&#34;color: #b60157&#34;&gt;0&lt;/span&gt;;
}
&lt;span style=&#34;color: #4b69c6&#34;&gt;blockquote&lt;/span&gt; &lt;span style=&#34;color: #4b69c6&#34;&gt;p&lt;/span&gt; + &lt;span style=&#34;color: #4b69c6&#34;&gt;p&lt;/span&gt; {
  &lt;span style=&#34;color: #4b69c6&#34;&gt;text-indent&lt;/span&gt;: &lt;span style=&#34;color: #b60157&#34;&gt;2&lt;/span&gt;&lt;span style=&#34;color: #d73948&#34;&gt;em&lt;/span&gt;;
  &lt;span style=&#34;color: #4b69c6&#34;&gt;margin&lt;/span&gt;: &lt;span style=&#34;color: #b60157&#34;&gt;0&lt;/span&gt;;
}&lt;/code&gt;&lt;/pre&gt;&lt;/div&gt;12:14pm on January 15, 2025 from Yaletown, Vancouver, British Columbia, Canada&lt;p&gt;&lt;a href=&#34;mailto:reply@silasjelley.com?subject=Reply%20to%3A%20%E2%80%9CImproved%20rendering%20of%20justified%20text%E2%80%9D&#34;&gt;Reply via email&lt;/a&gt;&lt;/p&gt;
</content>
</entry>
<entry>
  <title>Add dataclasses to ratchet up the strictness</title>
  <link rel="alternate" type="text/html" href="https://silasjelley.com/2024/12/11/234731" />
  <id>tag:silasjelley.com,2020-08-20:f544d737-8000-408d-b32d-86428a349e4d</id>
  <published>2024-12-16T09:54:32-08:00</published>
  <updated>2024-12-16T09:54:30-08:00</updated>
  <category term="notes" />
  <category term="changelogs" />
  <summary>In continuing to ratchet up the strictness of the build system I landed on the concept of dataclasses, which are new to this novice programmer, though the concept of a schema for validation is not.…</summary>
<mosaic:place>Kitsilano, Vancouver, British Columbia, Canada</mosaic:place>
<content type="html">
    &lt;p&gt;In continuing to ratchet up the strictness of the build system I landed on the concept of dataclasses, which are new to this novice programmer, though the concept of a schema for validation is not.&lt;/p&gt;&lt;p&gt;Anyway, I landed on creating one dataclass for Documents and another for Assets.&lt;/p&gt;&lt;div class=&#34;code-block&#34; data-lang=&#34;python&#34;&gt;&lt;div class=&#34;code-header&#34; data-mosaic-chrome=&#34;&#34;&gt;&lt;span class=&#34;code-lang&#34;&gt;python&lt;/span&gt;&lt;button class=&#34;code-copy&#34; aria-label=&#34;Copy code&#34; type=&#34;button&#34;&gt;Copy&lt;/button&gt;&lt;/div&gt;&lt;pre&gt;&lt;code data-lang=&#34;python&#34;&gt;&lt;span style=&#34;color: #301414&#34;&gt;@&lt;/span&gt;&lt;span style=&#34;color: #301414&#34;&gt;dataclass&lt;/span&gt;
&lt;span style=&#34;color: #d73948&#34;&gt;class&lt;/span&gt; &lt;span style=&#34;color: #4b69c6&#34;&gt;DocumentMetadata&lt;/span&gt;:
    filepath: Path
    uid: &lt;span style=&#34;color: #4b69c6&#34;&gt;str&lt;/span&gt;
    slug: &lt;span style=&#34;color: #4b69c6&#34;&gt;str&lt;/span&gt;
    title: &lt;span style=&#34;color: #4b69c6&#34;&gt;str&lt;/span&gt;
    primary: &lt;span style=&#34;color: #4b69c6&#34;&gt;str&lt;/span&gt;
    secondary: &lt;span style=&#34;color: #4b69c6&#34;&gt;str&lt;/span&gt;
    available: datetime.datetime
    created: datetime.datetime
    updated: datetime.datetime
    creator: &lt;span style=&#34;color: #4b69c6&#34;&gt;str&lt;/span&gt; &lt;span style=&#34;color: #d73948&#34;&gt;=&lt;/span&gt; &lt;span style=&#34;color: #198810&#34;&gt;&amp;#34;&lt;/span&gt;&lt;span style=&#34;color: #198810&#34;&gt;&amp;#34;&lt;/span&gt;
    note: &lt;span style=&#34;color: #4b69c6&#34;&gt;str&lt;/span&gt; &lt;span style=&#34;color: #d73948&#34;&gt;=&lt;/span&gt; &lt;span style=&#34;color: #198810&#34;&gt;&amp;#34;&lt;/span&gt;&lt;span style=&#34;color: #198810&#34;&gt;&amp;#34;&lt;/span&gt;
    favourite: &lt;span style=&#34;color: #4b69c6&#34;&gt;bool&lt;/span&gt; &lt;span style=&#34;color: #d73948&#34;&gt;=&lt;/span&gt; &lt;span style=&#34;color: #d73948&#34;&gt;False&lt;/span&gt;
    parent: &lt;span style=&#34;color: #4b69c6&#34;&gt;str&lt;/span&gt; &lt;span style=&#34;color: #d73948&#34;&gt;=&lt;/span&gt; &lt;span style=&#34;color: #198810&#34;&gt;&amp;#34;&lt;/span&gt;&lt;span style=&#34;color: #198810&#34;&gt;&amp;#34;&lt;/span&gt;
    description: &lt;span style=&#34;color: #4b69c6&#34;&gt;str&lt;/span&gt; &lt;span style=&#34;color: #d73948&#34;&gt;=&lt;/span&gt; &lt;span style=&#34;color: #198810&#34;&gt;&amp;#34;&lt;/span&gt;&lt;span style=&#34;color: #198810&#34;&gt;&amp;#34;&lt;/span&gt;
    layout: &lt;span style=&#34;color: #4b69c6&#34;&gt;str&lt;/span&gt; &lt;span style=&#34;color: #d73948&#34;&gt;=&lt;/span&gt; TEMPLATE_DEFAULT
    source: Dict &lt;span style=&#34;color: #d73948&#34;&gt;=&lt;/span&gt; &lt;span style=&#34;color: #4b69c6&#34;&gt;field&lt;/span&gt;(default_factory&lt;span style=&#34;color: #d73948&#34;&gt;=&lt;/span&gt;&lt;span style=&#34;color: #4b69c6&#34;&gt;dict&lt;/span&gt;)
    via: Dict &lt;span style=&#34;color: #d73948&#34;&gt;=&lt;/span&gt; &lt;span style=&#34;color: #4b69c6&#34;&gt;field&lt;/span&gt;(default_factory&lt;span style=&#34;color: #d73948&#34;&gt;=&lt;/span&gt;&lt;span style=&#34;color: #4b69c6&#34;&gt;dict&lt;/span&gt;)
    location: Dict[&lt;span style=&#34;color: #4b69c6&#34;&gt;str&lt;/span&gt;, Any] &lt;span style=&#34;color: #d73948&#34;&gt;=&lt;/span&gt; &lt;span style=&#34;color: #4b69c6&#34;&gt;field&lt;/span&gt;(
        default_factory&lt;span style=&#34;color: #d73948&#34;&gt;=&lt;/span&gt;&lt;span style=&#34;color: #d73948&#34;&gt;lambda&lt;/span&gt;: {
            &lt;span style=&#34;color: #198810&#34;&gt;&amp;#34;&lt;/span&gt;&lt;span style=&#34;color: #198810&#34;&gt;continent&lt;/span&gt;&lt;span style=&#34;color: #198810&#34;&gt;&amp;#34;&lt;/span&gt;: &lt;span style=&#34;color: #198810&#34;&gt;&amp;#34;&lt;/span&gt;&lt;span style=&#34;color: #198810&#34;&gt;&amp;#34;&lt;/span&gt;,
            &lt;span style=&#34;color: #198810&#34;&gt;&amp;#34;&lt;/span&gt;&lt;span style=&#34;color: #198810&#34;&gt;country&lt;/span&gt;&lt;span style=&#34;color: #198810&#34;&gt;&amp;#34;&lt;/span&gt;: &lt;span style=&#34;color: #198810&#34;&gt;&amp;#34;&lt;/span&gt;&lt;span style=&#34;color: #198810&#34;&gt;&amp;#34;&lt;/span&gt;,
            &lt;span style=&#34;color: #198810&#34;&gt;&amp;#34;&lt;/span&gt;&lt;span style=&#34;color: #198810&#34;&gt;region&lt;/span&gt;&lt;span style=&#34;color: #198810&#34;&gt;&amp;#34;&lt;/span&gt;: &lt;span style=&#34;color: #198810&#34;&gt;&amp;#34;&lt;/span&gt;&lt;span style=&#34;color: #198810&#34;&gt;&amp;#34;&lt;/span&gt;,
            &lt;span style=&#34;color: #198810&#34;&gt;&amp;#34;&lt;/span&gt;&lt;span style=&#34;color: #198810&#34;&gt;city&lt;/span&gt;&lt;span style=&#34;color: #198810&#34;&gt;&amp;#34;&lt;/span&gt;: &lt;span style=&#34;color: #198810&#34;&gt;&amp;#34;&lt;/span&gt;&lt;span style=&#34;color: #198810&#34;&gt;&amp;#34;&lt;/span&gt;,
            &lt;span style=&#34;color: #198810&#34;&gt;&amp;#34;&lt;/span&gt;&lt;span style=&#34;color: #198810&#34;&gt;note&lt;/span&gt;&lt;span style=&#34;color: #198810&#34;&gt;&amp;#34;&lt;/span&gt;: &lt;span style=&#34;color: #198810&#34;&gt;&amp;#34;&lt;/span&gt;&lt;span style=&#34;color: #198810&#34;&gt;&amp;#34;&lt;/span&gt;,
            &lt;span style=&#34;color: #198810&#34;&gt;&amp;#34;&lt;/span&gt;&lt;span style=&#34;color: #198810&#34;&gt;lat&lt;/span&gt;&lt;span style=&#34;color: #198810&#34;&gt;&amp;#34;&lt;/span&gt;: &lt;span style=&#34;color: #4b69c6&#34;&gt;int&lt;/span&gt;,
            &lt;span style=&#34;color: #198810&#34;&gt;&amp;#34;&lt;/span&gt;&lt;span style=&#34;color: #198810&#34;&gt;lng&lt;/span&gt;&lt;span style=&#34;color: #198810&#34;&gt;&amp;#34;&lt;/span&gt;: &lt;span style=&#34;color: #4b69c6&#34;&gt;int&lt;/span&gt;,
        }
    )
    collection: Dict[&lt;span style=&#34;color: #4b69c6&#34;&gt;str&lt;/span&gt;, Any] &lt;span style=&#34;color: #d73948&#34;&gt;=&lt;/span&gt; &lt;span style=&#34;color: #4b69c6&#34;&gt;field&lt;/span&gt;(
        default_factory&lt;span style=&#34;color: #d73948&#34;&gt;=&lt;/span&gt;&lt;span style=&#34;color: #d73948&#34;&gt;lambda&lt;/span&gt;: {
            &lt;span style=&#34;color: #198810&#34;&gt;&amp;#34;&lt;/span&gt;&lt;span style=&#34;color: #198810&#34;&gt;style&lt;/span&gt;&lt;span style=&#34;color: #198810&#34;&gt;&amp;#34;&lt;/span&gt;: &lt;span style=&#34;color: #198810&#34;&gt;&amp;#34;&lt;/span&gt;&lt;span style=&#34;color: #198810&#34;&gt;title&lt;/span&gt;&lt;span style=&#34;color: #198810&#34;&gt;&amp;#34;&lt;/span&gt;,
            &lt;span style=&#34;color: #198810&#34;&gt;&amp;#34;&lt;/span&gt;&lt;span style=&#34;color: #198810&#34;&gt;order&lt;/span&gt;&lt;span style=&#34;color: #198810&#34;&gt;&amp;#34;&lt;/span&gt;: &lt;span style=&#34;color: #198810&#34;&gt;&amp;#34;&lt;/span&gt;&lt;span style=&#34;color: #198810&#34;&gt;chronological&lt;/span&gt;&lt;span style=&#34;color: #198810&#34;&gt;&amp;#34;&lt;/span&gt;,
            &lt;span style=&#34;color: #198810&#34;&gt;&amp;#34;&lt;/span&gt;&lt;span style=&#34;color: #198810&#34;&gt;include&lt;/span&gt;&lt;span style=&#34;color: #198810&#34;&gt;&amp;#34;&lt;/span&gt;: [],
        }
    )
    attribution: Dict[&lt;span style=&#34;color: #4b69c6&#34;&gt;str&lt;/span&gt;, &lt;span style=&#34;color: #4b69c6&#34;&gt;str&lt;/span&gt;] &lt;span style=&#34;color: #d73948&#34;&gt;=&lt;/span&gt; &lt;span style=&#34;color: #4b69c6&#34;&gt;field&lt;/span&gt;(
        default_factory&lt;span style=&#34;color: #d73948&#34;&gt;=&lt;/span&gt;&lt;span style=&#34;color: #d73948&#34;&gt;lambda&lt;/span&gt;: {
            &lt;span style=&#34;color: #198810&#34;&gt;&amp;#34;&lt;/span&gt;&lt;span style=&#34;color: #198810&#34;&gt;plain&lt;/span&gt;&lt;span style=&#34;color: #198810&#34;&gt;&amp;#34;&lt;/span&gt;: &lt;span style=&#34;color: #198810&#34;&gt;&amp;#34;&lt;/span&gt;&lt;span style=&#34;color: #198810&#34;&gt;&amp;#34;&lt;/span&gt;,
            &lt;span style=&#34;color: #198810&#34;&gt;&amp;#34;&lt;/span&gt;&lt;span style=&#34;color: #198810&#34;&gt;djot&lt;/span&gt;&lt;span style=&#34;color: #198810&#34;&gt;&amp;#34;&lt;/span&gt;: &lt;span style=&#34;color: #198810&#34;&gt;&amp;#34;&lt;/span&gt;&lt;span style=&#34;color: #198810&#34;&gt;&amp;#34;&lt;/span&gt;,
            &lt;span style=&#34;color: #198810&#34;&gt;&amp;#34;&lt;/span&gt;&lt;span style=&#34;color: #198810&#34;&gt;html&lt;/span&gt;&lt;span style=&#34;color: #198810&#34;&gt;&amp;#34;&lt;/span&gt;: &lt;span style=&#34;color: #198810&#34;&gt;&amp;#34;&lt;/span&gt;&lt;span style=&#34;color: #198810&#34;&gt;&amp;#34;&lt;/span&gt;,
        }
    )
    media: &lt;span style=&#34;color: #4b69c6&#34;&gt;str&lt;/span&gt; &lt;span style=&#34;color: #d73948&#34;&gt;=&lt;/span&gt; &lt;span style=&#34;color: #198810&#34;&gt;&amp;#34;&lt;/span&gt;&lt;span style=&#34;color: #198810&#34;&gt;application/toml&lt;/span&gt;&lt;span style=&#34;color: #198810&#34;&gt;&amp;#34;&lt;/span&gt;
    words: Dict[&lt;span style=&#34;color: #4b69c6&#34;&gt;str&lt;/span&gt;, Any] &lt;span style=&#34;color: #d73948&#34;&gt;=&lt;/span&gt; &lt;span style=&#34;color: #4b69c6&#34;&gt;field&lt;/span&gt;(
        default_factory&lt;span style=&#34;color: #d73948&#34;&gt;=&lt;/span&gt;&lt;span style=&#34;color: #d73948&#34;&gt;lambda&lt;/span&gt;: {
            &lt;span style=&#34;color: #198810&#34;&gt;&amp;#34;&lt;/span&gt;&lt;span style=&#34;color: #198810&#34;&gt;self&lt;/span&gt;&lt;span style=&#34;color: #198810&#34;&gt;&amp;#34;&lt;/span&gt;: &lt;span style=&#34;color: #b60157&#34;&gt;0&lt;/span&gt;,
            &lt;span style=&#34;color: #198810&#34;&gt;&amp;#34;&lt;/span&gt;&lt;span style=&#34;color: #198810&#34;&gt;code&lt;/span&gt;&lt;span style=&#34;color: #198810&#34;&gt;&amp;#34;&lt;/span&gt;: {
                &lt;span style=&#34;color: #198810&#34;&gt;&amp;#34;&lt;/span&gt;&lt;span style=&#34;color: #198810&#34;&gt;lines&lt;/span&gt;&lt;span style=&#34;color: #198810&#34;&gt;&amp;#34;&lt;/span&gt;: &lt;span style=&#34;color: #b60157&#34;&gt;0&lt;/span&gt;,
                &lt;span style=&#34;color: #198810&#34;&gt;&amp;#34;&lt;/span&gt;&lt;span style=&#34;color: #198810&#34;&gt;words&lt;/span&gt;&lt;span style=&#34;color: #198810&#34;&gt;&amp;#34;&lt;/span&gt;: &lt;span style=&#34;color: #b60157&#34;&gt;0&lt;/span&gt;,
            },
            &lt;span style=&#34;color: #198810&#34;&gt;&amp;#34;&lt;/span&gt;&lt;span style=&#34;color: #198810&#34;&gt;references&lt;/span&gt;&lt;span style=&#34;color: #198810&#34;&gt;&amp;#34;&lt;/span&gt;: &lt;span style=&#34;color: #b60157&#34;&gt;0&lt;/span&gt;,
        }
    )
    status: &lt;span style=&#34;color: #4b69c6&#34;&gt;str&lt;/span&gt; &lt;span style=&#34;color: #d73948&#34;&gt;=&lt;/span&gt; &lt;span style=&#34;color: #198810&#34;&gt;&amp;#34;&lt;/span&gt;&lt;span style=&#34;color: #198810&#34;&gt;&amp;#34;&lt;/span&gt;
    links: LinksDict &lt;span style=&#34;color: #d73948&#34;&gt;=&lt;/span&gt; &lt;span style=&#34;color: #4b69c6&#34;&gt;field&lt;/span&gt;(
        default_factory&lt;span style=&#34;color: #d73948&#34;&gt;=&lt;/span&gt;&lt;span style=&#34;color: #d73948&#34;&gt;lambda&lt;/span&gt;: {
            &lt;span style=&#34;color: #198810&#34;&gt;&amp;#34;&lt;/span&gt;&lt;span style=&#34;color: #198810&#34;&gt;internal&lt;/span&gt;&lt;span style=&#34;color: #198810&#34;&gt;&amp;#34;&lt;/span&gt;: &lt;span style=&#34;color: #4b69c6&#34;&gt;list&lt;/span&gt;(),
            &lt;span style=&#34;color: #198810&#34;&gt;&amp;#34;&lt;/span&gt;&lt;span style=&#34;color: #198810&#34;&gt;external&lt;/span&gt;&lt;span style=&#34;color: #198810&#34;&gt;&amp;#34;&lt;/span&gt;: &lt;span style=&#34;color: #4b69c6&#34;&gt;list&lt;/span&gt;(),
            &lt;span style=&#34;color: #198810&#34;&gt;&amp;#34;&lt;/span&gt;&lt;span style=&#34;color: #198810&#34;&gt;backlinks&lt;/span&gt;&lt;span style=&#34;color: #198810&#34;&gt;&amp;#34;&lt;/span&gt;: &lt;span style=&#34;color: #4b69c6&#34;&gt;list&lt;/span&gt;(),
        }
    )
    options: List[&lt;span style=&#34;color: #4b69c6&#34;&gt;str&lt;/span&gt;] &lt;span style=&#34;color: #d73948&#34;&gt;=&lt;/span&gt; &lt;span style=&#34;color: #4b69c6&#34;&gt;field&lt;/span&gt;(default_factory&lt;span style=&#34;color: #d73948&#34;&gt;=&lt;/span&gt;&lt;span style=&#34;color: #4b69c6&#34;&gt;list&lt;/span&gt;)
    tags: List[&lt;span style=&#34;color: #4b69c6&#34;&gt;str&lt;/span&gt;] &lt;span style=&#34;color: #d73948&#34;&gt;=&lt;/span&gt; &lt;span style=&#34;color: #4b69c6&#34;&gt;field&lt;/span&gt;(default_factory&lt;span style=&#34;color: #d73948&#34;&gt;=&lt;/span&gt;&lt;span style=&#34;color: #4b69c6&#34;&gt;list&lt;/span&gt;)
    content: Dict[&lt;span style=&#34;color: #4b69c6&#34;&gt;str&lt;/span&gt;, &lt;span style=&#34;color: #4b69c6&#34;&gt;str&lt;/span&gt;] &lt;span style=&#34;color: #d73948&#34;&gt;=&lt;/span&gt; &lt;span style=&#34;color: #4b69c6&#34;&gt;field&lt;/span&gt;(default_factory&lt;span style=&#34;color: #d73948&#34;&gt;=&lt;/span&gt;&lt;span style=&#34;color: #4b69c6&#34;&gt;dict&lt;/span&gt;)

    &lt;span style=&#34;color: #d73948&#34;&gt;def&lt;/span&gt; &lt;span style=&#34;color: #4b69c6&#34;&gt;__post_init__&lt;/span&gt;(self):
        &lt;span style=&#34;color: #74747c&#34;&gt;#&lt;/span&gt;&lt;span style=&#34;color: #74747c&#34;&gt; Validate links dictionary structure&lt;/span&gt;
        required_link_types &lt;span style=&#34;color: #d73948&#34;&gt;=&lt;/span&gt; {&lt;span style=&#34;color: #198810&#34;&gt;&amp;#34;&lt;/span&gt;&lt;span style=&#34;color: #198810&#34;&gt;internal&lt;/span&gt;&lt;span style=&#34;color: #198810&#34;&gt;&amp;#34;&lt;/span&gt;, &lt;span style=&#34;color: #198810&#34;&gt;&amp;#34;&lt;/span&gt;&lt;span style=&#34;color: #198810&#34;&gt;external&lt;/span&gt;&lt;span style=&#34;color: #198810&#34;&gt;&amp;#34;&lt;/span&gt;, &lt;span style=&#34;color: #198810&#34;&gt;&amp;#34;&lt;/span&gt;&lt;span style=&#34;color: #198810&#34;&gt;backlinks&lt;/span&gt;&lt;span style=&#34;color: #198810&#34;&gt;&amp;#34;&lt;/span&gt;}
        &lt;span style=&#34;color: #d73948&#34;&gt;if&lt;/span&gt; (
            &lt;span style=&#34;color: #d73948&#34;&gt;not&lt;/span&gt; &lt;span style=&#34;color: #4b69c6&#34;&gt;isinstance&lt;/span&gt;(&lt;span style=&#34;color: #d73948&#34;&gt;self&lt;/span&gt;.links, &lt;span style=&#34;color: #4b69c6&#34;&gt;dict&lt;/span&gt;)
            &lt;span style=&#34;color: #d73948&#34;&gt;or&lt;/span&gt; &lt;span style=&#34;color: #4b69c6&#34;&gt;set&lt;/span&gt;(&lt;span style=&#34;color: #d73948&#34;&gt;self&lt;/span&gt;.links.&lt;span style=&#34;color: #4b69c6&#34;&gt;keys&lt;/span&gt;()) &lt;span style=&#34;color: #d73948&#34;&gt;!=&lt;/span&gt; required_link_types
        ):
            &lt;span style=&#34;color: #d73948&#34;&gt;raise&lt;/span&gt; &lt;span style=&#34;color: #4b69c6&#34;&gt;ValueError&lt;/span&gt;(
                &lt;span style=&#34;color: #d73948&#34;&gt;f&lt;/span&gt;&lt;span style=&#34;color: #198810&#34;&gt;&amp;#34;&lt;/span&gt;&lt;span style=&#34;color: #198810&#34;&gt;links must be a dictionary with exactly these keys: &lt;/span&gt;&lt;span style=&#34;color: #8b41b1&#34;&gt;{&lt;/span&gt;&lt;span style=&#34;color: #8b41b1&#34;&gt;required_link_types&lt;/span&gt;&lt;span style=&#34;color: #8b41b1&#34;&gt;}&lt;/span&gt;&lt;span style=&#34;color: #198810&#34;&gt;&amp;#34;&lt;/span&gt;
            )
        &lt;span style=&#34;color: #d73948&#34;&gt;for&lt;/span&gt; key &lt;span style=&#34;color: #d73948&#34;&gt;in&lt;/span&gt; &lt;span style=&#34;color: #d73948&#34;&gt;self&lt;/span&gt;.links:
            &lt;span style=&#34;color: #d73948&#34;&gt;if&lt;/span&gt; &lt;span style=&#34;color: #d73948&#34;&gt;not&lt;/span&gt; &lt;span style=&#34;color: #4b69c6&#34;&gt;isinstance&lt;/span&gt;(&lt;span style=&#34;color: #d73948&#34;&gt;self&lt;/span&gt;.links[key], &lt;span style=&#34;color: #4b69c6&#34;&gt;set&lt;/span&gt;):
                &lt;span style=&#34;color: #d73948&#34;&gt;self&lt;/span&gt;.links[key] &lt;span style=&#34;color: #d73948&#34;&gt;=&lt;/span&gt; &lt;span style=&#34;color: #4b69c6&#34;&gt;set&lt;/span&gt;(&lt;span style=&#34;color: #d73948&#34;&gt;self&lt;/span&gt;.links[key])
&lt;/code&gt;&lt;/pre&gt;&lt;/div&gt;&lt;div class=&#34;code-block&#34; data-lang=&#34;python&#34;&gt;&lt;div class=&#34;code-header&#34; data-mosaic-chrome=&#34;&#34;&gt;&lt;span class=&#34;code-lang&#34;&gt;python&lt;/span&gt;&lt;button class=&#34;code-copy&#34; aria-label=&#34;Copy code&#34; type=&#34;button&#34;&gt;Copy&lt;/button&gt;&lt;/div&gt;&lt;pre&gt;&lt;code data-lang=&#34;python&#34;&gt;&lt;span style=&#34;color: #301414&#34;&gt;@&lt;/span&gt;&lt;span style=&#34;color: #301414&#34;&gt;dataclass&lt;/span&gt;
&lt;span style=&#34;color: #d73948&#34;&gt;class&lt;/span&gt; &lt;span style=&#34;color: #4b69c6&#34;&gt;AssetMetadata&lt;/span&gt;:
    filepath: Path
    media: &lt;span style=&#34;color: #4b69c6&#34;&gt;str&lt;/span&gt;
    uid: &lt;span style=&#34;color: #4b69c6&#34;&gt;str&lt;/span&gt;
    slug: &lt;span style=&#34;color: #4b69c6&#34;&gt;str&lt;/span&gt;
    title: &lt;span style=&#34;color: #4b69c6&#34;&gt;str&lt;/span&gt;
    available: datetime.datetime
    created: datetime.datetime
    updated: datetime.datetime
    creator: &lt;span style=&#34;color: #4b69c6&#34;&gt;str&lt;/span&gt; &lt;span style=&#34;color: #d73948&#34;&gt;=&lt;/span&gt; &lt;span style=&#34;color: #198810&#34;&gt;&amp;#34;&lt;/span&gt;&lt;span style=&#34;color: #198810&#34;&gt;&amp;#34;&lt;/span&gt;
    note: &lt;span style=&#34;color: #4b69c6&#34;&gt;str&lt;/span&gt; &lt;span style=&#34;color: #d73948&#34;&gt;=&lt;/span&gt; &lt;span style=&#34;color: #198810&#34;&gt;&amp;#34;&lt;/span&gt;&lt;span style=&#34;color: #198810&#34;&gt;&amp;#34;&lt;/span&gt;
    favourite: &lt;span style=&#34;color: #4b69c6&#34;&gt;bool&lt;/span&gt; &lt;span style=&#34;color: #d73948&#34;&gt;=&lt;/span&gt; &lt;span style=&#34;color: #d73948&#34;&gt;False&lt;/span&gt;
    source: Dict &lt;span style=&#34;color: #d73948&#34;&gt;=&lt;/span&gt; &lt;span style=&#34;color: #4b69c6&#34;&gt;field&lt;/span&gt;(default_factory&lt;span style=&#34;color: #d73948&#34;&gt;=&lt;/span&gt;&lt;span style=&#34;color: #4b69c6&#34;&gt;dict&lt;/span&gt;)
    via: Dict &lt;span style=&#34;color: #d73948&#34;&gt;=&lt;/span&gt; &lt;span style=&#34;color: #4b69c6&#34;&gt;field&lt;/span&gt;(default_factory&lt;span style=&#34;color: #d73948&#34;&gt;=&lt;/span&gt;&lt;span style=&#34;color: #4b69c6&#34;&gt;dict&lt;/span&gt;)
    &lt;span style=&#34;color: #4b69c6&#34;&gt;hash&lt;/span&gt;: &lt;span style=&#34;color: #4b69c6&#34;&gt;str&lt;/span&gt; &lt;span style=&#34;color: #d73948&#34;&gt;=&lt;/span&gt; &lt;span style=&#34;color: #198810&#34;&gt;&amp;#34;&lt;/span&gt;&lt;span style=&#34;color: #198810&#34;&gt;&amp;#34;&lt;/span&gt;
    output_width: &lt;span style=&#34;color: #4b69c6&#34;&gt;int&lt;/span&gt; &lt;span style=&#34;color: #d73948&#34;&gt;=&lt;/span&gt; &lt;span style=&#34;color: #b60157&#34;&gt;0&lt;/span&gt;
    output_height: &lt;span style=&#34;color: #4b69c6&#34;&gt;int&lt;/span&gt; &lt;span style=&#34;color: #d73948&#34;&gt;=&lt;/span&gt; &lt;span style=&#34;color: #b60157&#34;&gt;0&lt;/span&gt;
    location: Dict[&lt;span style=&#34;color: #4b69c6&#34;&gt;str&lt;/span&gt;, Any] &lt;span style=&#34;color: #d73948&#34;&gt;=&lt;/span&gt; &lt;span style=&#34;color: #4b69c6&#34;&gt;field&lt;/span&gt;(
        default_factory&lt;span style=&#34;color: #d73948&#34;&gt;=&lt;/span&gt;&lt;span style=&#34;color: #d73948&#34;&gt;lambda&lt;/span&gt;: {
            &lt;span style=&#34;color: #198810&#34;&gt;&amp;#34;&lt;/span&gt;&lt;span style=&#34;color: #198810&#34;&gt;continent&lt;/span&gt;&lt;span style=&#34;color: #198810&#34;&gt;&amp;#34;&lt;/span&gt;: &lt;span style=&#34;color: #198810&#34;&gt;&amp;#34;&lt;/span&gt;&lt;span style=&#34;color: #198810&#34;&gt;&amp;#34;&lt;/span&gt;,
            &lt;span style=&#34;color: #198810&#34;&gt;&amp;#34;&lt;/span&gt;&lt;span style=&#34;color: #198810&#34;&gt;country&lt;/span&gt;&lt;span style=&#34;color: #198810&#34;&gt;&amp;#34;&lt;/span&gt;: &lt;span style=&#34;color: #198810&#34;&gt;&amp;#34;&lt;/span&gt;&lt;span style=&#34;color: #198810&#34;&gt;&amp;#34;&lt;/span&gt;,
            &lt;span style=&#34;color: #198810&#34;&gt;&amp;#34;&lt;/span&gt;&lt;span style=&#34;color: #198810&#34;&gt;region&lt;/span&gt;&lt;span style=&#34;color: #198810&#34;&gt;&amp;#34;&lt;/span&gt;: &lt;span style=&#34;color: #198810&#34;&gt;&amp;#34;&lt;/span&gt;&lt;span style=&#34;color: #198810&#34;&gt;&amp;#34;&lt;/span&gt;,
            &lt;span style=&#34;color: #198810&#34;&gt;&amp;#34;&lt;/span&gt;&lt;span style=&#34;color: #198810&#34;&gt;city&lt;/span&gt;&lt;span style=&#34;color: #198810&#34;&gt;&amp;#34;&lt;/span&gt;: &lt;span style=&#34;color: #198810&#34;&gt;&amp;#34;&lt;/span&gt;&lt;span style=&#34;color: #198810&#34;&gt;&amp;#34;&lt;/span&gt;,
            &lt;span style=&#34;color: #198810&#34;&gt;&amp;#34;&lt;/span&gt;&lt;span style=&#34;color: #198810&#34;&gt;note&lt;/span&gt;&lt;span style=&#34;color: #198810&#34;&gt;&amp;#34;&lt;/span&gt;: &lt;span style=&#34;color: #198810&#34;&gt;&amp;#34;&lt;/span&gt;&lt;span style=&#34;color: #198810&#34;&gt;&amp;#34;&lt;/span&gt;,
            &lt;span style=&#34;color: #198810&#34;&gt;&amp;#34;&lt;/span&gt;&lt;span style=&#34;color: #198810&#34;&gt;lat&lt;/span&gt;&lt;span style=&#34;color: #198810&#34;&gt;&amp;#34;&lt;/span&gt;: &lt;span style=&#34;color: #4b69c6&#34;&gt;int&lt;/span&gt;,
            &lt;span style=&#34;color: #198810&#34;&gt;&amp;#34;&lt;/span&gt;&lt;span style=&#34;color: #198810&#34;&gt;lng&lt;/span&gt;&lt;span style=&#34;color: #198810&#34;&gt;&amp;#34;&lt;/span&gt;: &lt;span style=&#34;color: #4b69c6&#34;&gt;int&lt;/span&gt;,
        }
    )
    attribution: Dict[&lt;span style=&#34;color: #4b69c6&#34;&gt;str&lt;/span&gt;, &lt;span style=&#34;color: #4b69c6&#34;&gt;str&lt;/span&gt;] &lt;span style=&#34;color: #d73948&#34;&gt;=&lt;/span&gt; &lt;span style=&#34;color: #4b69c6&#34;&gt;field&lt;/span&gt;(
        default_factory&lt;span style=&#34;color: #d73948&#34;&gt;=&lt;/span&gt;&lt;span style=&#34;color: #d73948&#34;&gt;lambda&lt;/span&gt;: {
            &lt;span style=&#34;color: #198810&#34;&gt;&amp;#34;&lt;/span&gt;&lt;span style=&#34;color: #198810&#34;&gt;plain&lt;/span&gt;&lt;span style=&#34;color: #198810&#34;&gt;&amp;#34;&lt;/span&gt;: &lt;span style=&#34;color: #198810&#34;&gt;&amp;#34;&lt;/span&gt;&lt;span style=&#34;color: #198810&#34;&gt;&amp;#34;&lt;/span&gt;,
            &lt;span style=&#34;color: #198810&#34;&gt;&amp;#34;&lt;/span&gt;&lt;span style=&#34;color: #198810&#34;&gt;djot&lt;/span&gt;&lt;span style=&#34;color: #198810&#34;&gt;&amp;#34;&lt;/span&gt;: &lt;span style=&#34;color: #198810&#34;&gt;&amp;#34;&lt;/span&gt;&lt;span style=&#34;color: #198810&#34;&gt;&amp;#34;&lt;/span&gt;,
            &lt;span style=&#34;color: #198810&#34;&gt;&amp;#34;&lt;/span&gt;&lt;span style=&#34;color: #198810&#34;&gt;html&lt;/span&gt;&lt;span style=&#34;color: #198810&#34;&gt;&amp;#34;&lt;/span&gt;: &lt;span style=&#34;color: #198810&#34;&gt;&amp;#34;&lt;/span&gt;&lt;span style=&#34;color: #198810&#34;&gt;&amp;#34;&lt;/span&gt;,
        }
    )
    words: Dict[&lt;span style=&#34;color: #4b69c6&#34;&gt;str&lt;/span&gt;, Any] &lt;span style=&#34;color: #d73948&#34;&gt;=&lt;/span&gt; &lt;span style=&#34;color: #4b69c6&#34;&gt;field&lt;/span&gt;(
        default_factory&lt;span style=&#34;color: #d73948&#34;&gt;=&lt;/span&gt;&lt;span style=&#34;color: #d73948&#34;&gt;lambda&lt;/span&gt;: {
            &lt;span style=&#34;color: #198810&#34;&gt;&amp;#34;&lt;/span&gt;&lt;span style=&#34;color: #198810&#34;&gt;self&lt;/span&gt;&lt;span style=&#34;color: #198810&#34;&gt;&amp;#34;&lt;/span&gt;: &lt;span style=&#34;color: #b60157&#34;&gt;0&lt;/span&gt;,
            &lt;span style=&#34;color: #198810&#34;&gt;&amp;#34;&lt;/span&gt;&lt;span style=&#34;color: #198810&#34;&gt;code&lt;/span&gt;&lt;span style=&#34;color: #198810&#34;&gt;&amp;#34;&lt;/span&gt;: {
                &lt;span style=&#34;color: #198810&#34;&gt;&amp;#34;&lt;/span&gt;&lt;span style=&#34;color: #198810&#34;&gt;lines&lt;/span&gt;&lt;span style=&#34;color: #198810&#34;&gt;&amp;#34;&lt;/span&gt;: &lt;span style=&#34;color: #b60157&#34;&gt;0&lt;/span&gt;,
                &lt;span style=&#34;color: #198810&#34;&gt;&amp;#34;&lt;/span&gt;&lt;span style=&#34;color: #198810&#34;&gt;words&lt;/span&gt;&lt;span style=&#34;color: #198810&#34;&gt;&amp;#34;&lt;/span&gt;: &lt;span style=&#34;color: #b60157&#34;&gt;0&lt;/span&gt;,
            },
            &lt;span style=&#34;color: #198810&#34;&gt;&amp;#34;&lt;/span&gt;&lt;span style=&#34;color: #198810&#34;&gt;references&lt;/span&gt;&lt;span style=&#34;color: #198810&#34;&gt;&amp;#34;&lt;/span&gt;: &lt;span style=&#34;color: #b60157&#34;&gt;0&lt;/span&gt;,
        }
    )
    links: LinksDict &lt;span style=&#34;color: #d73948&#34;&gt;=&lt;/span&gt; &lt;span style=&#34;color: #4b69c6&#34;&gt;field&lt;/span&gt;(
        default_factory&lt;span style=&#34;color: #d73948&#34;&gt;=&lt;/span&gt;&lt;span style=&#34;color: #d73948&#34;&gt;lambda&lt;/span&gt;: {
            &lt;span style=&#34;color: #198810&#34;&gt;&amp;#34;&lt;/span&gt;&lt;span style=&#34;color: #198810&#34;&gt;internal&lt;/span&gt;&lt;span style=&#34;color: #198810&#34;&gt;&amp;#34;&lt;/span&gt;: &lt;span style=&#34;color: #4b69c6&#34;&gt;list&lt;/span&gt;(),
            &lt;span style=&#34;color: #198810&#34;&gt;&amp;#34;&lt;/span&gt;&lt;span style=&#34;color: #198810&#34;&gt;external&lt;/span&gt;&lt;span style=&#34;color: #198810&#34;&gt;&amp;#34;&lt;/span&gt;: &lt;span style=&#34;color: #4b69c6&#34;&gt;list&lt;/span&gt;(),
            &lt;span style=&#34;color: #198810&#34;&gt;&amp;#34;&lt;/span&gt;&lt;span style=&#34;color: #198810&#34;&gt;backlinks&lt;/span&gt;&lt;span style=&#34;color: #198810&#34;&gt;&amp;#34;&lt;/span&gt;: &lt;span style=&#34;color: #4b69c6&#34;&gt;list&lt;/span&gt;(),
        }
    )
    tags: List[&lt;span style=&#34;color: #4b69c6&#34;&gt;str&lt;/span&gt;] &lt;span style=&#34;color: #d73948&#34;&gt;=&lt;/span&gt; &lt;span style=&#34;color: #4b69c6&#34;&gt;field&lt;/span&gt;(default_factory&lt;span style=&#34;color: #d73948&#34;&gt;=&lt;/span&gt;&lt;span style=&#34;color: #4b69c6&#34;&gt;list&lt;/span&gt;)
    content: Dict[&lt;span style=&#34;color: #4b69c6&#34;&gt;str&lt;/span&gt;, &lt;span style=&#34;color: #4b69c6&#34;&gt;str&lt;/span&gt;] &lt;span style=&#34;color: #d73948&#34;&gt;=&lt;/span&gt; &lt;span style=&#34;color: #4b69c6&#34;&gt;field&lt;/span&gt;(default_factory&lt;span style=&#34;color: #d73948&#34;&gt;=&lt;/span&gt;&lt;span style=&#34;color: #4b69c6&#34;&gt;dict&lt;/span&gt;)

    &lt;span style=&#34;color: #d73948&#34;&gt;def&lt;/span&gt; &lt;span style=&#34;color: #4b69c6&#34;&gt;__post_init__&lt;/span&gt;(self):
        &lt;span style=&#34;color: #74747c&#34;&gt;#&lt;/span&gt;&lt;span style=&#34;color: #74747c&#34;&gt; Validate links dictionary structure&lt;/span&gt;
        required_link_types &lt;span style=&#34;color: #d73948&#34;&gt;=&lt;/span&gt; {&lt;span style=&#34;color: #198810&#34;&gt;&amp;#34;&lt;/span&gt;&lt;span style=&#34;color: #198810&#34;&gt;internal&lt;/span&gt;&lt;span style=&#34;color: #198810&#34;&gt;&amp;#34;&lt;/span&gt;, &lt;span style=&#34;color: #198810&#34;&gt;&amp;#34;&lt;/span&gt;&lt;span style=&#34;color: #198810&#34;&gt;external&lt;/span&gt;&lt;span style=&#34;color: #198810&#34;&gt;&amp;#34;&lt;/span&gt;, &lt;span style=&#34;color: #198810&#34;&gt;&amp;#34;&lt;/span&gt;&lt;span style=&#34;color: #198810&#34;&gt;backlinks&lt;/span&gt;&lt;span style=&#34;color: #198810&#34;&gt;&amp;#34;&lt;/span&gt;}
        &lt;span style=&#34;color: #d73948&#34;&gt;if&lt;/span&gt; (
            &lt;span style=&#34;color: #d73948&#34;&gt;not&lt;/span&gt; &lt;span style=&#34;color: #4b69c6&#34;&gt;isinstance&lt;/span&gt;(&lt;span style=&#34;color: #d73948&#34;&gt;self&lt;/span&gt;.links, &lt;span style=&#34;color: #4b69c6&#34;&gt;dict&lt;/span&gt;)
            &lt;span style=&#34;color: #d73948&#34;&gt;or&lt;/span&gt; &lt;span style=&#34;color: #4b69c6&#34;&gt;set&lt;/span&gt;(&lt;span style=&#34;color: #d73948&#34;&gt;self&lt;/span&gt;.links.&lt;span style=&#34;color: #4b69c6&#34;&gt;keys&lt;/span&gt;()) &lt;span style=&#34;color: #d73948&#34;&gt;!=&lt;/span&gt; required_link_types
        ):
            &lt;span style=&#34;color: #d73948&#34;&gt;raise&lt;/span&gt; &lt;span style=&#34;color: #4b69c6&#34;&gt;ValueError&lt;/span&gt;(
                &lt;span style=&#34;color: #d73948&#34;&gt;f&lt;/span&gt;&lt;span style=&#34;color: #198810&#34;&gt;&amp;#34;&lt;/span&gt;&lt;span style=&#34;color: #198810&#34;&gt;links must be a dictionary with exactly these keys: &lt;/span&gt;&lt;span style=&#34;color: #8b41b1&#34;&gt;{&lt;/span&gt;&lt;span style=&#34;color: #8b41b1&#34;&gt;required_link_types&lt;/span&gt;&lt;span style=&#34;color: #8b41b1&#34;&gt;}&lt;/span&gt;&lt;span style=&#34;color: #198810&#34;&gt;&amp;#34;&lt;/span&gt;
            )
        &lt;span style=&#34;color: #d73948&#34;&gt;for&lt;/span&gt; key &lt;span style=&#34;color: #d73948&#34;&gt;in&lt;/span&gt; &lt;span style=&#34;color: #d73948&#34;&gt;self&lt;/span&gt;.links:
            &lt;span style=&#34;color: #d73948&#34;&gt;if&lt;/span&gt; &lt;span style=&#34;color: #d73948&#34;&gt;not&lt;/span&gt; &lt;span style=&#34;color: #4b69c6&#34;&gt;isinstance&lt;/span&gt;(&lt;span style=&#34;color: #d73948&#34;&gt;self&lt;/span&gt;.links[key], &lt;span style=&#34;color: #4b69c6&#34;&gt;set&lt;/span&gt;):
                &lt;span style=&#34;color: #d73948&#34;&gt;self&lt;/span&gt;.links[key] &lt;span style=&#34;color: #d73948&#34;&gt;=&lt;/span&gt; &lt;span style=&#34;color: #4b69c6&#34;&gt;set&lt;/span&gt;(&lt;span style=&#34;color: #d73948&#34;&gt;self&lt;/span&gt;.links[key])
&lt;/code&gt;&lt;/pre&gt;&lt;/div&gt;&lt;p&gt;This turned up a couple of oversights in metadata for existing documents, and also encouraged me to restructure the final built metadata, see backlinks and wordcounting.&lt;/p&gt;&lt;p&gt;Speaking of backlinks, I coupled this work with my ongoing effort to make the building of the site completely deterministic. The builds already are deterministic in every way that matters. Same inputs make for the same output, except in one way: because documents are built asynchronously, it has been possible for the order of backlink references to change between builds. This doesn’t alter any functionality or correctness but does mean that the order of the backlinks in the hidden build summary of each page could change, and this makes diffing over the whole site to spot regressions more noisy, as many differences were not really differences at all.&lt;/p&gt;&lt;p&gt;Solving this turned out to be easy once I realised that a few pages kept seeing the order shift because they referenced pages that had the same publish (&lt;code&gt;available&lt;/code&gt;) date, which is the key for the sort order. With that remedied, determinism is assured.&lt;/p&gt;&lt;details&gt;&lt;summary&gt;For a glimpse at the surface area of the changes, click here to see a diff from implementing the first dataclass, though more changes have landed since.&lt;/summary&gt;&lt;div class=&#34;code-block&#34; data-lang=&#34;diff&#34;&gt;&lt;div class=&#34;code-header&#34; data-mosaic-chrome=&#34;&#34;&gt;&lt;span class=&#34;code-lang&#34;&gt;diff&lt;/span&gt;&lt;button class=&#34;code-copy&#34; aria-label=&#34;Copy code&#34; type=&#34;button&#34;&gt;Copy&lt;/button&gt;&lt;/div&gt;&lt;pre&gt;&lt;code data-lang=&#34;diff&#34;&gt; # Imports
 from collections import Counter
&lt;span style=&#34;color: #d73948&#34;&gt;-&lt;/span&gt;&lt;span style=&#34;color: #d73948&#34;&gt;from dataclasses import dataclass, field&lt;/span&gt;
&lt;span style=&#34;color: #198810&#34;&gt;+&lt;/span&gt;&lt;span style=&#34;color: #198810&#34;&gt;from dataclasses import dataclass, field, asdict&lt;/span&gt;
 from hashlib import md5
 from pathlib import Path
 from shutil import copyfile
 from subprocess import run
 from typing import List, Dict, Any, Tuple
&lt;span style=&#34;color: #198810&#34;&gt;+&lt;/span&gt;&lt;span style=&#34;color: #198810&#34;&gt;from typing_extensions import TypedDict&lt;/span&gt;
 import asyncio
 import datetime
 import logging
&lt;span style=&#34;color: #8b41b1&#34;&gt;@@&lt;/span&gt;&lt;span style=&#34;color: #8b41b1&#34;&gt; &lt;/span&gt;&lt;span style=&#34;color: #8b41b1&#34;&gt;-73,11 +74,11&lt;/span&gt;&lt;span style=&#34;color: #8b41b1&#34;&gt; &lt;/span&gt;&lt;span style=&#34;color: #8b41b1&#34;&gt;@@&lt;/span&gt;&lt;span style=&#34;color: #8b41b1&#34;&gt; &lt;/span&gt;&lt;strong&gt;&lt;span style=&#34;color: #4b69c6&#34;&gt;class SiteMetadata:&lt;/span&gt;&lt;/strong&gt;
     words: Dict[str, int] = field(
         default_factory=lambda: {&amp;#34;drafts&amp;#34;: 0, &amp;#34;references&amp;#34;: 0, &amp;#34;self&amp;#34;: 0}
     )
&lt;span style=&#34;color: #d73948&#34;&gt;-&lt;/span&gt;&lt;span style=&#34;color: #d73948&#34;&gt;    links: Dict[str, set] = field(&lt;/span&gt;
&lt;span style=&#34;color: #198810&#34;&gt;+&lt;/span&gt;&lt;span style=&#34;color: #198810&#34;&gt;    links: Dict[str, Any] = field(&lt;/span&gt;
         default_factory=lambda: {
&lt;span style=&#34;color: #d73948&#34;&gt;-&lt;/span&gt;&lt;span style=&#34;color: #d73948&#34;&gt;            &amp;#34;internal&amp;#34;: set(),&lt;/span&gt;
&lt;span style=&#34;color: #198810&#34;&gt;+&lt;/span&gt;&lt;span style=&#34;color: #198810&#34;&gt;            &amp;#34;internal&amp;#34;: list(),&lt;/span&gt;
&lt;span style=&#34;color: #198810&#34;&gt;+&lt;/span&gt;&lt;span style=&#34;color: #198810&#34;&gt;            &amp;#34;backlinks&amp;#34;: list(),&lt;/span&gt;
             &amp;#34;external&amp;#34;: set(),
&lt;span style=&#34;color: #d73948&#34;&gt;-&lt;/span&gt;&lt;span style=&#34;color: #d73948&#34;&gt;            &amp;#34;backlinks&amp;#34;: set(),&lt;/span&gt;
         }
     )
     pagecount: int = 0
&lt;span style=&#34;color: #8b41b1&#34;&gt;@@&lt;/span&gt;&lt;span style=&#34;color: #8b41b1&#34;&gt; &lt;/span&gt;&lt;span style=&#34;color: #8b41b1&#34;&gt;-91,9 +92,15&lt;/span&gt;&lt;span style=&#34;color: #8b41b1&#34;&gt; &lt;/span&gt;&lt;span style=&#34;color: #8b41b1&#34;&gt;@@&lt;/span&gt;&lt;span style=&#34;color: #8b41b1&#34;&gt; &lt;/span&gt;&lt;strong&gt;&lt;span style=&#34;color: #4b69c6&#34;&gt;class SiteMetadata:&lt;/span&gt;&lt;/strong&gt;
     slug_to_title_lookup: Dict[str, str] = field(default_factory=dict)


&lt;span style=&#34;color: #198810&#34;&gt;+&lt;/span&gt;&lt;span style=&#34;color: #198810&#34;&gt;class LinksDict(TypedDict):&lt;/span&gt;
&lt;span style=&#34;color: #198810&#34;&gt;+&lt;/span&gt;&lt;span style=&#34;color: #198810&#34;&gt;    internal: list[str]&lt;/span&gt;
&lt;span style=&#34;color: #198810&#34;&gt;+&lt;/span&gt;&lt;span style=&#34;color: #198810&#34;&gt;    external: list[str]&lt;/span&gt;
&lt;span style=&#34;color: #198810&#34;&gt;+&lt;/span&gt;&lt;span style=&#34;color: #198810&#34;&gt;    backlinks: list[str]&lt;/span&gt;
&lt;span style=&#34;color: #198810&#34;&gt;+&lt;/span&gt;
&lt;span style=&#34;color: #198810&#34;&gt;+&lt;/span&gt;
 \@dataclass
 class DocumentMetadata:
&lt;span style=&#34;color: #d73948&#34;&gt;-&lt;/span&gt;&lt;span style=&#34;color: #d73948&#34;&gt;    filename: Path&lt;/span&gt;
&lt;span style=&#34;color: #198810&#34;&gt;+&lt;/span&gt;&lt;span style=&#34;color: #198810&#34;&gt;    filepath: Path&lt;/span&gt;
     uid: str
     slug: str
     created: datetime.datetime
&lt;span style=&#34;color: #8b41b1&#34;&gt;@@&lt;/span&gt;&lt;span style=&#34;color: #8b41b1&#34;&gt; &lt;/span&gt;&lt;span style=&#34;color: #8b41b1&#34;&gt;-102,20 +109,78&lt;/span&gt;&lt;span style=&#34;color: #8b41b1&#34;&gt; &lt;/span&gt;&lt;span style=&#34;color: #8b41b1&#34;&gt;@@&lt;/span&gt;&lt;span style=&#34;color: #8b41b1&#34;&gt; &lt;/span&gt;&lt;strong&gt;&lt;span style=&#34;color: #4b69c6&#34;&gt;class DocumentMetadata:&lt;/span&gt;&lt;/strong&gt;
     title: str
     primary: str
     secondary: str
&lt;span style=&#34;color: #198810&#34;&gt;+&lt;/span&gt;&lt;span style=&#34;color: #198810&#34;&gt;    creator: str = &amp;#34;&amp;#34;&lt;/span&gt;
&lt;span style=&#34;color: #198810&#34;&gt;+&lt;/span&gt;&lt;span style=&#34;color: #198810&#34;&gt;    note: str = &amp;#34;&amp;#34;&lt;/span&gt;
&lt;span style=&#34;color: #198810&#34;&gt;+&lt;/span&gt;&lt;span style=&#34;color: #198810&#34;&gt;    favourite: bool = False&lt;/span&gt;
&lt;span style=&#34;color: #198810&#34;&gt;+&lt;/span&gt;&lt;span style=&#34;color: #198810&#34;&gt;    parent: str = &amp;#34;&amp;#34;&lt;/span&gt;
&lt;span style=&#34;color: #198810&#34;&gt;+&lt;/span&gt;&lt;span style=&#34;color: #198810&#34;&gt;    description: str = &amp;#34;&amp;#34;&lt;/span&gt;
&lt;span style=&#34;color: #198810&#34;&gt;+&lt;/span&gt;&lt;span style=&#34;color: #198810&#34;&gt;    layout: str = TEMPLATE_DEFAULT&lt;/span&gt;
&lt;span style=&#34;color: #198810&#34;&gt;+&lt;/span&gt;&lt;span style=&#34;color: #198810&#34;&gt;    source: Dict = field(default_factory=dict)&lt;/span&gt;
&lt;span style=&#34;color: #198810&#34;&gt;+&lt;/span&gt;&lt;span style=&#34;color: #198810&#34;&gt;    via: Dict = field(default_factory=dict)&lt;/span&gt;
&lt;span style=&#34;color: #198810&#34;&gt;+&lt;/span&gt;&lt;span style=&#34;color: #198810&#34;&gt;    location: Dict = field(default_factory=dict)&lt;/span&gt;
&lt;span style=&#34;color: #198810&#34;&gt;+&lt;/span&gt;&lt;span style=&#34;color: #198810&#34;&gt;    collection: Dict[str, Any] = field(&lt;/span&gt;
&lt;span style=&#34;color: #198810&#34;&gt;+&lt;/span&gt;&lt;span style=&#34;color: #198810&#34;&gt;        default_factory=lambda: {&lt;/span&gt;
&lt;span style=&#34;color: #198810&#34;&gt;+&lt;/span&gt;&lt;span style=&#34;color: #198810&#34;&gt;            &amp;#34;style&amp;#34;: &amp;#34;title&amp;#34;,&lt;/span&gt;
&lt;span style=&#34;color: #198810&#34;&gt;+&lt;/span&gt;&lt;span style=&#34;color: #198810&#34;&gt;            &amp;#34;order&amp;#34;: &amp;#34;chronological&amp;#34;,&lt;/span&gt;
&lt;span style=&#34;color: #198810&#34;&gt;+&lt;/span&gt;&lt;span style=&#34;color: #198810&#34;&gt;            &amp;#34;include&amp;#34;: [],&lt;/span&gt;
&lt;span style=&#34;color: #198810&#34;&gt;+&lt;/span&gt;&lt;span style=&#34;color: #198810&#34;&gt;        }&lt;/span&gt;
&lt;span style=&#34;color: #198810&#34;&gt;+&lt;/span&gt;&lt;span style=&#34;color: #198810&#34;&gt;    )&lt;/span&gt;
&lt;span style=&#34;color: #198810&#34;&gt;+&lt;/span&gt;&lt;span style=&#34;color: #198810&#34;&gt;    attribution: Dict[str, str] = field(&lt;/span&gt;
&lt;span style=&#34;color: #198810&#34;&gt;+&lt;/span&gt;&lt;span style=&#34;color: #198810&#34;&gt;        default_factory=lambda: {&lt;/span&gt;
&lt;span style=&#34;color: #198810&#34;&gt;+&lt;/span&gt;&lt;span style=&#34;color: #198810&#34;&gt;            &amp;#34;plain&amp;#34;: &amp;#34;&amp;#34;,&lt;/span&gt;
&lt;span style=&#34;color: #198810&#34;&gt;+&lt;/span&gt;&lt;span style=&#34;color: #198810&#34;&gt;            &amp;#34;djot&amp;#34;: &amp;#34;&amp;#34;,&lt;/span&gt;
&lt;span style=&#34;color: #198810&#34;&gt;+&lt;/span&gt;&lt;span style=&#34;color: #198810&#34;&gt;            &amp;#34;html&amp;#34;: &amp;#34;&amp;#34;,&lt;/span&gt;
&lt;span style=&#34;color: #198810&#34;&gt;+&lt;/span&gt;&lt;span style=&#34;color: #198810&#34;&gt;        }&lt;/span&gt;
&lt;span style=&#34;color: #198810&#34;&gt;+&lt;/span&gt;&lt;span style=&#34;color: #198810&#34;&gt;    )&lt;/span&gt;
&lt;span style=&#34;color: #198810&#34;&gt;+&lt;/span&gt;&lt;span style=&#34;color: #198810&#34;&gt;    media: str = &amp;#34;application/toml&amp;#34;&lt;/span&gt;
     words: int = 0
&lt;span style=&#34;color: #d73948&#34;&gt;-&lt;/span&gt;&lt;span style=&#34;color: #d73948&#34;&gt;    links: Dict[str, set] = field(&lt;/span&gt;
&lt;span style=&#34;color: #198810&#34;&gt;+&lt;/span&gt;&lt;span style=&#34;color: #198810&#34;&gt;    status: str = &amp;#34;&amp;#34;&lt;/span&gt;
&lt;span style=&#34;color: #198810&#34;&gt;+&lt;/span&gt;&lt;span style=&#34;color: #198810&#34;&gt;    links: LinksDict = field(&lt;/span&gt;
         default_factory=lambda: {
&lt;span style=&#34;color: #d73948&#34;&gt;-&lt;/span&gt;&lt;span style=&#34;color: #d73948&#34;&gt;            &amp;#34;internal&amp;#34;: set(),&lt;/span&gt;
&lt;span style=&#34;color: #d73948&#34;&gt;-&lt;/span&gt;&lt;span style=&#34;color: #d73948&#34;&gt;            &amp;#34;external&amp;#34;: set(),&lt;/span&gt;
&lt;span style=&#34;color: #d73948&#34;&gt;-&lt;/span&gt;&lt;span style=&#34;color: #d73948&#34;&gt;            &amp;#34;backlinks&amp;#34;: set(),&lt;/span&gt;
&lt;span style=&#34;color: #198810&#34;&gt;+&lt;/span&gt;&lt;span style=&#34;color: #198810&#34;&gt;            &amp;#34;internal&amp;#34;: list(),&lt;/span&gt;
&lt;span style=&#34;color: #198810&#34;&gt;+&lt;/span&gt;&lt;span style=&#34;color: #198810&#34;&gt;            &amp;#34;external&amp;#34;: list(),&lt;/span&gt;
&lt;span style=&#34;color: #198810&#34;&gt;+&lt;/span&gt;&lt;span style=&#34;color: #198810&#34;&gt;            &amp;#34;backlinks&amp;#34;: list(),&lt;/span&gt;
         }
     )
     options: List[str] = field(default_factory=list)
     tags: List[str] = field(default_factory=list)
&lt;span style=&#34;color: #d73948&#34;&gt;-&lt;/span&gt;&lt;span style=&#34;color: #d73948&#34;&gt;    interlinks: List[str] = field(default_factory=list)&lt;/span&gt;
&lt;span style=&#34;color: #d73948&#34;&gt;-&lt;/span&gt;&lt;span style=&#34;color: #d73948&#34;&gt;    backlinks: List[str] = field(default_factory=list)&lt;/span&gt;
     content: Dict[str, str] = field(default_factory=dict)
&lt;span style=&#34;color: #d73948&#34;&gt;-&lt;/span&gt;&lt;span style=&#34;color: #d73948&#34;&gt;    html: str = &amp;#34;&amp;#34;&lt;/span&gt;
&lt;span style=&#34;color: #198810&#34;&gt;+&lt;/span&gt;
&lt;span style=&#34;color: #198810&#34;&gt;+&lt;/span&gt;&lt;span style=&#34;color: #198810&#34;&gt;    def __post_init__(self):&lt;/span&gt;
&lt;span style=&#34;color: #198810&#34;&gt;+&lt;/span&gt;&lt;span style=&#34;color: #198810&#34;&gt;        # Validate required string fields are not empty&lt;/span&gt;
&lt;span style=&#34;color: #198810&#34;&gt;+&lt;/span&gt;&lt;span style=&#34;color: #198810&#34;&gt;        # for field_name in [&amp;#34;uid&amp;#34;, &amp;#34;slug&amp;#34;, &amp;#34;title&amp;#34;, &amp;#34;primary&amp;#34;, &amp;#34;secondary&amp;#34;]:&lt;/span&gt;
&lt;span style=&#34;color: #198810&#34;&gt;+&lt;/span&gt;&lt;span style=&#34;color: #198810&#34;&gt;        #    value = getattr(self, field_name)&lt;/span&gt;
&lt;span style=&#34;color: #198810&#34;&gt;+&lt;/span&gt;&lt;span style=&#34;color: #198810&#34;&gt;        #    if not isinstance(value, str) or not value.strip():&lt;/span&gt;
&lt;span style=&#34;color: #198810&#34;&gt;+&lt;/span&gt;&lt;span style=&#34;color: #198810&#34;&gt;        #        raise ValueError(f&amp;#34;\n\n{self}\n\n{field_name} {value} must be a non-empty string&amp;#34;\n)&lt;/span&gt;
&lt;span style=&#34;color: #198810&#34;&gt;+&lt;/span&gt;
&lt;span style=&#34;color: #198810&#34;&gt;+&lt;/span&gt;&lt;span style=&#34;color: #198810&#34;&gt;        # Validate filepath is a Path object&lt;/span&gt;
&lt;span style=&#34;color: #198810&#34;&gt;+&lt;/span&gt;&lt;span style=&#34;color: #198810&#34;&gt;        if not isinstance(self.filepath, Path):&lt;/span&gt;
&lt;span style=&#34;color: #198810&#34;&gt;+&lt;/span&gt;&lt;span style=&#34;color: #198810&#34;&gt;            self.filepath = Path(self.filepath)&lt;/span&gt;
&lt;span style=&#34;color: #198810&#34;&gt;+&lt;/span&gt;
&lt;span style=&#34;color: #198810&#34;&gt;+&lt;/span&gt;&lt;span style=&#34;color: #198810&#34;&gt;        ## Validate datetime fields&lt;/span&gt;
&lt;span style=&#34;color: #198810&#34;&gt;+&lt;/span&gt;&lt;span style=&#34;color: #198810&#34;&gt;        # for field_name in [&amp;#34;created&amp;#34;, &amp;#34;updated&amp;#34;, &amp;#34;available&amp;#34;]:&lt;/span&gt;
&lt;span style=&#34;color: #198810&#34;&gt;+&lt;/span&gt;&lt;span style=&#34;color: #198810&#34;&gt;        #    value = getattr(self, field_name)&lt;/span&gt;
&lt;span style=&#34;color: #198810&#34;&gt;+&lt;/span&gt;&lt;span style=&#34;color: #198810&#34;&gt;        #    if not isinstance(value, datetime.datetime):&lt;/span&gt;
&lt;span style=&#34;color: #198810&#34;&gt;+&lt;/span&gt;&lt;span style=&#34;color: #198810&#34;&gt;        #        raise ValueError(f&amp;#34;{field_name} must be a datetime object&amp;#34;)&lt;/span&gt;
&lt;span style=&#34;color: #198810&#34;&gt;+&lt;/span&gt;&lt;span style=&#34;color: #198810&#34;&gt;        #    # Ensure timezone is None&lt;/span&gt;
&lt;span style=&#34;color: #198810&#34;&gt;+&lt;/span&gt;&lt;span style=&#34;color: #198810&#34;&gt;        #    setattr(self, field_name, value.replace(tzinfo=None))&lt;/span&gt;
&lt;span style=&#34;color: #198810&#34;&gt;+&lt;/span&gt;
&lt;span style=&#34;color: #198810&#34;&gt;+&lt;/span&gt;&lt;span style=&#34;color: #198810&#34;&gt;        # Validate words is non-negative&lt;/span&gt;
&lt;span style=&#34;color: #198810&#34;&gt;+&lt;/span&gt;&lt;span style=&#34;color: #198810&#34;&gt;        if not isinstance(self.words, int) or self.words &amp;lt; 0:&lt;/span&gt;
&lt;span style=&#34;color: #198810&#34;&gt;+&lt;/span&gt;&lt;span style=&#34;color: #198810&#34;&gt;            raise ValueError(&amp;#34;words must be a non-negative integer&amp;#34;)&lt;/span&gt;
&lt;span style=&#34;color: #198810&#34;&gt;+&lt;/span&gt;
&lt;span style=&#34;color: #198810&#34;&gt;+&lt;/span&gt;&lt;span style=&#34;color: #198810&#34;&gt;        # Validate links dictionary structure&lt;/span&gt;
&lt;span style=&#34;color: #198810&#34;&gt;+&lt;/span&gt;&lt;span style=&#34;color: #198810&#34;&gt;        required_link_types = {&amp;#34;internal&amp;#34;, &amp;#34;external&amp;#34;, &amp;#34;backlinks&amp;#34;}&lt;/span&gt;
&lt;span style=&#34;color: #198810&#34;&gt;+&lt;/span&gt;&lt;span style=&#34;color: #198810&#34;&gt;        if (&lt;/span&gt;
&lt;span style=&#34;color: #198810&#34;&gt;+&lt;/span&gt;&lt;span style=&#34;color: #198810&#34;&gt;            not isinstance(self.links, dict)&lt;/span&gt;
&lt;span style=&#34;color: #198810&#34;&gt;+&lt;/span&gt;&lt;span style=&#34;color: #198810&#34;&gt;            or set(self.links.keys()) != required_link_types&lt;/span&gt;
&lt;span style=&#34;color: #198810&#34;&gt;+&lt;/span&gt;&lt;span style=&#34;color: #198810&#34;&gt;        ):&lt;/span&gt;
&lt;span style=&#34;color: #198810&#34;&gt;+&lt;/span&gt;&lt;span style=&#34;color: #198810&#34;&gt;            raise ValueError(&lt;/span&gt;
&lt;span style=&#34;color: #198810&#34;&gt;+&lt;/span&gt;&lt;span style=&#34;color: #198810&#34;&gt;                f&amp;#34;links must be a dictionary with exactly these keys: {required_link_types}&amp;#34;&lt;/span&gt;
&lt;span style=&#34;color: #198810&#34;&gt;+&lt;/span&gt;&lt;span style=&#34;color: #198810&#34;&gt;            )&lt;/span&gt;
&lt;span style=&#34;color: #198810&#34;&gt;+&lt;/span&gt;&lt;span style=&#34;color: #198810&#34;&gt;        for key in self.links:&lt;/span&gt;
&lt;span style=&#34;color: #198810&#34;&gt;+&lt;/span&gt;&lt;span style=&#34;color: #198810&#34;&gt;            if not isinstance(self.links[key], set):&lt;/span&gt;
&lt;span style=&#34;color: #198810&#34;&gt;+&lt;/span&gt;&lt;span style=&#34;color: #198810&#34;&gt;                self.links[key] = set(self.links[key])&lt;/span&gt;


 def init_site():
&lt;span style=&#34;color: #8b41b1&#34;&gt;@@&lt;/span&gt;&lt;span style=&#34;color: #8b41b1&#34;&gt; &lt;/span&gt;&lt;span style=&#34;color: #8b41b1&#34;&gt;-132,12 +197,47&lt;/span&gt;&lt;span style=&#34;color: #8b41b1&#34;&gt; &lt;/span&gt;&lt;span style=&#34;color: #8b41b1&#34;&gt;@@&lt;/span&gt;&lt;span style=&#34;color: #8b41b1&#34;&gt; &lt;/span&gt;&lt;strong&gt;&lt;span style=&#34;color: #4b69c6&#34;&gt;def init_site():&lt;/span&gt;&lt;/strong&gt;
     )


&lt;span style=&#34;color: #d73948&#34;&gt;-&lt;/span&gt;&lt;span style=&#34;color: #d73948&#34;&gt;def load_assets():&lt;/span&gt;
&lt;span style=&#34;color: #198810&#34;&gt;+&lt;/span&gt;&lt;span style=&#34;color: #198810&#34;&gt;def preprocess_asset_metadata(&lt;/span&gt;
&lt;span style=&#34;color: #198810&#34;&gt;+&lt;/span&gt;&lt;span style=&#34;color: #198810&#34;&gt;    uid: str, asset_data: Dict[str, Any], manifest_path: Path&lt;/span&gt;
&lt;span style=&#34;color: #198810&#34;&gt;+&lt;/span&gt;&lt;span style=&#34;color: #198810&#34;&gt;) -&amp;gt; Dict[str, Any]:&lt;/span&gt;
&lt;span style=&#34;color: #198810&#34;&gt;+&lt;/span&gt;&lt;span style=&#34;color: #198810&#34;&gt;    &amp;#34;&amp;#34;&amp;#34;Preprocess asset metadata to ensure it meets DocumentMetadata requirements.&amp;#34;&amp;#34;&amp;#34;&lt;/span&gt;
&lt;span style=&#34;color: #198810&#34;&gt;+&lt;/span&gt;&lt;span style=&#34;color: #198810&#34;&gt;    processed = asset_data.copy()&lt;/span&gt;
&lt;span style=&#34;color: #198810&#34;&gt;+&lt;/span&gt;
&lt;span style=&#34;color: #198810&#34;&gt;+&lt;/span&gt;&lt;span style=&#34;color: #198810&#34;&gt;    # Handle dates&lt;/span&gt;
&lt;span style=&#34;color: #198810&#34;&gt;+&lt;/span&gt;&lt;span style=&#34;color: #198810&#34;&gt;    for date_field in [&amp;#34;created&amp;#34;, &amp;#34;updated&amp;#34;, &amp;#34;available&amp;#34;]:&lt;/span&gt;
&lt;span style=&#34;color: #198810&#34;&gt;+&lt;/span&gt;&lt;span style=&#34;color: #198810&#34;&gt;        if isinstance(processed.get(date_field), str):&lt;/span&gt;
&lt;span style=&#34;color: #198810&#34;&gt;+&lt;/span&gt;&lt;span style=&#34;color: #198810&#34;&gt;            processed[date_field] = _parse_date(processed[date_field])&lt;/span&gt;
&lt;span style=&#34;color: #198810&#34;&gt;+&lt;/span&gt;&lt;span style=&#34;color: #198810&#34;&gt;        elif isinstance(processed.get(date_field), datetime.datetime):&lt;/span&gt;
&lt;span style=&#34;color: #198810&#34;&gt;+&lt;/span&gt;&lt;span style=&#34;color: #198810&#34;&gt;            processed[date_field] = processed[date_field].replace(tzinfo=None)&lt;/span&gt;
&lt;span style=&#34;color: #198810&#34;&gt;+&lt;/span&gt;&lt;span style=&#34;color: #198810&#34;&gt;        else:&lt;/span&gt;
&lt;span style=&#34;color: #198810&#34;&gt;+&lt;/span&gt;&lt;span style=&#34;color: #198810&#34;&gt;            processed[date_field] = datetime.datetime.now()&lt;/span&gt;
&lt;span style=&#34;color: #198810&#34;&gt;+&lt;/span&gt;
&lt;span style=&#34;color: #198810&#34;&gt;+&lt;/span&gt;&lt;span style=&#34;color: #198810&#34;&gt;    # Set required fields with defaults if not present&lt;/span&gt;
&lt;span style=&#34;color: #198810&#34;&gt;+&lt;/span&gt;&lt;span style=&#34;color: #198810&#34;&gt;    processed.setdefault(&amp;#34;uid&amp;#34;, uid)&lt;/span&gt;
&lt;span style=&#34;color: #198810&#34;&gt;+&lt;/span&gt;&lt;span style=&#34;color: #198810&#34;&gt;    processed.setdefault(&amp;#34;primary&amp;#34;, &amp;#34;asset&amp;#34;)&lt;/span&gt;
&lt;span style=&#34;color: #198810&#34;&gt;+&lt;/span&gt;&lt;span style=&#34;color: #198810&#34;&gt;    processed.setdefault(&amp;#34;secondary&amp;#34;, processed[&amp;#34;media&amp;#34;])&lt;/span&gt;
&lt;span style=&#34;color: #198810&#34;&gt;+&lt;/span&gt;
&lt;span style=&#34;color: #198810&#34;&gt;+&lt;/span&gt;&lt;span style=&#34;color: #198810&#34;&gt;    return processed&lt;/span&gt;
&lt;span style=&#34;color: #198810&#34;&gt;+&lt;/span&gt;
&lt;span style=&#34;color: #198810&#34;&gt;+&lt;/span&gt;
&lt;span style=&#34;color: #198810&#34;&gt;+&lt;/span&gt;&lt;span style=&#34;color: #198810&#34;&gt;def load_assets() -&amp;gt; Dict[str, DocumentMetadata]:&lt;/span&gt;
&lt;span style=&#34;color: #198810&#34;&gt;+&lt;/span&gt;&lt;span style=&#34;color: #198810&#34;&gt;    &amp;#34;&amp;#34;&amp;#34;Load asset manifests and convert them to DocumentMetadata instances.&amp;#34;&amp;#34;&amp;#34;&lt;/span&gt;
     assets = {}
     asset_manifests = list(ASSET_DIR.glob(&amp;#34;manifests/*.toml&amp;#34;))
&lt;span style=&#34;color: #198810&#34;&gt;+&lt;/span&gt;
     for manifest in asset_manifests:
         with open(manifest, &amp;#34;rb&amp;#34;) as f:
&lt;span style=&#34;color: #d73948&#34;&gt;-&lt;/span&gt;&lt;span style=&#34;color: #d73948&#34;&gt;            assets.update(tomllib.load(f))&lt;/span&gt;
&lt;span style=&#34;color: #198810&#34;&gt;+&lt;/span&gt;&lt;span style=&#34;color: #198810&#34;&gt;            manifest_data = tomllib.load(f)&lt;/span&gt;
&lt;span style=&#34;color: #198810&#34;&gt;+&lt;/span&gt;
&lt;span style=&#34;color: #198810&#34;&gt;+&lt;/span&gt;&lt;span style=&#34;color: #198810&#34;&gt;        for uid, asset_data in manifest_data.items():&lt;/span&gt;
&lt;span style=&#34;color: #198810&#34;&gt;+&lt;/span&gt;&lt;span style=&#34;color: #198810&#34;&gt;            try:&lt;/span&gt;
&lt;span style=&#34;color: #198810&#34;&gt;+&lt;/span&gt;&lt;span style=&#34;color: #198810&#34;&gt;                processed_data = preprocess_asset_metadata(uid, asset_data, manifest)&lt;/span&gt;
&lt;span style=&#34;color: #198810&#34;&gt;+&lt;/span&gt;&lt;span style=&#34;color: #198810&#34;&gt;                processed_data[&amp;#34;filepath&amp;#34;] = ASSET_DIR / processed_data[&amp;#34;filepath&amp;#34;]&lt;/span&gt;
&lt;span style=&#34;color: #198810&#34;&gt;+&lt;/span&gt;&lt;span style=&#34;color: #198810&#34;&gt;                assets[uid] = DocumentMetadata(**processed_data)&lt;/span&gt;
&lt;span style=&#34;color: #198810&#34;&gt;+&lt;/span&gt;&lt;span style=&#34;color: #198810&#34;&gt;            except Exception as e:&lt;/span&gt;
&lt;span style=&#34;color: #198810&#34;&gt;+&lt;/span&gt;&lt;span style=&#34;color: #198810&#34;&gt;                print(f&amp;#34;Error processing asset {uid} from {manifest}: {str(e)}&amp;#34;)&lt;/span&gt;
&lt;span style=&#34;color: #198810&#34;&gt;+&lt;/span&gt;&lt;span style=&#34;color: #198810&#34;&gt;                continue&lt;/span&gt;
&lt;span style=&#34;color: #198810&#34;&gt;+&lt;/span&gt;
     return assets


&lt;span style=&#34;color: #8b41b1&#34;&gt;@@&lt;/span&gt;&lt;span style=&#34;color: #8b41b1&#34;&gt; &lt;/span&gt;&lt;span style=&#34;color: #8b41b1&#34;&gt;-176,7 +276,7&lt;/span&gt;&lt;span style=&#34;color: #8b41b1&#34;&gt; &lt;/span&gt;&lt;span style=&#34;color: #8b41b1&#34;&gt;@@&lt;/span&gt;&lt;span style=&#34;color: #8b41b1&#34;&gt; &lt;/span&gt;&lt;strong&gt;&lt;span style=&#34;color: #4b69c6&#34;&gt;def get_files() -&amp;gt; List[Path]:&lt;/span&gt;&lt;/strong&gt;
     return [f for f in NOTES_DIR.glob(&amp;#34;**/*.md&amp;#34;) if &amp;#34;available = &amp;#34; in f.read_text()]


&lt;span style=&#34;color: #d73948&#34;&gt;-&lt;/span&gt;&lt;span style=&#34;color: #d73948&#34;&gt;def extract_external_links(text: str) -&amp;gt; List:&lt;/span&gt;
&lt;span style=&#34;color: #198810&#34;&gt;+&lt;/span&gt;&lt;span style=&#34;color: #198810&#34;&gt;def extract_external_links(text: str, site) -&amp;gt; List:&lt;/span&gt;
     url_pattern = r&amp;#34;(https?://(?:[-\w.]|(?:%[\da-fA-F]{2}))+(?:/[^)\s]*)?)&amp;#34;
     matches = re.findall(url_pattern, text)

&lt;span style=&#34;color: #8b41b1&#34;&gt;@@&lt;/span&gt;&lt;span style=&#34;color: #8b41b1&#34;&gt; &lt;/span&gt;&lt;span style=&#34;color: #8b41b1&#34;&gt;-186,18 +286,21&lt;/span&gt;&lt;span style=&#34;color: #8b41b1&#34;&gt; &lt;/span&gt;&lt;span style=&#34;color: #8b41b1&#34;&gt;@@&lt;/span&gt;&lt;span style=&#34;color: #8b41b1&#34;&gt; &lt;/span&gt;&lt;strong&gt;&lt;span style=&#34;color: #4b69c6&#34;&gt;def extract_external_links(text: str) -&amp;gt; List:&lt;/span&gt;&lt;/strong&gt;
         parsed_url = urlparse(url)
         if parsed_url.netloc.lower() != &amp;#34;silasjelley.com&amp;#34;:
             external_links.add(url)
&lt;span style=&#34;color: #198810&#34;&gt;+&lt;/span&gt;&lt;span style=&#34;color: #198810&#34;&gt;            site.links[&amp;#34;external&amp;#34;].add(url)&lt;/span&gt;

&lt;span style=&#34;color: #d73948&#34;&gt;-&lt;/span&gt;&lt;span style=&#34;color: #d73948&#34;&gt;    return list(external_links)&lt;/span&gt;
&lt;span style=&#34;color: #198810&#34;&gt;+&lt;/span&gt;&lt;span style=&#34;color: #198810&#34;&gt;    return sorted(external_links)&lt;/span&gt;


 async def process_document(
&lt;span style=&#34;color: #d73948&#34;&gt;-&lt;/span&gt;&lt;span style=&#34;color: #d73948&#34;&gt;    filename: Path, site: SiteMetadata&lt;/span&gt;
&lt;span style=&#34;color: #d73948&#34;&gt;-&lt;/span&gt;&lt;span style=&#34;color: #d73948&#34;&gt;) -&amp;gt; Tuple[str, Dict[str, Any]]:&lt;/span&gt;
&lt;span style=&#34;color: #d73948&#34;&gt;-&lt;/span&gt;&lt;span style=&#34;color: #d73948&#34;&gt;    with open(filename, &amp;#34;rb&amp;#34;) as f:&lt;/span&gt;
&lt;span style=&#34;color: #198810&#34;&gt;+&lt;/span&gt;&lt;span style=&#34;color: #198810&#34;&gt;    filepath: Path, site: SiteMetadata&lt;/span&gt;
&lt;span style=&#34;color: #198810&#34;&gt;+&lt;/span&gt;&lt;span style=&#34;color: #198810&#34;&gt;) -&amp;gt; Tuple[str, DocumentMetadata]:&lt;/span&gt;
&lt;span style=&#34;color: #198810&#34;&gt;+&lt;/span&gt;&lt;span style=&#34;color: #198810&#34;&gt;    &amp;#34;&amp;#34;&amp;#34;Process a document file and return its UID and metadata.&amp;#34;&amp;#34;&amp;#34;&lt;/span&gt;
&lt;span style=&#34;color: #198810&#34;&gt;+&lt;/span&gt;
&lt;span style=&#34;color: #198810&#34;&gt;+&lt;/span&gt;&lt;span style=&#34;color: #198810&#34;&gt;    with open(filepath, &amp;#34;rb&amp;#34;) as f:&lt;/span&gt;
         try:
             parsed_toml = tomllib.load(f)
         except:
&lt;span style=&#34;color: #d73948&#34;&gt;-&lt;/span&gt;&lt;span style=&#34;color: #d73948&#34;&gt;            print(filename)&lt;/span&gt;
&lt;span style=&#34;color: #198810&#34;&gt;+&lt;/span&gt;&lt;span style=&#34;color: #198810&#34;&gt;            print(filepath)&lt;/span&gt;
             import sys

             sys.exit(1)
&lt;span style=&#34;color: #8b41b1&#34;&gt;@@&lt;/span&gt;&lt;span style=&#34;color: #8b41b1&#34;&gt; &lt;/span&gt;&lt;span style=&#34;color: #8b41b1&#34;&gt;-205,52 +308,48&lt;/span&gt;&lt;span style=&#34;color: #8b41b1&#34;&gt; &lt;/span&gt;&lt;span style=&#34;color: #8b41b1&#34;&gt;@@&lt;/span&gt;&lt;span style=&#34;color: #8b41b1&#34;&gt; &lt;/span&gt;&lt;strong&gt;&lt;span style=&#34;color: #4b69c6&#34;&gt;async def process_document(&lt;/span&gt;&lt;/strong&gt;
     # The UID is now the top-level table name
     uid = parsed_toml[&amp;#34;uid&amp;#34;]

&lt;span style=&#34;color: #d73948&#34;&gt;-&lt;/span&gt;&lt;span style=&#34;color: #d73948&#34;&gt;    # Preprocess metadata (assuming this function exists and works with the new format)&lt;/span&gt;
&lt;span style=&#34;color: #d73948&#34;&gt;-&lt;/span&gt;&lt;span style=&#34;color: #d73948&#34;&gt;    document = preprocess_metadata(filename, parsed_toml)&lt;/span&gt;
&lt;span style=&#34;color: #198810&#34;&gt;+&lt;/span&gt;&lt;span style=&#34;color: #198810&#34;&gt;    # Process metadata into DocumentMetadata instance&lt;/span&gt;
&lt;span style=&#34;color: #198810&#34;&gt;+&lt;/span&gt;&lt;span style=&#34;color: #198810&#34;&gt;    document = preprocess_metadata(filepath, parsed_toml)&lt;/span&gt;

     # Calculate and update word counts
     try:
&lt;span style=&#34;color: #d73948&#34;&gt;-&lt;/span&gt;&lt;span style=&#34;color: #d73948&#34;&gt;        document[&amp;#34;words&amp;#34;] = len(document[&amp;#34;content&amp;#34;][&amp;#34;plain&amp;#34;].split())&lt;/span&gt;
&lt;span style=&#34;color: #198810&#34;&gt;+&lt;/span&gt;&lt;span style=&#34;color: #198810&#34;&gt;        document.words = len(document.content.get(&amp;#34;plain&amp;#34;, &amp;#34;&amp;#34;).split())&lt;/span&gt;
     except:
&lt;span style=&#34;color: #d73948&#34;&gt;-&lt;/span&gt;&lt;span style=&#34;color: #d73948&#34;&gt;        document[&amp;#34;words&amp;#34;] = 0&lt;/span&gt;
&lt;span style=&#34;color: #198810&#34;&gt;+&lt;/span&gt;&lt;span style=&#34;color: #198810&#34;&gt;        document.words = 0&lt;/span&gt;

&lt;span style=&#34;color: #d73948&#34;&gt;-&lt;/span&gt;&lt;span style=&#34;color: #d73948&#34;&gt;    if document.get(&amp;#34;status&amp;#34;, &amp;#34;&amp;#34;) == &amp;#34;draft&amp;#34;:&lt;/span&gt;
&lt;span style=&#34;color: #d73948&#34;&gt;-&lt;/span&gt;&lt;span style=&#34;color: #d73948&#34;&gt;        site.words[&amp;#34;drafts&amp;#34;] += document[&amp;#34;words&amp;#34;]&lt;/span&gt;
&lt;span style=&#34;color: #198810&#34;&gt;+&lt;/span&gt;&lt;span style=&#34;color: #198810&#34;&gt;    if document.status == &amp;#34;draft&amp;#34;:&lt;/span&gt;
&lt;span style=&#34;color: #198810&#34;&gt;+&lt;/span&gt;&lt;span style=&#34;color: #198810&#34;&gt;        site.words[&amp;#34;drafts&amp;#34;] += document.words&lt;/span&gt;
     else:
         try:
&lt;span style=&#34;color: #d73948&#34;&gt;-&lt;/span&gt;&lt;span style=&#34;color: #d73948&#34;&gt;            document[&amp;#34;source&amp;#34;][&amp;#34;words&amp;#34;] = len(document[&amp;#34;source&amp;#34;][&amp;#34;text&amp;#34;].split())&lt;/span&gt;
&lt;span style=&#34;color: #d73948&#34;&gt;-&lt;/span&gt;&lt;span style=&#34;color: #d73948&#34;&gt;            site.words[&amp;#34;references&amp;#34;] += document[&amp;#34;source&amp;#34;][&amp;#34;words&amp;#34;]&lt;/span&gt;
&lt;span style=&#34;color: #198810&#34;&gt;+&lt;/span&gt;&lt;span style=&#34;color: #198810&#34;&gt;            source_words = len(document.source.get(&amp;#34;text&amp;#34;, &amp;#34;&amp;#34;).split())&lt;/span&gt;
&lt;span style=&#34;color: #198810&#34;&gt;+&lt;/span&gt;&lt;span style=&#34;color: #198810&#34;&gt;            site.words[&amp;#34;references&amp;#34;] += source_words&lt;/span&gt;
         except KeyError:
             pass
         try:
&lt;span style=&#34;color: #d73948&#34;&gt;-&lt;/span&gt;&lt;span style=&#34;color: #d73948&#34;&gt;            site.words[&amp;#34;self&amp;#34;] += document[&amp;#34;words&amp;#34;]&lt;/span&gt;
&lt;span style=&#34;color: #198810&#34;&gt;+&lt;/span&gt;&lt;span style=&#34;color: #198810&#34;&gt;            site.words[&amp;#34;self&amp;#34;] += document.words&lt;/span&gt;
         except:
             pass

     # Extract external links from the plain text content
     try:
&lt;span style=&#34;color: #d73948&#34;&gt;-&lt;/span&gt;&lt;span style=&#34;color: #d73948&#34;&gt;        plain_text = document.get(&amp;#34;content&amp;#34;, {}).get(&amp;#34;plain&amp;#34;, &amp;#34;&amp;#34;) + &amp;#34; &amp;#34;&lt;/span&gt;
&lt;span style=&#34;color: #d73948&#34;&gt;-&lt;/span&gt;&lt;span style=&#34;color: #d73948&#34;&gt;        plain_text += document.get(&amp;#34;source&amp;#34;, {}).get(&amp;#34;url&amp;#34;, &amp;#34;&amp;#34;) + &amp;#34; &amp;#34;&lt;/span&gt;
&lt;span style=&#34;color: #d73948&#34;&gt;-&lt;/span&gt;&lt;span style=&#34;color: #d73948&#34;&gt;        plain_text += document.get(&amp;#34;via&amp;#34;, {}).get(&amp;#34;url&amp;#34;, &amp;#34;&amp;#34;) + &amp;#34; &amp;#34;&lt;/span&gt;
&lt;span style=&#34;color: #d73948&#34;&gt;-&lt;/span&gt;
&lt;span style=&#34;color: #d73948&#34;&gt;-&lt;/span&gt;&lt;span style=&#34;color: #d73948&#34;&gt;        external_links = extract_external_links(plain_text)&lt;/span&gt;
&lt;span style=&#34;color: #198810&#34;&gt;+&lt;/span&gt;&lt;span style=&#34;color: #198810&#34;&gt;        plain_text = (&lt;/span&gt;
&lt;span style=&#34;color: #198810&#34;&gt;+&lt;/span&gt;&lt;span style=&#34;color: #198810&#34;&gt;            document.content.get(&amp;#34;plain&amp;#34;, &amp;#34;&amp;#34;)&lt;/span&gt;
&lt;span style=&#34;color: #198810&#34;&gt;+&lt;/span&gt;&lt;span style=&#34;color: #198810&#34;&gt;            + &amp;#34; &amp;#34;&lt;/span&gt;
&lt;span style=&#34;color: #198810&#34;&gt;+&lt;/span&gt;&lt;span style=&#34;color: #198810&#34;&gt;            + document.source.get(&amp;#34;url&amp;#34;, &amp;#34;&amp;#34;)&lt;/span&gt;
&lt;span style=&#34;color: #198810&#34;&gt;+&lt;/span&gt;&lt;span style=&#34;color: #198810&#34;&gt;            + &amp;#34; &amp;#34;&lt;/span&gt;
&lt;span style=&#34;color: #198810&#34;&gt;+&lt;/span&gt;&lt;span style=&#34;color: #198810&#34;&gt;            + document.via.get(&amp;#34;url&amp;#34;, &amp;#34;&amp;#34;)&lt;/span&gt;
&lt;span style=&#34;color: #198810&#34;&gt;+&lt;/span&gt;&lt;span style=&#34;color: #198810&#34;&gt;        )&lt;/span&gt;

&lt;span style=&#34;color: #d73948&#34;&gt;-&lt;/span&gt;&lt;span style=&#34;color: #d73948&#34;&gt;        # Store the external links in document[&amp;#34;links&amp;#34;][&amp;#34;external&amp;#34;]&lt;/span&gt;
&lt;span style=&#34;color: #d73948&#34;&gt;-&lt;/span&gt;&lt;span style=&#34;color: #d73948&#34;&gt;        document[&amp;#34;links&amp;#34;] = {&lt;/span&gt;
&lt;span style=&#34;color: #d73948&#34;&gt;-&lt;/span&gt;&lt;span style=&#34;color: #d73948&#34;&gt;            &amp;#34;internal&amp;#34;: set(),&lt;/span&gt;
&lt;span style=&#34;color: #d73948&#34;&gt;-&lt;/span&gt;&lt;span style=&#34;color: #d73948&#34;&gt;            &amp;#34;external&amp;#34;: set(),&lt;/span&gt;
&lt;span style=&#34;color: #d73948&#34;&gt;-&lt;/span&gt;&lt;span style=&#34;color: #d73948&#34;&gt;            &amp;#34;backlinks&amp;#34;: set(),&lt;/span&gt;
&lt;span style=&#34;color: #d73948&#34;&gt;-&lt;/span&gt;&lt;span style=&#34;color: #d73948&#34;&gt;        }&lt;/span&gt;
&lt;span style=&#34;color: #d73948&#34;&gt;-&lt;/span&gt;&lt;span style=&#34;color: #d73948&#34;&gt;        document[&amp;#34;links&amp;#34;][&amp;#34;external&amp;#34;].update(external_links)&lt;/span&gt;
&lt;span style=&#34;color: #d73948&#34;&gt;-&lt;/span&gt;&lt;span style=&#34;color: #d73948&#34;&gt;        site.links[&amp;#34;external&amp;#34;].update(external_links)&lt;/span&gt;
&lt;span style=&#34;color: #198810&#34;&gt;+&lt;/span&gt;&lt;span style=&#34;color: #198810&#34;&gt;        external_links = extract_external_links(plain_text, site)&lt;/span&gt;
&lt;span style=&#34;color: #198810&#34;&gt;+&lt;/span&gt;&lt;span style=&#34;color: #198810&#34;&gt;        document.links[&amp;#34;external&amp;#34;] = external_links&lt;/span&gt;
     except KeyError:
&lt;span style=&#34;color: #d73948&#34;&gt;-&lt;/span&gt;&lt;span style=&#34;color: #d73948&#34;&gt;        print(f&amp;#34;KeyError while compiling external links from {document[&amp;#39;filename&amp;#39;]}&amp;#34;)&lt;/span&gt;
&lt;span style=&#34;color: #198810&#34;&gt;+&lt;/span&gt;&lt;span style=&#34;color: #198810&#34;&gt;        print(f&amp;#34;KeyError while compiling external links from {document.filepath}&amp;#34;)&lt;/span&gt;
         pass

     return uid, document


&lt;span style=&#34;color: #d73948&#34;&gt;-&lt;/span&gt;&lt;span style=&#34;color: #d73948&#34;&gt;async def ingest_documents(site: SiteMetadata) -&amp;gt; Dict[str, Dict[str, Any]]:&lt;/span&gt;
&lt;span style=&#34;color: #198810&#34;&gt;+&lt;/span&gt;&lt;span style=&#34;color: #198810&#34;&gt;async def ingest_documents(site: SiteMetadata) -&amp;gt; Dict[str, Any]:&lt;/span&gt;
     logger.info(&amp;#34;Ingesting files&amp;#34;)
     file_list = get_files()
     documents = {}
&lt;span style=&#34;color: #8b41b1&#34;&gt;@@&lt;/span&gt;&lt;span style=&#34;color: #8b41b1&#34;&gt; &lt;/span&gt;&lt;span style=&#34;color: #8b41b1&#34;&gt;-258,11 +357,9&lt;/span&gt;&lt;span style=&#34;color: #8b41b1&#34;&gt; &lt;/span&gt;&lt;span style=&#34;color: #8b41b1&#34;&gt;@@&lt;/span&gt;&lt;span style=&#34;color: #8b41b1&#34;&gt; &lt;/span&gt;&lt;strong&gt;&lt;span style=&#34;color: #4b69c6&#34;&gt;async def ingest_documents(site: SiteMetadata) -&amp;gt; Dict[str, Dict[str, Any]]:&lt;/span&gt;&lt;/strong&gt;
     slug_to_uid_lookup = {}
     site_primaries = set()
     site_secondaries = set()
&lt;span style=&#34;color: #d73948&#34;&gt;-&lt;/span&gt;&lt;span style=&#34;color: #d73948&#34;&gt;    site_series = set()&lt;/span&gt;
&lt;span style=&#34;color: #d73948&#34;&gt;-&lt;/span&gt;&lt;span style=&#34;color: #d73948&#34;&gt;    tags = set()&lt;/span&gt;
     uuid_collision_lookup = []

&lt;span style=&#34;color: #d73948&#34;&gt;-&lt;/span&gt;&lt;span style=&#34;color: #d73948&#34;&gt;    tasks = [process_document(filename, site) for filename in file_list]&lt;/span&gt;
&lt;span style=&#34;color: #198810&#34;&gt;+&lt;/span&gt;&lt;span style=&#34;color: #198810&#34;&gt;    tasks = [process_document(filepath, site) for filepath in file_list]&lt;/span&gt;
     results = await asyncio.gather(*tasks)
     site.words[&amp;#34;total&amp;#34;] = (
         site.words[&amp;#34;drafts&amp;#34;] + site.words[&amp;#34;references&amp;#34;] + site.words[&amp;#34;self&amp;#34;]
&lt;span style=&#34;color: #8b41b1&#34;&gt;@@&lt;/span&gt;&lt;span style=&#34;color: #8b41b1&#34;&gt; &lt;/span&gt;&lt;span style=&#34;color: #8b41b1&#34;&gt;-270,13 +367,11&lt;/span&gt;&lt;span style=&#34;color: #8b41b1&#34;&gt; &lt;/span&gt;&lt;span style=&#34;color: #8b41b1&#34;&gt;@@&lt;/span&gt;&lt;span style=&#34;color: #8b41b1&#34;&gt; &lt;/span&gt;&lt;strong&gt;&lt;span style=&#34;color: #4b69c6&#34;&gt;async def ingest_documents(site: SiteMetadata) -&amp;gt; Dict[str, Dict[str, Any]]:&lt;/span&gt;&lt;/strong&gt;

     for uid, doc in results:
         documents[uid] = doc
&lt;span style=&#34;color: #d73948&#34;&gt;-&lt;/span&gt;&lt;span style=&#34;color: #d73948&#34;&gt;        slug_to_title_lookup[doc[&amp;#34;slug&amp;#34;]] = doc[&amp;#34;title&amp;#34;]&lt;/span&gt;
&lt;span style=&#34;color: #d73948&#34;&gt;-&lt;/span&gt;&lt;span style=&#34;color: #d73948&#34;&gt;        slug_to_uid_lookup[doc[&amp;#34;slug&amp;#34;]] = uid&lt;/span&gt;
&lt;span style=&#34;color: #d73948&#34;&gt;-&lt;/span&gt;&lt;span style=&#34;color: #d73948&#34;&gt;        site_primaries.add(doc[&amp;#34;primary&amp;#34;])&lt;/span&gt;
&lt;span style=&#34;color: #d73948&#34;&gt;-&lt;/span&gt;&lt;span style=&#34;color: #d73948&#34;&gt;        site_secondaries.add(doc[&amp;#34;secondary&amp;#34;])&lt;/span&gt;
&lt;span style=&#34;color: #d73948&#34;&gt;-&lt;/span&gt;&lt;span style=&#34;color: #d73948&#34;&gt;        if &amp;#34;series&amp;#34; in doc:&lt;/span&gt;
&lt;span style=&#34;color: #d73948&#34;&gt;-&lt;/span&gt;&lt;span style=&#34;color: #d73948&#34;&gt;            site_series.add(doc[&amp;#34;series&amp;#34;])&lt;/span&gt;
&lt;span style=&#34;color: #d73948&#34;&gt;-&lt;/span&gt;&lt;span style=&#34;color: #d73948&#34;&gt;        tags.update(doc.get(&amp;#34;tags&amp;#34;) or [])&lt;/span&gt;
&lt;span style=&#34;color: #198810&#34;&gt;+&lt;/span&gt;&lt;span style=&#34;color: #198810&#34;&gt;        slug_to_title_lookup[doc.slug] = doc.title&lt;/span&gt;
&lt;span style=&#34;color: #198810&#34;&gt;+&lt;/span&gt;&lt;span style=&#34;color: #198810&#34;&gt;        slug_to_uid_lookup[doc.slug] = uid&lt;/span&gt;
&lt;span style=&#34;color: #198810&#34;&gt;+&lt;/span&gt;&lt;span style=&#34;color: #198810&#34;&gt;        site_primaries.add(doc.primary)&lt;/span&gt;
&lt;span style=&#34;color: #198810&#34;&gt;+&lt;/span&gt;&lt;span style=&#34;color: #198810&#34;&gt;        site_secondaries.add(doc.secondary)&lt;/span&gt;
&lt;span style=&#34;color: #198810&#34;&gt;+&lt;/span&gt;&lt;span style=&#34;color: #198810&#34;&gt;        site.tags += doc.tags&lt;/span&gt;
         uuid_collision_lookup.append(uid)

     site.slug_to_uid_lookup = slug_to_uid_lookup
&lt;span style=&#34;color: #8b41b1&#34;&gt;@@&lt;/span&gt;&lt;span style=&#34;color: #8b41b1&#34;&gt; &lt;/span&gt;&lt;span style=&#34;color: #8b41b1&#34;&gt;-284,7 +379,6&lt;/span&gt;&lt;span style=&#34;color: #8b41b1&#34;&gt; &lt;/span&gt;&lt;span style=&#34;color: #8b41b1&#34;&gt;@@&lt;/span&gt;&lt;span style=&#34;color: #8b41b1&#34;&gt; &lt;/span&gt;&lt;strong&gt;&lt;span style=&#34;color: #4b69c6&#34;&gt;async def ingest_documents(site: SiteMetadata) -&amp;gt; Dict[str, Dict[str, Any]]:&lt;/span&gt;&lt;/strong&gt;
     check_uuid_collisions(uuid_collision_lookup)
     site.primaries = list(site_primaries)
     site.secondaries = list(site_secondaries)
&lt;span style=&#34;color: #d73948&#34;&gt;-&lt;/span&gt;&lt;span style=&#34;color: #d73948&#34;&gt;    site.tags = list(tags)&lt;/span&gt;
     site.pagecount = len(documents)

     logger.info(f&amp;#34;Ingested {site.pagecount} files&amp;#34;)
&lt;span style=&#34;color: #8b41b1&#34;&gt;@@&lt;/span&gt;&lt;span style=&#34;color: #8b41b1&#34;&gt; &lt;/span&gt;&lt;span style=&#34;color: #8b41b1&#34;&gt;-373,14 +467,14&lt;/span&gt;&lt;span style=&#34;color: #8b41b1&#34;&gt; &lt;/span&gt;&lt;span style=&#34;color: #8b41b1&#34;&gt;@@&lt;/span&gt;&lt;span style=&#34;color: #8b41b1&#34;&gt; &lt;/span&gt;&lt;strong&gt;&lt;span style=&#34;color: #4b69c6&#34;&gt;def process_image_parallel(input_data: Tuple[Path, Path, int, str]) -&amp;gt; None:&lt;/span&gt;&lt;/strong&gt;


 def process_assets(
&lt;span style=&#34;color: #d73948&#34;&gt;-&lt;/span&gt;&lt;span style=&#34;color: #d73948&#34;&gt;    assets: Dict[str, Dict[str, Any]], asset_dir: Path, output_dir: Path&lt;/span&gt;
&lt;span style=&#34;color: #198810&#34;&gt;+&lt;/span&gt;&lt;span style=&#34;color: #198810&#34;&gt;    assets: Dict[str, DocumentMetadata], asset_dir: Path, output_dir: Path&lt;/span&gt;
 ) -&amp;gt; None:
     logger.info(&amp;#34;Processing assets&amp;#34;)
     manifest_images = []

     for asset_identifier, asset_metadata in assets.items():
&lt;span style=&#34;color: #d73948&#34;&gt;-&lt;/span&gt;&lt;span style=&#34;color: #d73948&#34;&gt;        source_path = Path(asset_metadata[&amp;#34;filepath&amp;#34;])&lt;/span&gt;
&lt;span style=&#34;color: #d73948&#34;&gt;-&lt;/span&gt;&lt;span style=&#34;color: #d73948&#34;&gt;        output_path = output_dir / asset_metadata[&amp;#34;slug&amp;#34;]&lt;/span&gt;
&lt;span style=&#34;color: #198810&#34;&gt;+&lt;/span&gt;&lt;span style=&#34;color: #198810&#34;&gt;        source_path = Path(asset_metadata.filepath)&lt;/span&gt;
&lt;span style=&#34;color: #198810&#34;&gt;+&lt;/span&gt;&lt;span style=&#34;color: #198810&#34;&gt;        output_path = output_dir / asset_metadata.slug&lt;/span&gt;
         os.makedirs(output_path.parent, exist_ok=True)

         if not source_path.exists():
&lt;span style=&#34;color: #8b41b1&#34;&gt;@@&lt;/span&gt;&lt;span style=&#34;color: #8b41b1&#34;&gt; &lt;/span&gt;&lt;span style=&#34;color: #8b41b1&#34;&gt;-422,74 +516,52&lt;/span&gt;&lt;span style=&#34;color: #8b41b1&#34;&gt; &lt;/span&gt;&lt;span style=&#34;color: #8b41b1&#34;&gt;@@&lt;/span&gt;&lt;span style=&#34;color: #8b41b1&#34;&gt; &lt;/span&gt;&lt;strong&gt;&lt;span style=&#34;color: #4b69c6&#34;&gt;def _parse_date(date_str: str) -&amp;gt; datetime.datetime:&lt;/span&gt;&lt;/strong&gt;
         return datetime.datetime.strptime(date_str, &amp;#34;%Y-%m-%d&amp;#34;).replace(tzinfo=None)


&lt;span style=&#34;color: #d73948&#34;&gt;-&lt;/span&gt;&lt;span style=&#34;color: #d73948&#34;&gt;def preprocess_metadata(filename: Path, metadata: Dict[str, Any]) -&amp;gt; Dict[str, Any]:&lt;/span&gt;
&lt;span style=&#34;color: #d73948&#34;&gt;-&lt;/span&gt;&lt;span style=&#34;color: #d73948&#34;&gt;    &amp;#34;&amp;#34;&amp;#34;Preprocesses metadata for a document, ensuring required fields exist and formatting data.&amp;#34;&amp;#34;&amp;#34;&lt;/span&gt;
&lt;span style=&#34;color: #d73948&#34;&gt;-&lt;/span&gt;
&lt;span style=&#34;color: #d73948&#34;&gt;-&lt;/span&gt;&lt;span style=&#34;color: #d73948&#34;&gt;    metadata[&amp;#34;filename&amp;#34;] = filename&lt;/span&gt;
&lt;span style=&#34;color: #d73948&#34;&gt;-&lt;/span&gt;
&lt;span style=&#34;color: #d73948&#34;&gt;-&lt;/span&gt;&lt;span style=&#34;color: #d73948&#34;&gt;    # Validate required fields&lt;/span&gt;
&lt;span style=&#34;color: #d73948&#34;&gt;-&lt;/span&gt;&lt;span style=&#34;color: #d73948&#34;&gt;    required_fields = [&amp;#34;uid&amp;#34;, &amp;#34;slug&amp;#34;, &amp;#34;available&amp;#34;, &amp;#34;created&amp;#34;, &amp;#34;primary&amp;#34;, &amp;#34;secondary&amp;#34;]&lt;/span&gt;
&lt;span style=&#34;color: #d73948&#34;&gt;-&lt;/span&gt;&lt;span style=&#34;color: #d73948&#34;&gt;    missing_fields = [field for field in required_fields if field not in metadata]&lt;/span&gt;
&lt;span style=&#34;color: #d73948&#34;&gt;-&lt;/span&gt;&lt;span style=&#34;color: #d73948&#34;&gt;    if missing_fields:&lt;/span&gt;
&lt;span style=&#34;color: #d73948&#34;&gt;-&lt;/span&gt;&lt;span style=&#34;color: #d73948&#34;&gt;        raise ValueError(&lt;/span&gt;
&lt;span style=&#34;color: #d73948&#34;&gt;-&lt;/span&gt;&lt;span style=&#34;color: #d73948&#34;&gt;            f&amp;#34;[ERROR] Document missing {&amp;#39;, &amp;#39;.join(missing_fields)}\n  {filename}&amp;#34;&lt;/span&gt;
&lt;span style=&#34;color: #d73948&#34;&gt;-&lt;/span&gt;&lt;span style=&#34;color: #d73948&#34;&gt;        )&lt;/span&gt;
&lt;span style=&#34;color: #d73948&#34;&gt;-&lt;/span&gt;
&lt;span style=&#34;color: #d73948&#34;&gt;-&lt;/span&gt;&lt;span style=&#34;color: #d73948&#34;&gt;    # Set default values&lt;/span&gt;
&lt;span style=&#34;color: #d73948&#34;&gt;-&lt;/span&gt;&lt;span style=&#34;color: #d73948&#34;&gt;    metadata.setdefault(&amp;#34;updated&amp;#34;, metadata[&amp;#34;created&amp;#34;])&lt;/span&gt;
&lt;span style=&#34;color: #198810&#34;&gt;+&lt;/span&gt;&lt;span style=&#34;color: #198810&#34;&gt;def preprocess_metadata(filepath: Path, metadata: Dict[str, Any]) -&amp;gt; DocumentMetadata:&lt;/span&gt;
&lt;span style=&#34;color: #198810&#34;&gt;+&lt;/span&gt;&lt;span style=&#34;color: #198810&#34;&gt;    &amp;#34;&amp;#34;&amp;#34;Preprocesses metadata for a document and converts it to a DocumentMetadata instance.&amp;#34;&amp;#34;&amp;#34;&lt;/span&gt;
&lt;span style=&#34;color: #198810&#34;&gt;+&lt;/span&gt;&lt;span style=&#34;color: #198810&#34;&gt;    # Create a working copy to avoid modifying the input&lt;/span&gt;
&lt;span style=&#34;color: #198810&#34;&gt;+&lt;/span&gt;&lt;span style=&#34;color: #198810&#34;&gt;    processed = metadata.copy()&lt;/span&gt;

     # Parse date fields
     for date_field in [&amp;#34;created&amp;#34;, &amp;#34;updated&amp;#34;, &amp;#34;available&amp;#34;]:
&lt;span style=&#34;color: #d73948&#34;&gt;-&lt;/span&gt;&lt;span style=&#34;color: #d73948&#34;&gt;        if date_field in metadata:&lt;/span&gt;
&lt;span style=&#34;color: #d73948&#34;&gt;-&lt;/span&gt;&lt;span style=&#34;color: #d73948&#34;&gt;            if isinstance(metadata[date_field], str):&lt;/span&gt;
&lt;span style=&#34;color: #d73948&#34;&gt;-&lt;/span&gt;&lt;span style=&#34;color: #d73948&#34;&gt;                metadata[date_field] = _parse_date(metadata[date_field])&lt;/span&gt;
&lt;span style=&#34;color: #d73948&#34;&gt;-&lt;/span&gt;&lt;span style=&#34;color: #d73948&#34;&gt;            elif isinstance(metadata[date_field], datetime.datetime):&lt;/span&gt;
&lt;span style=&#34;color: #d73948&#34;&gt;-&lt;/span&gt;&lt;span style=&#34;color: #d73948&#34;&gt;                metadata[date_field] = metadata[date_field].replace(tzinfo=None)&lt;/span&gt;
&lt;span style=&#34;color: #d73948&#34;&gt;-&lt;/span&gt;
&lt;span style=&#34;color: #d73948&#34;&gt;-&lt;/span&gt;&lt;span style=&#34;color: #d73948&#34;&gt;    # Process source information&lt;/span&gt;
&lt;span style=&#34;color: #d73948&#34;&gt;-&lt;/span&gt;&lt;span style=&#34;color: #d73948&#34;&gt;    if &amp;#34;source&amp;#34; in metadata:&lt;/span&gt;
&lt;span style=&#34;color: #d73948&#34;&gt;-&lt;/span&gt;&lt;span style=&#34;color: #d73948&#34;&gt;        if &amp;#34;via&amp;#34; in metadata:&lt;/span&gt;
&lt;span style=&#34;color: #d73948&#34;&gt;-&lt;/span&gt;&lt;span style=&#34;color: #d73948&#34;&gt;            metadata.update(&lt;/span&gt;
&lt;span style=&#34;color: #d73948&#34;&gt;-&lt;/span&gt;&lt;span style=&#34;color: #d73948&#34;&gt;                process_source_information(metadata[&amp;#34;source&amp;#34;], metadata[&amp;#34;via&amp;#34;])&lt;/span&gt;
&lt;span style=&#34;color: #d73948&#34;&gt;-&lt;/span&gt;&lt;span style=&#34;color: #d73948&#34;&gt;            )&lt;/span&gt;
&lt;span style=&#34;color: #d73948&#34;&gt;-&lt;/span&gt;&lt;span style=&#34;color: #d73948&#34;&gt;        else:&lt;/span&gt;
&lt;span style=&#34;color: #d73948&#34;&gt;-&lt;/span&gt;&lt;span style=&#34;color: #d73948&#34;&gt;            metadata.update(process_source_information(metadata[&amp;#34;source&amp;#34;], {}))&lt;/span&gt;
&lt;span style=&#34;color: #198810&#34;&gt;+&lt;/span&gt;&lt;span style=&#34;color: #198810&#34;&gt;        if isinstance(processed.get(date_field), str):&lt;/span&gt;
&lt;span style=&#34;color: #198810&#34;&gt;+&lt;/span&gt;&lt;span style=&#34;color: #198810&#34;&gt;            processed[date_field] = _parse_date(processed[date_field])&lt;/span&gt;
&lt;span style=&#34;color: #198810&#34;&gt;+&lt;/span&gt;&lt;span style=&#34;color: #198810&#34;&gt;        elif isinstance(processed.get(date_field), datetime.datetime):&lt;/span&gt;
&lt;span style=&#34;color: #198810&#34;&gt;+&lt;/span&gt;&lt;span style=&#34;color: #198810&#34;&gt;            processed[date_field] = processed[date_field].replace(tzinfo=None)&lt;/span&gt;
&lt;span style=&#34;color: #198810&#34;&gt;+&lt;/span&gt;
&lt;span style=&#34;color: #198810&#34;&gt;+&lt;/span&gt;&lt;span style=&#34;color: #198810&#34;&gt;    # Set default updated time if not provided&lt;/span&gt;
&lt;span style=&#34;color: #198810&#34;&gt;+&lt;/span&gt;&lt;span style=&#34;color: #198810&#34;&gt;    processed.setdefault(&amp;#34;updated&amp;#34;, processed.get(&amp;#34;created&amp;#34;))&lt;/span&gt;
&lt;span style=&#34;color: #198810&#34;&gt;+&lt;/span&gt;
&lt;span style=&#34;color: #198810&#34;&gt;+&lt;/span&gt;&lt;span style=&#34;color: #198810&#34;&gt;    # Process source information if present&lt;/span&gt;
&lt;span style=&#34;color: #198810&#34;&gt;+&lt;/span&gt;&lt;span style=&#34;color: #198810&#34;&gt;    if &amp;#34;source&amp;#34; in processed:&lt;/span&gt;
&lt;span style=&#34;color: #198810&#34;&gt;+&lt;/span&gt;&lt;span style=&#34;color: #198810&#34;&gt;        processed[&amp;#34;attribution&amp;#34;] = process_source_information(&lt;/span&gt;
&lt;span style=&#34;color: #198810&#34;&gt;+&lt;/span&gt;&lt;span style=&#34;color: #198810&#34;&gt;            processed[&amp;#34;source&amp;#34;], processed.get(&amp;#34;via&amp;#34;, {})&lt;/span&gt;
&lt;span style=&#34;color: #198810&#34;&gt;+&lt;/span&gt;&lt;span style=&#34;color: #198810&#34;&gt;        )&lt;/span&gt;
&lt;span style=&#34;color: #198810&#34;&gt;+&lt;/span&gt;&lt;span style=&#34;color: #198810&#34;&gt;    else:&lt;/span&gt;
&lt;span style=&#34;color: #198810&#34;&gt;+&lt;/span&gt;&lt;span style=&#34;color: #198810&#34;&gt;        processed[&amp;#34;attribution&amp;#34;] = {}&lt;/span&gt;
&lt;span style=&#34;color: #198810&#34;&gt;+&lt;/span&gt;&lt;span style=&#34;color: #198810&#34;&gt;        processed[&amp;#34;source&amp;#34;] = {}&lt;/span&gt;
&lt;span style=&#34;color: #198810&#34;&gt;+&lt;/span&gt;
&lt;span style=&#34;color: #198810&#34;&gt;+&lt;/span&gt;&lt;span style=&#34;color: #198810&#34;&gt;    if &amp;#34;via&amp;#34; not in processed:&lt;/span&gt;
&lt;span style=&#34;color: #198810&#34;&gt;+&lt;/span&gt;&lt;span style=&#34;color: #198810&#34;&gt;        processed[&amp;#34;via&amp;#34;] = {}&lt;/span&gt;

     # Determine title
&lt;span style=&#34;color: #d73948&#34;&gt;-&lt;/span&gt;&lt;span style=&#34;color: #d73948&#34;&gt;    metadata[&amp;#34;title&amp;#34;] = (&lt;/span&gt;
&lt;span style=&#34;color: #d73948&#34;&gt;-&lt;/span&gt;&lt;span style=&#34;color: #d73948&#34;&gt;        metadata.get(&amp;#34;title&amp;#34;)&lt;/span&gt;
&lt;span style=&#34;color: #d73948&#34;&gt;-&lt;/span&gt;&lt;span style=&#34;color: #d73948&#34;&gt;        or metadata.get(&amp;#34;attribution&amp;#34;, {}).get(&amp;#34;plain&amp;#34;)&lt;/span&gt;
&lt;span style=&#34;color: #d73948&#34;&gt;-&lt;/span&gt;&lt;span style=&#34;color: #d73948&#34;&gt;        or metadata[&amp;#34;created&amp;#34;].strftime(&amp;#34;%B %e, %Y %-I.%M%p&amp;#34;)&lt;/span&gt;
&lt;span style=&#34;color: #198810&#34;&gt;+&lt;/span&gt;&lt;span style=&#34;color: #198810&#34;&gt;    processed[&amp;#34;title&amp;#34;] = (&lt;/span&gt;
&lt;span style=&#34;color: #198810&#34;&gt;+&lt;/span&gt;&lt;span style=&#34;color: #198810&#34;&gt;        processed.get(&amp;#34;title&amp;#34;)&lt;/span&gt;
&lt;span style=&#34;color: #198810&#34;&gt;+&lt;/span&gt;&lt;span style=&#34;color: #198810&#34;&gt;        or processed.get(&amp;#34;attribution&amp;#34;, {}).get(&amp;#34;plain&amp;#34;)&lt;/span&gt;
&lt;span style=&#34;color: #198810&#34;&gt;+&lt;/span&gt;&lt;span style=&#34;color: #198810&#34;&gt;        or processed[&amp;#34;created&amp;#34;].strftime(&amp;#34;%B %e, %Y %-I.%M%p&amp;#34;)&lt;/span&gt;
     )
&lt;span style=&#34;color: #d73948&#34;&gt;-&lt;/span&gt;&lt;span style=&#34;color: #d73948&#34;&gt;    # Ensure title and slug are strings&lt;/span&gt;
&lt;span style=&#34;color: #d73948&#34;&gt;-&lt;/span&gt;&lt;span style=&#34;color: #d73948&#34;&gt;    metadata[&amp;#34;title&amp;#34;] = str(metadata[&amp;#34;title&amp;#34;])&lt;/span&gt;
&lt;span style=&#34;color: #d73948&#34;&gt;-&lt;/span&gt;&lt;span style=&#34;color: #d73948&#34;&gt;    if metadata.get(&amp;#34;status&amp;#34;) == &amp;#34;draft&amp;#34;:&lt;/span&gt;
&lt;span style=&#34;color: #d73948&#34;&gt;-&lt;/span&gt;&lt;span style=&#34;color: #d73948&#34;&gt;        metadata[&amp;#34;slug&amp;#34;] = &amp;#34;drafts/&amp;#34; + metadata[&amp;#34;uid&amp;#34;]&lt;/span&gt;
&lt;span style=&#34;color: #d73948&#34;&gt;-&lt;/span&gt;&lt;span style=&#34;color: #d73948&#34;&gt;        metadata[&amp;#34;parent&amp;#34;] = &amp;#34;a26221ae-c742-4b73-8dc6-7f8807456a1b&amp;#34;&lt;/span&gt;
&lt;span style=&#34;color: #d73948&#34;&gt;-&lt;/span&gt;&lt;span style=&#34;color: #d73948&#34;&gt;    else:&lt;/span&gt;
&lt;span style=&#34;color: #d73948&#34;&gt;-&lt;/span&gt;&lt;span style=&#34;color: #d73948&#34;&gt;        metadata[&amp;#34;slug&amp;#34;] = str(metadata[&amp;#34;slug&amp;#34;])&lt;/span&gt;

&lt;span style=&#34;color: #d73948&#34;&gt;-&lt;/span&gt;&lt;span style=&#34;color: #d73948&#34;&gt;    # Initialize interlinks, backlinks, and tags&lt;/span&gt;
&lt;span style=&#34;color: #d73948&#34;&gt;-&lt;/span&gt;&lt;span style=&#34;color: #d73948&#34;&gt;    metadata[&amp;#34;interlinks&amp;#34;] = set()&lt;/span&gt;
&lt;span style=&#34;color: #d73948&#34;&gt;-&lt;/span&gt;&lt;span style=&#34;color: #d73948&#34;&gt;    metadata[&amp;#34;backlinks&amp;#34;] = set()&lt;/span&gt;
&lt;span style=&#34;color: #d73948&#34;&gt;-&lt;/span&gt;&lt;span style=&#34;color: #d73948&#34;&gt;    metadata[&amp;#34;tags&amp;#34;] = metadata.get(&amp;#34;tags&amp;#34;) or []&lt;/span&gt;
&lt;span style=&#34;color: #198810&#34;&gt;+&lt;/span&gt;&lt;span style=&#34;color: #198810&#34;&gt;    # Handle draft status&lt;/span&gt;
&lt;span style=&#34;color: #198810&#34;&gt;+&lt;/span&gt;&lt;span style=&#34;color: #198810&#34;&gt;    if processed.get(&amp;#34;status&amp;#34;) == &amp;#34;draft&amp;#34;:&lt;/span&gt;
&lt;span style=&#34;color: #198810&#34;&gt;+&lt;/span&gt;&lt;span style=&#34;color: #198810&#34;&gt;        processed[&amp;#34;slug&amp;#34;] = f&amp;#34;drafts/{processed[&amp;#39;uid&amp;#39;]}&amp;#34;&lt;/span&gt;

&lt;span style=&#34;color: #d73948&#34;&gt;-&lt;/span&gt;&lt;span style=&#34;color: #d73948&#34;&gt;    # Strip whitespace from plain content&lt;/span&gt;
&lt;span style=&#34;color: #d73948&#34;&gt;-&lt;/span&gt;&lt;span style=&#34;color: #d73948&#34;&gt;    try:&lt;/span&gt;
&lt;span style=&#34;color: #d73948&#34;&gt;-&lt;/span&gt;&lt;span style=&#34;color: #d73948&#34;&gt;        metadata[&amp;#34;content&amp;#34;][&amp;#34;plain&amp;#34;] = metadata[&amp;#34;content&amp;#34;][&amp;#34;plain&amp;#34;].strip()&lt;/span&gt;
&lt;span style=&#34;color: #d73948&#34;&gt;-&lt;/span&gt;&lt;span style=&#34;color: #d73948&#34;&gt;    except KeyError:&lt;/span&gt;
&lt;span style=&#34;color: #d73948&#34;&gt;-&lt;/span&gt;&lt;span style=&#34;color: #d73948&#34;&gt;        pass&lt;/span&gt;
&lt;span style=&#34;color: #d73948&#34;&gt;-&lt;/span&gt;&lt;span style=&#34;color: #d73948&#34;&gt;    try:&lt;/span&gt;
&lt;span style=&#34;color: #d73948&#34;&gt;-&lt;/span&gt;&lt;span style=&#34;color: #d73948&#34;&gt;        metadata[&amp;#34;source&amp;#34;][&amp;#34;text&amp;#34;] = metadata[&amp;#34;source&amp;#34;][&amp;#34;text&amp;#34;].strip()&lt;/span&gt;
&lt;span style=&#34;color: #d73948&#34;&gt;-&lt;/span&gt;&lt;span style=&#34;color: #d73948&#34;&gt;    except KeyError:&lt;/span&gt;
&lt;span style=&#34;color: #d73948&#34;&gt;-&lt;/span&gt;&lt;span style=&#34;color: #d73948&#34;&gt;        pass&lt;/span&gt;
&lt;span style=&#34;color: #198810&#34;&gt;+&lt;/span&gt;&lt;span style=&#34;color: #198810&#34;&gt;    # Add filepath as it&amp;#39;s required but comes from function parameter&lt;/span&gt;
&lt;span style=&#34;color: #198810&#34;&gt;+&lt;/span&gt;&lt;span style=&#34;color: #198810&#34;&gt;    processed[&amp;#34;filepath&amp;#34;] = filepath&lt;/span&gt;

&lt;span style=&#34;color: #d73948&#34;&gt;-&lt;/span&gt;&lt;span style=&#34;color: #d73948&#34;&gt;    return metadata&lt;/span&gt;
&lt;span style=&#34;color: #198810&#34;&gt;+&lt;/span&gt;&lt;span style=&#34;color: #198810&#34;&gt;    # Create and return DocumentMetadata instance&lt;/span&gt;
&lt;span style=&#34;color: #198810&#34;&gt;+&lt;/span&gt;&lt;span style=&#34;color: #198810&#34;&gt;    return DocumentMetadata(**processed)&lt;/span&gt;


&lt;span style=&#34;color: #d73948&#34;&gt;-&lt;/span&gt;&lt;span style=&#34;color: #d73948&#34;&gt;def process_source_information(&lt;/span&gt;
&lt;span style=&#34;color: #d73948&#34;&gt;-&lt;/span&gt;&lt;span style=&#34;color: #d73948&#34;&gt;    source: Dict[str, Any], via&lt;/span&gt;
&lt;span style=&#34;color: #d73948&#34;&gt;-&lt;/span&gt;&lt;span style=&#34;color: #d73948&#34;&gt;) -&amp;gt; Dict[str, Dict[str, str]]:&lt;/span&gt;
&lt;span style=&#34;color: #198810&#34;&gt;+&lt;/span&gt;&lt;span style=&#34;color: #198810&#34;&gt;def process_source_information(source: Dict[str, Any], via) -&amp;gt; Dict[str, str]:&lt;/span&gt;
     creator = source.get(&amp;#34;creator&amp;#34;) or source.get(&amp;#34;director&amp;#34;)
     title = source.get(&amp;#34;title&amp;#34;) or (
         &amp;#34; ♫ &amp;#34; + str(source.get(&amp;#34;track&amp;#34;))
&lt;span style=&#34;color: #8b41b1&#34;&gt;@@&lt;/span&gt;&lt;span style=&#34;color: #8b41b1&#34;&gt; &lt;/span&gt;&lt;span style=&#34;color: #8b41b1&#34;&gt;-587,13 +659,11&lt;/span&gt;&lt;span style=&#34;color: #8b41b1&#34;&gt; &lt;/span&gt;&lt;span style=&#34;color: #8b41b1&#34;&gt;@@&lt;/span&gt;&lt;span style=&#34;color: #8b41b1&#34;&gt; &lt;/span&gt;&lt;strong&gt;&lt;span style=&#34;color: #4b69c6&#34;&gt;def process_source_information(&lt;/span&gt;&lt;/strong&gt;
             partsvia = f&amp;#34; (#link(&amp;#34;{escape_url(via[&amp;#34;url&amp;#34;]&amp;#34;)[via]}))&amp;#34;

     return {
&lt;span style=&#34;color: #d73948&#34;&gt;-&lt;/span&gt;&lt;span style=&#34;color: #d73948&#34;&gt;        &amp;#34;attribution&amp;#34;: {&lt;/span&gt;
&lt;span style=&#34;color: #d73948&#34;&gt;-&lt;/span&gt;&lt;span style=&#34;color: #d73948&#34;&gt;            &amp;#34;plain&amp;#34;: f&amp;#34;{speaker}{&amp;#39;, &amp;#39;.join(partsplain + partsshared)}&amp;#34;,&lt;/span&gt;
&lt;span style=&#34;color: #d73948&#34;&gt;-&lt;/span&gt;&lt;span style=&#34;color: #d73948&#34;&gt;            &amp;#34;djot&amp;#34;: f&amp;#34;{speaker}{&amp;#39;, &amp;#39;.join(partsdjot + partsshared)}&amp;#34;,&lt;/span&gt;
&lt;span style=&#34;color: #d73948&#34;&gt;-&lt;/span&gt;&lt;span style=&#34;color: #d73948&#34;&gt;            &amp;#34;html&amp;#34;: format_rich_attribution(&lt;/span&gt;
&lt;span style=&#34;color: #d73948&#34;&gt;-&lt;/span&gt;&lt;span style=&#34;color: #d73948&#34;&gt;                &amp;#34; — &amp;#34; + f&amp;#34;{speaker}{&amp;#39;, &amp;#39;.join(partshtml + partsshared) + partsvia}&amp;#34;&lt;/span&gt;
&lt;span style=&#34;color: #d73948&#34;&gt;-&lt;/span&gt;&lt;span style=&#34;color: #d73948&#34;&gt;            ),&lt;/span&gt;
&lt;span style=&#34;color: #d73948&#34;&gt;-&lt;/span&gt;&lt;span style=&#34;color: #d73948&#34;&gt;        }&lt;/span&gt;
&lt;span style=&#34;color: #198810&#34;&gt;+&lt;/span&gt;&lt;span style=&#34;color: #198810&#34;&gt;        &amp;#34;plain&amp;#34;: f&amp;#34;{speaker}{&amp;#39;, &amp;#39;.join(partsplain + partsshared)}&amp;#34;,&lt;/span&gt;
&lt;span style=&#34;color: #198810&#34;&gt;+&lt;/span&gt;&lt;span style=&#34;color: #198810&#34;&gt;        &amp;#34;djot&amp;#34;: f&amp;#34;{speaker}{&amp;#39;, &amp;#39;.join(partsdjot + partsshared)}&amp;#34;,&lt;/span&gt;
&lt;span style=&#34;color: #198810&#34;&gt;+&lt;/span&gt;&lt;span style=&#34;color: #198810&#34;&gt;        &amp;#34;html&amp;#34;: format_rich_attribution(&lt;/span&gt;
&lt;span style=&#34;color: #198810&#34;&gt;+&lt;/span&gt;&lt;span style=&#34;color: #198810&#34;&gt;            &amp;#34; — &amp;#34; + f&amp;#34;{speaker}{&amp;#39;, &amp;#39;.join(partshtml + partsshared) + partsvia}&amp;#34;&lt;/span&gt;
&lt;span style=&#34;color: #198810&#34;&gt;+&lt;/span&gt;&lt;span style=&#34;color: #198810&#34;&gt;        ),&lt;/span&gt;
     }


&lt;span style=&#34;color: #8b41b1&#34;&gt;@@&lt;/span&gt;&lt;span style=&#34;color: #8b41b1&#34;&gt; &lt;/span&gt;&lt;span style=&#34;color: #8b41b1&#34;&gt;-619,8 +689,8&lt;/span&gt;&lt;span style=&#34;color: #8b41b1&#34;&gt; &lt;/span&gt;&lt;span style=&#34;color: #8b41b1&#34;&gt;@@&lt;/span&gt;&lt;span style=&#34;color: #8b41b1&#34;&gt; &lt;/span&gt;&lt;strong&gt;&lt;span style=&#34;color: #4b69c6&#34;&gt;def check_uuid_collisions(uuid_list):&lt;/span&gt;&lt;/strong&gt;


 def insert_substitutions(
&lt;span style=&#34;color: #d73948&#34;&gt;-&lt;/span&gt;&lt;span style=&#34;color: #d73948&#34;&gt;    documents: Dict[str, Dict[str, Any]],&lt;/span&gt;
&lt;span style=&#34;color: #d73948&#34;&gt;-&lt;/span&gt;&lt;span style=&#34;color: #d73948&#34;&gt;    assets: Dict[str, Dict[str, Any]],&lt;/span&gt;
&lt;span style=&#34;color: #198810&#34;&gt;+&lt;/span&gt;&lt;span style=&#34;color: #198810&#34;&gt;    documents: Dict[str, DocumentMetadata],&lt;/span&gt;
&lt;span style=&#34;color: #198810&#34;&gt;+&lt;/span&gt;&lt;span style=&#34;color: #198810&#34;&gt;    assets: Dict[str, DocumentMetadata],&lt;/span&gt;
     site: SiteMetadata,
 ) -&amp;gt; None:
     logger.info(&amp;#34;Performing substitutions&amp;#34;)
&lt;span style=&#34;color: #8b41b1&#34;&gt;@@&lt;/span&gt;&lt;span style=&#34;color: #8b41b1&#34;&gt; &lt;/span&gt;&lt;span style=&#34;color: #8b41b1&#34;&gt;-635,53 +705,56&lt;/span&gt;&lt;span style=&#34;color: #8b41b1&#34;&gt; &lt;/span&gt;&lt;span style=&#34;color: #8b41b1&#34;&gt;@@&lt;/span&gt;&lt;span style=&#34;color: #8b41b1&#34;&gt; &lt;/span&gt;&lt;strong&gt;&lt;span style=&#34;color: #4b69c6&#34;&gt;def insert_substitutions(&lt;/span&gt;&lt;/strong&gt;
     merged_data = {*documents, *assets}

     for key, page in documents.items():
&lt;span style=&#34;color: #d73948&#34;&gt;-&lt;/span&gt;&lt;span style=&#34;color: #d73948&#34;&gt;        logger.debug(f&amp;#34;  {key}, {page[&amp;#39;title&amp;#39;][:40]}&amp;#34;)&lt;/span&gt;
&lt;span style=&#34;color: #198810&#34;&gt;+&lt;/span&gt;&lt;span style=&#34;color: #198810&#34;&gt;        logger.debug(f&amp;#34;  {key}, {page.title[:40]}&amp;#34;)&lt;/span&gt;

&lt;span style=&#34;color: #d73948&#34;&gt;-&lt;/span&gt;&lt;span style=&#34;color: #d73948&#34;&gt;        text = page.get(&amp;#34;content&amp;#34;, {}).get(&amp;#34;plain&amp;#34;)&lt;/span&gt;
&lt;span style=&#34;color: #198810&#34;&gt;+&lt;/span&gt;&lt;span style=&#34;color: #198810&#34;&gt;        text = page.content.get(&amp;#34;plain&amp;#34;)&lt;/span&gt;
         if text:
             text = replace_import_references(text, REF_IMPT_RE, merged_data, key, page)
             text = replace_cite_references(text, REF_CITE_RE, merged_data)
             text = replace_title_references(text, REF_TITLE_RE, merged_data)
             text = replace_slug_references(text, REF_SLUG_RE, merged_data)
             text = process_reference_links(text, REF_LINK_RE, merged_data, key)
&lt;span style=&#34;color: #d73948&#34;&gt;-&lt;/span&gt;&lt;span style=&#34;color: #d73948&#34;&gt;            page[&amp;#34;content&amp;#34;][&amp;#34;plain&amp;#34;] = text.strip()&lt;/span&gt;
&lt;span style=&#34;color: #198810&#34;&gt;+&lt;/span&gt;&lt;span style=&#34;color: #198810&#34;&gt;            page.content[&amp;#34;plain&amp;#34;] = text.strip()&lt;/span&gt;


 def replace_slug_references(
&lt;span style=&#34;color: #d73948&#34;&gt;-&lt;/span&gt;&lt;span style=&#34;color: #d73948&#34;&gt;    text: str, regex: re.Pattern, merged_data: Dict[str, Dict[str, Any]]&lt;/span&gt;
&lt;span style=&#34;color: #198810&#34;&gt;+&lt;/span&gt;&lt;span style=&#34;color: #198810&#34;&gt;    text: str, regex: re.Pattern, merged_data: Dict[str, DocumentMetadata]&lt;/span&gt;
 ) -&amp;gt; str:
     for match in regex.finditer(text):
         ref_type, ref_short_id = match.groups()
         full_match = match.group(0)
         ref_id = next((k for k in merged_data if k.startswith(ref_short_id)), None)
         if ref_id:
&lt;span style=&#34;color: #d73948&#34;&gt;-&lt;/span&gt;&lt;span style=&#34;color: #d73948&#34;&gt;            replacement = f&amp;#34;/{merged_data[ref_id][&amp;#39;slug&amp;#39;]}&amp;#34;&lt;/span&gt;
&lt;span style=&#34;color: #198810&#34;&gt;+&lt;/span&gt;&lt;span style=&#34;color: #198810&#34;&gt;            try:&lt;/span&gt;
&lt;span style=&#34;color: #198810&#34;&gt;+&lt;/span&gt;&lt;span style=&#34;color: #198810&#34;&gt;                replacement = f&amp;#34;/{merged_data[ref_id].slug}&amp;#34;&lt;/span&gt;
&lt;span style=&#34;color: #198810&#34;&gt;+&lt;/span&gt;&lt;span style=&#34;color: #198810&#34;&gt;            except AttributeError:&lt;/span&gt;
&lt;span style=&#34;color: #198810&#34;&gt;+&lt;/span&gt;&lt;span style=&#34;color: #198810&#34;&gt;                replacement = f&amp;#34;/{merged_data[ref_id].slug}&amp;#34;&lt;/span&gt;
             text = text.replace(full_match, replacement)
     return text


 def replace_title_references(
&lt;span style=&#34;color: #d73948&#34;&gt;-&lt;/span&gt;&lt;span style=&#34;color: #d73948&#34;&gt;    text: str, regex: re.Pattern, merged_data: Dict[str, Dict[str, Any]]&lt;/span&gt;
&lt;span style=&#34;color: #198810&#34;&gt;+&lt;/span&gt;&lt;span style=&#34;color: #198810&#34;&gt;    text: str, regex: re.Pattern, merged_data: Dict[str, DocumentMetadata]&lt;/span&gt;
 ) -&amp;gt; str:
     for match in regex.finditer(text):
         opening, ref_type, ref_short_id, comment, closing = match.groups()
         full_match = match.group(0)
         ref_id = next((k for k in merged_data if k.startswith(ref_short_id)), None)
         if ref_id:
&lt;span style=&#34;color: #d73948&#34;&gt;-&lt;/span&gt;&lt;span style=&#34;color: #d73948&#34;&gt;            replacement = merged_data[ref_id][&amp;#34;title&amp;#34;]&lt;/span&gt;
&lt;span style=&#34;color: #198810&#34;&gt;+&lt;/span&gt;&lt;span style=&#34;color: #198810&#34;&gt;            replacement = merged_data[ref_id].title&lt;/span&gt;
             text = text.replace(full_match, replacement)
     return text


 def replace_cite_references(
&lt;span style=&#34;color: #d73948&#34;&gt;-&lt;/span&gt;&lt;span style=&#34;color: #d73948&#34;&gt;    text: str, regex: re.Pattern, merged_data: Dict[str, Dict[str, Any]]&lt;/span&gt;
&lt;span style=&#34;color: #198810&#34;&gt;+&lt;/span&gt;&lt;span style=&#34;color: #198810&#34;&gt;    text: str, regex: re.Pattern, merged_data: Dict[str, DocumentMetadata]&lt;/span&gt;
 ) -&amp;gt; str:
     for match in regex.finditer(text):
         opening, ref_type, ref_short_id, comment, closing = match.groups()
         full_match = match.group(0)
         ref_id = next((k for k in merged_data if k.startswith(ref_short_id)), None)
         if ref_id:
&lt;span style=&#34;color: #d73948&#34;&gt;-&lt;/span&gt;&lt;span style=&#34;color: #d73948&#34;&gt;            replacement = f&amp;#34;[{merged_data[ref_id][&amp;#34;attribution&amp;#34;][&amp;#34;djot&amp;#34;]}] (/{merged_data[ref_id][&amp;#34;slug&amp;#34;]})&amp;#34;&lt;/span&gt;
&lt;span style=&#34;color: #198810&#34;&gt;+&lt;/span&gt;&lt;span style=&#34;color: #198810&#34;&gt;            replacement = f&amp;#34;[{merged_data[ref_id].attribution[&amp;#34;djot&amp;#34;]}] (/{merged_data[ref_id].slug})&amp;#34;&lt;/span&gt;
             text = text.replace(full_match, replacement)
     return text

&lt;span style=&#34;color: #8b41b1&#34;&gt;@@&lt;/span&gt;&lt;span style=&#34;color: #8b41b1&#34;&gt; &lt;/span&gt;&lt;span style=&#34;color: #8b41b1&#34;&gt;-689,29 +762,32&lt;/span&gt;&lt;span style=&#34;color: #8b41b1&#34;&gt; &lt;/span&gt;&lt;span style=&#34;color: #8b41b1&#34;&gt;@@&lt;/span&gt;&lt;span style=&#34;color: #8b41b1&#34;&gt; &lt;/span&gt;&lt;strong&gt;&lt;span style=&#34;color: #4b69c6&#34;&gt;def replace_cite_references(&lt;/span&gt;&lt;/strong&gt;
 def replace_import_references(
     text: str,
     regex: re.Pattern,
&lt;span style=&#34;color: #d73948&#34;&gt;-&lt;/span&gt;&lt;span style=&#34;color: #d73948&#34;&gt;    merged_data: Dict[str, Dict[str, Any]],&lt;/span&gt;
&lt;span style=&#34;color: #198810&#34;&gt;+&lt;/span&gt;&lt;span style=&#34;color: #198810&#34;&gt;    merged_data: Dict[str, DocumentMetadata],&lt;/span&gt;
     key: str,
&lt;span style=&#34;color: #d73948&#34;&gt;-&lt;/span&gt;&lt;span style=&#34;color: #d73948&#34;&gt;    page: Dict,&lt;/span&gt;
&lt;span style=&#34;color: #198810&#34;&gt;+&lt;/span&gt;&lt;span style=&#34;color: #198810&#34;&gt;    page: DocumentMetadata,&lt;/span&gt;
 ) -&amp;gt; str:
     for match in regex.finditer(text):
         opening, ref_type, ref_short_id, comment, closing = match.groups()
         full_match = match.group(0)
         ref_id = next((k for k in merged_data if k.startswith(ref_short_id)), None)
         if ref_id:
&lt;span style=&#34;color: #d73948&#34;&gt;-&lt;/span&gt;&lt;span style=&#34;color: #d73948&#34;&gt;            ref_text = merged_data[ref_id][&amp;#34;content&amp;#34;][&amp;#34;plain&amp;#34;]&lt;/span&gt;
&lt;span style=&#34;color: #198810&#34;&gt;+&lt;/span&gt;&lt;span style=&#34;color: #198810&#34;&gt;            ref_text = merged_data[ref_id].content[&amp;#34;plain&amp;#34;]&lt;/span&gt;
             if ref_type == &amp;#34;import::&amp;#34;:
                 replacement = ref_text
             elif ref_type == &amp;#34;aside::&amp;#34;:
&lt;span style=&#34;color: #d73948&#34;&gt;-&lt;/span&gt;&lt;span style=&#34;color: #d73948&#34;&gt;                ref_title = merged_data[ref_id][&amp;#34;title&amp;#34;]&lt;/span&gt;
&lt;span style=&#34;color: #d73948&#34;&gt;-&lt;/span&gt;&lt;span style=&#34;color: #d73948&#34;&gt;                ref_slug = merged_data[ref_id][&amp;#34;slug&amp;#34;]&lt;/span&gt;
&lt;span style=&#34;color: #d73948&#34;&gt;-&lt;/span&gt;&lt;span style=&#34;color: #d73948&#34;&gt;                ref_location = merged_data[ref_id].get(&amp;#34;location&amp;#34;, &amp;#34;&amp;#34;)&lt;/span&gt;
&lt;span style=&#34;color: #d73948&#34;&gt;-&lt;/span&gt;&lt;span style=&#34;color: #d73948&#34;&gt;                location_string = (&lt;/span&gt;
&lt;span style=&#34;color: #d73948&#34;&gt;-&lt;/span&gt;&lt;span style=&#34;color: #d73948&#34;&gt;                    &amp;#34; ⚕ &amp;#34;&lt;/span&gt;
&lt;span style=&#34;color: #d73948&#34;&gt;-&lt;/span&gt;&lt;span style=&#34;color: #d73948&#34;&gt;                    + ref_location.get(&amp;#34;city&amp;#34;)&lt;/span&gt;
&lt;span style=&#34;color: #d73948&#34;&gt;-&lt;/span&gt;&lt;span style=&#34;color: #d73948&#34;&gt;                    + &amp;#34;, &amp;#34;&lt;/span&gt;
&lt;span style=&#34;color: #d73948&#34;&gt;-&lt;/span&gt;&lt;span style=&#34;color: #d73948&#34;&gt;                    + ref_location.get(&amp;#34;country&amp;#34;)&lt;/span&gt;
&lt;span style=&#34;color: #d73948&#34;&gt;-&lt;/span&gt;&lt;span style=&#34;color: #d73948&#34;&gt;                    or &amp;#34;&amp;#34;&lt;/span&gt;
&lt;span style=&#34;color: #d73948&#34;&gt;-&lt;/span&gt;&lt;span style=&#34;color: #d73948&#34;&gt;                )&lt;/span&gt;
&lt;span style=&#34;color: #198810&#34;&gt;+&lt;/span&gt;&lt;span style=&#34;color: #198810&#34;&gt;                ref_title = merged_data[ref_id].title&lt;/span&gt;
&lt;span style=&#34;color: #198810&#34;&gt;+&lt;/span&gt;&lt;span style=&#34;color: #198810&#34;&gt;                ref_slug = merged_data[ref_id].slug&lt;/span&gt;
&lt;span style=&#34;color: #198810&#34;&gt;+&lt;/span&gt;&lt;span style=&#34;color: #198810&#34;&gt;                ref_location = merged_data[ref_id].location&lt;/span&gt;
&lt;span style=&#34;color: #198810&#34;&gt;+&lt;/span&gt;&lt;span style=&#34;color: #198810&#34;&gt;                if ref_location:&lt;/span&gt;
&lt;span style=&#34;color: #198810&#34;&gt;+&lt;/span&gt;&lt;span style=&#34;color: #198810&#34;&gt;                    location_string = (&lt;/span&gt;
&lt;span style=&#34;color: #198810&#34;&gt;+&lt;/span&gt;&lt;span style=&#34;color: #198810&#34;&gt;                        &amp;#34; ⚕ &amp;#34;&lt;/span&gt;
&lt;span style=&#34;color: #198810&#34;&gt;+&lt;/span&gt;&lt;span style=&#34;color: #198810&#34;&gt;                        + ref_location.get(&amp;#34;city&amp;#34;)&lt;/span&gt;
&lt;span style=&#34;color: #198810&#34;&gt;+&lt;/span&gt;&lt;span style=&#34;color: #198810&#34;&gt;                        + &amp;#34;, &amp;#34;&lt;/span&gt;
&lt;span style=&#34;color: #198810&#34;&gt;+&lt;/span&gt;&lt;span style=&#34;color: #198810&#34;&gt;                        + ref_location.get(&amp;#34;country&amp;#34;)&lt;/span&gt;
&lt;span style=&#34;color: #198810&#34;&gt;+&lt;/span&gt;&lt;span style=&#34;color: #198810&#34;&gt;                        or &amp;#34;&amp;#34;&lt;/span&gt;
&lt;span style=&#34;color: #198810&#34;&gt;+&lt;/span&gt;&lt;span style=&#34;color: #198810&#34;&gt;                    )&lt;/span&gt;
&lt;span style=&#34;color: #198810&#34;&gt;+&lt;/span&gt;&lt;span style=&#34;color: #198810&#34;&gt;                else:&lt;/span&gt;
&lt;span style=&#34;color: #198810&#34;&gt;+&lt;/span&gt;&lt;span style=&#34;color: #198810&#34;&gt;                    location_string = &amp;#34;&amp;#34;&lt;/span&gt;
                 replacement = (
                     f&amp;#39;{{.aside}}\n{&amp;#39;:&amp;#39;*78}\n&amp;#39;
                     f&amp;#39;{ref_text}\\\n&amp;#39;
&lt;span style=&#34;color: #8b41b1&#34;&gt;@@&lt;/span&gt;&lt;span style=&#34;color: #8b41b1&#34;&gt; &lt;/span&gt;&lt;span style=&#34;color: #8b41b1&#34;&gt;-722,18 +798,22&lt;/span&gt;&lt;span style=&#34;color: #8b41b1&#34;&gt; &lt;/span&gt;&lt;span style=&#34;color: #8b41b1&#34;&gt;@@&lt;/span&gt;&lt;span style=&#34;color: #8b41b1&#34;&gt; &lt;/span&gt;&lt;strong&gt;&lt;span style=&#34;color: #4b69c6&#34;&gt;def replace_import_references(&lt;/span&gt;&lt;/strong&gt;
                 )
             else:
                 raise ValueError(f&amp;#34;Unrecognised reference type: {ref_type}&amp;#34;)
&lt;span style=&#34;color: #d73948&#34;&gt;-&lt;/span&gt;&lt;span style=&#34;color: #d73948&#34;&gt;            if not page.get(&amp;#34;status&amp;#34;, &amp;#34;&amp;#34;) == &amp;#34;draft&amp;#34;:&lt;/span&gt;
&lt;span style=&#34;color: #d73948&#34;&gt;-&lt;/span&gt;&lt;span style=&#34;color: #d73948&#34;&gt;                merged_data[ref_id][&amp;#34;backlinks&amp;#34;].add(key)&lt;/span&gt;
&lt;span style=&#34;color: #198810&#34;&gt;+&lt;/span&gt;&lt;span style=&#34;color: #198810&#34;&gt;            if not page.status == &amp;#34;draft&amp;#34;:&lt;/span&gt;
&lt;span style=&#34;color: #198810&#34;&gt;+&lt;/span&gt;&lt;span style=&#34;color: #198810&#34;&gt;                merged_data[ref_id].links[&amp;#34;backlinks&amp;#34;].add(key)&lt;/span&gt;
             text = text.replace(full_match, replacement)
     return text


 def process_reference_links(
&lt;span style=&#34;color: #d73948&#34;&gt;-&lt;/span&gt;&lt;span style=&#34;color: #d73948&#34;&gt;    text: str, regex: re.Pattern, merged_data: Dict[str, Dict[str, Any]], key: str&lt;/span&gt;
&lt;span style=&#34;color: #198810&#34;&gt;+&lt;/span&gt;&lt;span style=&#34;color: #198810&#34;&gt;    text: str, regex: re.Pattern, merged_data: Dict[str, DocumentMetadata], key: str&lt;/span&gt;
 ) -&amp;gt; str:
     for ref_text_match, _, ref_type, ref_short_id in regex.findall(text):
         match = f&amp;#34;#link(&amp;#34;{ref_type}{ref_short_id}&amp;#34;)[{ref_text_match}]&amp;#34;
&lt;span style=&#34;color: #d73948&#34;&gt;-&lt;/span&gt;&lt;span style=&#34;color: #d73948&#34;&gt;        ref_id = next((k for k in merged_data if k.startswith(ref_short_id)), None)&lt;/span&gt;
&lt;span style=&#34;color: #198810&#34;&gt;+&lt;/span&gt;&lt;span style=&#34;color: #198810&#34;&gt;        ref_id = next(&lt;/span&gt;
&lt;span style=&#34;color: #198810&#34;&gt;+&lt;/span&gt;&lt;span style=&#34;color: #198810&#34;&gt;            (k for k in merged_data.keys() if k.startswith(ref_short_id)), None&lt;/span&gt;
&lt;span style=&#34;color: #198810&#34;&gt;+&lt;/span&gt;&lt;span style=&#34;color: #198810&#34;&gt;        )&lt;/span&gt;
&lt;span style=&#34;color: #198810&#34;&gt;+&lt;/span&gt;&lt;span style=&#34;color: #198810&#34;&gt;        if ref_id is None:&lt;/span&gt;
&lt;span style=&#34;color: #198810&#34;&gt;+&lt;/span&gt;&lt;span style=&#34;color: #198810&#34;&gt;            print(f&amp;#34;No match found for {ref_short_id}&amp;#34;)&lt;/span&gt;

         if not ref_id:
             raise ValueError(
&lt;span style=&#34;color: #8b41b1&#34;&gt;@@&lt;/span&gt;&lt;span style=&#34;color: #8b41b1&#34;&gt; &lt;/span&gt;&lt;span style=&#34;color: #8b41b1&#34;&gt;-746,16 +826,16&lt;/span&gt;&lt;span style=&#34;color: #8b41b1&#34;&gt; &lt;/span&gt;&lt;span style=&#34;color: #8b41b1&#34;&gt;@@&lt;/span&gt;&lt;span style=&#34;color: #8b41b1&#34;&gt; &lt;/span&gt;&lt;strong&gt;&lt;span style=&#34;color: #4b69c6&#34;&gt;def process_reference_links(&lt;/span&gt;&lt;/strong&gt;
             )

         ref_text = get_reference_text(ref_text_match, merged_data[ref_id])
&lt;span style=&#34;color: #d73948&#34;&gt;-&lt;/span&gt;&lt;span style=&#34;color: #d73948&#34;&gt;        ref_slug = f&amp;#34;/{merged_data[ref_id][&amp;#39;slug&amp;#39;]}&amp;#34;&lt;/span&gt;
&lt;span style=&#34;color: #198810&#34;&gt;+&lt;/span&gt;&lt;span style=&#34;color: #198810&#34;&gt;        ref_slug = f&amp;#34;/{merged_data[ref_id].slug}&amp;#34;&lt;/span&gt;

         if ref_type == &amp;#34;link::&amp;#34;:
             try:
                 # Double quotes within a page title are escaped so that they don&amp;#39;t break the HTML &amp;#39;title&amp;#39; element
&lt;span style=&#34;color: #d73948&#34;&gt;-&lt;/span&gt;&lt;span style=&#34;color: #d73948&#34;&gt;                ref_title = f&amp;#34;{merged_data[ref_id][&amp;#39;title&amp;#39;]} | {merged_data[ref_id][&amp;#39;created&amp;#39;].strftime(&amp;#39;%B %Y&amp;#39;)}&amp;#34;.replace(&lt;/span&gt;
&lt;span style=&#34;color: #198810&#34;&gt;+&lt;/span&gt;&lt;span style=&#34;color: #198810&#34;&gt;                ref_title = f&amp;#34;{merged_data[ref_id].title} | {merged_data[ref_id].created.strftime(&amp;#39;%B %Y&amp;#39;)}&amp;#34;.replace(&lt;/span&gt;
                     &amp;#39;&amp;#34;&amp;#39;, &amp;#39;\\&amp;#34;&amp;#39;
                 )
             except KeyError:
&lt;span style=&#34;color: #d73948&#34;&gt;-&lt;/span&gt;&lt;span style=&#34;color: #d73948&#34;&gt;                ref_title = merged_data[ref_id][&amp;#34;title&amp;#34;].replace(&amp;#39;&amp;#34;&amp;#39;, &amp;#39;\\&amp;#34;&amp;#39;)&lt;/span&gt;
&lt;span style=&#34;color: #198810&#34;&gt;+&lt;/span&gt;&lt;span style=&#34;color: #198810&#34;&gt;                ref_title = merged_data[ref_id].title.replace(&amp;#39;&amp;#34;&amp;#39;, &amp;#39;\\&amp;#34;&amp;#39;)&lt;/span&gt;
             replacement = f&amp;#39;#link(&amp;#34;{ref_slug}&amp;#34;)[{ref_text}]{{title=&amp;#34;{ref_title}&amp;#34;}}&amp;#39;
         elif ref_type == &amp;#34;img::&amp;#34;:
             replacement = f&amp;#34;#link(&amp;#34;{ref_slug}&amp;#34;)[{ref_text}]&amp;#34;
&lt;span style=&#34;color: #8b41b1&#34;&gt;@@&lt;/span&gt;&lt;span style=&#34;color: #8b41b1&#34;&gt; &lt;/span&gt;&lt;span style=&#34;color: #8b41b1&#34;&gt;-778,18 +858,18&lt;/span&gt;&lt;span style=&#34;color: #8b41b1&#34;&gt; &lt;/span&gt;&lt;span style=&#34;color: #8b41b1&#34;&gt;@@&lt;/span&gt;&lt;span style=&#34;color: #8b41b1&#34;&gt; &lt;/span&gt;&lt;strong&gt;&lt;span style=&#34;color: #4b69c6&#34;&gt;def process_reference_links(&lt;/span&gt;&lt;/strong&gt;
     return text


&lt;span style=&#34;color: #d73948&#34;&gt;-&lt;/span&gt;&lt;span style=&#34;color: #d73948&#34;&gt;def get_reference_text(ref_text_match: str, ref_data: Dict) -&amp;gt; str:&lt;/span&gt;
&lt;span style=&#34;color: #198810&#34;&gt;+&lt;/span&gt;&lt;span style=&#34;color: #198810&#34;&gt;def get_reference_text(ref_text_match: str, ref_data) -&amp;gt; str:&lt;/span&gt;
     if ref_text_match.startswith(&amp;#34;::&amp;#34;) or ref_text_match == &amp;#34;&amp;#34;:
&lt;span style=&#34;color: #d73948&#34;&gt;-&lt;/span&gt;&lt;span style=&#34;color: #d73948&#34;&gt;        return ref_data.get(&amp;#34;title&amp;#34;)&lt;/span&gt;
&lt;span style=&#34;color: #198810&#34;&gt;+&lt;/span&gt;&lt;span style=&#34;color: #198810&#34;&gt;        return ref_data.title&lt;/span&gt;
     return ref_text_match


&lt;span style=&#34;color: #d73948&#34;&gt;-&lt;/span&gt;&lt;span style=&#34;color: #d73948&#34;&gt;def create_quote_replacement(ref_data: Dict, ref_slug: str) -&amp;gt; str:&lt;/span&gt;
&lt;span style=&#34;color: #d73948&#34;&gt;-&lt;/span&gt;&lt;span style=&#34;color: #d73948&#34;&gt;    ref_src = ref_data[&amp;#34;attribution&amp;#34;][&amp;#34;djot&amp;#34;]&lt;/span&gt;
&lt;span style=&#34;color: #198810&#34;&gt;+&lt;/span&gt;&lt;span style=&#34;color: #198810&#34;&gt;def create_quote_replacement(ref_data: DocumentMetadata, ref_slug: str) -&amp;gt; str:&lt;/span&gt;
&lt;span style=&#34;color: #198810&#34;&gt;+&lt;/span&gt;&lt;span style=&#34;color: #198810&#34;&gt;    ref_src = ref_data.attribution[&amp;#34;djot&amp;#34;]&lt;/span&gt;
     try:
&lt;span style=&#34;color: #d73948&#34;&gt;-&lt;/span&gt;&lt;span style=&#34;color: #d73948&#34;&gt;        ref_text = ref_data[&amp;#34;source&amp;#34;][&amp;#34;text&amp;#34;].replace(&amp;#34;\n\n&amp;#34;, &amp;#34;\n&amp;gt; \n&amp;gt; &amp;#34;).strip()&lt;/span&gt;
&lt;span style=&#34;color: #198810&#34;&gt;+&lt;/span&gt;&lt;span style=&#34;color: #198810&#34;&gt;        ref_text = ref_data.source[&amp;#34;text&amp;#34;].replace(&amp;#34;\n\n&amp;#34;, &amp;#34;\n&amp;gt; \n&amp;gt; &amp;#34;).strip()&lt;/span&gt;
     except:
&lt;span style=&#34;color: #d73948&#34;&gt;-&lt;/span&gt;&lt;span style=&#34;color: #d73948&#34;&gt;        print(f&amp;#34;Error creating quote replacement: {ref_data[&amp;#34;uid&amp;#34;]}&amp;#34;)&lt;/span&gt;
&lt;span style=&#34;color: #198810&#34;&gt;+&lt;/span&gt;&lt;span style=&#34;color: #198810&#34;&gt;        print(f&amp;#34;Error creating quote replacement: {ref_data.uid}&amp;#34;)&lt;/span&gt;
         import sys

         sys.exit()
&lt;span style=&#34;color: #8b41b1&#34;&gt;@@&lt;/span&gt;&lt;span style=&#34;color: #8b41b1&#34;&gt; &lt;/span&gt;&lt;span style=&#34;color: #8b41b1&#34;&gt;-808,10 +888,10&lt;/span&gt;&lt;span style=&#34;color: #8b41b1&#34;&gt; &lt;/span&gt;&lt;span style=&#34;color: #8b41b1&#34;&gt;@@&lt;/span&gt;&lt;span style=&#34;color: #8b41b1&#34;&gt; &lt;/span&gt;&lt;strong&gt;&lt;span style=&#34;color: #4b69c6&#34;&gt;Your browser does not support the video tag.&lt;/span&gt;&lt;/strong&gt;
 def generate_html(documents):
     logger.info(&amp;#34;Generating HTML&amp;#34;)
     for key, page in documents.items():
&lt;span style=&#34;color: #d73948&#34;&gt;-&lt;/span&gt;&lt;span style=&#34;color: #d73948&#34;&gt;        if page.get(&amp;#34;content&amp;#34;, {}).get(&amp;#34;plain&amp;#34;):&lt;/span&gt;
&lt;span style=&#34;color: #d73948&#34;&gt;-&lt;/span&gt;&lt;span style=&#34;color: #d73948&#34;&gt;            page[&amp;#34;content&amp;#34;][&amp;#34;html&amp;#34;] = run_jotdown(page[&amp;#34;content&amp;#34;][&amp;#34;plain&amp;#34;])&lt;/span&gt;
&lt;span style=&#34;color: #d73948&#34;&gt;-&lt;/span&gt;&lt;span style=&#34;color: #d73948&#34;&gt;        if page.get(&amp;#34;source&amp;#34;, {}).get(&amp;#34;text&amp;#34;):&lt;/span&gt;
&lt;span style=&#34;color: #d73948&#34;&gt;-&lt;/span&gt;&lt;span style=&#34;color: #d73948&#34;&gt;            page[&amp;#34;source&amp;#34;][&amp;#34;html&amp;#34;] = run_jotdown(page[&amp;#34;source&amp;#34;][&amp;#34;text&amp;#34;])&lt;/span&gt;
&lt;span style=&#34;color: #198810&#34;&gt;+&lt;/span&gt;&lt;span style=&#34;color: #198810&#34;&gt;        if page.content.get(&amp;#34;plain&amp;#34;):&lt;/span&gt;
&lt;span style=&#34;color: #198810&#34;&gt;+&lt;/span&gt;&lt;span style=&#34;color: #198810&#34;&gt;            page.content[&amp;#34;html&amp;#34;] = run_jotdown(page.content[&amp;#34;plain&amp;#34;])&lt;/span&gt;
&lt;span style=&#34;color: #198810&#34;&gt;+&lt;/span&gt;&lt;span style=&#34;color: #198810&#34;&gt;        if page.source.get(&amp;#34;text&amp;#34;):&lt;/span&gt;
&lt;span style=&#34;color: #198810&#34;&gt;+&lt;/span&gt;&lt;span style=&#34;color: #198810&#34;&gt;            page.source[&amp;#34;html&amp;#34;] = run_jotdown(page.source[&amp;#34;text&amp;#34;])&lt;/span&gt;


 class LedgerLexer(RegexLexer):
&lt;span style=&#34;color: #8b41b1&#34;&gt;@@&lt;/span&gt;&lt;span style=&#34;color: #8b41b1&#34;&gt; &lt;/span&gt;&lt;span style=&#34;color: #8b41b1&#34;&gt;-841,7 +921,7&lt;/span&gt;&lt;span style=&#34;color: #8b41b1&#34;&gt; &lt;/span&gt;&lt;span style=&#34;color: #8b41b1&#34;&gt;@@&lt;/span&gt;&lt;span style=&#34;color: #8b41b1&#34;&gt; &lt;/span&gt;&lt;strong&gt;&lt;span style=&#34;color: #4b69c6&#34;&gt;class LedgerLexer(RegexLexer):&lt;/span&gt;&lt;/strong&gt;
     }


&lt;span style=&#34;color: #d73948&#34;&gt;-&lt;/span&gt;&lt;span style=&#34;color: #d73948&#34;&gt;def highlight_code(code: str, language: str = None) -&amp;gt; str:&lt;/span&gt;
&lt;span style=&#34;color: #198810&#34;&gt;+&lt;/span&gt;&lt;span style=&#34;color: #198810&#34;&gt;def highlight_code(code: str, language: str) -&amp;gt; str:&lt;/span&gt;
     &amp;#34;&amp;#34;&amp;#34;
     Highlight code using Pygments with specified or guessed language.
     &amp;#34;&amp;#34;&amp;#34;
&lt;span style=&#34;color: #8b41b1&#34;&gt;@@&lt;/span&gt;&lt;span style=&#34;color: #8b41b1&#34;&gt; &lt;/span&gt;&lt;span style=&#34;color: #8b41b1&#34;&gt;-921,20 +1001,17&lt;/span&gt;&lt;span style=&#34;color: #8b41b1&#34;&gt; &lt;/span&gt;&lt;span style=&#34;color: #8b41b1&#34;&gt;@@&lt;/span&gt;&lt;span style=&#34;color: #8b41b1&#34;&gt; &lt;/span&gt;&lt;strong&gt;&lt;span style=&#34;color: #4b69c6&#34;&gt;def build_backlinks(documents, site):&lt;/span&gt;&lt;/strong&gt;
     FOOTNOTE_LINK_URL_RE = re.compile(r&amp;#34;\[.+?\]:\s\/(.*)&amp;#34;, re.DOTALL)
     interlink_count = 0
     for key, page in documents.items():
&lt;span style=&#34;color: #d73948&#34;&gt;-&lt;/span&gt;&lt;span style=&#34;color: #d73948&#34;&gt;        if (&lt;/span&gt;
&lt;span style=&#34;color: #d73948&#34;&gt;-&lt;/span&gt;&lt;span style=&#34;color: #d73948&#34;&gt;            &amp;#34;nobacklinks&amp;#34; in page.get(&amp;#34;options&amp;#34;, &amp;#34;&amp;#34;)&lt;/span&gt;
&lt;span style=&#34;color: #d73948&#34;&gt;-&lt;/span&gt;&lt;span style=&#34;color: #d73948&#34;&gt;            or page.get(&amp;#34;status&amp;#34;, &amp;#34;&amp;#34;) == &amp;#34;draft&amp;#34;&lt;/span&gt;
&lt;span style=&#34;color: #d73948&#34;&gt;-&lt;/span&gt;&lt;span style=&#34;color: #d73948&#34;&gt;        ):&lt;/span&gt;
&lt;span style=&#34;color: #198810&#34;&gt;+&lt;/span&gt;&lt;span style=&#34;color: #198810&#34;&gt;        if &amp;#34;nobacklinks&amp;#34; in page.options or page.status == &amp;#34;draft&amp;#34;:&lt;/span&gt;
             continue

&lt;span style=&#34;color: #d73948&#34;&gt;-&lt;/span&gt;&lt;span style=&#34;color: #d73948&#34;&gt;        logger.debug(page[&amp;#34;filename&amp;#34;])&lt;/span&gt;
&lt;span style=&#34;color: #198810&#34;&gt;+&lt;/span&gt;&lt;span style=&#34;color: #198810&#34;&gt;        logger.debug(page.filepath)&lt;/span&gt;

&lt;span style=&#34;color: #d73948&#34;&gt;-&lt;/span&gt;&lt;span style=&#34;color: #d73948&#34;&gt;        text = page.get(&amp;#34;content&amp;#34;, {}).get(&amp;#34;plain&amp;#34;)&lt;/span&gt;
&lt;span style=&#34;color: #198810&#34;&gt;+&lt;/span&gt;&lt;span style=&#34;color: #198810&#34;&gt;        text = page.content.get(&amp;#34;plain&amp;#34;)&lt;/span&gt;
         # Skip if no main content
         if not text:
             continue

&lt;span style=&#34;color: #d73948&#34;&gt;-&lt;/span&gt;&lt;span style=&#34;color: #d73948&#34;&gt;        interlinks = set(documents[key][&amp;#34;interlinks&amp;#34;])&lt;/span&gt;
&lt;span style=&#34;color: #198810&#34;&gt;+&lt;/span&gt;&lt;span style=&#34;color: #198810&#34;&gt;        interlinks = set(documents[key].links[&amp;#34;internal&amp;#34;])&lt;/span&gt;

         combined_refs = INLINE_LINK_RE.findall(text) + FOOTNOTE_LINK_URL_RE.findall(
             text
&lt;span style=&#34;color: #8b41b1&#34;&gt;@@&lt;/span&gt;&lt;span style=&#34;color: #8b41b1&#34;&gt; &lt;/span&gt;&lt;span style=&#34;color: #8b41b1&#34;&gt;-950,11 +1027,28&lt;/span&gt;&lt;span style=&#34;color: #8b41b1&#34;&gt; &lt;/span&gt;&lt;span style=&#34;color: #8b41b1&#34;&gt;@@&lt;/span&gt;&lt;span style=&#34;color: #8b41b1&#34;&gt; &lt;/span&gt;&lt;strong&gt;&lt;span style=&#34;color: #4b69c6&#34;&gt;def build_backlinks(documents, site):&lt;/span&gt;&lt;/strong&gt;
                     continue
                 logger.warning(f&amp;#34;\nKeyError in {page[&amp;#39;title&amp;#39;]} ({key}): {slug}&amp;#34;)

&lt;span style=&#34;color: #d73948&#34;&gt;-&lt;/span&gt;&lt;span style=&#34;color: #d73948&#34;&gt;        documents[key][&amp;#34;interlinks&amp;#34;] = list(interlinks)&lt;/span&gt;
&lt;span style=&#34;color: #198810&#34;&gt;+&lt;/span&gt;&lt;span style=&#34;color: #198810&#34;&gt;        documents[key].links[&amp;#34;internal&amp;#34;] = interlinks&lt;/span&gt;
         for interlink_key in interlinks:
&lt;span style=&#34;color: #d73948&#34;&gt;-&lt;/span&gt;&lt;span style=&#34;color: #d73948&#34;&gt;            documents[interlink_key][&amp;#34;backlinks&amp;#34;].add(key)&lt;/span&gt;
&lt;span style=&#34;color: #198810&#34;&gt;+&lt;/span&gt;&lt;span style=&#34;color: #198810&#34;&gt;            documents[interlink_key].links[&amp;#34;backlinks&amp;#34;].add(key)&lt;/span&gt;

&lt;span style=&#34;color: #d73948&#34;&gt;-&lt;/span&gt;&lt;span style=&#34;color: #d73948&#34;&gt;    return interlink_count&lt;/span&gt;
&lt;span style=&#34;color: #198810&#34;&gt;+&lt;/span&gt;&lt;span style=&#34;color: #198810&#34;&gt;    for key, page in documents.items():&lt;/span&gt;
&lt;span style=&#34;color: #198810&#34;&gt;+&lt;/span&gt;&lt;span style=&#34;color: #198810&#34;&gt;        # Sort interlinks based on published dates&lt;/span&gt;
&lt;span style=&#34;color: #198810&#34;&gt;+&lt;/span&gt;&lt;span style=&#34;color: #198810&#34;&gt;        documents[key].links[&amp;#34;internal&amp;#34;] = sorted(&lt;/span&gt;
&lt;span style=&#34;color: #198810&#34;&gt;+&lt;/span&gt;&lt;span style=&#34;color: #198810&#34;&gt;            documents[key].links[&amp;#34;internal&amp;#34;],&lt;/span&gt;
&lt;span style=&#34;color: #198810&#34;&gt;+&lt;/span&gt;&lt;span style=&#34;color: #198810&#34;&gt;            key=lambda x: documents[x].available,&lt;/span&gt;
&lt;span style=&#34;color: #198810&#34;&gt;+&lt;/span&gt;&lt;span style=&#34;color: #198810&#34;&gt;            reverse=True,  # Most recent first&lt;/span&gt;
&lt;span style=&#34;color: #198810&#34;&gt;+&lt;/span&gt;&lt;span style=&#34;color: #198810&#34;&gt;        )&lt;/span&gt;
&lt;span style=&#34;color: #198810&#34;&gt;+&lt;/span&gt;&lt;span style=&#34;color: #198810&#34;&gt;        # Sort backlinks based on published dates&lt;/span&gt;
&lt;span style=&#34;color: #198810&#34;&gt;+&lt;/span&gt;&lt;span style=&#34;color: #198810&#34;&gt;        documents[key].links[&amp;#34;backlinks&amp;#34;] = sorted(&lt;/span&gt;
&lt;span style=&#34;color: #198810&#34;&gt;+&lt;/span&gt;&lt;span style=&#34;color: #198810&#34;&gt;            documents[key].links[&amp;#34;backlinks&amp;#34;],&lt;/span&gt;
&lt;span style=&#34;color: #198810&#34;&gt;+&lt;/span&gt;&lt;span style=&#34;color: #198810&#34;&gt;            key=lambda x: documents[x].available,&lt;/span&gt;
&lt;span style=&#34;color: #198810&#34;&gt;+&lt;/span&gt;&lt;span style=&#34;color: #198810&#34;&gt;            reverse=True,  # Most recent first&lt;/span&gt;
&lt;span style=&#34;color: #198810&#34;&gt;+&lt;/span&gt;&lt;span style=&#34;color: #198810&#34;&gt;        )&lt;/span&gt;
&lt;span style=&#34;color: #198810&#34;&gt;+&lt;/span&gt;
&lt;span style=&#34;color: #198810&#34;&gt;+&lt;/span&gt;&lt;span style=&#34;color: #198810&#34;&gt;    &amp;#34;&amp;#34;&amp;#34;&lt;/span&gt;
&lt;span style=&#34;color: #198810&#34;&gt;+&lt;/span&gt;&lt;span style=&#34;color: #198810&#34;&gt;    TODO: REMOVE SITE.BACKLINKS in favour a &amp;#39;stats&amp;#39; or &amp;#39;count&amp;#39; (templates will need updating&lt;/span&gt;
&lt;span style=&#34;color: #198810&#34;&gt;+&lt;/span&gt;&lt;span style=&#34;color: #198810&#34;&gt;    &amp;#34;&amp;#34;&amp;#34;&lt;/span&gt;
&lt;span style=&#34;color: #198810&#34;&gt;+&lt;/span&gt;&lt;span style=&#34;color: #198810&#34;&gt;    site.backlinks += interlink_count&lt;/span&gt;


 def should_ignore_slug(slug):
&lt;span style=&#34;color: #8b41b1&#34;&gt;@@&lt;/span&gt;&lt;span style=&#34;color: #8b41b1&#34;&gt; &lt;/span&gt;&lt;span style=&#34;color: #8b41b1&#34;&gt;-966,7 +1060,7&lt;/span&gt;&lt;span style=&#34;color: #8b41b1&#34;&gt; &lt;/span&gt;&lt;span style=&#34;color: #8b41b1&#34;&gt;@@&lt;/span&gt;&lt;span style=&#34;color: #8b41b1&#34;&gt; &lt;/span&gt;&lt;strong&gt;&lt;span style=&#34;color: #4b69c6&#34;&gt;def should_ignore_slug(slug):&lt;/span&gt;&lt;/strong&gt;


 def build_collections(
&lt;span style=&#34;color: #d73948&#34;&gt;-&lt;/span&gt;&lt;span style=&#34;color: #d73948&#34;&gt;    documents: Dict[str, Dict[str, Any]], site: SiteMetadata&lt;/span&gt;
&lt;span style=&#34;color: #198810&#34;&gt;+&lt;/span&gt;&lt;span style=&#34;color: #198810&#34;&gt;    documents: Dict[str, DocumentMetadata], site: SiteMetadata&lt;/span&gt;
 ) -&amp;gt; Tuple[Dict[str, List[Dict[str, Any]]], List[Dict[str, Any]]]:
     collections = {
         primary: []
&lt;span style=&#34;color: #8b41b1&#34;&gt;@@&lt;/span&gt;&lt;span style=&#34;color: #8b41b1&#34;&gt; &lt;/span&gt;&lt;span style=&#34;color: #8b41b1&#34;&gt;-978,24 +1072,24&lt;/span&gt;&lt;span style=&#34;color: #8b41b1&#34;&gt; &lt;/span&gt;&lt;span style=&#34;color: #8b41b1&#34;&gt;@@&lt;/span&gt;&lt;span style=&#34;color: #8b41b1&#34;&gt; &lt;/span&gt;&lt;strong&gt;&lt;span style=&#34;color: #4b69c6&#34;&gt;def build_collections(&lt;/span&gt;&lt;/strong&gt;
     sitemap = []

     for key, page in sorted(
&lt;span style=&#34;color: #d73948&#34;&gt;-&lt;/span&gt;&lt;span style=&#34;color: #d73948&#34;&gt;        documents.items(), key=lambda k_v: k_v[1][&amp;#34;available&amp;#34;], reverse=True&lt;/span&gt;
&lt;span style=&#34;color: #198810&#34;&gt;+&lt;/span&gt;&lt;span style=&#34;color: #198810&#34;&gt;        documents.items(), key=lambda k_v: k_v[1].available, reverse=True&lt;/span&gt;
     ):
&lt;span style=&#34;color: #d73948&#34;&gt;-&lt;/span&gt;&lt;span style=&#34;color: #d73948&#34;&gt;        if page.get(&amp;#34;status&amp;#34;, &amp;#34;&amp;#34;) == &amp;#34;draft&amp;#34;:&lt;/span&gt;
&lt;span style=&#34;color: #198810&#34;&gt;+&lt;/span&gt;&lt;span style=&#34;color: #198810&#34;&gt;        if page.status == &amp;#34;draft&amp;#34;:&lt;/span&gt;
             collections[&amp;#34;cd68b918-ac5f-4d6c-abb5-a55a0318846b&amp;#34;].append(page)
             continue
&lt;span style=&#34;color: #d73948&#34;&gt;-&lt;/span&gt;&lt;span style=&#34;color: #d73948&#34;&gt;        elif &amp;#34;nofeed&amp;#34; in page.get(&amp;#34;options&amp;#34;, []):&lt;/span&gt;
&lt;span style=&#34;color: #198810&#34;&gt;+&lt;/span&gt;&lt;span style=&#34;color: #198810&#34;&gt;        elif &amp;#34;nofeed&amp;#34; in page.options:&lt;/span&gt;
             sitemap.append(page)
             continue
         else:
             sitemap.append(page)
             collections[&amp;#34;everything&amp;#34;].append(page)
&lt;span style=&#34;color: #d73948&#34;&gt;-&lt;/span&gt;&lt;span style=&#34;color: #d73948&#34;&gt;            collections[page[&amp;#34;primary&amp;#34;]].append(page)&lt;/span&gt;
&lt;span style=&#34;color: #d73948&#34;&gt;-&lt;/span&gt;&lt;span style=&#34;color: #d73948&#34;&gt;            collections[page[&amp;#34;secondary&amp;#34;]].append(page)&lt;/span&gt;
&lt;span style=&#34;color: #198810&#34;&gt;+&lt;/span&gt;&lt;span style=&#34;color: #198810&#34;&gt;            collections[page.primary].append(page)&lt;/span&gt;
&lt;span style=&#34;color: #198810&#34;&gt;+&lt;/span&gt;&lt;span style=&#34;color: #198810&#34;&gt;            collections[page.secondary].append(page)&lt;/span&gt;

&lt;span style=&#34;color: #d73948&#34;&gt;-&lt;/span&gt;&lt;span style=&#34;color: #d73948&#34;&gt;            for tag in page.get(&amp;#34;tags&amp;#34;, []):&lt;/span&gt;
&lt;span style=&#34;color: #198810&#34;&gt;+&lt;/span&gt;&lt;span style=&#34;color: #198810&#34;&gt;            for tag in page.tags:&lt;/span&gt;
                 collections[tag].append(page)

&lt;span style=&#34;color: #d73948&#34;&gt;-&lt;/span&gt;&lt;span style=&#34;color: #d73948&#34;&gt;            if page[&amp;#34;secondary&amp;#34;] in [&lt;/span&gt;
&lt;span style=&#34;color: #198810&#34;&gt;+&lt;/span&gt;&lt;span style=&#34;color: #198810&#34;&gt;            if page.secondary in [&lt;/span&gt;
                 &amp;#34;essays&amp;#34;,
                 &amp;#34;wandering&amp;#34;,
                 &amp;#34;rambling&amp;#34;,
&lt;span style=&#34;color: #8b41b1&#34;&gt;@@&lt;/span&gt;&lt;span style=&#34;color: #8b41b1&#34;&gt; &lt;/span&gt;&lt;span style=&#34;color: #8b41b1&#34;&gt;-1008,8 +1102,8&lt;/span&gt;&lt;span style=&#34;color: #8b41b1&#34;&gt; &lt;/span&gt;&lt;span style=&#34;color: #8b41b1&#34;&gt;@@&lt;/span&gt;&lt;span style=&#34;color: #8b41b1&#34;&gt; &lt;/span&gt;&lt;strong&gt;&lt;span style=&#34;color: #4b69c6&#34;&gt;def build_collections(&lt;/span&gt;&lt;/strong&gt;


 def output_html(
&lt;span style=&#34;color: #d73948&#34;&gt;-&lt;/span&gt;&lt;span style=&#34;color: #d73948&#34;&gt;    assets: Dict[str, Dict[str, Any]],&lt;/span&gt;
&lt;span style=&#34;color: #d73948&#34;&gt;-&lt;/span&gt;&lt;span style=&#34;color: #d73948&#34;&gt;    documents: Dict[str, Dict[str, Any]],&lt;/span&gt;
&lt;span style=&#34;color: #198810&#34;&gt;+&lt;/span&gt;&lt;span style=&#34;color: #198810&#34;&gt;    assets: Dict[str, DocumentMetadata],&lt;/span&gt;
&lt;span style=&#34;color: #198810&#34;&gt;+&lt;/span&gt;&lt;span style=&#34;color: #198810&#34;&gt;    documents: Dict[str, DocumentMetadata],&lt;/span&gt;
     collections: Dict[str, List[Dict[str, Any]]],
     site: SiteMetadata,
     env: Environment,
&lt;span style=&#34;color: #8b41b1&#34;&gt;@@&lt;/span&gt;&lt;span style=&#34;color: #8b41b1&#34;&gt; &lt;/span&gt;&lt;span style=&#34;color: #8b41b1&#34;&gt;-1018,7 +1112,7&lt;/span&gt;&lt;span style=&#34;color: #8b41b1&#34;&gt; &lt;/span&gt;&lt;span style=&#34;color: #8b41b1&#34;&gt;@@&lt;/span&gt;&lt;span style=&#34;color: #8b41b1&#34;&gt; &lt;/span&gt;&lt;strong&gt;&lt;span style=&#34;color: #4b69c6&#34;&gt;def output_html(&lt;/span&gt;&lt;/strong&gt;
     logger.info(&amp;#34;Generating Hypertext&amp;#34;)

     for key, page in documents.items():
&lt;span style=&#34;color: #d73948&#34;&gt;-&lt;/span&gt;&lt;span style=&#34;color: #d73948&#34;&gt;        template_file = page.get(&amp;#34;layout&amp;#34;, TEMPLATE_DEFAULT)&lt;/span&gt;
&lt;span style=&#34;color: #198810&#34;&gt;+&lt;/span&gt;&lt;span style=&#34;color: #198810&#34;&gt;        template_file = page.layout&lt;/span&gt;
         template = env.get_template(template_file)

         collection = build_page_collection(page, collections)
&lt;span style=&#34;color: #8b41b1&#34;&gt;@@&lt;/span&gt;&lt;span style=&#34;color: #8b41b1&#34;&gt; &lt;/span&gt;&lt;span style=&#34;color: #8b41b1&#34;&gt;-1028,28 +1122,29&lt;/span&gt;&lt;span style=&#34;color: #8b41b1&#34;&gt; &lt;/span&gt;&lt;span style=&#34;color: #8b41b1&#34;&gt;@@&lt;/span&gt;&lt;span style=&#34;color: #8b41b1&#34;&gt; &lt;/span&gt;&lt;strong&gt;&lt;span style=&#34;color: #4b69c6&#34;&gt;def output_html(&lt;/span&gt;&lt;/strong&gt;
             assets=assets,
             collections=collections,
             collection=collection,
&lt;span style=&#34;color: #d73948&#34;&gt;-&lt;/span&gt;&lt;span style=&#34;color: #d73948&#34;&gt;            page=page,&lt;/span&gt;
&lt;span style=&#34;color: #198810&#34;&gt;+&lt;/span&gt;&lt;span style=&#34;color: #198810&#34;&gt;            page=asdict(page),&lt;/span&gt;
             site=site,
         )

&lt;span style=&#34;color: #d73948&#34;&gt;-&lt;/span&gt;&lt;span style=&#34;color: #d73948&#34;&gt;        output_path = output_dir / page[&amp;#34;slug&amp;#34;] / &amp;#34;index.html&amp;#34;&lt;/span&gt;
&lt;span style=&#34;color: #198810&#34;&gt;+&lt;/span&gt;&lt;span style=&#34;color: #198810&#34;&gt;        output_path = output_dir / page.slug / &amp;#34;index.html&amp;#34;&lt;/span&gt;
         output_path.parent.mkdir(parents=True, exist_ok=True)

         with open(output_path, &amp;#34;w&amp;#34;) as f:
             f.write(output)

&lt;span style=&#34;color: #d73948&#34;&gt;-&lt;/span&gt;&lt;span style=&#34;color: #d73948&#34;&gt;        logger.debug(f&amp;#34;  {page[&amp;#39;filename&amp;#39;]} &amp;gt;&amp;gt; {output_path}&amp;#34;)&lt;/span&gt;
&lt;span style=&#34;color: #198810&#34;&gt;+&lt;/span&gt;&lt;span style=&#34;color: #198810&#34;&gt;        logger.debug(f&amp;#34;  {page.filepath} &amp;gt;&amp;gt; {output_path}&amp;#34;)&lt;/span&gt;


 def build_page_collection(page, collections):
     try:
         collection = [
             item
&lt;span style=&#34;color: #d73948&#34;&gt;-&lt;/span&gt;&lt;span style=&#34;color: #d73948&#34;&gt;            for include in page[&amp;#34;collection&amp;#34;][&amp;#34;include&amp;#34;]&lt;/span&gt;
&lt;span style=&#34;color: #198810&#34;&gt;+&lt;/span&gt;&lt;span style=&#34;color: #198810&#34;&gt;            for include in page.collection[&amp;#34;include&amp;#34;]&lt;/span&gt;
             for item in collections[include]
         ]
&lt;span style=&#34;color: #d73948&#34;&gt;-&lt;/span&gt;&lt;span style=&#34;color: #d73948&#34;&gt;        return sorted(collection, key=lambda x: x[&amp;#34;available&amp;#34;], reverse=True)&lt;/span&gt;
&lt;span style=&#34;color: #198810&#34;&gt;+&lt;/span&gt;&lt;span style=&#34;color: #198810&#34;&gt;        return sorted(collection, key=lambda x: x.available, reverse=True)&lt;/span&gt;
     except KeyError:
&lt;span style=&#34;color: #198810&#34;&gt;+&lt;/span&gt;&lt;span style=&#34;color: #198810&#34;&gt;        print(f&amp;#34;Failed collection for {page.filepath}&amp;#34;)&lt;/span&gt;
         return []


&lt;span style=&#34;color: #8b41b1&#34;&gt;@@&lt;/span&gt;&lt;span style=&#34;color: #8b41b1&#34;&gt; &lt;/span&gt;&lt;span style=&#34;color: #8b41b1&#34;&gt;-1126,8 +1221,7&lt;/span&gt;&lt;span style=&#34;color: #8b41b1&#34;&gt; &lt;/span&gt;&lt;span style=&#34;color: #8b41b1&#34;&gt;@@&lt;/span&gt;&lt;span style=&#34;color: #8b41b1&#34;&gt; &lt;/span&gt;&lt;strong&gt;&lt;span style=&#34;color: #4b69c6&#34;&gt;async def main():&lt;/span&gt;&lt;/strong&gt;
     generate_html(documents)

     # Build backlinks and collections
&lt;span style=&#34;color: #d73948&#34;&gt;-&lt;/span&gt;&lt;span style=&#34;color: #d73948&#34;&gt;    interlink_count = build_backlinks(documents, site)&lt;/span&gt;
&lt;span style=&#34;color: #d73948&#34;&gt;-&lt;/span&gt;&lt;span style=&#34;color: #d73948&#34;&gt;    site.backlinks += interlink_count&lt;/span&gt;
&lt;span style=&#34;color: #198810&#34;&gt;+&lt;/span&gt;&lt;span style=&#34;color: #198810&#34;&gt;    build_backlinks(documents, site)&lt;/span&gt;
     collections, sitemap = build_collections(documents, site)

     # Output HTML, feeds, and sitemap
&lt;span style=&#34;color: #8b41b1&#34;&gt;@@&lt;/span&gt;&lt;span style=&#34;color: #8b41b1&#34;&gt; &lt;/span&gt;&lt;span style=&#34;color: #8b41b1&#34;&gt;-1142,7 +1236,8&lt;/span&gt;&lt;span style=&#34;color: #8b41b1&#34;&gt; &lt;/span&gt;&lt;span style=&#34;color: #8b41b1&#34;&gt;@@&lt;/span&gt;&lt;span style=&#34;color: #8b41b1&#34;&gt; &lt;/span&gt;&lt;strong&gt;&lt;span style=&#34;color: #4b69c6&#34;&gt;async def main():&lt;/span&gt;&lt;/strong&gt;
     logger.info(&amp;#34;Build complete!&amp;#34;)
     logger.info(f&amp;#34;Pages: {site.pagecount}&amp;#34;)
     logger.info(f&amp;#34;Words: {site.words[&amp;#34;total&amp;#34;]}&amp;#34;)
&lt;span style=&#34;color: #d73948&#34;&gt;-&lt;/span&gt;&lt;span style=&#34;color: #d73948&#34;&gt;    logger.info(f&amp;#34;Interlinks: {interlink_count}&amp;#34;)&lt;/span&gt;
&lt;span style=&#34;color: #198810&#34;&gt;+&lt;/span&gt;&lt;span style=&#34;color: #198810&#34;&gt;    logger.info(f&amp;#34;Internal links: {site.backlinks}&amp;#34;)&lt;/span&gt;
&lt;span style=&#34;color: #198810&#34;&gt;+&lt;/span&gt;&lt;span style=&#34;color: #198810&#34;&gt;    logger.info(f&amp;#34;External links: {len(site.links[&amp;#34;external&amp;#34;])}&amp;#34;)&lt;/span&gt;


 if __name__ == &amp;#34;__main__&amp;#34;:&lt;/code&gt;&lt;/pre&gt;&lt;/div&gt;&lt;/details&gt;9:54am on December 16, 2024 from Kitsilano, Vancouver, British Columbia, Canada&lt;p&gt;&lt;a href=&#34;mailto:reply@silasjelley.com?subject=Reply%20to%3A%20%E2%80%9CAdd%20dataclasses%20to%20ratchet%20up%20the%20strictness%E2%80%9D&#34;&gt;Reply via email&lt;/a&gt;&lt;/p&gt;
</content>
</entry>
<entry>
  <title>CSS for responsive image galleries at all viewport widths</title>
  <link rel="alternate" type="text/html" href="https://silasjelley.com/2024/12/15/172527" />
  <id>tag:silasjelley.com,2020-08-20:875afe1a-3179-41ff-88df-8344816e6722</id>
  <published>2024-12-15T17:25:27-08:00</published>
  <updated>2024-12-15T17:25:27-08:00</updated>
  <category term="notes" />
  <category term="changelogs" />
  <summary>CSS is pure mayhem, but whatever, it’s what we’ve got. For a long time I’ve had reasonably good responsive image galleries. Really the last remaining roadblocks has been with those galleries where…</summary>
<mosaic:place>Kitsilano, Vancouver, British Columbia, Canada</mosaic:place>
<content type="html">
    &lt;p&gt;CSS is pure mayhem, but whatever, it’s what we’ve got. For a long time I’ve had reasonably good responsive image galleries. Really the last remaining roadblocks has been with those galleries where I’ve decided I need to vary the width of images &lt;em&gt;for aesthetic reasons&lt;/em&gt;…&lt;/p&gt;&lt;p&gt;Well, today I improved the style behaviour in half of those cases.&lt;/p&gt;&lt;p&gt;The only caveat to this set of styles is that you have to be careful when using the &lt;code&gt;wide-first&lt;/code&gt; or &lt;code&gt;wide-last&lt;/code&gt; classes as they can leave an orphan image out in space if you don’t consider how many (odd or even) images are in the gallery or if they are of very different aspect ratios. But besides those I’ve found this to be pretty rock solid, if a little verbose.&lt;/p&gt;&lt;p&gt;Here’s the relevant cascade,&lt;/p&gt;&lt;div class=&#34;code-block&#34; data-lang=&#34;css&#34;&gt;&lt;div class=&#34;code-header&#34; data-mosaic-chrome=&#34;&#34;&gt;&lt;span class=&#34;code-lang&#34;&gt;css&lt;/span&gt;&lt;button class=&#34;code-copy&#34; aria-label=&#34;Copy code&#34; type=&#34;button&#34;&gt;Copy&lt;/button&gt;&lt;/div&gt;&lt;pre&gt;&lt;code data-lang=&#34;css&#34;&gt;root {
  &lt;span style=&#34;color: #4b69c6&#34;&gt;--&lt;/span&gt;&lt;span style=&#34;color: #4b69c6&#34;&gt;body-width&lt;/span&gt;: &lt;span style=&#34;color: #b60157&#34;&gt;820&lt;/span&gt;&lt;span style=&#34;color: #d73948&#34;&gt;px&lt;/span&gt;;
  &lt;span style=&#34;color: #4b69c6&#34;&gt;--&lt;/span&gt;&lt;span style=&#34;color: #4b69c6&#34;&gt;gallery-spacing&lt;/span&gt;: clamp(&lt;span style=&#34;color: #b60157&#34;&gt;2&lt;/span&gt;&lt;span style=&#34;color: #d73948&#34;&gt;px&lt;/span&gt;, &lt;span style=&#34;color: #b60157&#34;&gt;4&lt;/span&gt;&lt;span style=&#34;color: #d73948&#34;&gt;px&lt;/span&gt;, &lt;span style=&#34;color: #b60157&#34;&gt;1&lt;/span&gt;&lt;span style=&#34;color: #d73948&#34;&gt;rem&lt;/span&gt;);
  &lt;span style=&#34;color: #4b69c6&#34;&gt;--&lt;/span&gt;&lt;span style=&#34;color: #4b69c6&#34;&gt;gallery-transition&lt;/span&gt;: &lt;span style=&#34;color: #b60157&#34;&gt;0&lt;/span&gt;&lt;span style=&#34;color: #b60157&#34;&gt;.&lt;/span&gt;&lt;span style=&#34;color: #b60157&#34;&gt;3&lt;/span&gt;&lt;span style=&#34;color: #d73948&#34;&gt;s&lt;/span&gt; &lt;span style=&#34;color: #4b69c6&#34;&gt;ease-in-out&lt;/span&gt;;
}

&lt;span style=&#34;color: #8b41b1&#34;&gt;.&lt;/span&gt;&lt;span style=&#34;color: #8b41b1&#34;&gt;gallery&lt;/span&gt; {
  &lt;span style=&#34;color: #4b69c6&#34;&gt;display&lt;/span&gt;: &lt;span style=&#34;color: #4b69c6&#34;&gt;grid&lt;/span&gt;;
  gap: &lt;span style=&#34;color: #4b69c6&#34;&gt;var&lt;/span&gt;(&lt;span style=&#34;color: #4b69c6&#34;&gt;--&lt;/span&gt;&lt;span style=&#34;color: #4b69c6&#34;&gt;gallery-spacing&lt;/span&gt;);
  &lt;span style=&#34;color: #4b69c6&#34;&gt;width&lt;/span&gt;: &lt;span style=&#34;color: #b60157&#34;&gt;100&lt;/span&gt;&lt;span style=&#34;color: #d73948&#34;&gt;%&lt;/span&gt;;
  &lt;span style=&#34;color: #4b69c6&#34;&gt;margin&lt;/span&gt;: &lt;span style=&#34;color: #b60157&#34;&gt;2&lt;/span&gt;&lt;span style=&#34;color: #d73948&#34;&gt;rem&lt;/span&gt; &lt;span style=&#34;color: #b60157&#34;&gt;0&lt;/span&gt;;
}

&lt;span style=&#34;color: #8b41b1&#34;&gt;.&lt;/span&gt;&lt;span style=&#34;color: #8b41b1&#34;&gt;gallery&lt;/span&gt; &amp;gt; &lt;span style=&#34;color: #4b69c6&#34;&gt;img&lt;/span&gt;,
&lt;span style=&#34;color: #8b41b1&#34;&gt;.&lt;/span&gt;&lt;span style=&#34;color: #8b41b1&#34;&gt;gallery&lt;/span&gt; &amp;gt; &lt;span style=&#34;color: #4b69c6&#34;&gt;picture&lt;/span&gt; {
  &lt;span style=&#34;color: #4b69c6&#34;&gt;width&lt;/span&gt;: &lt;span style=&#34;color: #b60157&#34;&gt;100&lt;/span&gt;&lt;span style=&#34;color: #d73948&#34;&gt;%&lt;/span&gt;;
  &lt;span style=&#34;color: #4b69c6&#34;&gt;height&lt;/span&gt;: &lt;span style=&#34;color: #b60157&#34;&gt;100&lt;/span&gt;&lt;span style=&#34;color: #d73948&#34;&gt;%&lt;/span&gt;;
}

&lt;span style=&#34;color: #8b41b1&#34;&gt;.&lt;/span&gt;&lt;span style=&#34;color: #8b41b1&#34;&gt;gallery&lt;/span&gt; &amp;gt; &lt;span style=&#34;color: #4b69c6&#34;&gt;img&lt;/span&gt;,
&lt;span style=&#34;color: #8b41b1&#34;&gt;.&lt;/span&gt;&lt;span style=&#34;color: #8b41b1&#34;&gt;gallery&lt;/span&gt; &amp;gt; &lt;span style=&#34;color: #4b69c6&#34;&gt;picture&lt;/span&gt; &lt;span style=&#34;color: #4b69c6&#34;&gt;img&lt;/span&gt; {
  &lt;span style=&#34;color: #4b69c6&#34;&gt;width&lt;/span&gt;: &lt;span style=&#34;color: #b60157&#34;&gt;100&lt;/span&gt;&lt;span style=&#34;color: #d73948&#34;&gt;%&lt;/span&gt;;
  &lt;span style=&#34;color: #4b69c6&#34;&gt;height&lt;/span&gt;: &lt;span style=&#34;color: #b60157&#34;&gt;100&lt;/span&gt;&lt;span style=&#34;color: #d73948&#34;&gt;%&lt;/span&gt;;
  &lt;span style=&#34;color: #4b69c6&#34;&gt;object-fit&lt;/span&gt;: &lt;span style=&#34;color: #4b69c6&#34;&gt;cover&lt;/span&gt;;
  &lt;span style=&#34;color: #4b69c6&#34;&gt;border-radius&lt;/span&gt;: &lt;span style=&#34;color: #4b69c6&#34;&gt;var&lt;/span&gt;(&lt;span style=&#34;color: #4b69c6&#34;&gt;--&lt;/span&gt;&lt;span style=&#34;color: #4b69c6&#34;&gt;image-radius&lt;/span&gt;);
  &lt;span style=&#34;color: #4b69c6&#34;&gt;transition&lt;/span&gt;: &lt;span style=&#34;color: #4b69c6&#34;&gt;transform&lt;/span&gt; &lt;span style=&#34;color: #4b69c6&#34;&gt;var&lt;/span&gt;(&lt;span style=&#34;color: #4b69c6&#34;&gt;--&lt;/span&gt;&lt;span style=&#34;color: #4b69c6&#34;&gt;gallery-transition&lt;/span&gt;);
}

&lt;span style=&#34;color: #8b41b1&#34;&gt;.&lt;/span&gt;&lt;span style=&#34;color: #8b41b1&#34;&gt;gallery&lt;/span&gt; &amp;gt; &lt;span style=&#34;color: #4b69c6&#34;&gt;img&lt;/span&gt;&lt;span style=&#34;color: #8b41b1&#34;&gt;:&lt;/span&gt;&lt;span style=&#34;color: #8b41b1&#34;&gt;hover&lt;/span&gt;,
&lt;span style=&#34;color: #8b41b1&#34;&gt;.&lt;/span&gt;&lt;span style=&#34;color: #8b41b1&#34;&gt;gallery&lt;/span&gt; &amp;gt; &lt;span style=&#34;color: #4b69c6&#34;&gt;picture&lt;/span&gt;&lt;span style=&#34;color: #8b41b1&#34;&gt;:&lt;/span&gt;&lt;span style=&#34;color: #8b41b1&#34;&gt;hover&lt;/span&gt; &lt;span style=&#34;color: #4b69c6&#34;&gt;img&lt;/span&gt; {
  &lt;span style=&#34;color: #4b69c6&#34;&gt;transform&lt;/span&gt;: &lt;span style=&#34;color: #4b69c6&#34;&gt;scale&lt;/span&gt;(&lt;span style=&#34;color: #b60157&#34;&gt;1&lt;/span&gt;&lt;span style=&#34;color: #b60157&#34;&gt;.&lt;/span&gt;&lt;span style=&#34;color: #b60157&#34;&gt;01&lt;/span&gt;);
  &lt;span style=&#34;color: #4b69c6&#34;&gt;cursor&lt;/span&gt;: &lt;span style=&#34;color: #4b69c6&#34;&gt;zoom-in&lt;/span&gt;;
}

&lt;span style=&#34;color: #74747c&#34;&gt;/*&lt;/span&gt;&lt;span style=&#34;color: #74747c&#34;&gt; Dynamic columns based on number of children &lt;/span&gt;&lt;span style=&#34;color: #74747c&#34;&gt;*/&lt;/span&gt;
&lt;span style=&#34;color: #8b41b1&#34;&gt;.&lt;/span&gt;&lt;span style=&#34;color: #8b41b1&#34;&gt;gallery&lt;/span&gt;&lt;span style=&#34;color: #8b41b1&#34;&gt;:&lt;/span&gt;&lt;span style=&#34;color: #8b41b1&#34;&gt;has&lt;/span&gt;(&amp;gt; &lt;span style=&#34;color: #8b41b1&#34;&gt;:&lt;/span&gt;&lt;span style=&#34;color: #8b41b1&#34;&gt;nth-child&lt;/span&gt;(&lt;span style=&#34;color: #b60157&#34;&gt;1&lt;/span&gt;)&lt;span style=&#34;color: #8b41b1&#34;&gt;:&lt;/span&gt;&lt;span style=&#34;color: #8b41b1&#34;&gt;nth-last-child&lt;/span&gt;(&lt;span style=&#34;color: #b60157&#34;&gt;1&lt;/span&gt;)) {
  &lt;span style=&#34;color: #4b69c6&#34;&gt;grid-template-columns&lt;/span&gt;: &lt;span style=&#34;color: #b60157&#34;&gt;1&lt;/span&gt;&lt;span style=&#34;color: #d73948&#34;&gt;fr&lt;/span&gt;;
}

&lt;span style=&#34;color: #8b41b1&#34;&gt;.&lt;/span&gt;&lt;span style=&#34;color: #8b41b1&#34;&gt;gallery&lt;/span&gt;&lt;span style=&#34;color: #8b41b1&#34;&gt;:&lt;/span&gt;&lt;span style=&#34;color: #8b41b1&#34;&gt;has&lt;/span&gt;(&amp;gt; &lt;span style=&#34;color: #8b41b1&#34;&gt;:&lt;/span&gt;&lt;span style=&#34;color: #8b41b1&#34;&gt;nth-child&lt;/span&gt;(&lt;span style=&#34;color: #b60157&#34;&gt;1&lt;/span&gt;)&lt;span style=&#34;color: #8b41b1&#34;&gt;:&lt;/span&gt;&lt;span style=&#34;color: #8b41b1&#34;&gt;nth-last-child&lt;/span&gt;(&lt;span style=&#34;color: #b60157&#34;&gt;2&lt;/span&gt;)),
&lt;span style=&#34;color: #8b41b1&#34;&gt;.&lt;/span&gt;&lt;span style=&#34;color: #8b41b1&#34;&gt;gallery&lt;/span&gt;&lt;span style=&#34;color: #8b41b1&#34;&gt;:&lt;/span&gt;&lt;span style=&#34;color: #8b41b1&#34;&gt;has&lt;/span&gt;(&amp;gt; &lt;span style=&#34;color: #8b41b1&#34;&gt;:&lt;/span&gt;&lt;span style=&#34;color: #8b41b1&#34;&gt;nth-child&lt;/span&gt;(&lt;span style=&#34;color: #b60157&#34;&gt;2&lt;/span&gt;)&lt;span style=&#34;color: #8b41b1&#34;&gt;:&lt;/span&gt;&lt;span style=&#34;color: #8b41b1&#34;&gt;nth-last-child&lt;/span&gt;(&lt;span style=&#34;color: #b60157&#34;&gt;1&lt;/span&gt;)) {
  &lt;span style=&#34;color: #4b69c6&#34;&gt;grid-template-columns&lt;/span&gt;: &lt;span style=&#34;color: #4b69c6&#34;&gt;repeat&lt;/span&gt;(&lt;span style=&#34;color: #b60157&#34;&gt;2&lt;/span&gt;, &lt;span style=&#34;color: #b60157&#34;&gt;1&lt;/span&gt;&lt;span style=&#34;color: #d73948&#34;&gt;fr&lt;/span&gt;);
}

&lt;span style=&#34;color: #8b41b1&#34;&gt;.&lt;/span&gt;&lt;span style=&#34;color: #8b41b1&#34;&gt;gallery&lt;/span&gt;&lt;span style=&#34;color: #8b41b1&#34;&gt;:&lt;/span&gt;&lt;span style=&#34;color: #8b41b1&#34;&gt;has&lt;/span&gt;(&amp;gt; &lt;span style=&#34;color: #8b41b1&#34;&gt;:&lt;/span&gt;&lt;span style=&#34;color: #8b41b1&#34;&gt;nth-child&lt;/span&gt;(&lt;span style=&#34;color: #b60157&#34;&gt;1&lt;/span&gt;)&lt;span style=&#34;color: #8b41b1&#34;&gt;:&lt;/span&gt;&lt;span style=&#34;color: #8b41b1&#34;&gt;nth-last-child&lt;/span&gt;(&lt;span style=&#34;color: #b60157&#34;&gt;3&lt;/span&gt;)),
&lt;span style=&#34;color: #8b41b1&#34;&gt;.&lt;/span&gt;&lt;span style=&#34;color: #8b41b1&#34;&gt;gallery&lt;/span&gt;&lt;span style=&#34;color: #8b41b1&#34;&gt;:&lt;/span&gt;&lt;span style=&#34;color: #8b41b1&#34;&gt;has&lt;/span&gt;(&amp;gt; &lt;span style=&#34;color: #8b41b1&#34;&gt;:&lt;/span&gt;&lt;span style=&#34;color: #8b41b1&#34;&gt;nth-child&lt;/span&gt;(&lt;span style=&#34;color: #b60157&#34;&gt;2&lt;/span&gt;)&lt;span style=&#34;color: #8b41b1&#34;&gt;:&lt;/span&gt;&lt;span style=&#34;color: #8b41b1&#34;&gt;nth-last-child&lt;/span&gt;(&lt;span style=&#34;color: #b60157&#34;&gt;2&lt;/span&gt;)),
&lt;span style=&#34;color: #8b41b1&#34;&gt;.&lt;/span&gt;&lt;span style=&#34;color: #8b41b1&#34;&gt;gallery&lt;/span&gt;&lt;span style=&#34;color: #8b41b1&#34;&gt;:&lt;/span&gt;&lt;span style=&#34;color: #8b41b1&#34;&gt;has&lt;/span&gt;(&amp;gt; &lt;span style=&#34;color: #8b41b1&#34;&gt;:&lt;/span&gt;&lt;span style=&#34;color: #8b41b1&#34;&gt;nth-child&lt;/span&gt;(&lt;span style=&#34;color: #b60157&#34;&gt;3&lt;/span&gt;)&lt;span style=&#34;color: #8b41b1&#34;&gt;:&lt;/span&gt;&lt;span style=&#34;color: #8b41b1&#34;&gt;nth-last-child&lt;/span&gt;(&lt;span style=&#34;color: #b60157&#34;&gt;1&lt;/span&gt;)) {
  &lt;span style=&#34;color: #4b69c6&#34;&gt;grid-template-columns&lt;/span&gt;: &lt;span style=&#34;color: #4b69c6&#34;&gt;repeat&lt;/span&gt;(&lt;span style=&#34;color: #b60157&#34;&gt;3&lt;/span&gt;, &lt;span style=&#34;color: #b60157&#34;&gt;1&lt;/span&gt;&lt;span style=&#34;color: #d73948&#34;&gt;fr&lt;/span&gt;);
}

&lt;span style=&#34;color: #8b41b1&#34;&gt;.&lt;/span&gt;&lt;span style=&#34;color: #8b41b1&#34;&gt;gallery&lt;/span&gt;&lt;span style=&#34;color: #8b41b1&#34;&gt;:&lt;/span&gt;&lt;span style=&#34;color: #8b41b1&#34;&gt;has&lt;/span&gt;(&amp;gt; &lt;span style=&#34;color: #8b41b1&#34;&gt;:&lt;/span&gt;&lt;span style=&#34;color: #8b41b1&#34;&gt;nth-child&lt;/span&gt;(&lt;span style=&#34;color: #d73948&#34;&gt;n&lt;/span&gt; &lt;span style=&#34;color: #b60157&#34;&gt;+ 4&lt;/span&gt;)) {
  &lt;span style=&#34;color: #4b69c6&#34;&gt;grid-template-columns&lt;/span&gt;: &lt;span style=&#34;color: #4b69c6&#34;&gt;repeat&lt;/span&gt;(&lt;span style=&#34;color: #4b69c6&#34;&gt;auto-fit&lt;/span&gt;, &lt;span style=&#34;color: #4b69c6&#34;&gt;minmax&lt;/span&gt;(&lt;span style=&#34;color: #b60157&#34;&gt;250&lt;/span&gt;&lt;span style=&#34;color: #d73948&#34;&gt;px&lt;/span&gt;, &lt;span style=&#34;color: #b60157&#34;&gt;1&lt;/span&gt;&lt;span style=&#34;color: #d73948&#34;&gt;fr&lt;/span&gt;));
}

&lt;span style=&#34;color: #74747c&#34;&gt;/*&lt;/span&gt;&lt;span style=&#34;color: #74747c&#34;&gt; Layout variants &lt;/span&gt;&lt;span style=&#34;color: #74747c&#34;&gt;*/&lt;/span&gt;
&lt;span style=&#34;color: #8b41b1&#34;&gt;.&lt;/span&gt;&lt;span style=&#34;color: #8b41b1&#34;&gt;gallery&lt;/span&gt;&lt;span style=&#34;color: #8b41b1&#34;&gt;.&lt;/span&gt;&lt;span style=&#34;color: #8b41b1&#34;&gt;one-wide&lt;/span&gt; {
  &lt;span style=&#34;color: #4b69c6&#34;&gt;grid-template-columns&lt;/span&gt;: &lt;span style=&#34;color: #b60157&#34;&gt;1&lt;/span&gt;&lt;span style=&#34;color: #d73948&#34;&gt;fr&lt;/span&gt; &lt;span style=&#34;color: #d73948&#34;&gt;!important&lt;/span&gt;;
}

&lt;span style=&#34;color: #8b41b1&#34;&gt;.&lt;/span&gt;&lt;span style=&#34;color: #8b41b1&#34;&gt;gallery&lt;/span&gt;&lt;span style=&#34;color: #8b41b1&#34;&gt;.&lt;/span&gt;&lt;span style=&#34;color: #8b41b1&#34;&gt;two-wide&lt;/span&gt; {
  &lt;span style=&#34;color: #4b69c6&#34;&gt;grid-template-columns&lt;/span&gt;: &lt;span style=&#34;color: #4b69c6&#34;&gt;repeat&lt;/span&gt;(&lt;span style=&#34;color: #b60157&#34;&gt;2&lt;/span&gt;, &lt;span style=&#34;color: #b60157&#34;&gt;1&lt;/span&gt;&lt;span style=&#34;color: #d73948&#34;&gt;fr&lt;/span&gt;) &lt;span style=&#34;color: #d73948&#34;&gt;!important&lt;/span&gt;;
}

&lt;span style=&#34;color: #8b41b1&#34;&gt;.&lt;/span&gt;&lt;span style=&#34;color: #8b41b1&#34;&gt;gallery&lt;/span&gt;&lt;span style=&#34;color: #8b41b1&#34;&gt;.&lt;/span&gt;&lt;span style=&#34;color: #8b41b1&#34;&gt;four-wide&lt;/span&gt; {
  &lt;span style=&#34;color: #4b69c6&#34;&gt;grid-template-columns&lt;/span&gt;: &lt;span style=&#34;color: #4b69c6&#34;&gt;repeat&lt;/span&gt;(&lt;span style=&#34;color: #4b69c6&#34;&gt;auto-fit&lt;/span&gt;, &lt;span style=&#34;color: #4b69c6&#34;&gt;minmax&lt;/span&gt;(&lt;span style=&#34;color: #b60157&#34;&gt;185&lt;/span&gt;&lt;span style=&#34;color: #d73948&#34;&gt;px&lt;/span&gt;, &lt;span style=&#34;color: #b60157&#34;&gt;1&lt;/span&gt;&lt;span style=&#34;color: #d73948&#34;&gt;fr&lt;/span&gt;));
}

&lt;span style=&#34;color: #8b41b1&#34;&gt;.&lt;/span&gt;&lt;span style=&#34;color: #8b41b1&#34;&gt;gallery&lt;/span&gt;&lt;span style=&#34;color: #8b41b1&#34;&gt;.&lt;/span&gt;&lt;span style=&#34;color: #8b41b1&#34;&gt;wide-first&lt;/span&gt; &amp;gt; &lt;span style=&#34;color: #8b41b1&#34;&gt;:&lt;/span&gt;&lt;span style=&#34;color: #8b41b1&#34;&gt;first-child&lt;/span&gt;,
&lt;span style=&#34;color: #8b41b1&#34;&gt;.&lt;/span&gt;&lt;span style=&#34;color: #8b41b1&#34;&gt;gallery&lt;/span&gt;&lt;span style=&#34;color: #8b41b1&#34;&gt;.&lt;/span&gt;&lt;span style=&#34;color: #8b41b1&#34;&gt;wide-last&lt;/span&gt; &amp;gt; &lt;span style=&#34;color: #8b41b1&#34;&gt;:&lt;/span&gt;&lt;span style=&#34;color: #8b41b1&#34;&gt;last-child&lt;/span&gt; {
  &lt;span style=&#34;color: #4b69c6&#34;&gt;grid-column&lt;/span&gt;: &lt;span style=&#34;color: #b60157&#34;&gt;1&lt;/span&gt; / &lt;span style=&#34;color: #b60157&#34;&gt;-1&lt;/span&gt;;
  &lt;span style=&#34;color: #4b69c6&#34;&gt;max-height&lt;/span&gt;: &lt;span style=&#34;color: #b60157&#34;&gt;80&lt;/span&gt;&lt;span style=&#34;color: #d73948&#34;&gt;vh&lt;/span&gt;;
}

&lt;span style=&#34;color: #d73948&#34;&gt;@&lt;/span&gt;&lt;span style=&#34;color: #d73948&#34;&gt;media&lt;/span&gt; (&lt;span style=&#34;color: #4b69c6&#34;&gt;max-width&lt;/span&gt;: &lt;span style=&#34;color: #b60157&#34;&gt;768&lt;/span&gt;&lt;span style=&#34;color: #d73948&#34;&gt;px&lt;/span&gt;) {
  &lt;span style=&#34;color: #8b41b1&#34;&gt;.&lt;/span&gt;&lt;span style=&#34;color: #8b41b1&#34;&gt;gallery&lt;/span&gt;&lt;span style=&#34;color: #8b41b1&#34;&gt;:&lt;/span&gt;&lt;span style=&#34;color: #8b41b1&#34;&gt;has&lt;/span&gt;(&amp;gt; &lt;span style=&#34;color: #8b41b1&#34;&gt;:&lt;/span&gt;&lt;span style=&#34;color: #8b41b1&#34;&gt;nth-child&lt;/span&gt;(&lt;span style=&#34;color: #b60157&#34;&gt;1&lt;/span&gt;)&lt;span style=&#34;color: #8b41b1&#34;&gt;:&lt;/span&gt;&lt;span style=&#34;color: #8b41b1&#34;&gt;nth-last-child&lt;/span&gt;(&lt;span style=&#34;color: #b60157&#34;&gt;3&lt;/span&gt;)),
  &lt;span style=&#34;color: #8b41b1&#34;&gt;.&lt;/span&gt;&lt;span style=&#34;color: #8b41b1&#34;&gt;gallery&lt;/span&gt;&lt;span style=&#34;color: #8b41b1&#34;&gt;:&lt;/span&gt;&lt;span style=&#34;color: #8b41b1&#34;&gt;has&lt;/span&gt;(&amp;gt; &lt;span style=&#34;color: #8b41b1&#34;&gt;:&lt;/span&gt;&lt;span style=&#34;color: #8b41b1&#34;&gt;nth-child&lt;/span&gt;(&lt;span style=&#34;color: #b60157&#34;&gt;2&lt;/span&gt;)&lt;span style=&#34;color: #8b41b1&#34;&gt;:&lt;/span&gt;&lt;span style=&#34;color: #8b41b1&#34;&gt;nth-last-child&lt;/span&gt;(&lt;span style=&#34;color: #b60157&#34;&gt;2&lt;/span&gt;)),
  &lt;span style=&#34;color: #8b41b1&#34;&gt;.&lt;/span&gt;&lt;span style=&#34;color: #8b41b1&#34;&gt;gallery&lt;/span&gt;&lt;span style=&#34;color: #8b41b1&#34;&gt;:&lt;/span&gt;&lt;span style=&#34;color: #8b41b1&#34;&gt;has&lt;/span&gt;(&amp;gt; &lt;span style=&#34;color: #8b41b1&#34;&gt;:&lt;/span&gt;&lt;span style=&#34;color: #8b41b1&#34;&gt;nth-child&lt;/span&gt;(&lt;span style=&#34;color: #b60157&#34;&gt;3&lt;/span&gt;)&lt;span style=&#34;color: #8b41b1&#34;&gt;:&lt;/span&gt;&lt;span style=&#34;color: #8b41b1&#34;&gt;nth-last-child&lt;/span&gt;(&lt;span style=&#34;color: #b60157&#34;&gt;1&lt;/span&gt;)) {
    &lt;span style=&#34;color: #4b69c6&#34;&gt;grid-template-columns&lt;/span&gt;: &lt;span style=&#34;color: #4b69c6&#34;&gt;repeat&lt;/span&gt;(&lt;span style=&#34;color: #b60157&#34;&gt;2&lt;/span&gt;, &lt;span style=&#34;color: #b60157&#34;&gt;1&lt;/span&gt;&lt;span style=&#34;color: #d73948&#34;&gt;fr&lt;/span&gt;);
  }
  &lt;span style=&#34;color: #8b41b1&#34;&gt;.&lt;/span&gt;&lt;span style=&#34;color: #8b41b1&#34;&gt;gallery&lt;/span&gt;&lt;span style=&#34;color: #8b41b1&#34;&gt;.&lt;/span&gt;&lt;span style=&#34;color: #8b41b1&#34;&gt;four-wide&lt;/span&gt;,
  &lt;span style=&#34;color: #8b41b1&#34;&gt;.&lt;/span&gt;&lt;span style=&#34;color: #8b41b1&#34;&gt;gallery&lt;/span&gt;&lt;span style=&#34;color: #8b41b1&#34;&gt;:&lt;/span&gt;&lt;span style=&#34;color: #8b41b1&#34;&gt;has&lt;/span&gt;(&amp;gt; &lt;span style=&#34;color: #8b41b1&#34;&gt;:&lt;/span&gt;&lt;span style=&#34;color: #8b41b1&#34;&gt;nth-child&lt;/span&gt;(&lt;span style=&#34;color: #d73948&#34;&gt;n&lt;/span&gt; &lt;span style=&#34;color: #b60157&#34;&gt;+ 4&lt;/span&gt;)) {
    &lt;span style=&#34;color: #4b69c6&#34;&gt;grid-template-columns&lt;/span&gt;: &lt;span style=&#34;color: #4b69c6&#34;&gt;repeat&lt;/span&gt;(&lt;span style=&#34;color: #b60157&#34;&gt;2&lt;/span&gt;, &lt;span style=&#34;color: #b60157&#34;&gt;1&lt;/span&gt;&lt;span style=&#34;color: #d73948&#34;&gt;fr&lt;/span&gt;);
  }
  &lt;span style=&#34;color: #8b41b1&#34;&gt;.&lt;/span&gt;&lt;span style=&#34;color: #8b41b1&#34;&gt;gallery&lt;/span&gt;&lt;span style=&#34;color: #8b41b1&#34;&gt;:&lt;/span&gt;&lt;span style=&#34;color: #8b41b1&#34;&gt;has&lt;/span&gt;(&amp;gt; &lt;span style=&#34;color: #8b41b1&#34;&gt;:&lt;/span&gt;&lt;span style=&#34;color: #8b41b1&#34;&gt;nth-child&lt;/span&gt;(&lt;span style=&#34;color: #b60157&#34;&gt;3&lt;/span&gt;)&lt;span style=&#34;color: #8b41b1&#34;&gt;:&lt;/span&gt;&lt;span style=&#34;color: #8b41b1&#34;&gt;nth-last-child&lt;/span&gt;(&lt;span style=&#34;color: #b60157&#34;&gt;1&lt;/span&gt;)) &amp;gt; &lt;span style=&#34;color: #8b41b1&#34;&gt;:&lt;/span&gt;&lt;span style=&#34;color: #8b41b1&#34;&gt;last-child&lt;/span&gt; {
    &lt;span style=&#34;color: #4b69c6&#34;&gt;grid-column&lt;/span&gt;: &lt;span style=&#34;color: #4b69c6&#34;&gt;span&lt;/span&gt; &lt;span style=&#34;color: #b60157&#34;&gt;2&lt;/span&gt;;
  }
}

&lt;span style=&#34;color: #d73948&#34;&gt;@&lt;/span&gt;&lt;span style=&#34;color: #d73948&#34;&gt;media&lt;/span&gt; (&lt;span style=&#34;color: #4b69c6&#34;&gt;max-width&lt;/span&gt;: &lt;span style=&#34;color: #b60157&#34;&gt;480&lt;/span&gt;&lt;span style=&#34;color: #d73948&#34;&gt;px&lt;/span&gt;) {
  &lt;span style=&#34;color: #8b41b1&#34;&gt;.&lt;/span&gt;&lt;span style=&#34;color: #8b41b1&#34;&gt;gallery&lt;/span&gt; {
    &lt;span style=&#34;color: #4b69c6&#34;&gt;grid-template-columns&lt;/span&gt;: &lt;span style=&#34;color: #b60157&#34;&gt;1&lt;/span&gt;&lt;span style=&#34;color: #d73948&#34;&gt;fr&lt;/span&gt;;
  }
  &lt;span style=&#34;color: #8b41b1&#34;&gt;.&lt;/span&gt;&lt;span style=&#34;color: #8b41b1&#34;&gt;gallery&lt;/span&gt;&lt;span style=&#34;color: #8b41b1&#34;&gt;.&lt;/span&gt;&lt;span style=&#34;color: #8b41b1&#34;&gt;four-wide&lt;/span&gt;,
  &lt;span style=&#34;color: #8b41b1&#34;&gt;.&lt;/span&gt;&lt;span style=&#34;color: #8b41b1&#34;&gt;gallery&lt;/span&gt;&lt;span style=&#34;color: #8b41b1&#34;&gt;:&lt;/span&gt;&lt;span style=&#34;color: #8b41b1&#34;&gt;has&lt;/span&gt;(&amp;gt; &lt;span style=&#34;color: #8b41b1&#34;&gt;:&lt;/span&gt;&lt;span style=&#34;color: #8b41b1&#34;&gt;nth-child&lt;/span&gt;(&lt;span style=&#34;color: #d73948&#34;&gt;n&lt;/span&gt; &lt;span style=&#34;color: #b60157&#34;&gt;+ 4&lt;/span&gt;)) {
    &lt;span style=&#34;color: #4b69c6&#34;&gt;grid-template-columns&lt;/span&gt;: &lt;span style=&#34;color: #4b69c6&#34;&gt;repeat&lt;/span&gt;(&lt;span style=&#34;color: #b60157&#34;&gt;2&lt;/span&gt;, &lt;span style=&#34;color: #b60157&#34;&gt;1&lt;/span&gt;&lt;span style=&#34;color: #d73948&#34;&gt;fr&lt;/span&gt;);
  }

  &lt;span style=&#34;color: #74747c&#34;&gt;/*&lt;/span&gt;&lt;span style=&#34;color: #74747c&#34;&gt; Disable hover effects on touch devices &lt;/span&gt;&lt;span style=&#34;color: #74747c&#34;&gt;*/&lt;/span&gt;
  &lt;span style=&#34;color: #8b41b1&#34;&gt;.&lt;/span&gt;&lt;span style=&#34;color: #8b41b1&#34;&gt;gallery&lt;/span&gt; &amp;gt; &lt;span style=&#34;color: #4b69c6&#34;&gt;img&lt;/span&gt;&lt;span style=&#34;color: #8b41b1&#34;&gt;:&lt;/span&gt;&lt;span style=&#34;color: #8b41b1&#34;&gt;hover&lt;/span&gt;,
  &lt;span style=&#34;color: #8b41b1&#34;&gt;.&lt;/span&gt;&lt;span style=&#34;color: #8b41b1&#34;&gt;gallery&lt;/span&gt; &amp;gt; &lt;span style=&#34;color: #4b69c6&#34;&gt;picture&lt;/span&gt;&lt;span style=&#34;color: #8b41b1&#34;&gt;:&lt;/span&gt;&lt;span style=&#34;color: #8b41b1&#34;&gt;hover&lt;/span&gt; &lt;span style=&#34;color: #4b69c6&#34;&gt;img&lt;/span&gt; {
    &lt;span style=&#34;color: #4b69c6&#34;&gt;transform&lt;/span&gt;: &lt;span style=&#34;color: #4b69c6&#34;&gt;none&lt;/span&gt;;
  }

}

&lt;span style=&#34;color: #74747c&#34;&gt;/*&lt;/span&gt;&lt;span style=&#34;color: #74747c&#34;&gt; Full viewport width variant &lt;/span&gt;&lt;span style=&#34;color: #74747c&#34;&gt;*/&lt;/span&gt;
&lt;span style=&#34;color: #8b41b1&#34;&gt;.&lt;/span&gt;&lt;span style=&#34;color: #8b41b1&#34;&gt;gallery&lt;/span&gt;&lt;span style=&#34;color: #8b41b1&#34;&gt;.&lt;/span&gt;&lt;span style=&#34;color: #8b41b1&#34;&gt;full-viewport&lt;/span&gt; {
  &lt;span style=&#34;color: #4b69c6&#34;&gt;width&lt;/span&gt;: &lt;span style=&#34;color: #b60157&#34;&gt;100&lt;/span&gt;&lt;span style=&#34;color: #d73948&#34;&gt;vw&lt;/span&gt;;
  &lt;span style=&#34;color: #4b69c6&#34;&gt;margin-left&lt;/span&gt;: &lt;span style=&#34;color: #4b69c6&#34;&gt;calc&lt;/span&gt;(&lt;span style=&#34;color: #b60157&#34;&gt;50&lt;/span&gt;&lt;span style=&#34;color: #d73948&#34;&gt;%&lt;/span&gt; &lt;span style=&#34;color: #d73948&#34;&gt;-&lt;/span&gt; &lt;span style=&#34;color: #b60157&#34;&gt;50&lt;/span&gt;&lt;span style=&#34;color: #d73948&#34;&gt;vw&lt;/span&gt;);
  &lt;span style=&#34;color: #4b69c6&#34;&gt;margin-right&lt;/span&gt;: &lt;span style=&#34;color: #4b69c6&#34;&gt;calc&lt;/span&gt;(&lt;span style=&#34;color: #b60157&#34;&gt;50&lt;/span&gt;&lt;span style=&#34;color: #d73948&#34;&gt;%&lt;/span&gt; &lt;span style=&#34;color: #d73948&#34;&gt;-&lt;/span&gt; &lt;span style=&#34;color: #b60157&#34;&gt;50&lt;/span&gt;&lt;span style=&#34;color: #d73948&#34;&gt;vw&lt;/span&gt;);
}

&lt;span style=&#34;color: #8b41b1&#34;&gt;.&lt;/span&gt;&lt;span style=&#34;color: #8b41b1&#34;&gt;gallery&lt;/span&gt;&lt;span style=&#34;color: #8b41b1&#34;&gt;.&lt;/span&gt;&lt;span style=&#34;color: #8b41b1&#34;&gt;full-viewport&lt;/span&gt; &lt;span style=&#34;color: #4b69c6&#34;&gt;img&lt;/span&gt;,
&lt;span style=&#34;color: #8b41b1&#34;&gt;.&lt;/span&gt;&lt;span style=&#34;color: #8b41b1&#34;&gt;gallery&lt;/span&gt;&lt;span style=&#34;color: #8b41b1&#34;&gt;.&lt;/span&gt;&lt;span style=&#34;color: #8b41b1&#34;&gt;full-viewport&lt;/span&gt; &lt;span style=&#34;color: #4b69c6&#34;&gt;picture&lt;/span&gt; {
  &lt;span style=&#34;color: #4b69c6&#34;&gt;transform&lt;/span&gt;: &lt;span style=&#34;color: #4b69c6&#34;&gt;none&lt;/span&gt; &lt;span style=&#34;color: #d73948&#34;&gt;!important&lt;/span&gt;;
  &lt;span style=&#34;color: #4b69c6&#34;&gt;border-radius&lt;/span&gt;: &lt;span style=&#34;color: #b60157&#34;&gt;0&lt;/span&gt;;
}

&lt;span style=&#34;color: #74747c&#34;&gt;/*&lt;/span&gt;&lt;span style=&#34;color: #74747c&#34;&gt; Square aspect ratio class &lt;/span&gt;&lt;span style=&#34;color: #74747c&#34;&gt;*/&lt;/span&gt;
&lt;span style=&#34;color: #8b41b1&#34;&gt;.&lt;/span&gt;&lt;span style=&#34;color: #8b41b1&#34;&gt;gallery&lt;/span&gt;&lt;span style=&#34;color: #8b41b1&#34;&gt;.&lt;/span&gt;&lt;span style=&#34;color: #8b41b1&#34;&gt;square-items&lt;/span&gt; &amp;gt; &lt;span style=&#34;color: #4b69c6&#34;&gt;img&lt;/span&gt;,
&lt;span style=&#34;color: #8b41b1&#34;&gt;.&lt;/span&gt;&lt;span style=&#34;color: #8b41b1&#34;&gt;gallery&lt;/span&gt;&lt;span style=&#34;color: #8b41b1&#34;&gt;.&lt;/span&gt;&lt;span style=&#34;color: #8b41b1&#34;&gt;square-items&lt;/span&gt; &amp;gt; &lt;span style=&#34;color: #4b69c6&#34;&gt;picture&lt;/span&gt; &lt;span style=&#34;color: #4b69c6&#34;&gt;img&lt;/span&gt; {
  aspect-ratio: &lt;span style=&#34;color: #b60157&#34;&gt;1&lt;/span&gt;;
}
&lt;/code&gt;&lt;/pre&gt;&lt;/div&gt;5:25pm on December 15, 2024 from Kitsilano, Vancouver, British Columbia, Canada&lt;p&gt;&lt;a href=&#34;mailto:reply@silasjelley.com?subject=Reply%20to%3A%20%E2%80%9CCSS%20for%20responsive%20image%20galleries%20at%20all%20viewport%20widths%E2%80%9D&#34;&gt;Reply via email&lt;/a&gt;&lt;/p&gt;
</content>
</entry>
<entry>
  <title>Distinguishing between prose and code when counting words</title>
  <link rel="alternate" type="text/html" href="https://silasjelley.com/2024/12/15/102756" />
  <id>tag:silasjelley.com,2020-08-20:88862f11-7c81-450f-b8b7-9aa0fd261e21</id>
  <published>2024-12-15T10:27:56-08:00</published>
  <updated>2024-12-15T10:27:56-08:00</updated>
  <category term="notes" />
  <category term="changelogs" />
  <summary>I’m including more and larger code snippets in documents throughout the site — such as this one — and I didn’t like that these were being counted amongst the ‘wordcount’ of the site. I’ve always…</summary>
<mosaic:place>Kitsilano, Vancouver, British Columbia, Canada</mosaic:place>
<content type="html">
    &lt;p&gt;I’m including more and larger code snippets in documents throughout the site — such as this one — and I didn’t like that these were being counted amongst the ‘wordcount’ of the site. I’ve always distinguished between my words and reference words — when you see a quote in one of my documents, that isn’t counted in my own wordcount — but now it’s time do distinguish more granularly between &lt;em&gt;my prose&lt;/em&gt; and &lt;em&gt;my code&lt;/em&gt;.&lt;/p&gt;&lt;p&gt;The first change was to the &lt;code&gt;SiteMetadata&lt;/code&gt; dataclass.&lt;/p&gt;&lt;div class=&#34;code-block&#34; data-lang=&#34;python&#34;&gt;&lt;div class=&#34;code-header&#34; data-mosaic-chrome=&#34;&#34;&gt;&lt;span class=&#34;code-lang&#34;&gt;python&lt;/span&gt;&lt;button class=&#34;code-copy&#34; aria-label=&#34;Copy code&#34; type=&#34;button&#34;&gt;Copy&lt;/button&gt;&lt;/div&gt;&lt;pre&gt;&lt;code data-lang=&#34;python&#34;&gt;&lt;span style=&#34;color: #301414&#34;&gt;@&lt;/span&gt;&lt;span style=&#34;color: #301414&#34;&gt;dataclass&lt;/span&gt;
&lt;span style=&#34;color: #d73948&#34;&gt;class&lt;/span&gt; &lt;span style=&#34;color: #4b69c6&#34;&gt;SiteMetadata&lt;/span&gt;:
&lt;span style=&#34;color: #d73948&#34;&gt;...&lt;/span&gt;
    words: Dict[&lt;span style=&#34;color: #4b69c6&#34;&gt;str&lt;/span&gt;, Any] &lt;span style=&#34;color: #d73948&#34;&gt;=&lt;/span&gt; &lt;span style=&#34;color: #4b69c6&#34;&gt;field&lt;/span&gt;(
        default_factory&lt;span style=&#34;color: #d73948&#34;&gt;=&lt;/span&gt;&lt;span style=&#34;color: #d73948&#34;&gt;lambda&lt;/span&gt;: {
            &lt;span style=&#34;color: #198810&#34;&gt;&amp;#34;&lt;/span&gt;&lt;span style=&#34;color: #198810&#34;&gt;self&lt;/span&gt;&lt;span style=&#34;color: #198810&#34;&gt;&amp;#34;&lt;/span&gt;: &lt;span style=&#34;color: #b60157&#34;&gt;0&lt;/span&gt;,
            &lt;span style=&#34;color: #198810&#34;&gt;&amp;#34;&lt;/span&gt;&lt;span style=&#34;color: #198810&#34;&gt;drafts&lt;/span&gt;&lt;span style=&#34;color: #198810&#34;&gt;&amp;#34;&lt;/span&gt;: &lt;span style=&#34;color: #b60157&#34;&gt;0&lt;/span&gt;,
            &lt;span style=&#34;color: #198810&#34;&gt;&amp;#34;&lt;/span&gt;&lt;span style=&#34;color: #198810&#34;&gt;code&lt;/span&gt;&lt;span style=&#34;color: #198810&#34;&gt;&amp;#34;&lt;/span&gt;: {
                &lt;span style=&#34;color: #198810&#34;&gt;&amp;#34;&lt;/span&gt;&lt;span style=&#34;color: #198810&#34;&gt;lines&lt;/span&gt;&lt;span style=&#34;color: #198810&#34;&gt;&amp;#34;&lt;/span&gt;: &lt;span style=&#34;color: #b60157&#34;&gt;0&lt;/span&gt;,
                &lt;span style=&#34;color: #198810&#34;&gt;&amp;#34;&lt;/span&gt;&lt;span style=&#34;color: #198810&#34;&gt;words&lt;/span&gt;&lt;span style=&#34;color: #198810&#34;&gt;&amp;#34;&lt;/span&gt;: &lt;span style=&#34;color: #b60157&#34;&gt;0&lt;/span&gt;,
            },
            &lt;span style=&#34;color: #198810&#34;&gt;&amp;#34;&lt;/span&gt;&lt;span style=&#34;color: #198810&#34;&gt;references&lt;/span&gt;&lt;span style=&#34;color: #198810&#34;&gt;&amp;#34;&lt;/span&gt;: &lt;span style=&#34;color: #b60157&#34;&gt;0&lt;/span&gt;,
        }
    )
&lt;span style=&#34;color: #d73948&#34;&gt;...&lt;/span&gt;&lt;/code&gt;&lt;/pre&gt;&lt;/div&gt;&lt;p&gt;The same block was also added to the &lt;code&gt;DocumentMetadata&lt;/code&gt; dataclass, just without the &lt;code&gt;drafts&lt;/code&gt; key.&lt;/p&gt;&lt;p&gt;The logic for tallying up the totals isn’t very elegant, I consider this a first draft, but it works. First the total document is summed,&lt;/p&gt;&lt;div class=&#34;code-block&#34; data-lang=&#34;python&#34;&gt;&lt;div class=&#34;code-header&#34; data-mosaic-chrome=&#34;&#34;&gt;&lt;span class=&#34;code-lang&#34;&gt;python&lt;/span&gt;&lt;button class=&#34;code-copy&#34; aria-label=&#34;Copy code&#34; type=&#34;button&#34;&gt;Copy&lt;/button&gt;&lt;/div&gt;&lt;pre&gt;&lt;code data-lang=&#34;python&#34;&gt;    &lt;span style=&#34;color: #d73948&#34;&gt;for&lt;/span&gt; key, page &lt;span style=&#34;color: #d73948&#34;&gt;in&lt;/span&gt; documents.&lt;span style=&#34;color: #4b69c6&#34;&gt;items&lt;/span&gt;():
        prose_wordcount &lt;span style=&#34;color: #d73948&#34;&gt;=&lt;/span&gt; &lt;span style=&#34;color: #4b69c6&#34;&gt;len&lt;/span&gt;(page.content.&lt;span style=&#34;color: #4b69c6&#34;&gt;get&lt;/span&gt;(&lt;span style=&#34;color: #198810&#34;&gt;&amp;#34;&lt;/span&gt;&lt;span style=&#34;color: #198810&#34;&gt;plain&lt;/span&gt;&lt;span style=&#34;color: #198810&#34;&gt;&amp;#34;&lt;/span&gt;, &lt;span style=&#34;color: #198810&#34;&gt;&amp;#34;&lt;/span&gt;&lt;span style=&#34;color: #198810&#34;&gt;&amp;#34;&lt;/span&gt;).&lt;span style=&#34;color: #4b69c6&#34;&gt;split&lt;/span&gt;())
        references_wordcount &lt;span style=&#34;color: #d73948&#34;&gt;=&lt;/span&gt; &lt;span style=&#34;color: #4b69c6&#34;&gt;len&lt;/span&gt;(page.source.&lt;span style=&#34;color: #4b69c6&#34;&gt;get&lt;/span&gt;(&lt;span style=&#34;color: #198810&#34;&gt;&amp;#34;&lt;/span&gt;&lt;span style=&#34;color: #198810&#34;&gt;text&lt;/span&gt;&lt;span style=&#34;color: #198810&#34;&gt;&amp;#34;&lt;/span&gt;, &lt;span style=&#34;color: #198810&#34;&gt;&amp;#34;&lt;/span&gt;&lt;span style=&#34;color: #198810&#34;&gt;&amp;#34;&lt;/span&gt;).&lt;span style=&#34;color: #4b69c6&#34;&gt;split&lt;/span&gt;())
        &lt;span style=&#34;color: #d73948&#34;&gt;if&lt;/span&gt; page.status &lt;span style=&#34;color: #d73948&#34;&gt;==&lt;/span&gt; &lt;span style=&#34;color: #198810&#34;&gt;&amp;#34;&lt;/span&gt;&lt;span style=&#34;color: #198810&#34;&gt;draft&lt;/span&gt;&lt;span style=&#34;color: #198810&#34;&gt;&amp;#34;&lt;/span&gt;:
            page.words[&lt;span style=&#34;color: #198810&#34;&gt;&amp;#34;&lt;/span&gt;&lt;span style=&#34;color: #198810&#34;&gt;self&lt;/span&gt;&lt;span style=&#34;color: #198810&#34;&gt;&amp;#34;&lt;/span&gt;] &lt;span style=&#34;color: #d73948&#34;&gt;+=&lt;/span&gt; prose_wordcount
            site.words[&lt;span style=&#34;color: #198810&#34;&gt;&amp;#34;&lt;/span&gt;&lt;span style=&#34;color: #198810&#34;&gt;drafts&lt;/span&gt;&lt;span style=&#34;color: #198810&#34;&gt;&amp;#34;&lt;/span&gt;] &lt;span style=&#34;color: #d73948&#34;&gt;+=&lt;/span&gt; prose_wordcount
        &lt;span style=&#34;color: #d73948&#34;&gt;else&lt;/span&gt;:
            page.words[&lt;span style=&#34;color: #198810&#34;&gt;&amp;#34;&lt;/span&gt;&lt;span style=&#34;color: #198810&#34;&gt;self&lt;/span&gt;&lt;span style=&#34;color: #198810&#34;&gt;&amp;#34;&lt;/span&gt;] &lt;span style=&#34;color: #d73948&#34;&gt;+=&lt;/span&gt; prose_wordcount
            site.words[&lt;span style=&#34;color: #198810&#34;&gt;&amp;#34;&lt;/span&gt;&lt;span style=&#34;color: #198810&#34;&gt;self&lt;/span&gt;&lt;span style=&#34;color: #198810&#34;&gt;&amp;#34;&lt;/span&gt;] &lt;span style=&#34;color: #d73948&#34;&gt;+=&lt;/span&gt; prose_wordcount

            site.words[&lt;span style=&#34;color: #198810&#34;&gt;&amp;#34;&lt;/span&gt;&lt;span style=&#34;color: #198810&#34;&gt;references&lt;/span&gt;&lt;span style=&#34;color: #198810&#34;&gt;&amp;#34;&lt;/span&gt;] &lt;span style=&#34;color: #d73948&#34;&gt;+=&lt;/span&gt; references_wordcount
            page.words[&lt;span style=&#34;color: #198810&#34;&gt;&amp;#34;&lt;/span&gt;&lt;span style=&#34;color: #198810&#34;&gt;references&lt;/span&gt;&lt;span style=&#34;color: #198810&#34;&gt;&amp;#34;&lt;/span&gt;] &lt;span style=&#34;color: #d73948&#34;&gt;+=&lt;/span&gt; references_wordcount

        logger.&lt;span style=&#34;color: #4b69c6&#34;&gt;debug&lt;/span&gt;(&lt;span style=&#34;color: #d73948&#34;&gt;f&lt;/span&gt;&lt;span style=&#34;color: #198810&#34;&gt;&amp;#34;&lt;/span&gt;&lt;span style=&#34;color: #198810&#34;&gt;  &lt;/span&gt;&lt;span style=&#34;color: #8b41b1&#34;&gt;{&lt;/span&gt;&lt;span style=&#34;color: #8b41b1&#34;&gt;key&lt;/span&gt;&lt;span style=&#34;color: #8b41b1&#34;&gt;}&lt;/span&gt;&lt;span style=&#34;color: #198810&#34;&gt;, &lt;/span&gt;&lt;span style=&#34;color: #8b41b1&#34;&gt;{&lt;/span&gt;&lt;span style=&#34;color: #8b41b1&#34;&gt;page&lt;/span&gt;&lt;span style=&#34;color: #8b41b1&#34;&gt;.&lt;/span&gt;&lt;span style=&#34;color: #8b41b1&#34;&gt;title&lt;/span&gt;&lt;span style=&#34;color: #8b41b1&#34;&gt;[&lt;/span&gt;&lt;span style=&#34;color: #8b41b1&#34;&gt;:&lt;/span&gt;&lt;span style=&#34;color: #b60157&#34;&gt;40&lt;/span&gt;&lt;span style=&#34;color: #8b41b1&#34;&gt;]&lt;/span&gt;&lt;span style=&#34;color: #8b41b1&#34;&gt;}&lt;/span&gt;&lt;span style=&#34;color: #198810&#34;&gt;&amp;#34;&lt;/span&gt;)&lt;/code&gt;&lt;/pre&gt;&lt;/div&gt;&lt;p&gt;And then, during the syntax highlighting, the code lines are tallied up and then subtracted from the prose lines.&lt;/p&gt;&lt;div class=&#34;code-block&#34; data-lang=&#34;python&#34;&gt;&lt;div class=&#34;code-header&#34; data-mosaic-chrome=&#34;&#34;&gt;&lt;span class=&#34;code-lang&#34;&gt;python&lt;/span&gt;&lt;button class=&#34;code-copy&#34; aria-label=&#34;Copy code&#34; type=&#34;button&#34;&gt;Copy&lt;/button&gt;&lt;/div&gt;&lt;pre&gt;&lt;code data-lang=&#34;python&#34;&gt;&lt;span style=&#34;color: #d73948&#34;&gt;def&lt;/span&gt; &lt;span style=&#34;color: #4b69c6&#34;&gt;save_code_block&lt;/span&gt;(match):
    leading_space &lt;span style=&#34;color: #d73948&#34;&gt;=&lt;/span&gt; match.&lt;span style=&#34;color: #4b69c6&#34;&gt;group&lt;/span&gt;(&lt;span style=&#34;color: #b60157&#34;&gt;1&lt;/span&gt;)
    raw_html_marker &lt;span style=&#34;color: #d73948&#34;&gt;=&lt;/span&gt; match.&lt;span style=&#34;color: #4b69c6&#34;&gt;group&lt;/span&gt;(&lt;span style=&#34;color: #b60157&#34;&gt;2&lt;/span&gt;)
    language &lt;span style=&#34;color: #d73948&#34;&gt;=&lt;/span&gt; match.&lt;span style=&#34;color: #4b69c6&#34;&gt;group&lt;/span&gt;(&lt;span style=&#34;color: #b60157&#34;&gt;3&lt;/span&gt;)
    code &lt;span style=&#34;color: #d73948&#34;&gt;=&lt;/span&gt; match.&lt;span style=&#34;color: #4b69c6&#34;&gt;group&lt;/span&gt;(&lt;span style=&#34;color: #b60157&#34;&gt;4&lt;/span&gt;).&lt;span style=&#34;color: #4b69c6&#34;&gt;rstrip&lt;/span&gt;()
    trailing_space &lt;span style=&#34;color: #d73948&#34;&gt;=&lt;/span&gt; match.&lt;span style=&#34;color: #4b69c6&#34;&gt;group&lt;/span&gt;(&lt;span style=&#34;color: #b60157&#34;&gt;5&lt;/span&gt;)
    code_words &lt;span style=&#34;color: #d73948&#34;&gt;=&lt;/span&gt; &lt;span style=&#34;color: #4b69c6&#34;&gt;len&lt;/span&gt;(code.&lt;span style=&#34;color: #4b69c6&#34;&gt;split&lt;/span&gt;())
    code_lines &lt;span style=&#34;color: #d73948&#34;&gt;=&lt;/span&gt; &lt;span style=&#34;color: #4b69c6&#34;&gt;len&lt;/span&gt;(code.&lt;span style=&#34;color: #4b69c6&#34;&gt;splitlines&lt;/span&gt;())
    page.words[&lt;span style=&#34;color: #198810&#34;&gt;&amp;#34;&lt;/span&gt;&lt;span style=&#34;color: #198810&#34;&gt;code&lt;/span&gt;&lt;span style=&#34;color: #198810&#34;&gt;&amp;#34;&lt;/span&gt;][&lt;span style=&#34;color: #198810&#34;&gt;&amp;#34;&lt;/span&gt;&lt;span style=&#34;color: #198810&#34;&gt;lines&lt;/span&gt;&lt;span style=&#34;color: #198810&#34;&gt;&amp;#34;&lt;/span&gt;] &lt;span style=&#34;color: #d73948&#34;&gt;+=&lt;/span&gt; code_lines
    page.words[&lt;span style=&#34;color: #198810&#34;&gt;&amp;#34;&lt;/span&gt;&lt;span style=&#34;color: #198810&#34;&gt;code&lt;/span&gt;&lt;span style=&#34;color: #198810&#34;&gt;&amp;#34;&lt;/span&gt;][&lt;span style=&#34;color: #198810&#34;&gt;&amp;#34;&lt;/span&gt;&lt;span style=&#34;color: #198810&#34;&gt;words&lt;/span&gt;&lt;span style=&#34;color: #198810&#34;&gt;&amp;#34;&lt;/span&gt;] &lt;span style=&#34;color: #d73948&#34;&gt;+=&lt;/span&gt; code_words
    site.words[&lt;span style=&#34;color: #198810&#34;&gt;&amp;#34;&lt;/span&gt;&lt;span style=&#34;color: #198810&#34;&gt;code&lt;/span&gt;&lt;span style=&#34;color: #198810&#34;&gt;&amp;#34;&lt;/span&gt;][&lt;span style=&#34;color: #198810&#34;&gt;&amp;#34;&lt;/span&gt;&lt;span style=&#34;color: #198810&#34;&gt;lines&lt;/span&gt;&lt;span style=&#34;color: #198810&#34;&gt;&amp;#34;&lt;/span&gt;] &lt;span style=&#34;color: #d73948&#34;&gt;+=&lt;/span&gt; code_lines
    site.words[&lt;span style=&#34;color: #198810&#34;&gt;&amp;#34;&lt;/span&gt;&lt;span style=&#34;color: #198810&#34;&gt;code&lt;/span&gt;&lt;span style=&#34;color: #198810&#34;&gt;&amp;#34;&lt;/span&gt;][&lt;span style=&#34;color: #198810&#34;&gt;&amp;#34;&lt;/span&gt;&lt;span style=&#34;color: #198810&#34;&gt;words&lt;/span&gt;&lt;span style=&#34;color: #198810&#34;&gt;&amp;#34;&lt;/span&gt;] &lt;span style=&#34;color: #d73948&#34;&gt;+=&lt;/span&gt; code_words
    &lt;span style=&#34;color: #74747c&#34;&gt;#&lt;/span&gt;&lt;span style=&#34;color: #74747c&#34;&gt; Remove the wordcount of codeblocks from the prose wordcounts&lt;/span&gt;
    page.words[&lt;span style=&#34;color: #198810&#34;&gt;&amp;#34;&lt;/span&gt;&lt;span style=&#34;color: #198810&#34;&gt;self&lt;/span&gt;&lt;span style=&#34;color: #198810&#34;&gt;&amp;#34;&lt;/span&gt;] &lt;span style=&#34;color: #d73948&#34;&gt;-=&lt;/span&gt; code_words
    site.words[&lt;span style=&#34;color: #198810&#34;&gt;&amp;#34;&lt;/span&gt;&lt;span style=&#34;color: #198810&#34;&gt;self&lt;/span&gt;&lt;span style=&#34;color: #198810&#34;&gt;&amp;#34;&lt;/span&gt;] &lt;span style=&#34;color: #d73948&#34;&gt;-=&lt;/span&gt; code_words

    &lt;span style=&#34;color: #d73948&#34;&gt;...&lt;/span&gt;&lt;/code&gt;&lt;/pre&gt;&lt;/div&gt;&lt;p&gt;The result is exactly what I wanted, but the method isn’t super elegant.&lt;/p&gt;&lt;p&gt;Including this post, the current counts are as follows,&lt;/p&gt;&lt;div class=&#34;code-block&#34; data-lang=&#34;console&#34;&gt;&lt;div class=&#34;code-header&#34; data-mosaic-chrome=&#34;&#34;&gt;&lt;span class=&#34;code-lang&#34;&gt;console&lt;/span&gt;&lt;button class=&#34;code-copy&#34; aria-label=&#34;Copy code&#34; type=&#34;button&#34;&gt;Copy&lt;/button&gt;&lt;/div&gt;&lt;pre&gt;&lt;code data-lang=&#34;console&#34;&gt;222,852 words

    136,784 of my own published words
     21,441 words of unpublished drafts
     64,627 words of quotes and reference material
      6,659 lines of code
     24,182 words of code&lt;/code&gt;&lt;/pre&gt;&lt;/div&gt;10:27am on December 15, 2024 from Kitsilano, Vancouver, British Columbia, Canada&lt;p&gt;&lt;a href=&#34;mailto:reply@silasjelley.com?subject=Reply%20to%3A%20%E2%80%9CDistinguishing%20between%20prose%20and%20code%20when%20counting%20words%E2%80%9D&#34;&gt;Reply via email&lt;/a&gt;&lt;/p&gt;
</content>
</entry>
<entry>
  <title>Include all external URLs in site statistics</title>
  <link rel="alternate" type="text/html" href="https://silasjelley.com/2024/12/11/094929" />
  <id>tag:silasjelley.com,2020-08-20:12b3458c-71f1-497d-a431-74f0a7f79a60</id>
  <published>2024-12-11T09:49:29-08:00</published>
  <updated>2024-12-11T09:49:29-08:00</updated>
  <category term="notes" />
  <category term="changelogs" />
  <summary>The stats page has long shown a count of the number of unique external links referenced on the site. Before this change the stats showed 483 unique external links, the relevant code is contained in…</summary>
<mosaic:place>Kitsilano, Vancouver, British Columbia, Canada</mosaic:place>
<content type="html">
    &lt;p&gt;The &lt;a href=&#34;/stats&#34; title=&#34;Stats | June 2022&#34; data-preview=&#34;/previews/e8498b85-a357-499f-9f4e-f504cf2afa7a.html&#34;&gt;stats page&lt;/a&gt; has long shown a count of the number of unique external links referenced on the site. Before this change the stats showed 483 unique external links, the relevant code is contained in the snippet below,&lt;/p&gt;&lt;div class=&#34;code-block&#34; data-lang=&#34;python&#34;&gt;&lt;div class=&#34;code-header&#34; data-mosaic-chrome=&#34;&#34;&gt;&lt;span class=&#34;code-lang&#34;&gt;python&lt;/span&gt;&lt;button class=&#34;code-copy&#34; aria-label=&#34;Copy code&#34; type=&#34;button&#34;&gt;Copy&lt;/button&gt;&lt;/div&gt;&lt;pre&gt;&lt;code data-lang=&#34;python&#34;&gt;&lt;span style=&#34;color: #d73948&#34;&gt;def&lt;/span&gt; &lt;span style=&#34;color: #4b69c6&#34;&gt;extract_external_links&lt;/span&gt;(text: &lt;span style=&#34;color: #4b69c6&#34;&gt;str&lt;/span&gt;) -&amp;gt; List:
    url_pattern &lt;span style=&#34;color: #d73948&#34;&gt;=&lt;/span&gt; &lt;span style=&#34;color: #d73948&#34;&gt;r&lt;/span&gt;&lt;span style=&#34;color: #198810&#34;&gt;&amp;#34;&lt;/span&gt;&lt;span style=&#34;color: #198810&#34;&gt;(&lt;/span&gt;&lt;span style=&#34;color: #198810&#34;&gt;https&lt;/span&gt;&lt;span style=&#34;color: #d73948&#34;&gt;?&lt;/span&gt;&lt;span style=&#34;color: #198810&#34;&gt;://&lt;/span&gt;&lt;span style=&#34;color: #198810&#34;&gt;(&lt;/span&gt;&lt;span style=&#34;color: #198810&#34;&gt;?:&lt;/span&gt;&lt;span style=&#34;color: #b60157&#34;&gt;[&lt;/span&gt;&lt;span style=&#34;color: #b60157&#34;&gt;-&lt;/span&gt;&lt;span style=&#34;color: #b60157&#34;&gt;\w&lt;/span&gt;&lt;span style=&#34;color: #b60157&#34;&gt;.&lt;/span&gt;&lt;span style=&#34;color: #b60157&#34;&gt;]&lt;/span&gt;&lt;span style=&#34;color: #d73948&#34;&gt;|&lt;/span&gt;&lt;span style=&#34;color: #198810&#34;&gt;(&lt;/span&gt;&lt;span style=&#34;color: #198810&#34;&gt;?:&lt;/span&gt;&lt;span style=&#34;color: #198810&#34;&gt;%&lt;/span&gt;&lt;span style=&#34;color: #b60157&#34;&gt;[&lt;/span&gt;&lt;span style=&#34;color: #b60157&#34;&gt;\d&lt;/span&gt;&lt;span style=&#34;color: #b60157&#34;&gt;a-f&lt;/span&gt;&lt;span style=&#34;color: #b60157&#34;&gt;A-F&lt;/span&gt;&lt;span style=&#34;color: #b60157&#34;&gt;]&lt;/span&gt;&lt;span style=&#34;color: #d73948&#34;&gt;{2}&lt;/span&gt;&lt;span style=&#34;color: #198810&#34;&gt;)&lt;/span&gt;&lt;span style=&#34;color: #198810&#34;&gt;)&lt;/span&gt;&lt;span style=&#34;color: #d73948&#34;&gt;+&lt;/span&gt;&lt;span style=&#34;color: #198810&#34;&gt;(&lt;/span&gt;&lt;span style=&#34;color: #198810&#34;&gt;?:&lt;/span&gt;&lt;span style=&#34;color: #198810&#34;&gt;/&lt;/span&gt;&lt;span style=&#34;color: #b60157&#34;&gt;[&lt;/span&gt;&lt;span style=&#34;color: #d73948&#34;&gt;^&lt;/span&gt;&lt;span style=&#34;color: #b60157&#34;&gt;)&lt;/span&gt;&lt;span style=&#34;color: #b60157&#34;&gt;\s&lt;/span&gt;&lt;span style=&#34;color: #b60157&#34;&gt;]&lt;/span&gt;&lt;span style=&#34;color: #d73948&#34;&gt;*&lt;/span&gt;&lt;span style=&#34;color: #198810&#34;&gt;)&lt;/span&gt;&lt;span style=&#34;color: #d73948&#34;&gt;?&lt;/span&gt;&lt;span style=&#34;color: #198810&#34;&gt;)&lt;/span&gt;&lt;span style=&#34;color: #198810&#34;&gt;&amp;#34;&lt;/span&gt;
    matches &lt;span style=&#34;color: #d73948&#34;&gt;=&lt;/span&gt; re.&lt;span style=&#34;color: #4b69c6&#34;&gt;findall&lt;/span&gt;(url_pattern, text)

    external_links &lt;span style=&#34;color: #d73948&#34;&gt;=&lt;/span&gt; &lt;span style=&#34;color: #4b69c6&#34;&gt;set&lt;/span&gt;()
    &lt;span style=&#34;color: #d73948&#34;&gt;for&lt;/span&gt; url &lt;span style=&#34;color: #d73948&#34;&gt;in&lt;/span&gt; matches:
        parsed_url &lt;span style=&#34;color: #d73948&#34;&gt;=&lt;/span&gt; &lt;span style=&#34;color: #4b69c6&#34;&gt;urlparse&lt;/span&gt;(url)
        &lt;span style=&#34;color: #d73948&#34;&gt;if&lt;/span&gt; parsed_url.netloc.&lt;span style=&#34;color: #4b69c6&#34;&gt;lower&lt;/span&gt;() &lt;span style=&#34;color: #d73948&#34;&gt;!=&lt;/span&gt; &lt;span style=&#34;color: #198810&#34;&gt;&amp;#34;&lt;/span&gt;&lt;span style=&#34;color: #198810&#34;&gt;silasjelley.com&lt;/span&gt;&lt;span style=&#34;color: #198810&#34;&gt;&amp;#34;&lt;/span&gt;:
            external_links.&lt;span style=&#34;color: #4b69c6&#34;&gt;add&lt;/span&gt;(url)

    &lt;span style=&#34;color: #d73948&#34;&gt;return&lt;/span&gt; &lt;span style=&#34;color: #4b69c6&#34;&gt;list&lt;/span&gt;(external_links)

&lt;span style=&#34;color: #d73948&#34;&gt;...&lt;/span&gt;

&lt;span style=&#34;color: #d73948&#34;&gt;try&lt;/span&gt;:
    plain_text &lt;span style=&#34;color: #d73948&#34;&gt;=&lt;/span&gt; document[&lt;span style=&#34;color: #198810&#34;&gt;&amp;#34;&lt;/span&gt;&lt;span style=&#34;color: #198810&#34;&gt;content&lt;/span&gt;&lt;span style=&#34;color: #198810&#34;&gt;&amp;#34;&lt;/span&gt;][&lt;span style=&#34;color: #198810&#34;&gt;&amp;#34;&lt;/span&gt;&lt;span style=&#34;color: #198810&#34;&gt;plain&lt;/span&gt;&lt;span style=&#34;color: #198810&#34;&gt;&amp;#34;&lt;/span&gt;]
    external_links &lt;span style=&#34;color: #d73948&#34;&gt;=&lt;/span&gt; &lt;span style=&#34;color: #4b69c6&#34;&gt;extract_external_links&lt;/span&gt;(plain_text)

    document[&lt;span style=&#34;color: #198810&#34;&gt;&amp;#34;&lt;/span&gt;&lt;span style=&#34;color: #198810&#34;&gt;links&lt;/span&gt;&lt;span style=&#34;color: #198810&#34;&gt;&amp;#34;&lt;/span&gt;][&lt;span style=&#34;color: #198810&#34;&gt;&amp;#34;&lt;/span&gt;&lt;span style=&#34;color: #198810&#34;&gt;external&lt;/span&gt;&lt;span style=&#34;color: #198810&#34;&gt;&amp;#34;&lt;/span&gt;].&lt;span style=&#34;color: #4b69c6&#34;&gt;update&lt;/span&gt;(external_links)
    site.links[&lt;span style=&#34;color: #198810&#34;&gt;&amp;#34;&lt;/span&gt;&lt;span style=&#34;color: #198810&#34;&gt;external&lt;/span&gt;&lt;span style=&#34;color: #198810&#34;&gt;&amp;#34;&lt;/span&gt;].&lt;span style=&#34;color: #4b69c6&#34;&gt;update&lt;/span&gt;(external_links)
&lt;span style=&#34;color: #d73948&#34;&gt;except&lt;/span&gt; &lt;span style=&#34;color: #4b69c6&#34;&gt;KeyError&lt;/span&gt;:
    &lt;span style=&#34;color: #d73948&#34;&gt;pass&lt;/span&gt;&lt;/code&gt;&lt;/pre&gt;&lt;/div&gt;&lt;p&gt;Up to now I’ve only included links within the main body of a page (&lt;code&gt;content[&amp;#34;plain&amp;#34;]&lt;/code&gt;), but my document format has evolved since then with more and more links being structured into the &lt;code&gt;[source]&lt;/code&gt; and &lt;code&gt;[via]&lt;/code&gt; tables.&lt;/p&gt;&lt;p&gt;First I wanted to grasp what kind of a difference this would make so, as usual, I started with a shell pipeline search through the output of the build script,&lt;/p&gt;&lt;div class=&#34;code-block&#34; data-lang=&#34;sh&#34;&gt;&lt;div class=&#34;code-header&#34; data-mosaic-chrome=&#34;&#34;&gt;&lt;span class=&#34;code-lang&#34;&gt;sh&lt;/span&gt;&lt;button class=&#34;code-copy&#34; aria-label=&#34;Copy code&#34; type=&#34;button&#34;&gt;Copy&lt;/button&gt;&lt;/div&gt;&lt;pre&gt;&lt;code data-lang=&#34;sh&#34;&gt;&lt;span style=&#34;color: #4b69c6&#34;&gt;rg&lt;/span&gt; --no-filename \
   --only-matching \
   --no-line-number \
   &lt;span style=&#34;color: #198810&#34;&gt;&amp;#39;&lt;/span&gt;&lt;span style=&#34;color: #198810&#34;&gt;http.*?://[^ \[\]&amp;#34;&amp;amp;&amp;lt;&amp;gt;)]*&lt;/span&gt;&lt;span style=&#34;color: #198810&#34;&gt;&amp;#39;&lt;/span&gt; \
   &lt;span style=&#34;color: #d73948&#34;&gt;*&lt;/span&gt;&lt;span style=&#34;color: #d73948&#34;&gt;*&lt;/span&gt;/&lt;span style=&#34;color: #d73948&#34;&gt;*&lt;/span&gt;.html &lt;span style=&#34;color: #d73948&#34;&gt;|&lt;/span&gt; \
   &lt;span style=&#34;color: #4b69c6&#34;&gt;sed&lt;/span&gt; \
     -e &lt;span style=&#34;color: #198810&#34;&gt;&amp;#34;&lt;/span&gt;&lt;span style=&#34;color: #198810&#34;&gt;s/&amp;#39;.*//&lt;/span&gt;&lt;span style=&#34;color: #198810&#34;&gt;&amp;#34;&lt;/span&gt; \
     -e &lt;span style=&#34;color: #198810&#34;&gt;&amp;#39;&lt;/span&gt;&lt;span style=&#34;color: #198810&#34;&gt;/silasjelley\.com/d&lt;/span&gt;&lt;span style=&#34;color: #198810&#34;&gt;&amp;#39;&lt;/span&gt; \
     -e &lt;span style=&#34;color: #198810&#34;&gt;&amp;#39;&lt;/span&gt;&lt;span style=&#34;color: #198810&#34;&gt;s,/$,,&lt;/span&gt;&lt;span style=&#34;color: #198810&#34;&gt;&amp;#39;&lt;/span&gt; \
     -e &lt;span style=&#34;color: #198810&#34;&gt;&amp;#39;&lt;/span&gt;&lt;span style=&#34;color: #198810&#34;&gt;s/#.*//&lt;/span&gt;&lt;span style=&#34;color: #198810&#34;&gt;&amp;#39;&lt;/span&gt; &lt;span style=&#34;color: #d73948&#34;&gt;|&lt;/span&gt; \
     &lt;span style=&#34;color: #4b69c6&#34;&gt;sort&lt;/span&gt; &lt;span style=&#34;color: #d73948&#34;&gt;|&lt;/span&gt; \
     &lt;span style=&#34;color: #4b69c6&#34;&gt;uniq&lt;/span&gt; &lt;span style=&#34;color: #d73948&#34;&gt;|&lt;/span&gt; \
     &lt;span style=&#34;color: #4b69c6&#34;&gt;wc&lt;/span&gt; -l&lt;/code&gt;&lt;/pre&gt;&lt;/div&gt;&lt;p&gt;The regex for link matching was pretty coarse so I tidied/normalised the output and removed internal links with some &lt;code&gt;sed&lt;/code&gt; patterns, before sorting, de-duping, and counting (&lt;code&gt; sort | uniq | wc -l &lt;/code&gt;).&lt;/p&gt;&lt;p&gt;The result: 907 unique external links, almost double the 483 contained purely in the main body content.&lt;/p&gt;&lt;p&gt;Now that number is slightly inflated as it includes links to external APIs such as &lt;code&gt;https://api.maptiler.com/maps/topo-v2/{z}/{x}/{y}.png?key=APIKEY&lt;/code&gt; for &lt;a href=&#34;/map&#34; title=&#34;Map of my world | July 2023&#34; data-preview=&#34;/previews/72577fcb-975d-44e7-818a-8d29fe2e6213.html&#34;&gt;my walk map&lt;/a&gt;, so our final number should be slightly lower.&lt;/p&gt;&lt;p&gt;This change includes the &lt;code&gt;[source]&lt;/code&gt; and &lt;code&gt;[via]&lt;/code&gt; tables when searching for links,&lt;/p&gt;&lt;div class=&#34;code-block&#34; data-lang=&#34;python&#34;&gt;&lt;div class=&#34;code-header&#34; data-mosaic-chrome=&#34;&#34;&gt;&lt;span class=&#34;code-lang&#34;&gt;python&lt;/span&gt;&lt;button class=&#34;code-copy&#34; aria-label=&#34;Copy code&#34; type=&#34;button&#34;&gt;Copy&lt;/button&gt;&lt;/div&gt;&lt;pre&gt;&lt;code data-lang=&#34;python&#34;&gt;&lt;span style=&#34;color: #d73948&#34;&gt;try&lt;/span&gt;:
    plain_text &lt;span style=&#34;color: #d73948&#34;&gt;=&lt;/span&gt; document.&lt;span style=&#34;color: #4b69c6&#34;&gt;get&lt;/span&gt;(&lt;span style=&#34;color: #198810&#34;&gt;&amp;#34;&lt;/span&gt;&lt;span style=&#34;color: #198810&#34;&gt;content&lt;/span&gt;&lt;span style=&#34;color: #198810&#34;&gt;&amp;#34;&lt;/span&gt;, {}).&lt;span style=&#34;color: #4b69c6&#34;&gt;get&lt;/span&gt;(&lt;span style=&#34;color: #198810&#34;&gt;&amp;#34;&lt;/span&gt;&lt;span style=&#34;color: #198810&#34;&gt;plain&lt;/span&gt;&lt;span style=&#34;color: #198810&#34;&gt;&amp;#34;&lt;/span&gt;, &lt;span style=&#34;color: #198810&#34;&gt;&amp;#34;&lt;/span&gt;&lt;span style=&#34;color: #198810&#34;&gt;&amp;#34;&lt;/span&gt;) &lt;span style=&#34;color: #d73948&#34;&gt;+&lt;/span&gt; &lt;span style=&#34;color: #198810&#34;&gt;&amp;#34;&lt;/span&gt;&lt;span style=&#34;color: #198810&#34;&gt; &lt;/span&gt;&lt;span style=&#34;color: #198810&#34;&gt;&amp;#34;&lt;/span&gt;
    plain_text &lt;span style=&#34;color: #d73948&#34;&gt;+=&lt;/span&gt; document.&lt;span style=&#34;color: #4b69c6&#34;&gt;get&lt;/span&gt;(&lt;span style=&#34;color: #198810&#34;&gt;&amp;#34;&lt;/span&gt;&lt;span style=&#34;color: #198810&#34;&gt;source&lt;/span&gt;&lt;span style=&#34;color: #198810&#34;&gt;&amp;#34;&lt;/span&gt;, {}).&lt;span style=&#34;color: #4b69c6&#34;&gt;get&lt;/span&gt;(&lt;span style=&#34;color: #198810&#34;&gt;&amp;#34;&lt;/span&gt;&lt;span style=&#34;color: #198810&#34;&gt;url&lt;/span&gt;&lt;span style=&#34;color: #198810&#34;&gt;&amp;#34;&lt;/span&gt;, &lt;span style=&#34;color: #198810&#34;&gt;&amp;#34;&lt;/span&gt;&lt;span style=&#34;color: #198810&#34;&gt;&amp;#34;&lt;/span&gt;) &lt;span style=&#34;color: #d73948&#34;&gt;+&lt;/span&gt; &lt;span style=&#34;color: #198810&#34;&gt;&amp;#34;&lt;/span&gt;&lt;span style=&#34;color: #198810&#34;&gt; &lt;/span&gt;&lt;span style=&#34;color: #198810&#34;&gt;&amp;#34;&lt;/span&gt;
    plain_text &lt;span style=&#34;color: #d73948&#34;&gt;+=&lt;/span&gt; document.&lt;span style=&#34;color: #4b69c6&#34;&gt;get&lt;/span&gt;(&lt;span style=&#34;color: #198810&#34;&gt;&amp;#34;&lt;/span&gt;&lt;span style=&#34;color: #198810&#34;&gt;via&lt;/span&gt;&lt;span style=&#34;color: #198810&#34;&gt;&amp;#34;&lt;/span&gt;, {}).&lt;span style=&#34;color: #4b69c6&#34;&gt;get&lt;/span&gt;(&lt;span style=&#34;color: #198810&#34;&gt;&amp;#34;&lt;/span&gt;&lt;span style=&#34;color: #198810&#34;&gt;url&lt;/span&gt;&lt;span style=&#34;color: #198810&#34;&gt;&amp;#34;&lt;/span&gt;, &lt;span style=&#34;color: #198810&#34;&gt;&amp;#34;&lt;/span&gt;&lt;span style=&#34;color: #198810&#34;&gt;&amp;#34;&lt;/span&gt;) &lt;span style=&#34;color: #d73948&#34;&gt;+&lt;/span&gt; &lt;span style=&#34;color: #198810&#34;&gt;&amp;#34;&lt;/span&gt;&lt;span style=&#34;color: #198810&#34;&gt; &lt;/span&gt;&lt;span style=&#34;color: #198810&#34;&gt;&amp;#34;&lt;/span&gt;

    external_links &lt;span style=&#34;color: #d73948&#34;&gt;=&lt;/span&gt; &lt;span style=&#34;color: #4b69c6&#34;&gt;extract_external_links&lt;/span&gt;(plain_text)

    document[&lt;span style=&#34;color: #198810&#34;&gt;&amp;#34;&lt;/span&gt;&lt;span style=&#34;color: #198810&#34;&gt;links&lt;/span&gt;&lt;span style=&#34;color: #198810&#34;&gt;&amp;#34;&lt;/span&gt;][&lt;span style=&#34;color: #198810&#34;&gt;&amp;#34;&lt;/span&gt;&lt;span style=&#34;color: #198810&#34;&gt;external&lt;/span&gt;&lt;span style=&#34;color: #198810&#34;&gt;&amp;#34;&lt;/span&gt;].&lt;span style=&#34;color: #4b69c6&#34;&gt;update&lt;/span&gt;(external_links)
    site.links[&lt;span style=&#34;color: #198810&#34;&gt;&amp;#34;&lt;/span&gt;&lt;span style=&#34;color: #198810&#34;&gt;external&lt;/span&gt;&lt;span style=&#34;color: #198810&#34;&gt;&amp;#34;&lt;/span&gt;].&lt;span style=&#34;color: #4b69c6&#34;&gt;update&lt;/span&gt;(external_links)
&lt;span style=&#34;color: #d73948&#34;&gt;except&lt;/span&gt; &lt;span style=&#34;color: #4b69c6&#34;&gt;KeyError&lt;/span&gt;:
    &lt;span style=&#34;color: #4b69c6&#34;&gt;print&lt;/span&gt;(&lt;span style=&#34;color: #d73948&#34;&gt;f&lt;/span&gt;&lt;span style=&#34;color: #198810&#34;&gt;&amp;#34;&lt;/span&gt;&lt;span style=&#34;color: #198810&#34;&gt;KeyError while compiling external links from &lt;/span&gt;&lt;span style=&#34;color: #8b41b1&#34;&gt;{&lt;/span&gt;&lt;span style=&#34;color: #8b41b1&#34;&gt;document&lt;/span&gt;&lt;span style=&#34;color: #8b41b1&#34;&gt;[&lt;/span&gt;&lt;span style=&#34;color: #198810&#34;&gt;&amp;#39;&lt;/span&gt;&lt;span style=&#34;color: #198810&#34;&gt;filename&lt;/span&gt;&lt;span style=&#34;color: #198810&#34;&gt;&amp;#39;&lt;/span&gt;&lt;span style=&#34;color: #8b41b1&#34;&gt;]&lt;/span&gt;&lt;span style=&#34;color: #8b41b1&#34;&gt;}&lt;/span&gt;&lt;span style=&#34;color: #198810&#34;&gt;&amp;#34;&lt;/span&gt;)
    &lt;span style=&#34;color: #d73948&#34;&gt;pass&lt;/span&gt;&lt;/code&gt;&lt;/pre&gt;&lt;/div&gt;&lt;p&gt;After the change, the stats reflect 869 unique external links.&lt;/p&gt;9:49am on December 11, 2024 from Kitsilano, Vancouver, British Columbia, Canada&lt;p&gt;&lt;a href=&#34;mailto:reply@silasjelley.com?subject=Reply%20to%3A%20%E2%80%9CInclude%20all%20external%20URLs%20in%20site%20statistics%E2%80%9D&#34;&gt;Reply via email&lt;/a&gt;&lt;/p&gt;
</content>
</entry>
<entry>
  <title>Switch image references to use picture elements and AVIF encoded files</title>
  <link rel="alternate" type="text/html" href="https://silasjelley.com/2024/12/04/181603" />
  <id>tag:silasjelley.com,2020-08-20:5f39dd4e-8ae8-47d3-a3ff-120f9ce3d0c9</id>
  <published>2024-12-04T18:16:03-08:00</published>
  <updated>2024-12-04T18:16:03-08:00</updated>
  <category term="notes" />
  <category term="changelogs" />
  <summary>Up to now, image references, eg. #link(&#34;img:​:5f39dd4e&#34;)[::ImageAlt] have functioned like so: The source section (between parentheses) is substituted directly from the asset manifest, in this case…</summary>
<mosaic:place>Yaletown, Vancouver, British Columbia, Canada</mosaic:place>
<content type="html">
    &lt;p&gt;Up to now, image references, eg. &lt;code&gt;#link(&amp;#34;img:​:5f39dd4e&amp;#34;)[::ImageAlt]&lt;/code&gt; have functioned like so:&lt;/p&gt;&lt;ul&gt;&lt;li&gt;The source section (between parentheses) is substituted directly from the asset manifest, in this case referenced by the first 8-chars of its UUIDv4.&lt;/li&gt;&lt;li&gt;If the Alt-text [between square brackets] begins with ‘::’, it is also replaced by the description from the corresponding asset manifest, else it is left as is.&lt;/li&gt;&lt;/ul&gt;&lt;p&gt;This has worked well, but I’ve been wanting to add AVIF support in order to take advantage of its better compression performance. AVIF is not universally supported, so a fallback (eg. JPEG) is necessary. The HTML &lt;code&gt;\&amp;lt;picture&amp;gt;&lt;/code&gt; element is well suited to this. The Djot image syntax has been bypassed, image references are now directly replaced with a final HTML snippet like so,&lt;/p&gt;&lt;div class=&#34;code-block&#34; data-lang=&#34;python&#34;&gt;&lt;div class=&#34;code-header&#34; data-mosaic-chrome=&#34;&#34;&gt;&lt;span class=&#34;code-lang&#34;&gt;python&lt;/span&gt;&lt;button class=&#34;code-copy&#34; aria-label=&#34;Copy code&#34; type=&#34;button&#34;&gt;Copy&lt;/button&gt;&lt;/div&gt;&lt;pre&gt;&lt;code data-lang=&#34;python&#34;&gt;replacement &lt;span style=&#34;color: #d73948&#34;&gt;=&lt;/span&gt; &lt;span style=&#34;color: #d73948&#34;&gt;f&lt;/span&gt;&lt;span style=&#34;color: #198810&#34;&gt;&amp;#34;&amp;#34;&amp;#34;&lt;/span&gt;&lt;span style=&#34;color: #198810&#34;&gt;`​`​`=html&lt;/span&gt;
&lt;span style=&#34;color: #198810&#34;&gt;\&amp;lt;&lt;/span&gt;&lt;span style=&#34;color: #198810&#34;&gt;picture&amp;gt;&lt;/span&gt;
&lt;span style=&#34;color: #198810&#34;&gt;\&amp;lt;&lt;/span&gt;&lt;span style=&#34;color: #198810&#34;&gt;source srcset=&amp;#34;&lt;/span&gt;&lt;span style=&#34;color: #8b41b1&#34;&gt;{&lt;/span&gt;&lt;span style=&#34;color: #4b69c6&#34;&gt;Path&lt;/span&gt;&lt;span style=&#34;color: #8b41b1&#34;&gt;(&lt;/span&gt;&lt;span style=&#34;color: #8b41b1&#34;&gt;ref_slug&lt;/span&gt;&lt;span style=&#34;color: #8b41b1&#34;&gt;)&lt;/span&gt;&lt;span style=&#34;color: #8b41b1&#34;&gt;.&lt;/span&gt;&lt;span style=&#34;color: #4b69c6&#34;&gt;with_suffix&lt;/span&gt;&lt;span style=&#34;color: #8b41b1&#34;&gt;(&lt;/span&gt;&lt;span style=&#34;color: #198810&#34;&gt;&amp;#34;&lt;/span&gt;&lt;span style=&#34;color: #198810&#34;&gt;.avif&lt;/span&gt;&lt;span style=&#34;color: #198810&#34;&gt;&amp;#34;&lt;/span&gt;&lt;span style=&#34;color: #8b41b1&#34;&gt;)&lt;/span&gt;&lt;span style=&#34;color: #8b41b1&#34;&gt;}&lt;/span&gt;&lt;span style=&#34;color: #198810&#34;&gt;&amp;#34; type=&amp;#34;image/avif&amp;#34; /&amp;gt;&lt;/span&gt;
&lt;span style=&#34;color: #198810&#34;&gt;\&amp;lt;&lt;/span&gt;&lt;span style=&#34;color: #198810&#34;&gt;img alt=&amp;#34;&lt;/span&gt;&lt;span style=&#34;color: #8b41b1&#34;&gt;{&lt;/span&gt;&lt;span style=&#34;color: #8b41b1&#34;&gt;ref_text&lt;/span&gt;&lt;span style=&#34;color: #8b41b1&#34;&gt;}&lt;/span&gt;&lt;span style=&#34;color: #198810&#34;&gt;&amp;#34; src=&amp;#34;&lt;/span&gt;&lt;span style=&#34;color: #8b41b1&#34;&gt;{&lt;/span&gt;&lt;span style=&#34;color: #8b41b1&#34;&gt;ref_slug&lt;/span&gt;&lt;span style=&#34;color: #8b41b1&#34;&gt;}&lt;/span&gt;&lt;span style=&#34;color: #198810&#34;&gt;&amp;#34;&amp;gt;&lt;/span&gt;
&lt;span style=&#34;color: #198810&#34;&gt;\&amp;lt;&lt;/span&gt;&lt;span style=&#34;color: #198810&#34;&gt;/picture&amp;gt;&lt;/span&gt;
&lt;span style=&#34;color: #198810&#34;&gt;`​`​`&lt;/span&gt;&lt;span style=&#34;color: #198810&#34;&gt;&amp;#34;&amp;#34;&amp;#34;&lt;/span&gt;&lt;/code&gt;&lt;/pre&gt;&lt;/div&gt;&lt;p&gt;The actual AVIF creation support was added using &lt;code&gt;pillow_avif-plugin&lt;/code&gt;, a plugin for the Pillow library I was already using for compressing JPEGs. Most of the relevant code is in the &lt;code&gt;process_image_parallel&lt;/code&gt; function,&lt;/p&gt;&lt;div class=&#34;code-block&#34; data-lang=&#34;python&#34;&gt;&lt;div class=&#34;code-header&#34; data-mosaic-chrome=&#34;&#34;&gt;&lt;span class=&#34;code-lang&#34;&gt;python&lt;/span&gt;&lt;button class=&#34;code-copy&#34; aria-label=&#34;Copy code&#34; type=&#34;button&#34;&gt;Copy&lt;/button&gt;&lt;/div&gt;&lt;pre&gt;&lt;code data-lang=&#34;python&#34;&gt;&lt;span style=&#34;color: #d73948&#34;&gt;def&lt;/span&gt; &lt;span style=&#34;color: #4b69c6&#34;&gt;process_image_parallel&lt;/span&gt;(input_data: Tuple[Path, Path, &lt;span style=&#34;color: #4b69c6&#34;&gt;int&lt;/span&gt;, &lt;span style=&#34;color: #4b69c6&#34;&gt;str&lt;/span&gt;]) -&amp;gt; &lt;span style=&#34;color: #d73948&#34;&gt;None&lt;/span&gt;:
    workaround_import &lt;span style=&#34;color: #d73948&#34;&gt;=&lt;/span&gt; pillow_avif.AvifImagePlugin
    input_image, output_path, output_width, uid &lt;span style=&#34;color: #d73948&#34;&gt;=&lt;/span&gt; input_data
    lock_path &lt;span style=&#34;color: #d73948&#34;&gt;=&lt;/span&gt; output_path.&lt;span style=&#34;color: #4b69c6&#34;&gt;with_suffix&lt;/span&gt;(&lt;span style=&#34;color: #198810&#34;&gt;&amp;#34;&lt;/span&gt;&lt;span style=&#34;color: #198810&#34;&gt;.lock&lt;/span&gt;&lt;span style=&#34;color: #198810&#34;&gt;&amp;#34;&lt;/span&gt;)
    lock &lt;span style=&#34;color: #d73948&#34;&gt;=&lt;/span&gt; &lt;span style=&#34;color: #4b69c6&#34;&gt;FileLock&lt;/span&gt;(&lt;span style=&#34;color: #4b69c6&#34;&gt;str&lt;/span&gt;(lock_path))

    &lt;span style=&#34;color: #74747c&#34;&gt;#&lt;/span&gt;&lt;span style=&#34;color: #74747c&#34;&gt; Define AVIF output path&lt;/span&gt;
    avif_output_path &lt;span style=&#34;color: #d73948&#34;&gt;=&lt;/span&gt; output_path.&lt;span style=&#34;color: #4b69c6&#34;&gt;with_suffix&lt;/span&gt;(&lt;span style=&#34;color: #198810&#34;&gt;&amp;#34;&lt;/span&gt;&lt;span style=&#34;color: #198810&#34;&gt;.avif&lt;/span&gt;&lt;span style=&#34;color: #198810&#34;&gt;&amp;#34;&lt;/span&gt;)

    &lt;span style=&#34;color: #74747c&#34;&gt;#&lt;/span&gt;&lt;span style=&#34;color: #74747c&#34;&gt; Check if AVIF support is available&lt;/span&gt;
    avif_available &lt;span style=&#34;color: #d73948&#34;&gt;=&lt;/span&gt; &lt;span style=&#34;color: #198810&#34;&gt;&amp;#34;&lt;/span&gt;&lt;span style=&#34;color: #198810&#34;&gt;AVIF&lt;/span&gt;&lt;span style=&#34;color: #198810&#34;&gt;&amp;#34;&lt;/span&gt; &lt;span style=&#34;color: #d73948&#34;&gt;in&lt;/span&gt; Image.SAVE

    &lt;span style=&#34;color: #d73948&#34;&gt;try&lt;/span&gt;:
        &lt;span style=&#34;color: #d73948&#34;&gt;with&lt;/span&gt; lock:
            &lt;span style=&#34;color: #d73948&#34;&gt;if&lt;/span&gt; output_path.&lt;span style=&#34;color: #4b69c6&#34;&gt;exists&lt;/span&gt;() &lt;span style=&#34;color: #d73948&#34;&gt;and&lt;/span&gt; avif_output_path.&lt;span style=&#34;color: #4b69c6&#34;&gt;exists&lt;/span&gt;():
                &lt;span style=&#34;color: #d73948&#34;&gt;return&lt;/span&gt;

            os.&lt;span style=&#34;color: #4b69c6&#34;&gt;makedirs&lt;/span&gt;(output_path.parent, exist_ok&lt;span style=&#34;color: #d73948&#34;&gt;=&lt;/span&gt;&lt;span style=&#34;color: #d73948&#34;&gt;True&lt;/span&gt;)

            &lt;span style=&#34;color: #d73948&#34;&gt;with&lt;/span&gt; Image.&lt;span style=&#34;color: #4b69c6&#34;&gt;open&lt;/span&gt;(input_image) &lt;span style=&#34;color: #d73948&#34;&gt;as&lt;/span&gt; im:
                original_format &lt;span style=&#34;color: #d73948&#34;&gt;=&lt;/span&gt; im.format
                im &lt;span style=&#34;color: #d73948&#34;&gt;=&lt;/span&gt; ImageOps.&lt;span style=&#34;color: #4b69c6&#34;&gt;exif_transpose&lt;/span&gt;(im)
                output_height &lt;span style=&#34;color: #d73948&#34;&gt;=&lt;/span&gt; &lt;span style=&#34;color: #4b69c6&#34;&gt;int&lt;/span&gt;(im.size[&lt;span style=&#34;color: #b60157&#34;&gt;1&lt;/span&gt;] &lt;span style=&#34;color: #d73948&#34;&gt;*&lt;/span&gt; (output_width &lt;span style=&#34;color: #d73948&#34;&gt;/&lt;/span&gt; im.size[&lt;span style=&#34;color: #b60157&#34;&gt;0&lt;/span&gt;]))

                &lt;span style=&#34;color: #d73948&#34;&gt;with&lt;/span&gt; im.&lt;span style=&#34;color: #4b69c6&#34;&gt;resize&lt;/span&gt;(
                    (output_width, output_height), Image.Resampling.LANCZOS
                ) &lt;span style=&#34;color: #d73948&#34;&gt;as&lt;/span&gt; output_image:
                    &lt;span style=&#34;color: #74747c&#34;&gt;#&lt;/span&gt;&lt;span style=&#34;color: #74747c&#34;&gt; Save JPEG version&lt;/span&gt;
                    &lt;span style=&#34;color: #d73948&#34;&gt;if&lt;/span&gt; (
                        original_format &lt;span style=&#34;color: #d73948&#34;&gt;!=&lt;/span&gt; &lt;span style=&#34;color: #198810&#34;&gt;&amp;#34;&lt;/span&gt;&lt;span style=&#34;color: #198810&#34;&gt;JPEG&lt;/span&gt;&lt;span style=&#34;color: #198810&#34;&gt;&amp;#34;&lt;/span&gt;
                        &lt;span style=&#34;color: #d73948&#34;&gt;and&lt;/span&gt; &lt;span style=&#34;color: #4b69c6&#34;&gt;str&lt;/span&gt;(output_path).&lt;span style=&#34;color: #4b69c6&#34;&gt;endswith&lt;/span&gt;(&lt;span style=&#34;color: #198810&#34;&gt;&amp;#34;&lt;/span&gt;&lt;span style=&#34;color: #198810&#34;&gt;jpg&lt;/span&gt;&lt;span style=&#34;color: #198810&#34;&gt;&amp;#34;&lt;/span&gt;)
                        &lt;span style=&#34;color: #d73948&#34;&gt;and&lt;/span&gt; output_image.mode &lt;span style=&#34;color: #d73948&#34;&gt;in&lt;/span&gt; (&lt;span style=&#34;color: #198810&#34;&gt;&amp;#34;&lt;/span&gt;&lt;span style=&#34;color: #198810&#34;&gt;RGBA&lt;/span&gt;&lt;span style=&#34;color: #198810&#34;&gt;&amp;#34;&lt;/span&gt;, &lt;span style=&#34;color: #198810&#34;&gt;&amp;#34;&lt;/span&gt;&lt;span style=&#34;color: #198810&#34;&gt;P&lt;/span&gt;&lt;span style=&#34;color: #198810&#34;&gt;&amp;#34;&lt;/span&gt;)
                    ):
                        output_image &lt;span style=&#34;color: #d73948&#34;&gt;=&lt;/span&gt; output_image.&lt;span style=&#34;color: #4b69c6&#34;&gt;convert&lt;/span&gt;(&lt;span style=&#34;color: #198810&#34;&gt;&amp;#34;&lt;/span&gt;&lt;span style=&#34;color: #198810&#34;&gt;RGB&lt;/span&gt;&lt;span style=&#34;color: #198810&#34;&gt;&amp;#34;&lt;/span&gt;)

                    output_image.&lt;span style=&#34;color: #4b69c6&#34;&gt;save&lt;/span&gt;(output_path, quality&lt;span style=&#34;color: #d73948&#34;&gt;=&lt;/span&gt;&lt;span style=&#34;color: #b60157&#34;&gt;85&lt;/span&gt;, optimize&lt;span style=&#34;color: #d73948&#34;&gt;=&lt;/span&gt;&lt;span style=&#34;color: #d73948&#34;&gt;True&lt;/span&gt;)

                    &lt;span style=&#34;color: #74747c&#34;&gt;#&lt;/span&gt;&lt;span style=&#34;color: #74747c&#34;&gt; Save AVIF version only if support is available&lt;/span&gt;
                    &lt;span style=&#34;color: #d73948&#34;&gt;if&lt;/span&gt; avif_available:
                        &lt;span style=&#34;color: #d73948&#34;&gt;try&lt;/span&gt;:
                            &lt;span style=&#34;color: #d73948&#34;&gt;if&lt;/span&gt; output_image.mode &lt;span style=&#34;color: #d73948&#34;&gt;in&lt;/span&gt; (&lt;span style=&#34;color: #198810&#34;&gt;&amp;#34;&lt;/span&gt;&lt;span style=&#34;color: #198810&#34;&gt;RGBA&lt;/span&gt;&lt;span style=&#34;color: #198810&#34;&gt;&amp;#34;&lt;/span&gt;, &lt;span style=&#34;color: #198810&#34;&gt;&amp;#34;&lt;/span&gt;&lt;span style=&#34;color: #198810&#34;&gt;P&lt;/span&gt;&lt;span style=&#34;color: #198810&#34;&gt;&amp;#34;&lt;/span&gt;):
                                avif_image &lt;span style=&#34;color: #d73948&#34;&gt;=&lt;/span&gt; output_image.&lt;span style=&#34;color: #4b69c6&#34;&gt;convert&lt;/span&gt;(&lt;span style=&#34;color: #198810&#34;&gt;&amp;#34;&lt;/span&gt;&lt;span style=&#34;color: #198810&#34;&gt;RGB&lt;/span&gt;&lt;span style=&#34;color: #198810&#34;&gt;&amp;#34;&lt;/span&gt;)
                            &lt;span style=&#34;color: #d73948&#34;&gt;else&lt;/span&gt;:
                                avif_image &lt;span style=&#34;color: #d73948&#34;&gt;=&lt;/span&gt; output_image.&lt;span style=&#34;color: #4b69c6&#34;&gt;copy&lt;/span&gt;()

                            avif_image.&lt;span style=&#34;color: #4b69c6&#34;&gt;save&lt;/span&gt;(
                                avif_output_path,
                                format&lt;span style=&#34;color: #d73948&#34;&gt;=&lt;/span&gt;&lt;span style=&#34;color: #198810&#34;&gt;&amp;#34;&lt;/span&gt;&lt;span style=&#34;color: #198810&#34;&gt;AVIF&lt;/span&gt;&lt;span style=&#34;color: #198810&#34;&gt;&amp;#34;&lt;/span&gt;,
                                quality&lt;span style=&#34;color: #d73948&#34;&gt;=&lt;/span&gt;&lt;span style=&#34;color: #b60157&#34;&gt;60&lt;/span&gt;,  &lt;span style=&#34;color: #74747c&#34;&gt;#&lt;/span&gt;&lt;span style=&#34;color: #74747c&#34;&gt; Lower quality for better compression, still maintains good visual quality&lt;/span&gt;
                                speed&lt;span style=&#34;color: #d73948&#34;&gt;=&lt;/span&gt;&lt;span style=&#34;color: #b60157&#34;&gt;5&lt;/span&gt;,  &lt;span style=&#34;color: #74747c&#34;&gt;#&lt;/span&gt;&lt;span style=&#34;color: #74747c&#34;&gt; Slowest speed = best compression (0 is slowest, 10 is fastest)&lt;/span&gt;
                                bits&lt;span style=&#34;color: #d73948&#34;&gt;=&lt;/span&gt;&lt;span style=&#34;color: #b60157&#34;&gt;10&lt;/span&gt;,  &lt;span style=&#34;color: #74747c&#34;&gt;#&lt;/span&gt;&lt;span style=&#34;color: #74747c&#34;&gt; Use 10-bit color depth for better quality-to-size ratio&lt;/span&gt;
                                compress_level&lt;span style=&#34;color: #d73948&#34;&gt;=&lt;/span&gt;&lt;span style=&#34;color: #b60157&#34;&gt;8&lt;/span&gt;,  &lt;span style=&#34;color: #74747c&#34;&gt;#&lt;/span&gt;&lt;span style=&#34;color: #74747c&#34;&gt; Highest compression level (range 0-8)&lt;/span&gt;
                                color_space&lt;span style=&#34;color: #d73948&#34;&gt;=&lt;/span&gt;&lt;span style=&#34;color: #198810&#34;&gt;&amp;#34;&lt;/span&gt;&lt;span style=&#34;color: #198810&#34;&gt;bt709&lt;/span&gt;&lt;span style=&#34;color: #198810&#34;&gt;&amp;#34;&lt;/span&gt;,  &lt;span style=&#34;color: #74747c&#34;&gt;#&lt;/span&gt;&lt;span style=&#34;color: #74747c&#34;&gt; Use YUV BT.709 color space&lt;/span&gt;
                                chroma&lt;span style=&#34;color: #d73948&#34;&gt;=&lt;/span&gt;&lt;span style=&#34;color: #b60157&#34;&gt;0&lt;/span&gt;,  &lt;span style=&#34;color: #74747c&#34;&gt;#&lt;/span&gt;&lt;span style=&#34;color: #74747c&#34;&gt; 4:4:4 chroma sampling (0=4:4:4, 1=4:2:0, 2=4:2:2)&lt;/span&gt;
                                num_threads&lt;span style=&#34;color: #d73948&#34;&gt;=&lt;/span&gt;&lt;span style=&#34;color: #b60157&#34;&gt;0&lt;/span&gt;,  &lt;span style=&#34;color: #74747c&#34;&gt;#&lt;/span&gt;&lt;span style=&#34;color: #74747c&#34;&gt; Use all available CPU threads for encoding&lt;/span&gt;
                            )
                            logger.&lt;span style=&#34;color: #4b69c6&#34;&gt;debug&lt;/span&gt;(
                                &lt;span style=&#34;color: #d73948&#34;&gt;f&lt;/span&gt;&lt;span style=&#34;color: #198810&#34;&gt;&amp;#34;&lt;/span&gt;&lt;span style=&#34;color: #198810&#34;&gt;Processed image: &lt;/span&gt;&lt;span style=&#34;color: #8b41b1&#34;&gt;{&lt;/span&gt;&lt;span style=&#34;color: #8b41b1&#34;&gt;input_image&lt;/span&gt;&lt;span style=&#34;color: #8b41b1&#34;&gt;}&lt;/span&gt;&lt;span style=&#34;color: #198810&#34;&gt; -&amp;gt; &lt;/span&gt;&lt;span style=&#34;color: #8b41b1&#34;&gt;{&lt;/span&gt;&lt;span style=&#34;color: #8b41b1&#34;&gt;output_path&lt;/span&gt;&lt;span style=&#34;color: #8b41b1&#34;&gt;}&lt;/span&gt;&lt;span style=&#34;color: #198810&#34;&gt; and &lt;/span&gt;&lt;span style=&#34;color: #8b41b1&#34;&gt;{&lt;/span&gt;&lt;span style=&#34;color: #8b41b1&#34;&gt;avif_output_path&lt;/span&gt;&lt;span style=&#34;color: #8b41b1&#34;&gt;}&lt;/span&gt;&lt;span style=&#34;color: #198810&#34;&gt;&amp;#34;&lt;/span&gt;
                            )
                        &lt;span style=&#34;color: #d73948&#34;&gt;except&lt;/span&gt; &lt;span style=&#34;color: #4b69c6&#34;&gt;Exception&lt;/span&gt; &lt;span style=&#34;color: #d73948&#34;&gt;as&lt;/span&gt; e:
                            logger.&lt;span style=&#34;color: #4b69c6&#34;&gt;error&lt;/span&gt;(
                                &lt;span style=&#34;color: #d73948&#34;&gt;f&lt;/span&gt;&lt;span style=&#34;color: #198810&#34;&gt;&amp;#34;&lt;/span&gt;&lt;span style=&#34;color: #198810&#34;&gt;Error saving AVIF version of &lt;/span&gt;&lt;span style=&#34;color: #8b41b1&#34;&gt;{&lt;/span&gt;&lt;span style=&#34;color: #8b41b1&#34;&gt;input_image&lt;/span&gt;&lt;span style=&#34;color: #8b41b1&#34;&gt;}&lt;/span&gt;&lt;span style=&#34;color: #198810&#34;&gt;: &lt;/span&gt;&lt;span style=&#34;color: #8b41b1&#34;&gt;{&lt;/span&gt;&lt;span style=&#34;color: #8b41b1&#34;&gt;e&lt;/span&gt;&lt;span style=&#34;color: #8b41b1&#34;&gt;}&lt;/span&gt;&lt;span style=&#34;color: #198810&#34;&gt;&amp;#34;&lt;/span&gt;
                            )
                    &lt;span style=&#34;color: #d73948&#34;&gt;else&lt;/span&gt;:
                        logger.&lt;span style=&#34;color: #4b69c6&#34;&gt;error&lt;/span&gt;(
                            &lt;span style=&#34;color: #198810&#34;&gt;&amp;#34;&lt;/span&gt;&lt;span style=&#34;color: #198810&#34;&gt;AVIF support not available. Skipping AVIF conversion.&lt;/span&gt;&lt;span style=&#34;color: #198810&#34;&gt;&amp;#34;&lt;/span&gt;
                        )
                        logger.&lt;span style=&#34;color: #4b69c6&#34;&gt;debug&lt;/span&gt;(&lt;span style=&#34;color: #d73948&#34;&gt;f&lt;/span&gt;&lt;span style=&#34;color: #198810&#34;&gt;&amp;#34;&lt;/span&gt;&lt;span style=&#34;color: #198810&#34;&gt;Processed image: &lt;/span&gt;&lt;span style=&#34;color: #8b41b1&#34;&gt;{&lt;/span&gt;&lt;span style=&#34;color: #8b41b1&#34;&gt;input_image&lt;/span&gt;&lt;span style=&#34;color: #8b41b1&#34;&gt;}&lt;/span&gt;&lt;span style=&#34;color: #198810&#34;&gt; -&amp;gt; &lt;/span&gt;&lt;span style=&#34;color: #8b41b1&#34;&gt;{&lt;/span&gt;&lt;span style=&#34;color: #8b41b1&#34;&gt;output_path&lt;/span&gt;&lt;span style=&#34;color: #8b41b1&#34;&gt;}&lt;/span&gt;&lt;span style=&#34;color: #198810&#34;&gt;&amp;#34;&lt;/span&gt;)

    &lt;span style=&#34;color: #d73948&#34;&gt;except&lt;/span&gt; &lt;span style=&#34;color: #4b69c6&#34;&gt;OSError&lt;/span&gt; &lt;span style=&#34;color: #d73948&#34;&gt;as&lt;/span&gt; e:
        logger.&lt;span style=&#34;color: #4b69c6&#34;&gt;error&lt;/span&gt;(&lt;span style=&#34;color: #d73948&#34;&gt;f&lt;/span&gt;&lt;span style=&#34;color: #198810&#34;&gt;&amp;#34;&lt;/span&gt;&lt;span style=&#34;color: #198810&#34;&gt;OS error processing &lt;/span&gt;&lt;span style=&#34;color: #8b41b1&#34;&gt;{&lt;/span&gt;&lt;span style=&#34;color: #8b41b1&#34;&gt;input_image&lt;/span&gt;&lt;span style=&#34;color: #8b41b1&#34;&gt;}&lt;/span&gt;&lt;span style=&#34;color: #198810&#34;&gt;: &lt;/span&gt;&lt;span style=&#34;color: #8b41b1&#34;&gt;{&lt;/span&gt;&lt;span style=&#34;color: #8b41b1&#34;&gt;e&lt;/span&gt;&lt;span style=&#34;color: #8b41b1&#34;&gt;}&lt;/span&gt;&lt;span style=&#34;color: #198810&#34;&gt;&amp;#34;&lt;/span&gt;)
    &lt;span style=&#34;color: #d73948&#34;&gt;except&lt;/span&gt; &lt;span style=&#34;color: #4b69c6&#34;&gt;Exception&lt;/span&gt; &lt;span style=&#34;color: #d73948&#34;&gt;as&lt;/span&gt; e:
        logger.&lt;span style=&#34;color: #4b69c6&#34;&gt;error&lt;/span&gt;(&lt;span style=&#34;color: #d73948&#34;&gt;f&lt;/span&gt;&lt;span style=&#34;color: #198810&#34;&gt;&amp;#34;&lt;/span&gt;&lt;span style=&#34;color: #198810&#34;&gt;Error processing &lt;/span&gt;&lt;span style=&#34;color: #8b41b1&#34;&gt;{&lt;/span&gt;&lt;span style=&#34;color: #8b41b1&#34;&gt;input_image&lt;/span&gt;&lt;span style=&#34;color: #8b41b1&#34;&gt;}&lt;/span&gt;&lt;span style=&#34;color: #198810&#34;&gt;: &lt;/span&gt;&lt;span style=&#34;color: #8b41b1&#34;&gt;{&lt;/span&gt;&lt;span style=&#34;color: #8b41b1&#34;&gt;e&lt;/span&gt;&lt;span style=&#34;color: #8b41b1&#34;&gt;}&lt;/span&gt;&lt;span style=&#34;color: #198810&#34;&gt;&amp;#34;&lt;/span&gt;)
    &lt;span style=&#34;color: #d73948&#34;&gt;finally&lt;/span&gt;:
        &lt;span style=&#34;color: #d73948&#34;&gt;if&lt;/span&gt; lock_path.&lt;span style=&#34;color: #4b69c6&#34;&gt;exists&lt;/span&gt;():
            &lt;span style=&#34;color: #d73948&#34;&gt;try&lt;/span&gt;:
                lock_path.&lt;span style=&#34;color: #4b69c6&#34;&gt;unlink&lt;/span&gt;()
            &lt;span style=&#34;color: #d73948&#34;&gt;except&lt;/span&gt; &lt;span style=&#34;color: #4b69c6&#34;&gt;OSError&lt;/span&gt;:
                &lt;span style=&#34;color: #d73948&#34;&gt;pass&lt;/span&gt;&lt;/code&gt;&lt;/pre&gt;&lt;/div&gt;&lt;p&gt;It was also necessary to update my gallery/lightbox JavaScript code, as the previous version was loading the JPEG fallback when the lightbox opened, wasting bandwidth.&lt;/p&gt;&lt;div class=&#34;code-block&#34; data-lang=&#34;js&#34;&gt;&lt;div class=&#34;code-header&#34; data-mosaic-chrome=&#34;&#34;&gt;&lt;span class=&#34;code-lang&#34;&gt;js&lt;/span&gt;&lt;button class=&#34;code-copy&#34; aria-label=&#34;Copy code&#34; type=&#34;button&#34;&gt;Copy&lt;/button&gt;&lt;/div&gt;&lt;pre&gt;&lt;code data-lang=&#34;js&#34;&gt;&lt;span style=&#34;color: #d73948&#34;&gt;class&lt;/span&gt; &lt;span style=&#34;color: #4b69c6&#34;&gt;Lightbox&lt;/span&gt; {
  &lt;span style=&#34;color: #4b69c6&#34;&gt;constructor&lt;/span&gt;(galleryElement) {
    &lt;span style=&#34;color: #d73948&#34;&gt;this&lt;/span&gt;.galleryElement &lt;span style=&#34;color: #d73948&#34;&gt;=&lt;/span&gt; galleryElement;
    &lt;span style=&#34;color: #d73948&#34;&gt;this&lt;/span&gt;.galleryItems &lt;span style=&#34;color: #d73948&#34;&gt;=&lt;/span&gt; &lt;span style=&#34;color: #d73948&#34;&gt;this&lt;/span&gt;.galleryElement.&lt;span style=&#34;color: #4b69c6&#34;&gt;querySelectorAll&lt;/span&gt;(&lt;span style=&#34;color: #198810&#34;&gt;&amp;#39;&lt;/span&gt;&lt;span style=&#34;color: #198810&#34;&gt;img, picture&lt;/span&gt;&lt;span style=&#34;color: #198810&#34;&gt;&amp;#39;&lt;/span&gt;);
    &lt;span style=&#34;color: #d73948&#34;&gt;this&lt;/span&gt;.currentIndex &lt;span style=&#34;color: #d73948&#34;&gt;=&lt;/span&gt; &lt;span style=&#34;color: #b60157&#34;&gt;0&lt;/span&gt;;
    &lt;span style=&#34;color: #d73948&#34;&gt;this&lt;/span&gt;.overlay &lt;span style=&#34;color: #d73948&#34;&gt;=&lt;/span&gt; &lt;span style=&#34;color: #d73948&#34;&gt;null&lt;/span&gt;;
    &lt;span style=&#34;color: #d73948&#34;&gt;this&lt;/span&gt;.content &lt;span style=&#34;color: #d73948&#34;&gt;=&lt;/span&gt; &lt;span style=&#34;color: #d73948&#34;&gt;null&lt;/span&gt;;
    &lt;span style=&#34;color: #d73948&#34;&gt;this&lt;/span&gt;.image &lt;span style=&#34;color: #d73948&#34;&gt;=&lt;/span&gt; &lt;span style=&#34;color: #d73948&#34;&gt;null&lt;/span&gt;;
    &lt;span style=&#34;color: #d73948&#34;&gt;this&lt;/span&gt;.caption &lt;span style=&#34;color: #d73948&#34;&gt;=&lt;/span&gt; &lt;span style=&#34;color: #d73948&#34;&gt;null&lt;/span&gt;;
    &lt;span style=&#34;color: #d73948&#34;&gt;this&lt;/span&gt;.closeButton &lt;span style=&#34;color: #d73948&#34;&gt;=&lt;/span&gt; &lt;span style=&#34;color: #d73948&#34;&gt;null&lt;/span&gt;;
    &lt;span style=&#34;color: #d73948&#34;&gt;this&lt;/span&gt;.prevButton &lt;span style=&#34;color: #d73948&#34;&gt;=&lt;/span&gt; &lt;span style=&#34;color: #d73948&#34;&gt;null&lt;/span&gt;;
    &lt;span style=&#34;color: #d73948&#34;&gt;this&lt;/span&gt;.nextButton &lt;span style=&#34;color: #d73948&#34;&gt;=&lt;/span&gt; &lt;span style=&#34;color: #d73948&#34;&gt;null&lt;/span&gt;;
    &lt;span style=&#34;color: #d73948&#34;&gt;this&lt;/span&gt;.isOpen &lt;span style=&#34;color: #d73948&#34;&gt;=&lt;/span&gt; &lt;span style=&#34;color: #d73948&#34;&gt;false&lt;/span&gt;;
    &lt;span style=&#34;color: #d73948&#34;&gt;this&lt;/span&gt;.&lt;span style=&#34;color: #4b69c6&#34;&gt;init&lt;/span&gt;();
    &lt;span style=&#34;color: #d73948&#34;&gt;this&lt;/span&gt;.imageCount &lt;span style=&#34;color: #d73948&#34;&gt;=&lt;/span&gt; galleryElement.&lt;span style=&#34;color: #4b69c6&#34;&gt;querySelectorAll&lt;/span&gt;(&lt;span style=&#34;color: #198810&#34;&gt;&amp;#39;&lt;/span&gt;&lt;span style=&#34;color: #198810&#34;&gt;img&lt;/span&gt;&lt;span style=&#34;color: #198810&#34;&gt;&amp;#39;&lt;/span&gt;).length;
  }

  &lt;span style=&#34;color: #4b69c6&#34;&gt;init&lt;/span&gt;() {
    &lt;span style=&#34;color: #d73948&#34;&gt;this&lt;/span&gt;.&lt;span style=&#34;color: #4b69c6&#34;&gt;createLightbox&lt;/span&gt;();
    &lt;span style=&#34;color: #d73948&#34;&gt;this&lt;/span&gt;.&lt;span style=&#34;color: #4b69c6&#34;&gt;addEventListeners&lt;/span&gt;();
  }

  &lt;span style=&#34;color: #4b69c6&#34;&gt;createLightbox&lt;/span&gt;() {
    &lt;span style=&#34;color: #d73948&#34;&gt;this&lt;/span&gt;.overlay &lt;span style=&#34;color: #d73948&#34;&gt;=&lt;/span&gt; &lt;span style=&#34;color: #4b69c6&#34;&gt;document&lt;/span&gt;.&lt;span style=&#34;color: #4b69c6&#34;&gt;createElement&lt;/span&gt;(&lt;span style=&#34;color: #198810&#34;&gt;&amp;#39;&lt;/span&gt;&lt;span style=&#34;color: #198810&#34;&gt;div&lt;/span&gt;&lt;span style=&#34;color: #198810&#34;&gt;&amp;#39;&lt;/span&gt;);
    &lt;span style=&#34;color: #d73948&#34;&gt;this&lt;/span&gt;.overlay.className &lt;span style=&#34;color: #d73948&#34;&gt;=&lt;/span&gt; &lt;span style=&#34;color: #198810&#34;&gt;&amp;#39;&lt;/span&gt;&lt;span style=&#34;color: #198810&#34;&gt;lightbox-overlay&lt;/span&gt;&lt;span style=&#34;color: #198810&#34;&gt;&amp;#39;&lt;/span&gt;;
    &lt;span style=&#34;color: #d73948&#34;&gt;this&lt;/span&gt;.overlay.innerHTML &lt;span style=&#34;color: #d73948&#34;&gt;=&lt;/span&gt; &lt;span style=&#34;color: #198810&#34;&gt;`&lt;/span&gt;
&lt;span style=&#34;color: #198810&#34;&gt;      &lt;/span&gt;&lt;span style=&#34;color: #1d6c76&#34;&gt;\&amp;lt;&lt;/span&gt;&lt;span style=&#34;color: #198810&#34;&gt;div class=&amp;#34;lightbox-content&amp;#34;&amp;gt;&lt;/span&gt;
&lt;span style=&#34;color: #198810&#34;&gt;        &lt;/span&gt;&lt;span style=&#34;color: #1d6c76&#34;&gt;\&amp;lt;&lt;/span&gt;&lt;span style=&#34;color: #198810&#34;&gt;img src=&amp;#34;&amp;#34; alt=&amp;#34;&amp;#34; class=&amp;#34;lightbox-image&amp;#34;&amp;gt;&lt;/span&gt;
&lt;span style=&#34;color: #198810&#34;&gt;        &lt;/span&gt;&lt;span style=&#34;color: #1d6c76&#34;&gt;\&amp;lt;&lt;/span&gt;&lt;span style=&#34;color: #198810&#34;&gt;p class=&amp;#34;lightbox-caption&amp;#34;&amp;gt;&lt;/span&gt;&lt;span style=&#34;color: #1d6c76&#34;&gt;\&amp;lt;&lt;/span&gt;&lt;span style=&#34;color: #198810&#34;&gt;/p&amp;gt;&lt;/span&gt;
&lt;span style=&#34;color: #198810&#34;&gt;        &lt;/span&gt;&lt;span style=&#34;color: #1d6c76&#34;&gt;\&amp;lt;&lt;/span&gt;&lt;span style=&#34;color: #198810&#34;&gt;button class=&amp;#34;lightbox-prev&amp;#34;&amp;gt;&amp;amp;lt;&lt;/span&gt;&lt;span style=&#34;color: #1d6c76&#34;&gt;\&amp;lt;&lt;/span&gt;&lt;span style=&#34;color: #198810&#34;&gt;/button&amp;gt;&lt;/span&gt;
&lt;span style=&#34;color: #198810&#34;&gt;        &lt;/span&gt;&lt;span style=&#34;color: #1d6c76&#34;&gt;\&amp;lt;&lt;/span&gt;&lt;span style=&#34;color: #198810&#34;&gt;button class=&amp;#34;lightbox-next&amp;#34;&amp;gt;&amp;amp;gt;&lt;/span&gt;&lt;span style=&#34;color: #1d6c76&#34;&gt;\&amp;lt;&lt;/span&gt;&lt;span style=&#34;color: #198810&#34;&gt;/button&amp;gt;&lt;/span&gt;
&lt;span style=&#34;color: #198810&#34;&gt;      &lt;/span&gt;&lt;span style=&#34;color: #1d6c76&#34;&gt;\&amp;lt;&lt;/span&gt;&lt;span style=&#34;color: #198810&#34;&gt;/div&amp;gt;&lt;/span&gt;
&lt;span style=&#34;color: #198810&#34;&gt;      &lt;/span&gt;&lt;span style=&#34;color: #1d6c76&#34;&gt;\&amp;lt;&lt;/span&gt;&lt;span style=&#34;color: #198810&#34;&gt;button class=&amp;#34;lightbox-close&amp;#34;&amp;gt;&amp;amp;times;&lt;/span&gt;&lt;span style=&#34;color: #1d6c76&#34;&gt;\&amp;lt;&lt;/span&gt;&lt;span style=&#34;color: #198810&#34;&gt;/button&amp;gt;&lt;/span&gt;
&lt;span style=&#34;color: #198810&#34;&gt;    &lt;/span&gt;&lt;span style=&#34;color: #198810&#34;&gt;`&lt;/span&gt;;
    &lt;span style=&#34;color: #4b69c6&#34;&gt;document&lt;/span&gt;.body.&lt;span style=&#34;color: #4b69c6&#34;&gt;appendChild&lt;/span&gt;(&lt;span style=&#34;color: #d73948&#34;&gt;this&lt;/span&gt;.overlay);

    &lt;span style=&#34;color: #d73948&#34;&gt;this&lt;/span&gt;.content &lt;span style=&#34;color: #d73948&#34;&gt;=&lt;/span&gt; &lt;span style=&#34;color: #d73948&#34;&gt;this&lt;/span&gt;.overlay.&lt;span style=&#34;color: #4b69c6&#34;&gt;querySelector&lt;/span&gt;(&lt;span style=&#34;color: #198810&#34;&gt;&amp;#39;&lt;/span&gt;&lt;span style=&#34;color: #198810&#34;&gt;.lightbox-content&lt;/span&gt;&lt;span style=&#34;color: #198810&#34;&gt;&amp;#39;&lt;/span&gt;);
    &lt;span style=&#34;color: #d73948&#34;&gt;this&lt;/span&gt;.image &lt;span style=&#34;color: #d73948&#34;&gt;=&lt;/span&gt; &lt;span style=&#34;color: #d73948&#34;&gt;this&lt;/span&gt;.overlay.&lt;span style=&#34;color: #4b69c6&#34;&gt;querySelector&lt;/span&gt;(&lt;span style=&#34;color: #198810&#34;&gt;&amp;#39;&lt;/span&gt;&lt;span style=&#34;color: #198810&#34;&gt;.lightbox-image&lt;/span&gt;&lt;span style=&#34;color: #198810&#34;&gt;&amp;#39;&lt;/span&gt;);
    &lt;span style=&#34;color: #d73948&#34;&gt;this&lt;/span&gt;.caption &lt;span style=&#34;color: #d73948&#34;&gt;=&lt;/span&gt; &lt;span style=&#34;color: #d73948&#34;&gt;this&lt;/span&gt;.overlay.&lt;span style=&#34;color: #4b69c6&#34;&gt;querySelector&lt;/span&gt;(&lt;span style=&#34;color: #198810&#34;&gt;&amp;#39;&lt;/span&gt;&lt;span style=&#34;color: #198810&#34;&gt;.lightbox-caption&lt;/span&gt;&lt;span style=&#34;color: #198810&#34;&gt;&amp;#39;&lt;/span&gt;);
    &lt;span style=&#34;color: #d73948&#34;&gt;this&lt;/span&gt;.closeButton &lt;span style=&#34;color: #d73948&#34;&gt;=&lt;/span&gt; &lt;span style=&#34;color: #d73948&#34;&gt;this&lt;/span&gt;.overlay.&lt;span style=&#34;color: #4b69c6&#34;&gt;querySelector&lt;/span&gt;(&lt;span style=&#34;color: #198810&#34;&gt;&amp;#39;&lt;/span&gt;&lt;span style=&#34;color: #198810&#34;&gt;.lightbox-close&lt;/span&gt;&lt;span style=&#34;color: #198810&#34;&gt;&amp;#39;&lt;/span&gt;);
    &lt;span style=&#34;color: #d73948&#34;&gt;this&lt;/span&gt;.prevButton &lt;span style=&#34;color: #d73948&#34;&gt;=&lt;/span&gt; &lt;span style=&#34;color: #d73948&#34;&gt;this&lt;/span&gt;.overlay.&lt;span style=&#34;color: #4b69c6&#34;&gt;querySelector&lt;/span&gt;(&lt;span style=&#34;color: #198810&#34;&gt;&amp;#39;&lt;/span&gt;&lt;span style=&#34;color: #198810&#34;&gt;.lightbox-prev&lt;/span&gt;&lt;span style=&#34;color: #198810&#34;&gt;&amp;#39;&lt;/span&gt;);
    &lt;span style=&#34;color: #d73948&#34;&gt;this&lt;/span&gt;.nextButton &lt;span style=&#34;color: #d73948&#34;&gt;=&lt;/span&gt; &lt;span style=&#34;color: #d73948&#34;&gt;this&lt;/span&gt;.overlay.&lt;span style=&#34;color: #4b69c6&#34;&gt;querySelector&lt;/span&gt;(&lt;span style=&#34;color: #198810&#34;&gt;&amp;#39;&lt;/span&gt;&lt;span style=&#34;color: #198810&#34;&gt;.lightbox-next&lt;/span&gt;&lt;span style=&#34;color: #198810&#34;&gt;&amp;#39;&lt;/span&gt;);
  }

  &lt;span style=&#34;color: #4b69c6&#34;&gt;getImageDetails&lt;/span&gt;(element) {
    &lt;span style=&#34;color: #d73948&#34;&gt;if&lt;/span&gt; (element.tagName.&lt;span style=&#34;color: #4b69c6&#34;&gt;toLowerCase&lt;/span&gt;() &lt;span style=&#34;color: #d73948&#34;&gt;===&lt;/span&gt; &lt;span style=&#34;color: #198810&#34;&gt;&amp;#39;&lt;/span&gt;&lt;span style=&#34;color: #198810&#34;&gt;picture&lt;/span&gt;&lt;span style=&#34;color: #198810&#34;&gt;&amp;#39;&lt;/span&gt;) {
      &lt;span style=&#34;color: #d73948&#34;&gt;const&lt;/span&gt; img &lt;span style=&#34;color: #d73948&#34;&gt;=&lt;/span&gt; element.&lt;span style=&#34;color: #4b69c6&#34;&gt;querySelector&lt;/span&gt;(&lt;span style=&#34;color: #198810&#34;&gt;&amp;#39;&lt;/span&gt;&lt;span style=&#34;color: #198810&#34;&gt;img&lt;/span&gt;&lt;span style=&#34;color: #198810&#34;&gt;&amp;#39;&lt;/span&gt;);
      &lt;span style=&#34;color: #d73948&#34;&gt;return&lt;/span&gt; {
        &lt;span style=&#34;color: #74747c&#34;&gt;//&lt;/span&gt;&lt;span style=&#34;color: #74747c&#34;&gt; currentSrc gives us the source that the browser actually loaded&lt;/span&gt;
        src: img.currentSrc &lt;span style=&#34;color: #d73948&#34;&gt;||&lt;/span&gt; img.src,
        alt: img.alt
      };
    } &lt;span style=&#34;color: #d73948&#34;&gt;else&lt;/span&gt; {
      &lt;span style=&#34;color: #d73948&#34;&gt;return&lt;/span&gt; {
        src: element.currentSrc &lt;span style=&#34;color: #d73948&#34;&gt;||&lt;/span&gt; element.src,
        alt: element.alt
      };
    }
  }

  &lt;span style=&#34;color: #4b69c6&#34;&gt;addEventListeners&lt;/span&gt;() {
    &lt;span style=&#34;color: #d73948&#34;&gt;this&lt;/span&gt;.galleryItems.&lt;span style=&#34;color: #4b69c6&#34;&gt;forEach&lt;/span&gt;((item, index) &lt;span style=&#34;color: #d73948&#34;&gt;=&amp;gt;&lt;/span&gt; {
      &lt;span style=&#34;color: #74747c&#34;&gt;//&lt;/span&gt;&lt;span style=&#34;color: #74747c&#34;&gt; For picture elements, we need to attach the listener to the img inside&lt;/span&gt;
      &lt;span style=&#34;color: #d73948&#34;&gt;const&lt;/span&gt; clickTarget &lt;span style=&#34;color: #d73948&#34;&gt;=&lt;/span&gt; item.tagName.&lt;span style=&#34;color: #4b69c6&#34;&gt;toLowerCase&lt;/span&gt;() &lt;span style=&#34;color: #d73948&#34;&gt;===&lt;/span&gt; &lt;span style=&#34;color: #198810&#34;&gt;&amp;#39;&lt;/span&gt;&lt;span style=&#34;color: #198810&#34;&gt;picture&lt;/span&gt;&lt;span style=&#34;color: #198810&#34;&gt;&amp;#39;&lt;/span&gt;
        &lt;span style=&#34;color: #d73948&#34;&gt;?&lt;/span&gt; item.&lt;span style=&#34;color: #4b69c6&#34;&gt;querySelector&lt;/span&gt;(&lt;span style=&#34;color: #198810&#34;&gt;&amp;#39;&lt;/span&gt;&lt;span style=&#34;color: #198810&#34;&gt;img&lt;/span&gt;&lt;span style=&#34;color: #198810&#34;&gt;&amp;#39;&lt;/span&gt;)
        &lt;span style=&#34;color: #d73948&#34;&gt;:&lt;/span&gt; item;

      clickTarget.&lt;span style=&#34;color: #4b69c6&#34;&gt;addEventListener&lt;/span&gt;(&lt;span style=&#34;color: #198810&#34;&gt;&amp;#39;&lt;/span&gt;&lt;span style=&#34;color: #198810&#34;&gt;click&lt;/span&gt;&lt;span style=&#34;color: #198810&#34;&gt;&amp;#39;&lt;/span&gt;, (e) &lt;span style=&#34;color: #d73948&#34;&gt;=&amp;gt;&lt;/span&gt; {
        e.&lt;span style=&#34;color: #4b69c6&#34;&gt;preventDefault&lt;/span&gt;();
        &lt;span style=&#34;color: #d73948&#34;&gt;this&lt;/span&gt;.&lt;span style=&#34;color: #4b69c6&#34;&gt;openLightbox&lt;/span&gt;(index);
      });
    });

    &lt;span style=&#34;color: #d73948&#34;&gt;this&lt;/span&gt;.overlay.&lt;span style=&#34;color: #4b69c6&#34;&gt;addEventListener&lt;/span&gt;(&lt;span style=&#34;color: #198810&#34;&gt;&amp;#39;&lt;/span&gt;&lt;span style=&#34;color: #198810&#34;&gt;click&lt;/span&gt;&lt;span style=&#34;color: #198810&#34;&gt;&amp;#39;&lt;/span&gt;, (e) &lt;span style=&#34;color: #d73948&#34;&gt;=&amp;gt;&lt;/span&gt; {
      &lt;span style=&#34;color: #d73948&#34;&gt;if&lt;/span&gt; (&lt;span style=&#34;color: #d73948&#34;&gt;!&lt;/span&gt;&lt;span style=&#34;color: #d73948&#34;&gt;this&lt;/span&gt;.content.&lt;span style=&#34;color: #4b69c6&#34;&gt;contains&lt;/span&gt;(e.target) &lt;span style=&#34;color: #d73948&#34;&gt;||&lt;/span&gt; e.target &lt;span style=&#34;color: #d73948&#34;&gt;===&lt;/span&gt; &lt;span style=&#34;color: #d73948&#34;&gt;this&lt;/span&gt;.content) {
        &lt;span style=&#34;color: #d73948&#34;&gt;this&lt;/span&gt;.&lt;span style=&#34;color: #4b69c6&#34;&gt;closeLightbox&lt;/span&gt;();
      }
    });

    &lt;span style=&#34;color: #d73948&#34;&gt;this&lt;/span&gt;.closeButton.&lt;span style=&#34;color: #4b69c6&#34;&gt;addEventListener&lt;/span&gt;(&lt;span style=&#34;color: #198810&#34;&gt;&amp;#39;&lt;/span&gt;&lt;span style=&#34;color: #198810&#34;&gt;click&lt;/span&gt;&lt;span style=&#34;color: #198810&#34;&gt;&amp;#39;&lt;/span&gt;, () &lt;span style=&#34;color: #d73948&#34;&gt;=&amp;gt;&lt;/span&gt; &lt;span style=&#34;color: #d73948&#34;&gt;this&lt;/span&gt;.&lt;span style=&#34;color: #4b69c6&#34;&gt;closeLightbox&lt;/span&gt;());

    &lt;span style=&#34;color: #4b69c6&#34;&gt;document&lt;/span&gt;.&lt;span style=&#34;color: #4b69c6&#34;&gt;addEventListener&lt;/span&gt;(&lt;span style=&#34;color: #198810&#34;&gt;&amp;#39;&lt;/span&gt;&lt;span style=&#34;color: #198810&#34;&gt;keydown&lt;/span&gt;&lt;span style=&#34;color: #198810&#34;&gt;&amp;#39;&lt;/span&gt;, (e) &lt;span style=&#34;color: #d73948&#34;&gt;=&amp;gt;&lt;/span&gt; {
      &lt;span style=&#34;color: #d73948&#34;&gt;if&lt;/span&gt; (&lt;span style=&#34;color: #d73948&#34;&gt;this&lt;/span&gt;.isOpen) {
        &lt;span style=&#34;color: #d73948&#34;&gt;if&lt;/span&gt; (e.key &lt;span style=&#34;color: #d73948&#34;&gt;===&lt;/span&gt; &lt;span style=&#34;color: #198810&#34;&gt;&amp;#39;&lt;/span&gt;&lt;span style=&#34;color: #198810&#34;&gt;Escape&lt;/span&gt;&lt;span style=&#34;color: #198810&#34;&gt;&amp;#39;&lt;/span&gt;) &lt;span style=&#34;color: #d73948&#34;&gt;this&lt;/span&gt;.&lt;span style=&#34;color: #4b69c6&#34;&gt;closeLightbox&lt;/span&gt;();
        &lt;span style=&#34;color: #d73948&#34;&gt;if&lt;/span&gt; (e.key &lt;span style=&#34;color: #d73948&#34;&gt;===&lt;/span&gt; &lt;span style=&#34;color: #198810&#34;&gt;&amp;#39;&lt;/span&gt;&lt;span style=&#34;color: #198810&#34;&gt;ArrowLeft&lt;/span&gt;&lt;span style=&#34;color: #198810&#34;&gt;&amp;#39;&lt;/span&gt;) &lt;span style=&#34;color: #d73948&#34;&gt;this&lt;/span&gt;.&lt;span style=&#34;color: #4b69c6&#34;&gt;showPrevious&lt;/span&gt;();
        &lt;span style=&#34;color: #d73948&#34;&gt;if&lt;/span&gt; (e.key &lt;span style=&#34;color: #d73948&#34;&gt;===&lt;/span&gt; &lt;span style=&#34;color: #198810&#34;&gt;&amp;#39;&lt;/span&gt;&lt;span style=&#34;color: #198810&#34;&gt;ArrowRight&lt;/span&gt;&lt;span style=&#34;color: #198810&#34;&gt;&amp;#39;&lt;/span&gt;) &lt;span style=&#34;color: #d73948&#34;&gt;this&lt;/span&gt;.&lt;span style=&#34;color: #4b69c6&#34;&gt;showNext&lt;/span&gt;();
      }
    });

    &lt;span style=&#34;color: #4b69c6&#34;&gt;window&lt;/span&gt;.&lt;span style=&#34;color: #4b69c6&#34;&gt;addEventListener&lt;/span&gt;(&lt;span style=&#34;color: #198810&#34;&gt;&amp;#39;&lt;/span&gt;&lt;span style=&#34;color: #198810&#34;&gt;popstate&lt;/span&gt;&lt;span style=&#34;color: #198810&#34;&gt;&amp;#39;&lt;/span&gt;, () &lt;span style=&#34;color: #d73948&#34;&gt;=&amp;gt;&lt;/span&gt; {
      &lt;span style=&#34;color: #d73948&#34;&gt;if&lt;/span&gt; (&lt;span style=&#34;color: #d73948&#34;&gt;this&lt;/span&gt;.isOpen) {
        &lt;span style=&#34;color: #d73948&#34;&gt;this&lt;/span&gt;.&lt;span style=&#34;color: #4b69c6&#34;&gt;closeLightbox&lt;/span&gt;(&lt;span style=&#34;color: #d73948&#34;&gt;false&lt;/span&gt;);
      }
    });

    &lt;span style=&#34;color: #d73948&#34;&gt;this&lt;/span&gt;.prevButton.&lt;span style=&#34;color: #4b69c6&#34;&gt;addEventListener&lt;/span&gt;(&lt;span style=&#34;color: #198810&#34;&gt;&amp;#39;&lt;/span&gt;&lt;span style=&#34;color: #198810&#34;&gt;click&lt;/span&gt;&lt;span style=&#34;color: #198810&#34;&gt;&amp;#39;&lt;/span&gt;, () &lt;span style=&#34;color: #d73948&#34;&gt;=&amp;gt;&lt;/span&gt; &lt;span style=&#34;color: #d73948&#34;&gt;this&lt;/span&gt;.&lt;span style=&#34;color: #4b69c6&#34;&gt;showPrevious&lt;/span&gt;());
    &lt;span style=&#34;color: #d73948&#34;&gt;this&lt;/span&gt;.nextButton.&lt;span style=&#34;color: #4b69c6&#34;&gt;addEventListener&lt;/span&gt;(&lt;span style=&#34;color: #198810&#34;&gt;&amp;#39;&lt;/span&gt;&lt;span style=&#34;color: #198810&#34;&gt;click&lt;/span&gt;&lt;span style=&#34;color: #198810&#34;&gt;&amp;#39;&lt;/span&gt;, () &lt;span style=&#34;color: #d73948&#34;&gt;=&amp;gt;&lt;/span&gt; &lt;span style=&#34;color: #d73948&#34;&gt;this&lt;/span&gt;.&lt;span style=&#34;color: #4b69c6&#34;&gt;showNext&lt;/span&gt;());
  }

  &lt;span style=&#34;color: #4b69c6&#34;&gt;openLightbox&lt;/span&gt;(index) {
    &lt;span style=&#34;color: #d73948&#34;&gt;this&lt;/span&gt;.currentIndex &lt;span style=&#34;color: #d73948&#34;&gt;=&lt;/span&gt; index;
    &lt;span style=&#34;color: #d73948&#34;&gt;this&lt;/span&gt;.&lt;span style=&#34;color: #4b69c6&#34;&gt;updateLightboxContent&lt;/span&gt;();
    &lt;span style=&#34;color: #d73948&#34;&gt;this&lt;/span&gt;.overlay.style.display &lt;span style=&#34;color: #d73948&#34;&gt;=&lt;/span&gt; &lt;span style=&#34;color: #198810&#34;&gt;&amp;#39;&lt;/span&gt;&lt;span style=&#34;color: #198810&#34;&gt;block&lt;/span&gt;&lt;span style=&#34;color: #198810&#34;&gt;&amp;#39;&lt;/span&gt;;
    &lt;span style=&#34;color: #4b69c6&#34;&gt;document&lt;/span&gt;.body.style.overflow &lt;span style=&#34;color: #d73948&#34;&gt;=&lt;/span&gt; &lt;span style=&#34;color: #198810&#34;&gt;&amp;#39;&lt;/span&gt;&lt;span style=&#34;color: #198810&#34;&gt;hidden&lt;/span&gt;&lt;span style=&#34;color: #198810&#34;&gt;&amp;#39;&lt;/span&gt;;
    &lt;span style=&#34;color: #d73948&#34;&gt;this&lt;/span&gt;.isOpen &lt;span style=&#34;color: #d73948&#34;&gt;=&lt;/span&gt; &lt;span style=&#34;color: #d73948&#34;&gt;true&lt;/span&gt;;
    history.&lt;span style=&#34;color: #4b69c6&#34;&gt;pushState&lt;/span&gt;({ lightboxOpen: &lt;span style=&#34;color: #d73948&#34;&gt;true&lt;/span&gt; }, &lt;span style=&#34;color: #198810&#34;&gt;&amp;#39;&lt;/span&gt;&lt;span style=&#34;color: #198810&#34;&gt;&amp;#39;&lt;/span&gt;);
  }

  &lt;span style=&#34;color: #4b69c6&#34;&gt;closeLightbox&lt;/span&gt;(pushState &lt;span style=&#34;color: #d73948&#34;&gt;=&lt;/span&gt; &lt;span style=&#34;color: #d73948&#34;&gt;true&lt;/span&gt;) {
    &lt;span style=&#34;color: #d73948&#34;&gt;this&lt;/span&gt;.overlay.style.display &lt;span style=&#34;color: #d73948&#34;&gt;=&lt;/span&gt; &lt;span style=&#34;color: #198810&#34;&gt;&amp;#39;&lt;/span&gt;&lt;span style=&#34;color: #198810&#34;&gt;none&lt;/span&gt;&lt;span style=&#34;color: #198810&#34;&gt;&amp;#39;&lt;/span&gt;;
    &lt;span style=&#34;color: #4b69c6&#34;&gt;document&lt;/span&gt;.body.style.overflow &lt;span style=&#34;color: #d73948&#34;&gt;=&lt;/span&gt; &lt;span style=&#34;color: #198810&#34;&gt;&amp;#39;&lt;/span&gt;&lt;span style=&#34;color: #198810&#34;&gt;&amp;#39;&lt;/span&gt;;
    &lt;span style=&#34;color: #d73948&#34;&gt;this&lt;/span&gt;.isOpen &lt;span style=&#34;color: #d73948&#34;&gt;=&lt;/span&gt; &lt;span style=&#34;color: #d73948&#34;&gt;false&lt;/span&gt;;
    &lt;span style=&#34;color: #d73948&#34;&gt;if&lt;/span&gt; (pushState) {
      history.&lt;span style=&#34;color: #4b69c6&#34;&gt;pushState&lt;/span&gt;({ lightboxOpen: &lt;span style=&#34;color: #d73948&#34;&gt;false&lt;/span&gt; }, &lt;span style=&#34;color: #198810&#34;&gt;&amp;#39;&lt;/span&gt;&lt;span style=&#34;color: #198810&#34;&gt;&amp;#39;&lt;/span&gt;);
    }
  }

&lt;span style=&#34;color: #4b69c6&#34;&gt;updateLightboxContent&lt;/span&gt;() {
  &lt;span style=&#34;color: #d73948&#34;&gt;const&lt;/span&gt; currentItem &lt;span style=&#34;color: #d73948&#34;&gt;=&lt;/span&gt; &lt;span style=&#34;color: #d73948&#34;&gt;this&lt;/span&gt;.galleryItems[&lt;span style=&#34;color: #d73948&#34;&gt;this&lt;/span&gt;.currentIndex];
  &lt;span style=&#34;color: #d73948&#34;&gt;const&lt;/span&gt; { src, alt } &lt;span style=&#34;color: #d73948&#34;&gt;=&lt;/span&gt; &lt;span style=&#34;color: #d73948&#34;&gt;this&lt;/span&gt;.&lt;span style=&#34;color: #4b69c6&#34;&gt;getImageDetails&lt;/span&gt;(currentItem);

  &lt;span style=&#34;color: #d73948&#34;&gt;this&lt;/span&gt;.image.src &lt;span style=&#34;color: #d73948&#34;&gt;=&lt;/span&gt; src;
  &lt;span style=&#34;color: #d73948&#34;&gt;this&lt;/span&gt;.image.alt &lt;span style=&#34;color: #d73948&#34;&gt;=&lt;/span&gt; alt;
  &lt;span style=&#34;color: #d73948&#34;&gt;this&lt;/span&gt;.caption.textContent &lt;span style=&#34;color: #d73948&#34;&gt;=&lt;/span&gt; alt;

  &lt;span style=&#34;color: #74747c&#34;&gt;//&lt;/span&gt;&lt;span style=&#34;color: #74747c&#34;&gt; Use imageCount instead of galleryItems.length&lt;/span&gt;
  &lt;span style=&#34;color: #d73948&#34;&gt;if&lt;/span&gt; (&lt;span style=&#34;color: #d73948&#34;&gt;this&lt;/span&gt;.imageCount &lt;span style=&#34;color: #d73948&#34;&gt;&amp;lt;=&lt;/span&gt; &lt;span style=&#34;color: #b60157&#34;&gt;1&lt;/span&gt;) {
    &lt;span style=&#34;color: #d73948&#34;&gt;this&lt;/span&gt;.prevButton.style.display &lt;span style=&#34;color: #d73948&#34;&gt;=&lt;/span&gt; &lt;span style=&#34;color: #198810&#34;&gt;&amp;#39;&lt;/span&gt;&lt;span style=&#34;color: #198810&#34;&gt;none&lt;/span&gt;&lt;span style=&#34;color: #198810&#34;&gt;&amp;#39;&lt;/span&gt;;
    &lt;span style=&#34;color: #d73948&#34;&gt;this&lt;/span&gt;.nextButton.style.display &lt;span style=&#34;color: #d73948&#34;&gt;=&lt;/span&gt; &lt;span style=&#34;color: #198810&#34;&gt;&amp;#39;&lt;/span&gt;&lt;span style=&#34;color: #198810&#34;&gt;none&lt;/span&gt;&lt;span style=&#34;color: #198810&#34;&gt;&amp;#39;&lt;/span&gt;;
  } &lt;span style=&#34;color: #d73948&#34;&gt;else&lt;/span&gt; {
    &lt;span style=&#34;color: #d73948&#34;&gt;this&lt;/span&gt;.prevButton.style.display &lt;span style=&#34;color: #d73948&#34;&gt;=&lt;/span&gt; &lt;span style=&#34;color: #198810&#34;&gt;&amp;#39;&lt;/span&gt;&lt;span style=&#34;color: #198810&#34;&gt;block&lt;/span&gt;&lt;span style=&#34;color: #198810&#34;&gt;&amp;#39;&lt;/span&gt;;
    &lt;span style=&#34;color: #d73948&#34;&gt;this&lt;/span&gt;.nextButton.style.display &lt;span style=&#34;color: #d73948&#34;&gt;=&lt;/span&gt; &lt;span style=&#34;color: #198810&#34;&gt;&amp;#39;&lt;/span&gt;&lt;span style=&#34;color: #198810&#34;&gt;block&lt;/span&gt;&lt;span style=&#34;color: #198810&#34;&gt;&amp;#39;&lt;/span&gt;;
  }
}

  &lt;span style=&#34;color: #4b69c6&#34;&gt;showPrevious&lt;/span&gt;() {
    &lt;span style=&#34;color: #d73948&#34;&gt;this&lt;/span&gt;.currentIndex &lt;span style=&#34;color: #d73948&#34;&gt;=&lt;/span&gt; (&lt;span style=&#34;color: #d73948&#34;&gt;this&lt;/span&gt;.currentIndex &lt;span style=&#34;color: #d73948&#34;&gt;-&lt;/span&gt; &lt;span style=&#34;color: #b60157&#34;&gt;1&lt;/span&gt; &lt;span style=&#34;color: #d73948&#34;&gt;+&lt;/span&gt; &lt;span style=&#34;color: #d73948&#34;&gt;this&lt;/span&gt;.galleryItems.length) &lt;span style=&#34;color: #d73948&#34;&gt;%&lt;/span&gt; &lt;span style=&#34;color: #d73948&#34;&gt;this&lt;/span&gt;.galleryItems.length;
    &lt;span style=&#34;color: #d73948&#34;&gt;this&lt;/span&gt;.&lt;span style=&#34;color: #4b69c6&#34;&gt;updateLightboxContent&lt;/span&gt;();
  }

  &lt;span style=&#34;color: #4b69c6&#34;&gt;showNext&lt;/span&gt;() {
    &lt;span style=&#34;color: #d73948&#34;&gt;this&lt;/span&gt;.currentIndex &lt;span style=&#34;color: #d73948&#34;&gt;=&lt;/span&gt; (&lt;span style=&#34;color: #d73948&#34;&gt;this&lt;/span&gt;.currentIndex &lt;span style=&#34;color: #d73948&#34;&gt;+&lt;/span&gt; &lt;span style=&#34;color: #b60157&#34;&gt;1&lt;/span&gt;) &lt;span style=&#34;color: #d73948&#34;&gt;%&lt;/span&gt; &lt;span style=&#34;color: #d73948&#34;&gt;this&lt;/span&gt;.galleryItems.length;
    &lt;span style=&#34;color: #d73948&#34;&gt;this&lt;/span&gt;.&lt;span style=&#34;color: #4b69c6&#34;&gt;updateLightboxContent&lt;/span&gt;();
  }
}

&lt;span style=&#34;color: #74747c&#34;&gt;//&lt;/span&gt;&lt;span style=&#34;color: #74747c&#34;&gt; Initialize the lightbox for each gallery&lt;/span&gt;
&lt;span style=&#34;color: #4b69c6&#34;&gt;document&lt;/span&gt;.&lt;span style=&#34;color: #4b69c6&#34;&gt;addEventListener&lt;/span&gt;(&lt;span style=&#34;color: #198810&#34;&gt;&amp;#39;&lt;/span&gt;&lt;span style=&#34;color: #198810&#34;&gt;DOMContentLoaded&lt;/span&gt;&lt;span style=&#34;color: #198810&#34;&gt;&amp;#39;&lt;/span&gt;, () &lt;span style=&#34;color: #d73948&#34;&gt;=&amp;gt;&lt;/span&gt; {
  &lt;span style=&#34;color: #d73948&#34;&gt;const&lt;/span&gt; galleries &lt;span style=&#34;color: #d73948&#34;&gt;=&lt;/span&gt; &lt;span style=&#34;color: #4b69c6&#34;&gt;document&lt;/span&gt;.&lt;span style=&#34;color: #4b69c6&#34;&gt;querySelectorAll&lt;/span&gt;(&lt;span style=&#34;color: #198810&#34;&gt;&amp;#39;&lt;/span&gt;&lt;span style=&#34;color: #198810&#34;&gt;.gallery&lt;/span&gt;&lt;span style=&#34;color: #198810&#34;&gt;&amp;#39;&lt;/span&gt;);
  galleries.&lt;span style=&#34;color: #4b69c6&#34;&gt;forEach&lt;/span&gt;(gallery &lt;span style=&#34;color: #d73948&#34;&gt;=&amp;gt;&lt;/span&gt; &lt;span style=&#34;color: #d73948&#34;&gt;new&lt;/span&gt; Lightbox(gallery));
});&lt;/code&gt;&lt;/pre&gt;&lt;/div&gt;&lt;p&gt;The result: higher image quality (raised image default width from 1400px to 1600px) and &lt;strong&gt;half&lt;/strong&gt; the file-size, eg. &lt;a href=&#34;/nonsense&#34; title=&#34;Some of the nonsense from my old loaf | May 2022&#34; data-preview=&#34;/previews/34a75a10-e143-4d05-9040-e2caed02ce41.html&#34;&gt;my nonsense page&lt;/a&gt; has been cut from 7.8MB transferred to load, to 3.45MB. Or, to compare only the actual images, 6.8MB to 2.94MB, a 57% saving. At higher quality! Madness.&lt;/p&gt;&lt;p&gt;Coupled with the previous change —&lt;span style=&#34;white-space: pre-wrap&#34;&gt; &lt;/span&gt;&lt;a href=&#34;/2024/11/17/175502&#34; title=&#34;Convert heavy PNGs to JPEG where appropriate | November 2024&#34; data-preview=&#34;/previews/5f25baf8-9305-4a85-af66-6ae111ee7cdd.html&#34;&gt;Convert heavy PNGs to JPEG where appropriate&lt;/a&gt; — that page has been cut from 15.9 to 3.45MB. Happy with that.&lt;/p&gt;&lt;aside class=&#34;aside&#34;&gt;&lt;p&gt;Small problem with the new image reference solution: classes specified in Djot are no longer passed through as the Djot rendering is bypassed. Most images on the site are wrapped in a ‘gallery’ div, so I can still class that, but it does create a small annoyance for bare images.&lt;/p&gt;&lt;time datetime=&#34;2024-12-05T10:08:23-08:00&#34;&gt;&lt;a href=&#34;/2024/12/05/100823&#34;&gt;December 5, 2024 10.08AM&lt;/a&gt;&lt;/time&gt;&lt;/aside&gt;6:16pm on December 4, 2024 from Yaletown, Vancouver, British Columbia, Canada&lt;p&gt;&lt;a href=&#34;mailto:reply@silasjelley.com?subject=Reply%20to%3A%20%E2%80%9CSwitch%20image%20references%20to%20use%20picture%20elements%20and%20AVIF%20encoded%20files%E2%80%9D&#34;&gt;Reply via email&lt;/a&gt;&lt;/p&gt;
</content>
</entry>
<entry>
  <title>Switched to non-breaking spaces in Chapter, Volume, Edition, and Page attribution</title>
  <link rel="alternate" type="text/html" href="https://silasjelley.com/2024/11/19/203127" />
  <id>tag:silasjelley.com,2020-08-20:8d5230e3-f7ce-43c0-9fe4-e79b2071fd2b</id>
  <published>2024-11-19T20:31:27-08:00</published>
  <updated>2024-11-19T20:31:27-08:00</updated>
  <category term="notes" />
  <category term="changelogs" />
  <summary>A very minor change to resolve a bit of acute visual nit-picking. The space in eg, ‘p. 56’, ‘Ch. 7’, ‘Vol. 9’, or ‘(3rd edition)’, created by my attribution logic, could cause the two parts to appear…</summary>
<mosaic:place>Kitsilano, Vancouver, British Columbia, Canada</mosaic:place>
<content type="html">
    &lt;p&gt;A very minor change to resolve a bit of acute visual nit-picking. The space in eg, ‘p. 56’, ‘Ch. 7’, ‘Vol. 9’, or ‘(3rd edition)’, created by my attribution logic, could cause the two parts to appear on separate lines in a long attribution string or a narrow viewport. Switching to a non-breaking space ‘ ‘ (visually indistinguishable from a normal space) means they will always appear side by side.&lt;/p&gt;&lt;p&gt;Unicode codepoint U+00A0, commonly abbreviated as NBSP.&lt;/p&gt;8:31pm on November 19, 2024 from Kitsilano, Vancouver, British Columbia, Canada&lt;p&gt;&lt;a href=&#34;mailto:reply@silasjelley.com?subject=Reply%20to%3A%20%E2%80%9CSwitched%20to%20non-breaking%20spaces%20in%20Chapter%2C%20Volume%2C%20Edition%2C%20and%20Page%20attribution%E2%80%9D&#34;&gt;Reply via email&lt;/a&gt;&lt;/p&gt;
</content>
</entry>
<entry>
  <title>Convert heavy PNGs to JPEG where appropriate</title>
  <link rel="alternate" type="text/html" href="https://silasjelley.com/2024/11/17/175502" />
  <id>tag:silasjelley.com,2020-08-20:5f25baf8-9305-4a85-af66-6ae111ee7cdd</id>
  <published>2024-11-17T17:55:02-08:00</published>
  <updated>2024-11-17T17:55:02-08:00</updated>
  <category term="notes" />
  <category term="changelogs" />
  <summary>While viewing my nonsense page with the network tab of the developer tools open I noticed the page was transferring a total of 15.8MB to load. The page loads hundreds of posts so this isn’t…</summary>
<mosaic:place>Kitsilano, Vancouver, British Columbia, Canada</mosaic:place>
<content type="html">
    &lt;p&gt;While viewing my &lt;a href=&#34;/nonsense&#34; title=&#34;Some of the nonsense from my old loaf | May 2022&#34; data-preview=&#34;/previews/34a75a10-e143-4d05-9040-e2caed02ce41.html&#34;&gt;nonsense page&lt;/a&gt; with the network tab of the developer tools open I noticed the page was transferring a total of 15.8MB to load. The page loads hundreds of posts so this isn’t completely absurd, but it felt excessive. Turns out most of the weight was coming from a handful of PNG posters and screenshots.&lt;/p&gt;&lt;p&gt;In the general case, JPEGs are smaller than PNGs, but I didn’t want to hardcode conversion of all PNGs because there are times when lossless or transparent images are wanted.&lt;/p&gt;&lt;p&gt;I toyed around with a couple of implementations. My first prototype added a &lt;code&gt;convert_to&lt;/code&gt; key to the asset manifests, but in the end I decided to simply convert on the basis of the output_path suffix being different than the input_path suffix in a manifest entry, allowing every stage of the build to seamlessly pick up the correct path to reference.&lt;/p&gt;&lt;p&gt;Switching those few heavy-weight PNGs to JPEG output cut the page weight from 15.8MB down to 5.18MB.&lt;/p&gt;&lt;p&gt;The most egregious offender was &lt;a href=&#34;/2022/06/10/212140&#34; title=&#34;Princess Mononoke, my first Ghibli | June 2022&#34; data-preview=&#34;/previews/ea33be5e-e2b4-49e2-93be-dd7632a9c56d.html&#34;&gt;Princess Mononoke, my first Ghibli&lt;/a&gt;“) coming in at 2.8MB initially, down to 240kB after conversion to JPEG. Shown below, the only change required in a manifest entry is to change the suffix/file-extension.&lt;/p&gt;&lt;div class=&#34;code-block&#34; data-lang=&#34;toml&#34;&gt;&lt;div class=&#34;code-header&#34; data-mosaic-chrome=&#34;&#34;&gt;&lt;span class=&#34;code-lang&#34;&gt;toml&lt;/span&gt;&lt;button class=&#34;code-copy&#34; aria-label=&#34;Copy code&#34; type=&#34;button&#34;&gt;Copy&lt;/button&gt;&lt;/div&gt;&lt;pre&gt;&lt;code data-lang=&#34;toml&#34;&gt;[&lt;span style=&#34;color: #4b69c6&#34;&gt;27991f33-f40f-48ab-9690-0003db7b2038&lt;/span&gt;]
&lt;span style=&#34;color: #4b69c6&#34;&gt;type&lt;/span&gt; = &lt;span style=&#34;color: #198810&#34;&gt;&amp;#34;&lt;/span&gt;&lt;span style=&#34;color: #198810&#34;&gt;poster&lt;/span&gt;&lt;span style=&#34;color: #198810&#34;&gt;&amp;#34;&lt;/span&gt;
&lt;span style=&#34;color: #4b69c6&#34;&gt;title&lt;/span&gt; = &lt;span style=&#34;color: #198810&#34;&gt;&amp;#34;&lt;/span&gt;&lt;span style=&#34;color: #198810&#34;&gt;The poster for the film Blade Runner (1982)&lt;/span&gt;&lt;span style=&#34;color: #198810&#34;&gt;&amp;#34;&lt;/span&gt;
&lt;span style=&#34;color: #4b69c6&#34;&gt;filepath&lt;/span&gt; = &lt;span style=&#34;color: #198810&#34;&gt;&amp;#34;&lt;/span&gt;&lt;span style=&#34;color: #198810&#34;&gt;/home/silas/library/images/posters/films/1982_Blade-Runner.png&lt;/span&gt;&lt;span style=&#34;color: #198810&#34;&gt;&amp;#34;&lt;/span&gt;
&lt;span style=&#34;color: #4b69c6&#34;&gt;slug&lt;/span&gt; = &lt;span style=&#34;color: #198810&#34;&gt;&amp;#34;&lt;/span&gt;&lt;span style=&#34;color: #198810&#34;&gt;library/images/posters/films/1982_Blade-Runner.jpg&lt;/span&gt;&lt;span style=&#34;color: #198810&#34;&gt;&amp;#34;&lt;/span&gt;&lt;/code&gt;&lt;/pre&gt;&lt;/div&gt;&lt;p&gt;The only change I needed to make to the build script was to check the colour-space when converting to JPEG and switch it to RGB in the case that the source colour-space was either ‘RGBA’ or ‘P’:&lt;/p&gt;&lt;div class=&#34;code-block&#34; data-lang=&#34;python&#34;&gt;&lt;div class=&#34;code-header&#34; data-mosaic-chrome=&#34;&#34;&gt;&lt;span class=&#34;code-lang&#34;&gt;python&lt;/span&gt;&lt;button class=&#34;code-copy&#34; aria-label=&#34;Copy code&#34; type=&#34;button&#34;&gt;Copy&lt;/button&gt;&lt;/div&gt;&lt;pre&gt;&lt;code data-lang=&#34;python&#34;&gt;&lt;span style=&#34;color: #d73948&#34;&gt;def&lt;/span&gt; &lt;span style=&#34;color: #4b69c6&#34;&gt;process_image_parallel&lt;/span&gt;(input_data: Tuple[Path, Path, &lt;span style=&#34;color: #4b69c6&#34;&gt;int&lt;/span&gt;]) -&amp;gt; &lt;span style=&#34;color: #d73948&#34;&gt;None&lt;/span&gt;:
    input_image, output_path, output_width &lt;span style=&#34;color: #d73948&#34;&gt;=&lt;/span&gt; input_data
    lock_path &lt;span style=&#34;color: #d73948&#34;&gt;=&lt;/span&gt; output_path.&lt;span style=&#34;color: #4b69c6&#34;&gt;with_suffix&lt;/span&gt;(&lt;span style=&#34;color: #198810&#34;&gt;&amp;#34;&lt;/span&gt;&lt;span style=&#34;color: #198810&#34;&gt;.lock&lt;/span&gt;&lt;span style=&#34;color: #198810&#34;&gt;&amp;#34;&lt;/span&gt;)
    lock &lt;span style=&#34;color: #d73948&#34;&gt;=&lt;/span&gt; &lt;span style=&#34;color: #4b69c6&#34;&gt;FileLock&lt;/span&gt;(&lt;span style=&#34;color: #4b69c6&#34;&gt;str&lt;/span&gt;(lock_path))

    &lt;span style=&#34;color: #d73948&#34;&gt;try&lt;/span&gt;:
        &lt;span style=&#34;color: #d73948&#34;&gt;with&lt;/span&gt; lock:
            &lt;span style=&#34;color: #d73948&#34;&gt;if&lt;/span&gt; output_path.&lt;span style=&#34;color: #4b69c6&#34;&gt;exists&lt;/span&gt;():
                &lt;span style=&#34;color: #d73948&#34;&gt;return&lt;/span&gt;

            os.&lt;span style=&#34;color: #4b69c6&#34;&gt;makedirs&lt;/span&gt;(output_path.parent, exist_ok&lt;span style=&#34;color: #d73948&#34;&gt;=&lt;/span&gt;&lt;span style=&#34;color: #d73948&#34;&gt;True&lt;/span&gt;)

            &lt;span style=&#34;color: #d73948&#34;&gt;with&lt;/span&gt; Image.&lt;span style=&#34;color: #4b69c6&#34;&gt;open&lt;/span&gt;(input_image) &lt;span style=&#34;color: #d73948&#34;&gt;as&lt;/span&gt; im:
                original_format &lt;span style=&#34;color: #d73948&#34;&gt;=&lt;/span&gt; im.format
                im &lt;span style=&#34;color: #d73948&#34;&gt;=&lt;/span&gt; ImageOps.&lt;span style=&#34;color: #4b69c6&#34;&gt;exif_transpose&lt;/span&gt;(im)
                output_height &lt;span style=&#34;color: #d73948&#34;&gt;=&lt;/span&gt; &lt;span style=&#34;color: #4b69c6&#34;&gt;int&lt;/span&gt;(im.size[&lt;span style=&#34;color: #b60157&#34;&gt;1&lt;/span&gt;] &lt;span style=&#34;color: #d73948&#34;&gt;*&lt;/span&gt; (output_width &lt;span style=&#34;color: #d73948&#34;&gt;/&lt;/span&gt; im.size[&lt;span style=&#34;color: #b60157&#34;&gt;0&lt;/span&gt;]))

                &lt;span style=&#34;color: #d73948&#34;&gt;with&lt;/span&gt; im.&lt;span style=&#34;color: #4b69c6&#34;&gt;resize&lt;/span&gt;(
                    (output_width, output_height), Image.Resampling.LANCZOS
                ) &lt;span style=&#34;color: #d73948&#34;&gt;as&lt;/span&gt; output_image:
                    &lt;span style=&#34;color: #d73948&#34;&gt;if&lt;/span&gt; (
                        original_format &lt;span style=&#34;color: #d73948&#34;&gt;!=&lt;/span&gt; &lt;span style=&#34;color: #198810&#34;&gt;&amp;#34;&lt;/span&gt;&lt;span style=&#34;color: #198810&#34;&gt;JPEG&lt;/span&gt;&lt;span style=&#34;color: #198810&#34;&gt;&amp;#34;&lt;/span&gt;
                        &lt;span style=&#34;color: #d73948&#34;&gt;and&lt;/span&gt; &lt;span style=&#34;color: #4b69c6&#34;&gt;str&lt;/span&gt;(output_path).&lt;span style=&#34;color: #4b69c6&#34;&gt;endswith&lt;/span&gt;(&lt;span style=&#34;color: #198810&#34;&gt;&amp;#34;&lt;/span&gt;&lt;span style=&#34;color: #198810&#34;&gt;jpg&lt;/span&gt;&lt;span style=&#34;color: #198810&#34;&gt;&amp;#34;&lt;/span&gt;)
                        &lt;span style=&#34;color: #d73948&#34;&gt;and&lt;/span&gt; output_image.mode &lt;span style=&#34;color: #d73948&#34;&gt;in&lt;/span&gt; (&lt;span style=&#34;color: #198810&#34;&gt;&amp;#34;&lt;/span&gt;&lt;span style=&#34;color: #198810&#34;&gt;RGBA&lt;/span&gt;&lt;span style=&#34;color: #198810&#34;&gt;&amp;#34;&lt;/span&gt;, &lt;span style=&#34;color: #198810&#34;&gt;&amp;#34;&lt;/span&gt;&lt;span style=&#34;color: #198810&#34;&gt;P&lt;/span&gt;&lt;span style=&#34;color: #198810&#34;&gt;&amp;#34;&lt;/span&gt;)
                    ):
                        output_image &lt;span style=&#34;color: #d73948&#34;&gt;=&lt;/span&gt; output_image.&lt;span style=&#34;color: #4b69c6&#34;&gt;convert&lt;/span&gt;(&lt;span style=&#34;color: #198810&#34;&gt;&amp;#34;&lt;/span&gt;&lt;span style=&#34;color: #198810&#34;&gt;RGB&lt;/span&gt;&lt;span style=&#34;color: #198810&#34;&gt;&amp;#34;&lt;/span&gt;)

                    output_image.&lt;span style=&#34;color: #4b69c6&#34;&gt;save&lt;/span&gt;(output_path, quality&lt;span style=&#34;color: #d73948&#34;&gt;=&lt;/span&gt;&lt;span style=&#34;color: #b60157&#34;&gt;85&lt;/span&gt;, optimize&lt;span style=&#34;color: #d73948&#34;&gt;=&lt;/span&gt;&lt;span style=&#34;color: #d73948&#34;&gt;True&lt;/span&gt;)

            logger.&lt;span style=&#34;color: #4b69c6&#34;&gt;debug&lt;/span&gt;(&lt;span style=&#34;color: #d73948&#34;&gt;f&lt;/span&gt;&lt;span style=&#34;color: #198810&#34;&gt;&amp;#34;&lt;/span&gt;&lt;span style=&#34;color: #198810&#34;&gt;Processed image: &lt;/span&gt;&lt;span style=&#34;color: #8b41b1&#34;&gt;{&lt;/span&gt;&lt;span style=&#34;color: #8b41b1&#34;&gt;input_image&lt;/span&gt;&lt;span style=&#34;color: #8b41b1&#34;&gt;}&lt;/span&gt;&lt;span style=&#34;color: #198810&#34;&gt; -&amp;gt; &lt;/span&gt;&lt;span style=&#34;color: #8b41b1&#34;&gt;{&lt;/span&gt;&lt;span style=&#34;color: #8b41b1&#34;&gt;output_path&lt;/span&gt;&lt;span style=&#34;color: #8b41b1&#34;&gt;}&lt;/span&gt;&lt;span style=&#34;color: #198810&#34;&gt;&amp;#34;&lt;/span&gt;)

    &lt;span style=&#34;color: #d73948&#34;&gt;except&lt;/span&gt; &lt;span style=&#34;color: #4b69c6&#34;&gt;OSError&lt;/span&gt; &lt;span style=&#34;color: #d73948&#34;&gt;as&lt;/span&gt; e:
        logger.&lt;span style=&#34;color: #4b69c6&#34;&gt;error&lt;/span&gt;(&lt;span style=&#34;color: #d73948&#34;&gt;f&lt;/span&gt;&lt;span style=&#34;color: #198810&#34;&gt;&amp;#34;&lt;/span&gt;&lt;span style=&#34;color: #198810&#34;&gt;OS error processing &lt;/span&gt;&lt;span style=&#34;color: #8b41b1&#34;&gt;{&lt;/span&gt;&lt;span style=&#34;color: #8b41b1&#34;&gt;input_image&lt;/span&gt;&lt;span style=&#34;color: #8b41b1&#34;&gt;}&lt;/span&gt;&lt;span style=&#34;color: #198810&#34;&gt;: &lt;/span&gt;&lt;span style=&#34;color: #8b41b1&#34;&gt;{&lt;/span&gt;&lt;span style=&#34;color: #8b41b1&#34;&gt;e&lt;/span&gt;&lt;span style=&#34;color: #8b41b1&#34;&gt;}&lt;/span&gt;&lt;span style=&#34;color: #198810&#34;&gt;&amp;#34;&lt;/span&gt;)
    &lt;span style=&#34;color: #d73948&#34;&gt;except&lt;/span&gt; &lt;span style=&#34;color: #4b69c6&#34;&gt;Exception&lt;/span&gt; &lt;span style=&#34;color: #d73948&#34;&gt;as&lt;/span&gt; e:
        logger.&lt;span style=&#34;color: #4b69c6&#34;&gt;error&lt;/span&gt;(&lt;span style=&#34;color: #d73948&#34;&gt;f&lt;/span&gt;&lt;span style=&#34;color: #198810&#34;&gt;&amp;#34;&lt;/span&gt;&lt;span style=&#34;color: #198810&#34;&gt;Error processing &lt;/span&gt;&lt;span style=&#34;color: #8b41b1&#34;&gt;{&lt;/span&gt;&lt;span style=&#34;color: #8b41b1&#34;&gt;input_image&lt;/span&gt;&lt;span style=&#34;color: #8b41b1&#34;&gt;}&lt;/span&gt;&lt;span style=&#34;color: #198810&#34;&gt;: &lt;/span&gt;&lt;span style=&#34;color: #8b41b1&#34;&gt;{&lt;/span&gt;&lt;span style=&#34;color: #8b41b1&#34;&gt;e&lt;/span&gt;&lt;span style=&#34;color: #8b41b1&#34;&gt;}&lt;/span&gt;&lt;span style=&#34;color: #198810&#34;&gt;&amp;#34;&lt;/span&gt;)
    &lt;span style=&#34;color: #d73948&#34;&gt;finally&lt;/span&gt;:
        &lt;span style=&#34;color: #d73948&#34;&gt;if&lt;/span&gt; lock_path.&lt;span style=&#34;color: #4b69c6&#34;&gt;exists&lt;/span&gt;():
            &lt;span style=&#34;color: #d73948&#34;&gt;try&lt;/span&gt;:
                lock_path.&lt;span style=&#34;color: #4b69c6&#34;&gt;unlink&lt;/span&gt;()
            &lt;span style=&#34;color: #d73948&#34;&gt;except&lt;/span&gt; &lt;span style=&#34;color: #4b69c6&#34;&gt;OSError&lt;/span&gt;:
                &lt;span style=&#34;color: #d73948&#34;&gt;pass&lt;/span&gt;&lt;/code&gt;&lt;/pre&gt;&lt;/div&gt;5:55pm on November 17, 2024 from Kitsilano, Vancouver, British Columbia, Canada&lt;p&gt;&lt;a href=&#34;mailto:reply@silasjelley.com?subject=Reply%20to%3A%20%E2%80%9CConvert%20heavy%20PNGs%20to%20JPEG%20where%20appropriate%E2%80%9D&#34;&gt;Reply via email&lt;/a&gt;&lt;/p&gt;
</content>
</entry>
<entry>
  <title>Import referenced documents at build time</title>
  <link rel="alternate" type="text/html" href="https://silasjelley.com/2024/11/15/132717" />
  <id>tag:silasjelley.com,2020-08-20:5a0d3cbb-f865-49ce-8b97-2a33a61296f8</id>
  <published>2024-11-15T13:27:17-07:00</published>
  <updated>2024-11-15T13:27:17-07:00</updated>
  <category term="notes" />
  <category term="changelogs" />
  <summary>Added import references, restoring and improving the functionality of the ‘transclude’ reference that I previously deprecated and removed. Has two modes, both of which support comments. import,…</summary>
<mosaic:place>East Village, Calgary, Alberta, Canada</mosaic:place>
<content type="html">
    &lt;p&gt;Added import references, restoring and improving the functionality of the ‘transclude’ reference that I previously deprecated and removed.&lt;/p&gt;&lt;p&gt;Has two modes, both of which support comments.&lt;/p&gt;&lt;ul&gt;&lt;li&gt;&lt;code&gt;import&lt;/code&gt;, transcludes the content of the referenced document as is, without any additional markup or visual cue.&lt;/li&gt;&lt;li&gt;&lt;code&gt;aside&lt;/code&gt;, creates an aside-type block that also includes an outbound link.&lt;/li&gt;&lt;/ul&gt;&lt;p&gt;Both support an optional comment at the reference-site that is discarded during substitution.&lt;/p&gt;&lt;p&gt;The following snippet (minus the backslash),&lt;/p&gt;&lt;div class=&#34;code-block&#34;&gt;&lt;div class=&#34;code-header&#34; data-mosaic-chrome=&#34;&#34;&gt;&lt;button class=&#34;code-copy&#34; aria-label=&#34;Copy code&#34; type=&#34;button&#34;&gt;Copy&lt;/button&gt;&lt;/div&gt;&lt;pre&gt;&lt;code&gt;{{ aside::501108be // getting arrested again }\}&lt;/code&gt;&lt;/pre&gt;&lt;/div&gt;&lt;p&gt;Would be substituted with this markup,&lt;/p&gt;&lt;div class=&#34;code-block&#34;&gt;&lt;div class=&#34;code-header&#34; data-mosaic-chrome=&#34;&#34;&gt;&lt;button class=&#34;code-copy&#34; aria-label=&#34;Copy code&#34; type=&#34;button&#34;&gt;Copy&lt;/button&gt;&lt;/div&gt;&lt;pre&gt;&lt;code&gt;{{ aside::501108be // getting arrested again }}&lt;/code&gt;&lt;/pre&gt;&lt;/div&gt;&lt;p&gt;Which would then be rendered into the following later in the build,&lt;/p&gt;&lt;aside class=&#34;aside&#34;&gt;&lt;p&gt;The first time you get arrested your friends ask you, “What happened?!”&lt;br/&gt;The second time you get arrested it’s already, “What did you do?”&lt;/p&gt;&lt;time datetime=&#34;2024-11-03T15:13:30+03:00&#34;&gt;&lt;a href=&#34;/2024/11/03/151330&#34;&gt;November 3, 2024 3.13PM&lt;/a&gt;&lt;/time&gt;&lt;/aside&gt;&lt;p&gt;Both forms of import create a backlink in the referenced document, but only &lt;code&gt;aside&lt;/code&gt; creates a visible outward link at the reference-site. This allows documents to be assembled seamlessly where that is a better fit than a call-out, but generally I expect I’ll use the &lt;code&gt;aside&lt;/code&gt; mode more often, as I generally prefer for connections to be bi-directional.&lt;/p&gt;1:27pm on November 15, 2024 from East Village, Calgary, Alberta, Canada&lt;p&gt;&lt;a href=&#34;mailto:reply@silasjelley.com?subject=Reply%20to%3A%20%E2%80%9CImport%20referenced%20documents%20at%20build%20time%E2%80%9D&#34;&gt;Reply via email&lt;/a&gt;&lt;/p&gt;
</content>
</entry>
<entry>
  <title>Add syntax highlighting to code blocks using Pygments</title>
  <link rel="alternate" type="text/html" href="https://silasjelley.com/2024/10/20/022613" />
  <id>tag:silasjelley.com,2020-08-20:2283933e-c8e3-43be-b801-f580ffd59adc</id>
  <published>2024-10-20T02:26:13+03:00</published>
  <updated>2024-10-20T02:26:13+03:00</updated>
  <category term="notes" />
  <category term="changelogs" />
  <summary>Implementation was pretty straight forward after getting the regex right to treat ‘=html’ blocks as raw. Changes located in the run_jotdown function and the new highlight_code function, as well as…</summary>
<mosaic:place>Haydarpaşa, Istanbul, Turkey</mosaic:place>
<content type="html">
    &lt;p&gt;Implementation was pretty straight forward after getting the regex right to treat ‘=html’ blocks as raw.&lt;/p&gt;&lt;p&gt;Changes located in the &lt;code&gt;run_jotdown&lt;/code&gt; function and the new &lt;em&gt;highlight_code&lt;/em&gt; function, as well as fiddling with css.&lt;/p&gt;&lt;div class=&#34;code-block&#34; data-lang=&#34;python&#34;&gt;&lt;div class=&#34;code-header&#34; data-mosaic-chrome=&#34;&#34;&gt;&lt;span class=&#34;code-lang&#34;&gt;python&lt;/span&gt;&lt;button class=&#34;code-copy&#34; aria-label=&#34;Copy code&#34; type=&#34;button&#34;&gt;Copy&lt;/button&gt;&lt;/div&gt;&lt;pre&gt;&lt;code data-lang=&#34;python&#34;&gt;&lt;span style=&#34;color: #d73948&#34;&gt;def&lt;/span&gt; &lt;span style=&#34;color: #4b69c6&#34;&gt;highlight_code&lt;/span&gt;(code: &lt;span style=&#34;color: #4b69c6&#34;&gt;str&lt;/span&gt;, language: &lt;span style=&#34;color: #4b69c6&#34;&gt;str&lt;/span&gt; &lt;span style=&#34;color: #d73948&#34;&gt;=&lt;/span&gt; &lt;span style=&#34;color: #d73948&#34;&gt;None&lt;/span&gt;) -&amp;gt; &lt;span style=&#34;color: #4b69c6&#34;&gt;str&lt;/span&gt;:
    &lt;span style=&#34;color: #74747c&#34;&gt;&amp;#34;&amp;#34;&amp;#34;&lt;/span&gt;
&lt;span style=&#34;color: #74747c&#34;&gt;    Highlight code using Pygments with specified or guessed language.&lt;/span&gt;
&lt;span style=&#34;color: #74747c&#34;&gt;    &lt;/span&gt;&lt;span style=&#34;color: #74747c&#34;&gt;&amp;#34;&amp;#34;&amp;#34;&lt;/span&gt;
    &lt;span style=&#34;color: #d73948&#34;&gt;try&lt;/span&gt;:
        &lt;span style=&#34;color: #d73948&#34;&gt;if&lt;/span&gt; language:
            lexer &lt;span style=&#34;color: #d73948&#34;&gt;=&lt;/span&gt; &lt;span style=&#34;color: #4b69c6&#34;&gt;get_lexer_by_name&lt;/span&gt;(language.&lt;span style=&#34;color: #4b69c6&#34;&gt;lower&lt;/span&gt;())
        &lt;span style=&#34;color: #d73948&#34;&gt;else&lt;/span&gt;:
            lexer &lt;span style=&#34;color: #d73948&#34;&gt;=&lt;/span&gt; &lt;span style=&#34;color: #4b69c6&#34;&gt;guess_lexer&lt;/span&gt;(code)

        formatter &lt;span style=&#34;color: #d73948&#34;&gt;=&lt;/span&gt; &lt;span style=&#34;color: #4b69c6&#34;&gt;HtmlFormatter&lt;/span&gt;(
            style&lt;span style=&#34;color: #d73948&#34;&gt;=&lt;/span&gt;config[&lt;span style=&#34;color: #198810&#34;&gt;&amp;#34;&lt;/span&gt;&lt;span style=&#34;color: #198810&#34;&gt;syntax_highlighting&lt;/span&gt;&lt;span style=&#34;color: #198810&#34;&gt;&amp;#34;&lt;/span&gt;][&lt;span style=&#34;color: #198810&#34;&gt;&amp;#34;&lt;/span&gt;&lt;span style=&#34;color: #198810&#34;&gt;style&lt;/span&gt;&lt;span style=&#34;color: #198810&#34;&gt;&amp;#34;&lt;/span&gt;],
            linenos&lt;span style=&#34;color: #d73948&#34;&gt;=&lt;/span&gt;&lt;span style=&#34;color: #198810&#34;&gt;&amp;#34;&lt;/span&gt;&lt;span style=&#34;color: #198810&#34;&gt;table&lt;/span&gt;&lt;span style=&#34;color: #198810&#34;&gt;&amp;#34;&lt;/span&gt;
            &lt;span style=&#34;color: #d73948&#34;&gt;if&lt;/span&gt; config[&lt;span style=&#34;color: #198810&#34;&gt;&amp;#34;&lt;/span&gt;&lt;span style=&#34;color: #198810&#34;&gt;syntax_highlighting&lt;/span&gt;&lt;span style=&#34;color: #198810&#34;&gt;&amp;#34;&lt;/span&gt;].&lt;span style=&#34;color: #4b69c6&#34;&gt;get&lt;/span&gt;(&lt;span style=&#34;color: #198810&#34;&gt;&amp;#34;&lt;/span&gt;&lt;span style=&#34;color: #198810&#34;&gt;line_numbers&lt;/span&gt;&lt;span style=&#34;color: #198810&#34;&gt;&amp;#34;&lt;/span&gt;, &lt;span style=&#34;color: #d73948&#34;&gt;False&lt;/span&gt;)
            &lt;span style=&#34;color: #d73948&#34;&gt;else&lt;/span&gt; &lt;span style=&#34;color: #d73948&#34;&gt;False&lt;/span&gt;,
            cssclass&lt;span style=&#34;color: #d73948&#34;&gt;=&lt;/span&gt;&lt;span style=&#34;color: #198810&#34;&gt;&amp;#34;&lt;/span&gt;&lt;span style=&#34;color: #198810&#34;&gt;highlight&lt;/span&gt;&lt;span style=&#34;color: #198810&#34;&gt;&amp;#34;&lt;/span&gt;,
        )
        &lt;span style=&#34;color: #d73948&#34;&gt;return&lt;/span&gt; &lt;span style=&#34;color: #4b69c6&#34;&gt;highlight&lt;/span&gt;(code, lexer, formatter)
    &lt;span style=&#34;color: #d73948&#34;&gt;except&lt;/span&gt; ClassNotFound:
        &lt;span style=&#34;color: #74747c&#34;&gt;#&lt;/span&gt;&lt;span style=&#34;color: #74747c&#34;&gt; If language isn&amp;#39;t found, return code wrapped in pre tags&lt;/span&gt;
        &lt;span style=&#34;color: #d73948&#34;&gt;return&lt;/span&gt; &lt;span style=&#34;color: #d73948&#34;&gt;f&lt;/span&gt;&lt;span style=&#34;color: #198810&#34;&gt;&amp;#34;&lt;/span&gt;&lt;span style=&#34;color: #198810&#34;&gt;\&amp;lt;&lt;/span&gt;&lt;span style=&#34;color: #198810&#34;&gt;pre&amp;gt;&lt;/span&gt;&lt;span style=&#34;color: #198810&#34;&gt;\&amp;lt;&lt;/span&gt;&lt;span style=&#34;color: #198810&#34;&gt;code&amp;gt;&lt;/span&gt;&lt;span style=&#34;color: #8b41b1&#34;&gt;{&lt;/span&gt;&lt;span style=&#34;color: #8b41b1&#34;&gt;code&lt;/span&gt;&lt;span style=&#34;color: #8b41b1&#34;&gt;}&lt;/span&gt;&lt;span style=&#34;color: #198810&#34;&gt;\&amp;lt;&lt;/span&gt;&lt;span style=&#34;color: #198810&#34;&gt;/code&amp;gt;&lt;/span&gt;&lt;span style=&#34;color: #198810&#34;&gt;\&amp;lt;&lt;/span&gt;&lt;span style=&#34;color: #198810&#34;&gt;/pre&amp;gt;&lt;/span&gt;&lt;span style=&#34;color: #198810&#34;&gt;&amp;#34;&lt;/span&gt;


&lt;span style=&#34;color: #d73948&#34;&gt;def&lt;/span&gt; &lt;span style=&#34;color: #4b69c6&#34;&gt;run_jotdown&lt;/span&gt;(plaintext: &lt;span style=&#34;color: #4b69c6&#34;&gt;str&lt;/span&gt;) -&amp;gt; &lt;span style=&#34;color: #4b69c6&#34;&gt;str&lt;/span&gt;:
    &lt;span style=&#34;color: #74747c&#34;&gt;&amp;#34;&amp;#34;&amp;#34;&lt;/span&gt;
&lt;span style=&#34;color: #74747c&#34;&gt;    Modified to handle code blocks with syntax highlighting.&lt;/span&gt;
&lt;span style=&#34;color: #74747c&#34;&gt;    Fixed to properly handle both raw HTML and HTML code blocks.&lt;/span&gt;
&lt;span style=&#34;color: #74747c&#34;&gt;    &lt;/span&gt;&lt;span style=&#34;color: #74747c&#34;&gt;&amp;#34;&amp;#34;&amp;#34;&lt;/span&gt;
    CODE_BLOCK_RE &lt;span style=&#34;color: #d73948&#34;&gt;=&lt;/span&gt; re.&lt;span style=&#34;color: #4b69c6&#34;&gt;compile&lt;/span&gt;(&lt;span style=&#34;color: #d73948&#34;&gt;r&lt;/span&gt;&lt;span style=&#34;color: #198810&#34;&gt;&amp;#34;&lt;/span&gt;&lt;span style=&#34;color: #1d6c76&#34;&gt;\`&lt;/span&gt;&lt;span style=&#34;color: #1d6c76&#34;&gt;\`&lt;/span&gt;&lt;span style=&#34;color: #1d6c76&#34;&gt;\`&lt;/span&gt;&lt;span style=&#34;color: #1d6c76&#34;&gt;\`&lt;/span&gt;&lt;span style=&#34;color: #d73948&#34;&gt;*&lt;/span&gt;&lt;span style=&#34;color: #198810&#34;&gt;(&lt;/span&gt;&lt;span style=&#34;color: #198810&#34;&gt;=html&lt;/span&gt;&lt;span style=&#34;color: #d73948&#34;&gt;|&lt;/span&gt;&lt;span style=&#34;color: #b60157&#34;&gt;\s&lt;/span&gt;&lt;span style=&#34;color: #d73948&#34;&gt;*&lt;/span&gt;&lt;span style=&#34;color: #198810&#34;&gt;(&lt;/span&gt;&lt;span style=&#34;color: #198810&#34;&gt;?:&lt;/span&gt;&lt;span style=&#34;color: #198810&#34;&gt;(&lt;/span&gt;&lt;span style=&#34;color: #b60157&#34;&gt;\w&lt;/span&gt;&lt;span style=&#34;color: #d73948&#34;&gt;+&lt;/span&gt;&lt;span style=&#34;color: #198810&#34;&gt;)&lt;/span&gt;&lt;span style=&#34;color: #1d6c76&#34;&gt;\n&lt;/span&gt;&lt;span style=&#34;color: #198810&#34;&gt;)&lt;/span&gt;&lt;span style=&#34;color: #198810&#34;&gt;)&lt;/span&gt;&lt;span style=&#34;color: #d73948&#34;&gt;?&lt;/span&gt;&lt;span style=&#34;color: #198810&#34;&gt;(&lt;/span&gt;&lt;span style=&#34;color: #b60157&#34;&gt;.&lt;/span&gt;&lt;span style=&#34;color: #d73948&#34;&gt;*?&lt;/span&gt;&lt;span style=&#34;color: #198810&#34;&gt;)&lt;/span&gt;&lt;span style=&#34;color: #1d6c76&#34;&gt;\`&lt;/span&gt;&lt;span style=&#34;color: #1d6c76&#34;&gt;\`&lt;/span&gt;&lt;span style=&#34;color: #1d6c76&#34;&gt;\`&lt;/span&gt;&lt;span style=&#34;color: #1d6c76&#34;&gt;\`&lt;/span&gt;&lt;span style=&#34;color: #d73948&#34;&gt;*&lt;/span&gt;&lt;span style=&#34;color: #198810&#34;&gt;&amp;#34;&lt;/span&gt;, re.DOTALL)
    code_blocks &lt;span style=&#34;color: #d73948&#34;&gt;=&lt;/span&gt; []
    marker_template &lt;span style=&#34;color: #d73948&#34;&gt;=&lt;/span&gt; &lt;span style=&#34;color: #198810&#34;&gt;&amp;#34;&lt;/span&gt;&lt;span style=&#34;color: #198810&#34;&gt;§CODE_BLOCK_&lt;/span&gt;&lt;span style=&#34;color: #b60157&#34;&gt;{&lt;/span&gt;&lt;span style=&#34;color: #b60157&#34;&gt;}&lt;/span&gt;&lt;span style=&#34;color: #198810&#34;&gt;§&lt;/span&gt;&lt;span style=&#34;color: #198810&#34;&gt;&amp;#34;&lt;/span&gt;

    &lt;span style=&#34;color: #d73948&#34;&gt;def&lt;/span&gt; &lt;span style=&#34;color: #4b69c6&#34;&gt;save_code_block&lt;/span&gt;(match):
        raw_html_marker &lt;span style=&#34;color: #d73948&#34;&gt;=&lt;/span&gt; match.&lt;span style=&#34;color: #4b69c6&#34;&gt;group&lt;/span&gt;(&lt;span style=&#34;color: #b60157&#34;&gt;1&lt;/span&gt;)
        language &lt;span style=&#34;color: #d73948&#34;&gt;=&lt;/span&gt; match.&lt;span style=&#34;color: #4b69c6&#34;&gt;group&lt;/span&gt;(&lt;span style=&#34;color: #b60157&#34;&gt;2&lt;/span&gt;)
        code &lt;span style=&#34;color: #d73948&#34;&gt;=&lt;/span&gt; match.&lt;span style=&#34;color: #4b69c6&#34;&gt;group&lt;/span&gt;(&lt;span style=&#34;color: #b60157&#34;&gt;3&lt;/span&gt;).&lt;span style=&#34;color: #4b69c6&#34;&gt;strip&lt;/span&gt;()

        &lt;span style=&#34;color: #74747c&#34;&gt;#&lt;/span&gt;&lt;span style=&#34;color: #74747c&#34;&gt; Check if this is a raw HTML block&lt;/span&gt;
        &lt;span style=&#34;color: #d73948&#34;&gt;if&lt;/span&gt; raw_html_marker &lt;span style=&#34;color: #d73948&#34;&gt;==&lt;/span&gt; &lt;span style=&#34;color: #198810&#34;&gt;&amp;#34;&lt;/span&gt;&lt;span style=&#34;color: #198810&#34;&gt;=html&lt;/span&gt;&lt;span style=&#34;color: #198810&#34;&gt;&amp;#34;&lt;/span&gt;:
            &lt;span style=&#34;color: #d73948&#34;&gt;return&lt;/span&gt; &lt;span style=&#34;color: #d73948&#34;&gt;f&lt;/span&gt;&lt;span style=&#34;color: #198810&#34;&gt;&amp;#34;&lt;/span&gt;&lt;span style=&#34;color: #198810&#34;&gt;\`&lt;/span&gt;&lt;span style=&#34;color: #198810&#34;&gt;\`&lt;/span&gt;&lt;span style=&#34;color: #198810&#34;&gt;\`&lt;/span&gt;&lt;span style=&#34;color: #198810&#34;&gt;=html&lt;/span&gt;&lt;span style=&#34;color: #1d6c76&#34;&gt;\n&lt;/span&gt;&lt;span style=&#34;color: #8b41b1&#34;&gt;{&lt;/span&gt;&lt;span style=&#34;color: #8b41b1&#34;&gt;code&lt;/span&gt;&lt;span style=&#34;color: #8b41b1&#34;&gt;}&lt;/span&gt;&lt;span style=&#34;color: #1d6c76&#34;&gt;\n&lt;/span&gt;&lt;span style=&#34;color: #198810&#34;&gt;\`&lt;/span&gt;&lt;span style=&#34;color: #198810&#34;&gt;\`&lt;/span&gt;&lt;span style=&#34;color: #198810&#34;&gt;\`&lt;/span&gt;&lt;span style=&#34;color: #198810&#34;&gt;&amp;#34;&lt;/span&gt;

        &lt;span style=&#34;color: #74747c&#34;&gt;#&lt;/span&gt;&lt;span style=&#34;color: #74747c&#34;&gt; For all other cases, including &amp;#39;html&amp;#39; language, highlight the code&lt;/span&gt;
        highlighted &lt;span style=&#34;color: #d73948&#34;&gt;=&lt;/span&gt; &lt;span style=&#34;color: #4b69c6&#34;&gt;highlight_code&lt;/span&gt;(code, language)
        marker &lt;span style=&#34;color: #d73948&#34;&gt;=&lt;/span&gt; marker_template.&lt;span style=&#34;color: #4b69c6&#34;&gt;format&lt;/span&gt;(&lt;span style=&#34;color: #4b69c6&#34;&gt;len&lt;/span&gt;(code_blocks))
        code_blocks.&lt;span style=&#34;color: #4b69c6&#34;&gt;append&lt;/span&gt;(highlighted)
        &lt;span style=&#34;color: #d73948&#34;&gt;return&lt;/span&gt; &lt;span style=&#34;color: #d73948&#34;&gt;f&lt;/span&gt;&lt;span style=&#34;color: #198810&#34;&gt;&amp;#34;&lt;/span&gt;&lt;span style=&#34;color: #198810&#34;&gt;\`&lt;/span&gt;&lt;span style=&#34;color: #198810&#34;&gt;\`&lt;/span&gt;&lt;span style=&#34;color: #198810&#34;&gt;\`&lt;/span&gt;&lt;span style=&#34;color: #198810&#34;&gt;=html&lt;/span&gt;&lt;span style=&#34;color: #1d6c76&#34;&gt;\n&lt;/span&gt;&lt;span style=&#34;color: #8b41b1&#34;&gt;{&lt;/span&gt;&lt;span style=&#34;color: #8b41b1&#34;&gt;marker&lt;/span&gt;&lt;span style=&#34;color: #8b41b1&#34;&gt;}&lt;/span&gt;&lt;span style=&#34;color: #1d6c76&#34;&gt;\n&lt;/span&gt;&lt;span style=&#34;color: #198810&#34;&gt;\`&lt;/span&gt;&lt;span style=&#34;color: #198810&#34;&gt;\`&lt;/span&gt;&lt;span style=&#34;color: #198810&#34;&gt;\`&lt;/span&gt;&lt;span style=&#34;color: #198810&#34;&gt;&amp;#34;&lt;/span&gt;

    &lt;span style=&#34;color: #74747c&#34;&gt;#&lt;/span&gt;&lt;span style=&#34;color: #74747c&#34;&gt; First, replace all code blocks with markers&lt;/span&gt;
    processed_text &lt;span style=&#34;color: #d73948&#34;&gt;=&lt;/span&gt; CODE_BLOCK_RE.&lt;span style=&#34;color: #4b69c6&#34;&gt;sub&lt;/span&gt;(save_code_block, plaintext)

    &lt;span style=&#34;color: #74747c&#34;&gt;#&lt;/span&gt;&lt;span style=&#34;color: #74747c&#34;&gt; Run through jotdown&lt;/span&gt;
    html &lt;span style=&#34;color: #d73948&#34;&gt;=&lt;/span&gt; &lt;span style=&#34;color: #4b69c6&#34;&gt;run&lt;/span&gt;(&lt;span style=&#34;color: #198810&#34;&gt;&amp;#34;&lt;/span&gt;&lt;span style=&#34;color: #198810&#34;&gt;jotdown&lt;/span&gt;&lt;span style=&#34;color: #198810&#34;&gt;&amp;#34;&lt;/span&gt;, input&lt;span style=&#34;color: #d73948&#34;&gt;=&lt;/span&gt;processed_text, text&lt;span style=&#34;color: #d73948&#34;&gt;=&lt;/span&gt;&lt;span style=&#34;color: #d73948&#34;&gt;True&lt;/span&gt;, capture_output&lt;span style=&#34;color: #d73948&#34;&gt;=&lt;/span&gt;&lt;span style=&#34;color: #d73948&#34;&gt;True&lt;/span&gt;).stdout

    &lt;span style=&#34;color: #74747c&#34;&gt;#&lt;/span&gt;&lt;span style=&#34;color: #74747c&#34;&gt; Replace markers with actual highlighted code&lt;/span&gt;
    &lt;span style=&#34;color: #d73948&#34;&gt;for&lt;/span&gt; i, code &lt;span style=&#34;color: #d73948&#34;&gt;in&lt;/span&gt; &lt;span style=&#34;color: #4b69c6&#34;&gt;enumerate&lt;/span&gt;(code_blocks):
        marker &lt;span style=&#34;color: #d73948&#34;&gt;=&lt;/span&gt; marker_template.&lt;span style=&#34;color: #4b69c6&#34;&gt;format&lt;/span&gt;(i)
        html &lt;span style=&#34;color: #d73948&#34;&gt;=&lt;/span&gt; html.&lt;span style=&#34;color: #4b69c6&#34;&gt;replace&lt;/span&gt;(marker, code)

    &lt;span style=&#34;color: #d73948&#34;&gt;return&lt;/span&gt; html&lt;/code&gt;&lt;/pre&gt;&lt;/div&gt;&lt;p&gt;Note that in the above snippet, the backticks (`) have been escaped to prevent the markup on this page from breaking, remove the backslashes if you use this code yourself.&lt;/p&gt;&lt;details&gt;&lt;summary&gt;Click here to see the CSS I settled on&lt;/summary&gt;&lt;div class=&#34;code-block&#34; data-lang=&#34;css&#34;&gt;&lt;div class=&#34;code-header&#34; data-mosaic-chrome=&#34;&#34;&gt;&lt;span class=&#34;code-lang&#34;&gt;css&lt;/span&gt;&lt;button class=&#34;code-copy&#34; aria-label=&#34;Copy code&#34; type=&#34;button&#34;&gt;Copy&lt;/button&gt;&lt;/div&gt;&lt;pre&gt;&lt;code data-lang=&#34;css&#34;&gt;&lt;span style=&#34;color: #8b41b1&#34;&gt;:&lt;/span&gt;&lt;span style=&#34;color: #8b41b1&#34;&gt;root&lt;/span&gt; {
  &lt;span style=&#34;color: #4b69c6&#34;&gt;--&lt;/span&gt;&lt;span style=&#34;color: #4b69c6&#34;&gt;highlight-font-size&lt;/span&gt;: &lt;span style=&#34;color: #b60157&#34;&gt;0&lt;/span&gt;&lt;span style=&#34;color: #b60157&#34;&gt;.&lt;/span&gt;&lt;span style=&#34;color: #b60157&#34;&gt;9&lt;/span&gt;&lt;span style=&#34;color: #d73948&#34;&gt;em&lt;/span&gt;;
  &lt;span style=&#34;color: #4b69c6&#34;&gt;--&lt;/span&gt;&lt;span style=&#34;color: #4b69c6&#34;&gt;highlight-border-radius&lt;/span&gt;: &lt;span style=&#34;color: #b60157&#34;&gt;6&lt;/span&gt;&lt;span style=&#34;color: #d73948&#34;&gt;px&lt;/span&gt;;
  &lt;span style=&#34;color: #4b69c6&#34;&gt;--&lt;/span&gt;&lt;span style=&#34;color: #4b69c6&#34;&gt;highlight-padding&lt;/span&gt;: &lt;span style=&#34;color: #b60157&#34;&gt;1&lt;/span&gt;&lt;span style=&#34;color: #d73948&#34;&gt;rem&lt;/span&gt;;
  &lt;span style=&#34;color: #4b69c6&#34;&gt;--&lt;/span&gt;&lt;span style=&#34;color: #4b69c6&#34;&gt;highlight-line-number-color&lt;/span&gt;: &lt;span style=&#34;color: #b60157&#34;&gt;#&lt;/span&gt;&lt;span style=&#34;color: #b60157&#34;&gt;6e7681&lt;/span&gt;;
}

&lt;span style=&#34;color: #8b41b1&#34;&gt;.&lt;/span&gt;&lt;span style=&#34;color: #8b41b1&#34;&gt;highlight&lt;/span&gt; {
  &lt;span style=&#34;color: #4b69c6&#34;&gt;font-size&lt;/span&gt;: &lt;span style=&#34;color: #4b69c6&#34;&gt;var&lt;/span&gt;(&lt;span style=&#34;color: #4b69c6&#34;&gt;--&lt;/span&gt;&lt;span style=&#34;color: #4b69c6&#34;&gt;highlight-font-size&lt;/span&gt;, 0.9em);
  &lt;span style=&#34;color: #4b69c6&#34;&gt;border-radius&lt;/span&gt;: &lt;span style=&#34;color: #4b69c6&#34;&gt;var&lt;/span&gt;(&lt;span style=&#34;color: #4b69c6&#34;&gt;--&lt;/span&gt;&lt;span style=&#34;color: #4b69c6&#34;&gt;highlight-border-radius&lt;/span&gt;, 6px);
  &lt;span style=&#34;color: #4b69c6&#34;&gt;padding&lt;/span&gt;: &lt;span style=&#34;color: #4b69c6&#34;&gt;var&lt;/span&gt;(&lt;span style=&#34;color: #4b69c6&#34;&gt;--&lt;/span&gt;&lt;span style=&#34;color: #4b69c6&#34;&gt;highlight-padding&lt;/span&gt;, 1rem);
}

&lt;span style=&#34;color: #8b41b1&#34;&gt;.&lt;/span&gt;&lt;span style=&#34;color: #8b41b1&#34;&gt;highlight&lt;/span&gt; &lt;span style=&#34;color: #4b69c6&#34;&gt;pre&lt;/span&gt; {
  &lt;span style=&#34;color: #4b69c6&#34;&gt;margin&lt;/span&gt;: &lt;span style=&#34;color: #b60157&#34;&gt;0&lt;/span&gt;;
  &lt;span style=&#34;color: #4b69c6&#34;&gt;overflow-x&lt;/span&gt;: &lt;span style=&#34;color: #4b69c6&#34;&gt;auto&lt;/span&gt;;
}

&lt;span style=&#34;color: #8b41b1&#34;&gt;.&lt;/span&gt;&lt;span style=&#34;color: #8b41b1&#34;&gt;highlight&lt;/span&gt; &lt;span style=&#34;color: #4b69c6&#34;&gt;table&lt;/span&gt; {
  &lt;span style=&#34;color: #4b69c6&#34;&gt;border-spacing&lt;/span&gt;: &lt;span style=&#34;color: #b60157&#34;&gt;0&lt;/span&gt;;
  &lt;span style=&#34;color: #4b69c6&#34;&gt;border&lt;/span&gt;: &lt;span style=&#34;color: #4b69c6&#34;&gt;none&lt;/span&gt;;
  &lt;span style=&#34;color: #4b69c6&#34;&gt;margin&lt;/span&gt;: &lt;span style=&#34;color: #b60157&#34;&gt;0&lt;/span&gt;;
}

&lt;span style=&#34;color: #8b41b1&#34;&gt;.&lt;/span&gt;&lt;span style=&#34;color: #8b41b1&#34;&gt;highlight&lt;/span&gt; &lt;span style=&#34;color: #4b69c6&#34;&gt;table&lt;/span&gt; &lt;span style=&#34;color: #4b69c6&#34;&gt;td&lt;/span&gt; {
  &lt;span style=&#34;color: #4b69c6&#34;&gt;padding&lt;/span&gt;: &lt;span style=&#34;color: #b60157&#34;&gt;0&lt;/span&gt;;
  &lt;span style=&#34;color: #4b69c6&#34;&gt;border&lt;/span&gt;: &lt;span style=&#34;color: #4b69c6&#34;&gt;none&lt;/span&gt;;
}

&lt;span style=&#34;color: #8b41b1&#34;&gt;.&lt;/span&gt;&lt;span style=&#34;color: #8b41b1&#34;&gt;highlight&lt;/span&gt; &lt;span style=&#34;color: #8b41b1&#34;&gt;.&lt;/span&gt;&lt;span style=&#34;color: #8b41b1&#34;&gt;linenos&lt;/span&gt; {
  &lt;span style=&#34;color: #4b69c6&#34;&gt;user-select&lt;/span&gt;: &lt;span style=&#34;color: #4b69c6&#34;&gt;none&lt;/span&gt;;
  &lt;span style=&#34;color: #4b69c6&#34;&gt;padding-right&lt;/span&gt;: &lt;span style=&#34;color: #b60157&#34;&gt;1&lt;/span&gt;&lt;span style=&#34;color: #d73948&#34;&gt;rem&lt;/span&gt;;
  &lt;span style=&#34;color: #4b69c6&#34;&gt;color&lt;/span&gt;: &lt;span style=&#34;color: #4b69c6&#34;&gt;var&lt;/span&gt;(&lt;span style=&#34;color: #4b69c6&#34;&gt;--&lt;/span&gt;&lt;span style=&#34;color: #4b69c6&#34;&gt;highlight-line-number-color&lt;/span&gt;);
  &lt;span style=&#34;color: #4b69c6&#34;&gt;text-align&lt;/span&gt;: &lt;span style=&#34;color: #4b69c6&#34;&gt;right&lt;/span&gt;;
  &lt;span style=&#34;color: #4b69c6&#34;&gt;width&lt;/span&gt;: &lt;span style=&#34;color: #b60157&#34;&gt;1&lt;/span&gt;&lt;span style=&#34;color: #d73948&#34;&gt;%&lt;/span&gt;;
  &lt;span style=&#34;color: #4b69c6&#34;&gt;white-space&lt;/span&gt;: &lt;span style=&#34;color: #4b69c6&#34;&gt;nowrap&lt;/span&gt;;
}

\&lt;span style=&#34;color: #d73948&#34;&gt;@&lt;/span&gt;&lt;span style=&#34;color: #d73948&#34;&gt;media&lt;/span&gt; (prefers-&lt;span style=&#34;color: #4b69c6&#34;&gt;color&lt;/span&gt;-scheme: dark) {
  &lt;span style=&#34;color: #8b41b1&#34;&gt;.&lt;/span&gt;&lt;span style=&#34;color: #8b41b1&#34;&gt;highlight&lt;/span&gt; {
    &lt;span style=&#34;color: #4b69c6&#34;&gt;background&lt;/span&gt;: &lt;span style=&#34;color: #4b69c6&#34;&gt;var&lt;/span&gt;(&lt;span style=&#34;color: #4b69c6&#34;&gt;--&lt;/span&gt;&lt;span style=&#34;color: #4b69c6&#34;&gt;code-background&lt;/span&gt;, #262220) &lt;span style=&#34;color: #d73948&#34;&gt;!important&lt;/span&gt;;
  }
  &lt;span style=&#34;color: #4b69c6&#34;&gt;pre&lt;/span&gt; {
    &lt;span style=&#34;color: #4b69c6&#34;&gt;line-height&lt;/span&gt;: &lt;span style=&#34;color: #b60157&#34;&gt;125&lt;/span&gt;&lt;span style=&#34;color: #d73948&#34;&gt;%&lt;/span&gt;;
  }
  &lt;span style=&#34;color: #4b69c6&#34;&gt;td&lt;/span&gt;&lt;span style=&#34;color: #8b41b1&#34;&gt;.&lt;/span&gt;&lt;span style=&#34;color: #8b41b1&#34;&gt;linenos&lt;/span&gt; &lt;span style=&#34;color: #8b41b1&#34;&gt;.&lt;/span&gt;&lt;span style=&#34;color: #8b41b1&#34;&gt;normal&lt;/span&gt; {
    &lt;span style=&#34;color: #4b69c6&#34;&gt;color&lt;/span&gt;: &lt;span style=&#34;color: #b60157&#34;&gt;#&lt;/span&gt;&lt;span style=&#34;color: #b60157&#34;&gt;4e4e4e&lt;/span&gt;;
    &lt;span style=&#34;color: #4b69c6&#34;&gt;background-color&lt;/span&gt;: &lt;span style=&#34;color: #4b69c6&#34;&gt;transparent&lt;/span&gt;;
    &lt;span style=&#34;color: #4b69c6&#34;&gt;padding-left&lt;/span&gt;: &lt;span style=&#34;color: #b60157&#34;&gt;5&lt;/span&gt;&lt;span style=&#34;color: #d73948&#34;&gt;px&lt;/span&gt;;
    &lt;span style=&#34;color: #4b69c6&#34;&gt;padding-right&lt;/span&gt;: &lt;span style=&#34;color: #b60157&#34;&gt;5&lt;/span&gt;&lt;span style=&#34;color: #d73948&#34;&gt;px&lt;/span&gt;;
  }
  &lt;span style=&#34;color: #4b69c6&#34;&gt;span&lt;/span&gt;&lt;span style=&#34;color: #8b41b1&#34;&gt;.&lt;/span&gt;&lt;span style=&#34;color: #8b41b1&#34;&gt;linenos&lt;/span&gt; {
    &lt;span style=&#34;color: #4b69c6&#34;&gt;color&lt;/span&gt;: &lt;span style=&#34;color: #b60157&#34;&gt;#&lt;/span&gt;&lt;span style=&#34;color: #b60157&#34;&gt;4e4e4e&lt;/span&gt;;
    &lt;span style=&#34;color: #4b69c6&#34;&gt;background-color&lt;/span&gt;: &lt;span style=&#34;color: #4b69c6&#34;&gt;transparent&lt;/span&gt;;
    &lt;span style=&#34;color: #4b69c6&#34;&gt;padding-left&lt;/span&gt;: &lt;span style=&#34;color: #b60157&#34;&gt;5&lt;/span&gt;&lt;span style=&#34;color: #d73948&#34;&gt;px&lt;/span&gt;;
    &lt;span style=&#34;color: #4b69c6&#34;&gt;padding-right&lt;/span&gt;: &lt;span style=&#34;color: #b60157&#34;&gt;5&lt;/span&gt;&lt;span style=&#34;color: #d73948&#34;&gt;px&lt;/span&gt;;
  }
  &lt;span style=&#34;color: #4b69c6&#34;&gt;td&lt;/span&gt;&lt;span style=&#34;color: #8b41b1&#34;&gt;.&lt;/span&gt;&lt;span style=&#34;color: #8b41b1&#34;&gt;linenos&lt;/span&gt; &lt;span style=&#34;color: #8b41b1&#34;&gt;.&lt;/span&gt;&lt;span style=&#34;color: #8b41b1&#34;&gt;special&lt;/span&gt; {
    &lt;span style=&#34;color: #4b69c6&#34;&gt;color&lt;/span&gt;: &lt;span style=&#34;color: #b60157&#34;&gt;#&lt;/span&gt;&lt;span style=&#34;color: #b60157&#34;&gt;8f9494&lt;/span&gt;;
    &lt;span style=&#34;color: #4b69c6&#34;&gt;background-color&lt;/span&gt;: &lt;span style=&#34;color: #b60157&#34;&gt;#&lt;/span&gt;&lt;span style=&#34;color: #b60157&#34;&gt;ffffc0&lt;/span&gt;;
    &lt;span style=&#34;color: #4b69c6&#34;&gt;padding-left&lt;/span&gt;: &lt;span style=&#34;color: #b60157&#34;&gt;5&lt;/span&gt;&lt;span style=&#34;color: #d73948&#34;&gt;px&lt;/span&gt;;
    &lt;span style=&#34;color: #4b69c6&#34;&gt;padding-right&lt;/span&gt;: &lt;span style=&#34;color: #b60157&#34;&gt;5&lt;/span&gt;&lt;span style=&#34;color: #d73948&#34;&gt;px&lt;/span&gt;;
  }
  &lt;span style=&#34;color: #4b69c6&#34;&gt;span&lt;/span&gt;&lt;span style=&#34;color: #8b41b1&#34;&gt;.&lt;/span&gt;&lt;span style=&#34;color: #8b41b1&#34;&gt;linenos&lt;/span&gt;&lt;span style=&#34;color: #8b41b1&#34;&gt;.&lt;/span&gt;&lt;span style=&#34;color: #8b41b1&#34;&gt;special&lt;/span&gt; {
    &lt;span style=&#34;color: #4b69c6&#34;&gt;color&lt;/span&gt;: &lt;span style=&#34;color: #b60157&#34;&gt;#&lt;/span&gt;&lt;span style=&#34;color: #b60157&#34;&gt;8f9494&lt;/span&gt;;
    &lt;span style=&#34;color: #4b69c6&#34;&gt;background-color&lt;/span&gt;: &lt;span style=&#34;color: #b60157&#34;&gt;#&lt;/span&gt;&lt;span style=&#34;color: #b60157&#34;&gt;ffffc0&lt;/span&gt;;
    &lt;span style=&#34;color: #4b69c6&#34;&gt;padding-left&lt;/span&gt;: &lt;span style=&#34;color: #b60157&#34;&gt;5&lt;/span&gt;&lt;span style=&#34;color: #d73948&#34;&gt;px&lt;/span&gt;;
    &lt;span style=&#34;color: #4b69c6&#34;&gt;padding-right&lt;/span&gt;: &lt;span style=&#34;color: #b60157&#34;&gt;5&lt;/span&gt;&lt;span style=&#34;color: #d73948&#34;&gt;px&lt;/span&gt;;
  }
  &lt;span style=&#34;color: #8b41b1&#34;&gt;.&lt;/span&gt;&lt;span style=&#34;color: #8b41b1&#34;&gt;highlight&lt;/span&gt; &lt;span style=&#34;color: #8b41b1&#34;&gt;.&lt;/span&gt;&lt;span style=&#34;color: #8b41b1&#34;&gt;hll&lt;/span&gt; {
    &lt;span style=&#34;color: #4b69c6&#34;&gt;background-color&lt;/span&gt;: &lt;span style=&#34;color: #b60157&#34;&gt;#&lt;/span&gt;&lt;span style=&#34;color: #b60157&#34;&gt;ddd0c0&lt;/span&gt;;
  }
  &lt;span style=&#34;color: #8b41b1&#34;&gt;.&lt;/span&gt;&lt;span style=&#34;color: #8b41b1&#34;&gt;highlight&lt;/span&gt; {
    &lt;span style=&#34;color: #4b69c6&#34;&gt;background&lt;/span&gt;: &lt;span style=&#34;color: #b60157&#34;&gt;#&lt;/span&gt;&lt;span style=&#34;color: #b60157&#34;&gt;262220&lt;/span&gt;;
    &lt;span style=&#34;color: #4b69c6&#34;&gt;color&lt;/span&gt;: &lt;span style=&#34;color: #b60157&#34;&gt;#&lt;/span&gt;&lt;span style=&#34;color: #b60157&#34;&gt;ddd0c0&lt;/span&gt;;
  }
  &lt;span style=&#34;color: #8b41b1&#34;&gt;.&lt;/span&gt;&lt;span style=&#34;color: #8b41b1&#34;&gt;highlight&lt;/span&gt; &lt;span style=&#34;color: #8b41b1&#34;&gt;.&lt;/span&gt;&lt;span style=&#34;color: #8b41b1&#34;&gt;c&lt;/span&gt; {
    &lt;span style=&#34;color: #4b69c6&#34;&gt;color&lt;/span&gt;: &lt;span style=&#34;color: #b60157&#34;&gt;#&lt;/span&gt;&lt;span style=&#34;color: #b60157&#34;&gt;70757a&lt;/span&gt;;
  } &lt;span style=&#34;color: #74747c&#34;&gt;/*&lt;/span&gt;&lt;span style=&#34;color: #74747c&#34;&gt; Comment &lt;/span&gt;&lt;span style=&#34;color: #74747c&#34;&gt;*/&lt;/span&gt;
  &lt;span style=&#34;color: #8b41b1&#34;&gt;.&lt;/span&gt;&lt;span style=&#34;color: #8b41b1&#34;&gt;highlight&lt;/span&gt; &lt;span style=&#34;color: #8b41b1&#34;&gt;.&lt;/span&gt;&lt;span style=&#34;color: #8b41b1&#34;&gt;err&lt;/span&gt; {
    &lt;span style=&#34;color: #4b69c6&#34;&gt;color&lt;/span&gt;: &lt;span style=&#34;color: #b60157&#34;&gt;#&lt;/span&gt;&lt;span style=&#34;color: #b60157&#34;&gt;af5f5f&lt;/span&gt;;
  } &lt;span style=&#34;color: #74747c&#34;&gt;/*&lt;/span&gt;&lt;span style=&#34;color: #74747c&#34;&gt; Error &lt;/span&gt;&lt;span style=&#34;color: #74747c&#34;&gt;*/&lt;/span&gt;
  &lt;span style=&#34;color: #8b41b1&#34;&gt;.&lt;/span&gt;&lt;span style=&#34;color: #8b41b1&#34;&gt;highlight&lt;/span&gt; &lt;span style=&#34;color: #8b41b1&#34;&gt;.&lt;/span&gt;&lt;span style=&#34;color: #8b41b1&#34;&gt;esc&lt;/span&gt; {
    &lt;span style=&#34;color: #4b69c6&#34;&gt;color&lt;/span&gt;: &lt;span style=&#34;color: #b60157&#34;&gt;#&lt;/span&gt;&lt;span style=&#34;color: #b60157&#34;&gt;ddd0c0&lt;/span&gt;;
  } &lt;span style=&#34;color: #74747c&#34;&gt;/*&lt;/span&gt;&lt;span style=&#34;color: #74747c&#34;&gt; Escape &lt;/span&gt;&lt;span style=&#34;color: #74747c&#34;&gt;*/&lt;/span&gt;
  &lt;span style=&#34;color: #8b41b1&#34;&gt;.&lt;/span&gt;&lt;span style=&#34;color: #8b41b1&#34;&gt;highlight&lt;/span&gt; &lt;span style=&#34;color: #8b41b1&#34;&gt;.&lt;/span&gt;&lt;span style=&#34;color: #8b41b1&#34;&gt;g&lt;/span&gt; {
    &lt;span style=&#34;color: #4b69c6&#34;&gt;color&lt;/span&gt;: &lt;span style=&#34;color: #b60157&#34;&gt;#&lt;/span&gt;&lt;span style=&#34;color: #b60157&#34;&gt;ddd0c0&lt;/span&gt;;
  } &lt;span style=&#34;color: #74747c&#34;&gt;/*&lt;/span&gt;&lt;span style=&#34;color: #74747c&#34;&gt; Generic &lt;/span&gt;&lt;span style=&#34;color: #74747c&#34;&gt;*/&lt;/span&gt;
  &lt;span style=&#34;color: #8b41b1&#34;&gt;.&lt;/span&gt;&lt;span style=&#34;color: #8b41b1&#34;&gt;highlight&lt;/span&gt; &lt;span style=&#34;color: #8b41b1&#34;&gt;.&lt;/span&gt;&lt;span style=&#34;color: #8b41b1&#34;&gt;k&lt;/span&gt; {
    &lt;span style=&#34;color: #4b69c6&#34;&gt;color&lt;/span&gt;: &lt;span style=&#34;color: #b60157&#34;&gt;#&lt;/span&gt;&lt;span style=&#34;color: #b60157&#34;&gt;919191&lt;/span&gt;;
  } &lt;span style=&#34;color: #74747c&#34;&gt;/*&lt;/span&gt;&lt;span style=&#34;color: #74747c&#34;&gt; Keyword &lt;/span&gt;&lt;span style=&#34;color: #74747c&#34;&gt;*/&lt;/span&gt;
  &lt;span style=&#34;color: #8b41b1&#34;&gt;.&lt;/span&gt;&lt;span style=&#34;color: #8b41b1&#34;&gt;highlight&lt;/span&gt; &lt;span style=&#34;color: #8b41b1&#34;&gt;.&lt;/span&gt;&lt;span style=&#34;color: #8b41b1&#34;&gt;l&lt;/span&gt; {
    &lt;span style=&#34;color: #4b69c6&#34;&gt;color&lt;/span&gt;: &lt;span style=&#34;color: #b60157&#34;&gt;#&lt;/span&gt;&lt;span style=&#34;color: #b60157&#34;&gt;af875f&lt;/span&gt;;
  } &lt;span style=&#34;color: #74747c&#34;&gt;/*&lt;/span&gt;&lt;span style=&#34;color: #74747c&#34;&gt; Literal &lt;/span&gt;&lt;span style=&#34;color: #74747c&#34;&gt;*/&lt;/span&gt;
  &lt;span style=&#34;color: #8b41b1&#34;&gt;.&lt;/span&gt;&lt;span style=&#34;color: #8b41b1&#34;&gt;highlight&lt;/span&gt; &lt;span style=&#34;color: #8b41b1&#34;&gt;.&lt;/span&gt;&lt;span style=&#34;color: #8b41b1&#34;&gt;n&lt;/span&gt; {
    &lt;span style=&#34;color: #4b69c6&#34;&gt;color&lt;/span&gt;: &lt;span style=&#34;color: #b60157&#34;&gt;#&lt;/span&gt;&lt;span style=&#34;color: #b60157&#34;&gt;ddd0c0&lt;/span&gt;;
  } &lt;span style=&#34;color: #74747c&#34;&gt;/*&lt;/span&gt;&lt;span style=&#34;color: #74747c&#34;&gt; Name &lt;/span&gt;&lt;span style=&#34;color: #74747c&#34;&gt;*/&lt;/span&gt;
  &lt;span style=&#34;color: #8b41b1&#34;&gt;.&lt;/span&gt;&lt;span style=&#34;color: #8b41b1&#34;&gt;highlight&lt;/span&gt; &lt;span style=&#34;color: #8b41b1&#34;&gt;.&lt;/span&gt;&lt;span style=&#34;color: #8b41b1&#34;&gt;o&lt;/span&gt; {
    &lt;span style=&#34;color: #4b69c6&#34;&gt;color&lt;/span&gt;: &lt;span style=&#34;color: #b60157&#34;&gt;#&lt;/span&gt;&lt;span style=&#34;color: #b60157&#34;&gt;878787&lt;/span&gt;;
  } &lt;span style=&#34;color: #74747c&#34;&gt;/*&lt;/span&gt;&lt;span style=&#34;color: #74747c&#34;&gt; Operator &lt;/span&gt;&lt;span style=&#34;color: #74747c&#34;&gt;*/&lt;/span&gt;
  &lt;span style=&#34;color: #8b41b1&#34;&gt;.&lt;/span&gt;&lt;span style=&#34;color: #8b41b1&#34;&gt;highlight&lt;/span&gt; &lt;span style=&#34;color: #8b41b1&#34;&gt;.&lt;/span&gt;&lt;span style=&#34;color: #8b41b1&#34;&gt;x&lt;/span&gt; {
    &lt;span style=&#34;color: #4b69c6&#34;&gt;color&lt;/span&gt;: &lt;span style=&#34;color: #b60157&#34;&gt;#&lt;/span&gt;&lt;span style=&#34;color: #b60157&#34;&gt;ddd0c0&lt;/span&gt;;
  } &lt;span style=&#34;color: #74747c&#34;&gt;/*&lt;/span&gt;&lt;span style=&#34;color: #74747c&#34;&gt; Other &lt;/span&gt;&lt;span style=&#34;color: #74747c&#34;&gt;*/&lt;/span&gt;
  &lt;span style=&#34;color: #8b41b1&#34;&gt;.&lt;/span&gt;&lt;span style=&#34;color: #8b41b1&#34;&gt;highlight&lt;/span&gt; &lt;span style=&#34;color: #8b41b1&#34;&gt;.&lt;/span&gt;&lt;span style=&#34;color: #8b41b1&#34;&gt;p&lt;/span&gt; {
    &lt;span style=&#34;color: #4b69c6&#34;&gt;color&lt;/span&gt;: &lt;span style=&#34;color: #b60157&#34;&gt;#&lt;/span&gt;&lt;span style=&#34;color: #b60157&#34;&gt;ddd0c0&lt;/span&gt;;
  } &lt;span style=&#34;color: #74747c&#34;&gt;/*&lt;/span&gt;&lt;span style=&#34;color: #74747c&#34;&gt; Punctuation &lt;/span&gt;&lt;span style=&#34;color: #74747c&#34;&gt;*/&lt;/span&gt;
  &lt;span style=&#34;color: #8b41b1&#34;&gt;.&lt;/span&gt;&lt;span style=&#34;color: #8b41b1&#34;&gt;highlight&lt;/span&gt; &lt;span style=&#34;color: #8b41b1&#34;&gt;.&lt;/span&gt;&lt;span style=&#34;color: #8b41b1&#34;&gt;ch&lt;/span&gt; {
    &lt;span style=&#34;color: #4b69c6&#34;&gt;color&lt;/span&gt;: &lt;span style=&#34;color: #b60157&#34;&gt;#&lt;/span&gt;&lt;span style=&#34;color: #b60157&#34;&gt;8f9f9f&lt;/span&gt;;
  } &lt;span style=&#34;color: #74747c&#34;&gt;/*&lt;/span&gt;&lt;span style=&#34;color: #74747c&#34;&gt; Comment.Hashbang &lt;/span&gt;&lt;span style=&#34;color: #74747c&#34;&gt;*/&lt;/span&gt;
  &lt;span style=&#34;color: #8b41b1&#34;&gt;.&lt;/span&gt;&lt;span style=&#34;color: #8b41b1&#34;&gt;highlight&lt;/span&gt; &lt;span style=&#34;color: #8b41b1&#34;&gt;.&lt;/span&gt;&lt;span style=&#34;color: #8b41b1&#34;&gt;cm&lt;/span&gt; {
    &lt;span style=&#34;color: #4b69c6&#34;&gt;color&lt;/span&gt;: &lt;span style=&#34;color: #b60157&#34;&gt;#&lt;/span&gt;&lt;span style=&#34;color: #b60157&#34;&gt;70757a&lt;/span&gt;;
  } &lt;span style=&#34;color: #74747c&#34;&gt;/*&lt;/span&gt;&lt;span style=&#34;color: #74747c&#34;&gt; Comment.Multiline &lt;/span&gt;&lt;span style=&#34;color: #74747c&#34;&gt;*/&lt;/span&gt;
  &lt;span style=&#34;color: #8b41b1&#34;&gt;.&lt;/span&gt;&lt;span style=&#34;color: #8b41b1&#34;&gt;highlight&lt;/span&gt; &lt;span style=&#34;color: #8b41b1&#34;&gt;.&lt;/span&gt;&lt;span style=&#34;color: #8b41b1&#34;&gt;cp&lt;/span&gt; {
    &lt;span style=&#34;color: #4b69c6&#34;&gt;color&lt;/span&gt;: &lt;span style=&#34;color: #b60157&#34;&gt;#&lt;/span&gt;&lt;span style=&#34;color: #b60157&#34;&gt;fdd0c0&lt;/span&gt;;
  } &lt;span style=&#34;color: #74747c&#34;&gt;/*&lt;/span&gt;&lt;span style=&#34;color: #74747c&#34;&gt; Comment.Preproc &lt;/span&gt;&lt;span style=&#34;color: #74747c&#34;&gt;*/&lt;/span&gt;
  &lt;span style=&#34;color: #8b41b1&#34;&gt;.&lt;/span&gt;&lt;span style=&#34;color: #8b41b1&#34;&gt;highlight&lt;/span&gt; &lt;span style=&#34;color: #8b41b1&#34;&gt;.&lt;/span&gt;&lt;span style=&#34;color: #8b41b1&#34;&gt;cpf&lt;/span&gt; {
    &lt;span style=&#34;color: #4b69c6&#34;&gt;color&lt;/span&gt;: &lt;span style=&#34;color: #b60157&#34;&gt;#&lt;/span&gt;&lt;span style=&#34;color: #b60157&#34;&gt;c9b98f&lt;/span&gt;;
  } &lt;span style=&#34;color: #74747c&#34;&gt;/*&lt;/span&gt;&lt;span style=&#34;color: #74747c&#34;&gt; Comment.PreprocFile &lt;/span&gt;&lt;span style=&#34;color: #74747c&#34;&gt;*/&lt;/span&gt;
  &lt;span style=&#34;color: #8b41b1&#34;&gt;.&lt;/span&gt;&lt;span style=&#34;color: #8b41b1&#34;&gt;highlight&lt;/span&gt; &lt;span style=&#34;color: #8b41b1&#34;&gt;.&lt;/span&gt;&lt;span style=&#34;color: #8b41b1&#34;&gt;c1&lt;/span&gt; {
    &lt;span style=&#34;color: #4b69c6&#34;&gt;color&lt;/span&gt;: &lt;span style=&#34;color: #b60157&#34;&gt;#&lt;/span&gt;&lt;span style=&#34;color: #b60157&#34;&gt;70757a&lt;/span&gt;;
  } &lt;span style=&#34;color: #74747c&#34;&gt;/*&lt;/span&gt;&lt;span style=&#34;color: #74747c&#34;&gt; Comment.Single &lt;/span&gt;&lt;span style=&#34;color: #74747c&#34;&gt;*/&lt;/span&gt;
  &lt;span style=&#34;color: #8b41b1&#34;&gt;.&lt;/span&gt;&lt;span style=&#34;color: #8b41b1&#34;&gt;highlight&lt;/span&gt; &lt;span style=&#34;color: #8b41b1&#34;&gt;.&lt;/span&gt;&lt;span style=&#34;color: #8b41b1&#34;&gt;cs&lt;/span&gt; {
    &lt;span style=&#34;color: #4b69c6&#34;&gt;color&lt;/span&gt;: &lt;span style=&#34;color: #b60157&#34;&gt;#&lt;/span&gt;&lt;span style=&#34;color: #b60157&#34;&gt;af5f5f&lt;/span&gt;;
  } &lt;span style=&#34;color: #74747c&#34;&gt;/*&lt;/span&gt;&lt;span style=&#34;color: #74747c&#34;&gt; Comment.Special &lt;/span&gt;&lt;span style=&#34;color: #74747c&#34;&gt;*/&lt;/span&gt;
  &lt;span style=&#34;color: #8b41b1&#34;&gt;.&lt;/span&gt;&lt;span style=&#34;color: #8b41b1&#34;&gt;highlight&lt;/span&gt; &lt;span style=&#34;color: #8b41b1&#34;&gt;.&lt;/span&gt;&lt;span style=&#34;color: #8b41b1&#34;&gt;gd&lt;/span&gt; {
    &lt;span style=&#34;color: #4b69c6&#34;&gt;color&lt;/span&gt;: &lt;span style=&#34;color: #b60157&#34;&gt;#&lt;/span&gt;&lt;span style=&#34;color: #b60157&#34;&gt;bb6868&lt;/span&gt;;
  } &lt;span style=&#34;color: #74747c&#34;&gt;/*&lt;/span&gt;&lt;span style=&#34;color: #74747c&#34;&gt; Generic.Deleted &lt;/span&gt;&lt;span style=&#34;color: #74747c&#34;&gt;*/&lt;/span&gt;
  &lt;span style=&#34;color: #8b41b1&#34;&gt;.&lt;/span&gt;&lt;span style=&#34;color: #8b41b1&#34;&gt;highlight&lt;/span&gt; &lt;span style=&#34;color: #8b41b1&#34;&gt;.&lt;/span&gt;&lt;span style=&#34;color: #8b41b1&#34;&gt;ge&lt;/span&gt; {
    &lt;span style=&#34;color: #4b69c6&#34;&gt;color&lt;/span&gt;: &lt;span style=&#34;color: #b60157&#34;&gt;#&lt;/span&gt;&lt;span style=&#34;color: #b60157&#34;&gt;ddd0c0&lt;/span&gt;;
    &lt;span style=&#34;color: #4b69c6&#34;&gt;font-style&lt;/span&gt;: &lt;span style=&#34;color: #4b69c6&#34;&gt;italic&lt;/span&gt;;
  } &lt;span style=&#34;color: #74747c&#34;&gt;/*&lt;/span&gt;&lt;span style=&#34;color: #74747c&#34;&gt; Generic.Emph &lt;/span&gt;&lt;span style=&#34;color: #74747c&#34;&gt;*/&lt;/span&gt;
  &lt;span style=&#34;color: #8b41b1&#34;&gt;.&lt;/span&gt;&lt;span style=&#34;color: #8b41b1&#34;&gt;highlight&lt;/span&gt; &lt;span style=&#34;color: #8b41b1&#34;&gt;.&lt;/span&gt;&lt;span style=&#34;color: #8b41b1&#34;&gt;ges&lt;/span&gt; {
    &lt;span style=&#34;color: #4b69c6&#34;&gt;color&lt;/span&gt;: &lt;span style=&#34;color: #b60157&#34;&gt;#&lt;/span&gt;&lt;span style=&#34;color: #b60157&#34;&gt;ddd0c0&lt;/span&gt;;
  } &lt;span style=&#34;color: #74747c&#34;&gt;/*&lt;/span&gt;&lt;span style=&#34;color: #74747c&#34;&gt; Generic.EmphStrong &lt;/span&gt;&lt;span style=&#34;color: #74747c&#34;&gt;*/&lt;/span&gt;
  &lt;span style=&#34;color: #8b41b1&#34;&gt;.&lt;/span&gt;&lt;span style=&#34;color: #8b41b1&#34;&gt;highlight&lt;/span&gt; &lt;span style=&#34;color: #8b41b1&#34;&gt;.&lt;/span&gt;&lt;span style=&#34;color: #8b41b1&#34;&gt;gr&lt;/span&gt; {
    &lt;span style=&#34;color: #4b69c6&#34;&gt;color&lt;/span&gt;: &lt;span style=&#34;color: #b60157&#34;&gt;#&lt;/span&gt;&lt;span style=&#34;color: #b60157&#34;&gt;af5f5f&lt;/span&gt;;
  } &lt;span style=&#34;color: #74747c&#34;&gt;/*&lt;/span&gt;&lt;span style=&#34;color: #74747c&#34;&gt; Generic.Error &lt;/span&gt;&lt;span style=&#34;color: #74747c&#34;&gt;*/&lt;/span&gt;
  &lt;span style=&#34;color: #8b41b1&#34;&gt;.&lt;/span&gt;&lt;span style=&#34;color: #8b41b1&#34;&gt;highlight&lt;/span&gt; &lt;span style=&#34;color: #8b41b1&#34;&gt;.&lt;/span&gt;&lt;span style=&#34;color: #8b41b1&#34;&gt;gh&lt;/span&gt; {
    &lt;span style=&#34;color: #4b69c6&#34;&gt;color&lt;/span&gt;: &lt;span style=&#34;color: #b60157&#34;&gt;#&lt;/span&gt;&lt;span style=&#34;color: #b60157&#34;&gt;ddd0c0&lt;/span&gt;;
  } &lt;span style=&#34;color: #74747c&#34;&gt;/*&lt;/span&gt;&lt;span style=&#34;color: #74747c&#34;&gt; Generic.Heading &lt;/span&gt;&lt;span style=&#34;color: #74747c&#34;&gt;*/&lt;/span&gt;
  &lt;span style=&#34;color: #8b41b1&#34;&gt;.&lt;/span&gt;&lt;span style=&#34;color: #8b41b1&#34;&gt;highlight&lt;/span&gt; &lt;span style=&#34;color: #8b41b1&#34;&gt;.&lt;/span&gt;&lt;span style=&#34;color: #8b41b1&#34;&gt;gi&lt;/span&gt; {
    &lt;span style=&#34;color: #4b69c6&#34;&gt;color&lt;/span&gt;: &lt;span style=&#34;color: #b60157&#34;&gt;#&lt;/span&gt;&lt;span style=&#34;color: #b60157&#34;&gt;849155&lt;/span&gt;;
  } &lt;span style=&#34;color: #74747c&#34;&gt;/*&lt;/span&gt;&lt;span style=&#34;color: #74747c&#34;&gt; Generic.Inserted &lt;/span&gt;&lt;span style=&#34;color: #74747c&#34;&gt;*/&lt;/span&gt;
  &lt;span style=&#34;color: #8b41b1&#34;&gt;.&lt;/span&gt;&lt;span style=&#34;color: #8b41b1&#34;&gt;highlight&lt;/span&gt; &lt;span style=&#34;color: #8b41b1&#34;&gt;.&lt;/span&gt;&lt;span style=&#34;color: #8b41b1&#34;&gt;go&lt;/span&gt; {
    &lt;span style=&#34;color: #4b69c6&#34;&gt;color&lt;/span&gt;: &lt;span style=&#34;color: #b60157&#34;&gt;#&lt;/span&gt;&lt;span style=&#34;color: #b60157&#34;&gt;ddd0c0&lt;/span&gt;;
  } &lt;span style=&#34;color: #74747c&#34;&gt;/*&lt;/span&gt;&lt;span style=&#34;color: #74747c&#34;&gt; Generic.Output &lt;/span&gt;&lt;span style=&#34;color: #74747c&#34;&gt;*/&lt;/span&gt;
  &lt;span style=&#34;color: #8b41b1&#34;&gt;.&lt;/span&gt;&lt;span style=&#34;color: #8b41b1&#34;&gt;highlight&lt;/span&gt; &lt;span style=&#34;color: #8b41b1&#34;&gt;.&lt;/span&gt;&lt;span style=&#34;color: #8b41b1&#34;&gt;gp&lt;/span&gt; {
    &lt;span style=&#34;color: #4b69c6&#34;&gt;color&lt;/span&gt;: &lt;span style=&#34;color: #b60157&#34;&gt;#&lt;/span&gt;&lt;span style=&#34;color: #b60157&#34;&gt;ddd0c0&lt;/span&gt;;
  } &lt;span style=&#34;color: #74747c&#34;&gt;/*&lt;/span&gt;&lt;span style=&#34;color: #74747c&#34;&gt; Generic.Prompt &lt;/span&gt;&lt;span style=&#34;color: #74747c&#34;&gt;*/&lt;/span&gt;
  &lt;span style=&#34;color: #8b41b1&#34;&gt;.&lt;/span&gt;&lt;span style=&#34;color: #8b41b1&#34;&gt;highlight&lt;/span&gt; &lt;span style=&#34;color: #8b41b1&#34;&gt;.&lt;/span&gt;&lt;span style=&#34;color: #8b41b1&#34;&gt;gs&lt;/span&gt; {
    &lt;span style=&#34;color: #4b69c6&#34;&gt;color&lt;/span&gt;: &lt;span style=&#34;color: #b60157&#34;&gt;#&lt;/span&gt;&lt;span style=&#34;color: #b60157&#34;&gt;ddd0c0&lt;/span&gt;;
    &lt;span style=&#34;color: #4b69c6&#34;&gt;font-weight&lt;/span&gt;: &lt;span style=&#34;color: #4b69c6&#34;&gt;bold&lt;/span&gt;;
  } &lt;span style=&#34;color: #74747c&#34;&gt;/*&lt;/span&gt;&lt;span style=&#34;color: #74747c&#34;&gt; Generic.Strong &lt;/span&gt;&lt;span style=&#34;color: #74747c&#34;&gt;*/&lt;/span&gt;
  &lt;span style=&#34;color: #8b41b1&#34;&gt;.&lt;/span&gt;&lt;span style=&#34;color: #8b41b1&#34;&gt;highlight&lt;/span&gt; &lt;span style=&#34;color: #8b41b1&#34;&gt;.&lt;/span&gt;&lt;span style=&#34;color: #8b41b1&#34;&gt;gu&lt;/span&gt; {
    &lt;span style=&#34;color: #4b69c6&#34;&gt;color&lt;/span&gt;: &lt;span style=&#34;color: #b60157&#34;&gt;#&lt;/span&gt;&lt;span style=&#34;color: #b60157&#34;&gt;ddd0c0&lt;/span&gt;;
  } &lt;span style=&#34;color: #74747c&#34;&gt;/*&lt;/span&gt;&lt;span style=&#34;color: #74747c&#34;&gt; Generic.Subheading &lt;/span&gt;&lt;span style=&#34;color: #74747c&#34;&gt;*/&lt;/span&gt;
  &lt;span style=&#34;color: #8b41b1&#34;&gt;.&lt;/span&gt;&lt;span style=&#34;color: #8b41b1&#34;&gt;highlight&lt;/span&gt; &lt;span style=&#34;color: #8b41b1&#34;&gt;.&lt;/span&gt;&lt;span style=&#34;color: #8b41b1&#34;&gt;gt&lt;/span&gt; {
    &lt;span style=&#34;color: #4b69c6&#34;&gt;color&lt;/span&gt;: &lt;span style=&#34;color: #b60157&#34;&gt;#&lt;/span&gt;&lt;span style=&#34;color: #b60157&#34;&gt;af5f5f&lt;/span&gt;;
  } &lt;span style=&#34;color: #74747c&#34;&gt;/*&lt;/span&gt;&lt;span style=&#34;color: #74747c&#34;&gt; Generic.Traceback &lt;/span&gt;&lt;span style=&#34;color: #74747c&#34;&gt;*/&lt;/span&gt;
  &lt;span style=&#34;color: #8b41b1&#34;&gt;.&lt;/span&gt;&lt;span style=&#34;color: #8b41b1&#34;&gt;highlight&lt;/span&gt; &lt;span style=&#34;color: #8b41b1&#34;&gt;.&lt;/span&gt;&lt;span style=&#34;color: #8b41b1&#34;&gt;kc&lt;/span&gt; {
    &lt;span style=&#34;color: #4b69c6&#34;&gt;color&lt;/span&gt;: &lt;span style=&#34;color: #b60157&#34;&gt;#&lt;/span&gt;&lt;span style=&#34;color: #b60157&#34;&gt;875f5f&lt;/span&gt;;
  } &lt;span style=&#34;color: #74747c&#34;&gt;/*&lt;/span&gt;&lt;span style=&#34;color: #74747c&#34;&gt; Keyword.Constant &lt;/span&gt;&lt;span style=&#34;color: #74747c&#34;&gt;*/&lt;/span&gt;
  &lt;span style=&#34;color: #8b41b1&#34;&gt;.&lt;/span&gt;&lt;span style=&#34;color: #8b41b1&#34;&gt;highlight&lt;/span&gt; &lt;span style=&#34;color: #8b41b1&#34;&gt;.&lt;/span&gt;&lt;span style=&#34;color: #8b41b1&#34;&gt;kd&lt;/span&gt; {
    &lt;span style=&#34;color: #4b69c6&#34;&gt;color&lt;/span&gt;: &lt;span style=&#34;color: #b60157&#34;&gt;#&lt;/span&gt;&lt;span style=&#34;color: #b60157&#34;&gt;875f5f&lt;/span&gt;;
  } &lt;span style=&#34;color: #74747c&#34;&gt;/*&lt;/span&gt;&lt;span style=&#34;color: #74747c&#34;&gt; Keyword.Declaration &lt;/span&gt;&lt;span style=&#34;color: #74747c&#34;&gt;*/&lt;/span&gt;
  &lt;span style=&#34;color: #8b41b1&#34;&gt;.&lt;/span&gt;&lt;span style=&#34;color: #8b41b1&#34;&gt;highlight&lt;/span&gt; &lt;span style=&#34;color: #8b41b1&#34;&gt;.&lt;/span&gt;&lt;span style=&#34;color: #8b41b1&#34;&gt;kn&lt;/span&gt; {
    &lt;span style=&#34;color: #4b69c6&#34;&gt;color&lt;/span&gt;: &lt;span style=&#34;color: #b60157&#34;&gt;#&lt;/span&gt;&lt;span style=&#34;color: #b60157&#34;&gt;875f5f&lt;/span&gt;;
  } &lt;span style=&#34;color: #74747c&#34;&gt;/*&lt;/span&gt;&lt;span style=&#34;color: #74747c&#34;&gt; Keyword.Namespace &lt;/span&gt;&lt;span style=&#34;color: #74747c&#34;&gt;*/&lt;/span&gt;
  &lt;span style=&#34;color: #8b41b1&#34;&gt;.&lt;/span&gt;&lt;span style=&#34;color: #8b41b1&#34;&gt;highlight&lt;/span&gt; &lt;span style=&#34;color: #8b41b1&#34;&gt;.&lt;/span&gt;&lt;span style=&#34;color: #8b41b1&#34;&gt;kp&lt;/span&gt; {
    &lt;span style=&#34;color: #4b69c6&#34;&gt;color&lt;/span&gt;: &lt;span style=&#34;color: #b60157&#34;&gt;#&lt;/span&gt;&lt;span style=&#34;color: #b60157&#34;&gt;919191&lt;/span&gt;;
  } &lt;span style=&#34;color: #74747c&#34;&gt;/*&lt;/span&gt;&lt;span style=&#34;color: #74747c&#34;&gt; Keyword.Pseudo &lt;/span&gt;&lt;span style=&#34;color: #74747c&#34;&gt;*/&lt;/span&gt;
  &lt;span style=&#34;color: #8b41b1&#34;&gt;.&lt;/span&gt;&lt;span style=&#34;color: #8b41b1&#34;&gt;highlight&lt;/span&gt; &lt;span style=&#34;color: #8b41b1&#34;&gt;.&lt;/span&gt;&lt;span style=&#34;color: #8b41b1&#34;&gt;kr&lt;/span&gt; {
    &lt;span style=&#34;color: #4b69c6&#34;&gt;color&lt;/span&gt;: &lt;span style=&#34;color: #b60157&#34;&gt;#&lt;/span&gt;&lt;span style=&#34;color: #b60157&#34;&gt;b46276&lt;/span&gt;;
  } &lt;span style=&#34;color: #74747c&#34;&gt;/*&lt;/span&gt;&lt;span style=&#34;color: #74747c&#34;&gt; Keyword.Reserved &lt;/span&gt;&lt;span style=&#34;color: #74747c&#34;&gt;*/&lt;/span&gt;
  &lt;span style=&#34;color: #8b41b1&#34;&gt;.&lt;/span&gt;&lt;span style=&#34;color: #8b41b1&#34;&gt;highlight&lt;/span&gt; &lt;span style=&#34;color: #8b41b1&#34;&gt;.&lt;/span&gt;&lt;span style=&#34;color: #8b41b1&#34;&gt;kt&lt;/span&gt; {
    &lt;span style=&#34;color: #4b69c6&#34;&gt;color&lt;/span&gt;: &lt;span style=&#34;color: #b60157&#34;&gt;#&lt;/span&gt;&lt;span style=&#34;color: #b60157&#34;&gt;af875f&lt;/span&gt;;
  } &lt;span style=&#34;color: #74747c&#34;&gt;/*&lt;/span&gt;&lt;span style=&#34;color: #74747c&#34;&gt; Keyword.Type &lt;/span&gt;&lt;span style=&#34;color: #74747c&#34;&gt;*/&lt;/span&gt;
  &lt;span style=&#34;color: #8b41b1&#34;&gt;.&lt;/span&gt;&lt;span style=&#34;color: #8b41b1&#34;&gt;highlight&lt;/span&gt; &lt;span style=&#34;color: #8b41b1&#34;&gt;.&lt;/span&gt;&lt;span style=&#34;color: #8b41b1&#34;&gt;ld&lt;/span&gt; {
    &lt;span style=&#34;color: #4b69c6&#34;&gt;color&lt;/span&gt;: &lt;span style=&#34;color: #b60157&#34;&gt;#&lt;/span&gt;&lt;span style=&#34;color: #b60157&#34;&gt;af875f&lt;/span&gt;;
  } &lt;span style=&#34;color: #74747c&#34;&gt;/*&lt;/span&gt;&lt;span style=&#34;color: #74747c&#34;&gt; Literal.Date &lt;/span&gt;&lt;span style=&#34;color: #74747c&#34;&gt;*/&lt;/span&gt;
  &lt;span style=&#34;color: #8b41b1&#34;&gt;.&lt;/span&gt;&lt;span style=&#34;color: #8b41b1&#34;&gt;highlight&lt;/span&gt; &lt;span style=&#34;color: #8b41b1&#34;&gt;.&lt;/span&gt;&lt;span style=&#34;color: #8b41b1&#34;&gt;m&lt;/span&gt; {
    &lt;span style=&#34;color: #4b69c6&#34;&gt;color&lt;/span&gt;: &lt;span style=&#34;color: #b60157&#34;&gt;#&lt;/span&gt;&lt;span style=&#34;color: #b60157&#34;&gt;87afaf&lt;/span&gt;;
  } &lt;span style=&#34;color: #74747c&#34;&gt;/*&lt;/span&gt;&lt;span style=&#34;color: #74747c&#34;&gt; Literal.Number &lt;/span&gt;&lt;span style=&#34;color: #74747c&#34;&gt;*/&lt;/span&gt;
  &lt;span style=&#34;color: #8b41b1&#34;&gt;.&lt;/span&gt;&lt;span style=&#34;color: #8b41b1&#34;&gt;highlight&lt;/span&gt; &lt;span style=&#34;color: #8b41b1&#34;&gt;.&lt;/span&gt;&lt;span style=&#34;color: #8b41b1&#34;&gt;s&lt;/span&gt; {
    &lt;span style=&#34;color: #4b69c6&#34;&gt;color&lt;/span&gt;: &lt;span style=&#34;color: #b60157&#34;&gt;#&lt;/span&gt;&lt;span style=&#34;color: #b60157&#34;&gt;c9b98f&lt;/span&gt;;
  } &lt;span style=&#34;color: #74747c&#34;&gt;/*&lt;/span&gt;&lt;span style=&#34;color: #74747c&#34;&gt; Literal.String &lt;/span&gt;&lt;span style=&#34;color: #74747c&#34;&gt;*/&lt;/span&gt;
  &lt;span style=&#34;color: #8b41b1&#34;&gt;.&lt;/span&gt;&lt;span style=&#34;color: #8b41b1&#34;&gt;highlight&lt;/span&gt; &lt;span style=&#34;color: #8b41b1&#34;&gt;.&lt;/span&gt;&lt;span style=&#34;color: #8b41b1&#34;&gt;na&lt;/span&gt; {
    &lt;span style=&#34;color: #4b69c6&#34;&gt;color&lt;/span&gt;: &lt;span style=&#34;color: #b60157&#34;&gt;#&lt;/span&gt;&lt;span style=&#34;color: #b60157&#34;&gt;ddd0c0&lt;/span&gt;;
  } &lt;span style=&#34;color: #74747c&#34;&gt;/*&lt;/span&gt;&lt;span style=&#34;color: #74747c&#34;&gt; Name.Attribute &lt;/span&gt;&lt;span style=&#34;color: #74747c&#34;&gt;*/&lt;/span&gt;
  &lt;span style=&#34;color: #8b41b1&#34;&gt;.&lt;/span&gt;&lt;span style=&#34;color: #8b41b1&#34;&gt;highlight&lt;/span&gt; &lt;span style=&#34;color: #8b41b1&#34;&gt;.&lt;/span&gt;&lt;span style=&#34;color: #8b41b1&#34;&gt;nb&lt;/span&gt; {
    &lt;span style=&#34;color: #4b69c6&#34;&gt;color&lt;/span&gt;: &lt;span style=&#34;color: #b60157&#34;&gt;#&lt;/span&gt;&lt;span style=&#34;color: #b60157&#34;&gt;ddd0c0&lt;/span&gt;;
  } &lt;span style=&#34;color: #74747c&#34;&gt;/*&lt;/span&gt;&lt;span style=&#34;color: #74747c&#34;&gt; Name.Builtin &lt;/span&gt;&lt;span style=&#34;color: #74747c&#34;&gt;*/&lt;/span&gt;
  &lt;span style=&#34;color: #8b41b1&#34;&gt;.&lt;/span&gt;&lt;span style=&#34;color: #8b41b1&#34;&gt;highlight&lt;/span&gt; &lt;span style=&#34;color: #8b41b1&#34;&gt;.&lt;/span&gt;&lt;span style=&#34;color: #8b41b1&#34;&gt;nc&lt;/span&gt; {
    &lt;span style=&#34;color: #4b69c6&#34;&gt;color&lt;/span&gt;: &lt;span style=&#34;color: #b60157&#34;&gt;#&lt;/span&gt;&lt;span style=&#34;color: #b60157&#34;&gt;875f5f&lt;/span&gt;;
  } &lt;span style=&#34;color: #74747c&#34;&gt;/*&lt;/span&gt;&lt;span style=&#34;color: #74747c&#34;&gt; Name.Class &lt;/span&gt;&lt;span style=&#34;color: #74747c&#34;&gt;*/&lt;/span&gt;
  &lt;span style=&#34;color: #8b41b1&#34;&gt;.&lt;/span&gt;&lt;span style=&#34;color: #8b41b1&#34;&gt;highlight&lt;/span&gt; &lt;span style=&#34;color: #8b41b1&#34;&gt;.&lt;/span&gt;&lt;span style=&#34;color: #8b41b1&#34;&gt;no&lt;/span&gt; {
    &lt;span style=&#34;color: #4b69c6&#34;&gt;color&lt;/span&gt;: &lt;span style=&#34;color: #b60157&#34;&gt;#&lt;/span&gt;&lt;span style=&#34;color: #b60157&#34;&gt;af8787&lt;/span&gt;;
  } &lt;span style=&#34;color: #74747c&#34;&gt;/*&lt;/span&gt;&lt;span style=&#34;color: #74747c&#34;&gt; Name.Constant &lt;/span&gt;&lt;span style=&#34;color: #74747c&#34;&gt;*/&lt;/span&gt;
  &lt;span style=&#34;color: #8b41b1&#34;&gt;.&lt;/span&gt;&lt;span style=&#34;color: #8b41b1&#34;&gt;highlight&lt;/span&gt; &lt;span style=&#34;color: #8b41b1&#34;&gt;.&lt;/span&gt;&lt;span style=&#34;color: #8b41b1&#34;&gt;nd&lt;/span&gt; {
    &lt;span style=&#34;color: #4b69c6&#34;&gt;color&lt;/span&gt;: &lt;span style=&#34;color: #b60157&#34;&gt;#&lt;/span&gt;&lt;span style=&#34;color: #b60157&#34;&gt;fdd0c0&lt;/span&gt;;
  } &lt;span style=&#34;color: #74747c&#34;&gt;/*&lt;/span&gt;&lt;span style=&#34;color: #74747c&#34;&gt; Name.Decorator &lt;/span&gt;&lt;span style=&#34;color: #74747c&#34;&gt;*/&lt;/span&gt;
  &lt;span style=&#34;color: #8b41b1&#34;&gt;.&lt;/span&gt;&lt;span style=&#34;color: #8b41b1&#34;&gt;highlight&lt;/span&gt; &lt;span style=&#34;color: #8b41b1&#34;&gt;.&lt;/span&gt;&lt;span style=&#34;color: #8b41b1&#34;&gt;ni&lt;/span&gt; {
    &lt;span style=&#34;color: #4b69c6&#34;&gt;color&lt;/span&gt;: &lt;span style=&#34;color: #b60157&#34;&gt;#&lt;/span&gt;&lt;span style=&#34;color: #b60157&#34;&gt;ddd0c0&lt;/span&gt;;
  } &lt;span style=&#34;color: #74747c&#34;&gt;/*&lt;/span&gt;&lt;span style=&#34;color: #74747c&#34;&gt; Name.Entity &lt;/span&gt;&lt;span style=&#34;color: #74747c&#34;&gt;*/&lt;/span&gt;
  &lt;span style=&#34;color: #8b41b1&#34;&gt;.&lt;/span&gt;&lt;span style=&#34;color: #8b41b1&#34;&gt;highlight&lt;/span&gt; &lt;span style=&#34;color: #8b41b1&#34;&gt;.&lt;/span&gt;&lt;span style=&#34;color: #8b41b1&#34;&gt;ne&lt;/span&gt; {
    &lt;span style=&#34;color: #4b69c6&#34;&gt;color&lt;/span&gt;: &lt;span style=&#34;color: #b60157&#34;&gt;#&lt;/span&gt;&lt;span style=&#34;color: #b60157&#34;&gt;877575&lt;/span&gt;;
  } &lt;span style=&#34;color: #74747c&#34;&gt;/*&lt;/span&gt;&lt;span style=&#34;color: #74747c&#34;&gt; Name.Exception &lt;/span&gt;&lt;span style=&#34;color: #74747c&#34;&gt;*/&lt;/span&gt;
  &lt;span style=&#34;color: #8b41b1&#34;&gt;.&lt;/span&gt;&lt;span style=&#34;color: #8b41b1&#34;&gt;highlight&lt;/span&gt; &lt;span style=&#34;color: #8b41b1&#34;&gt;.&lt;/span&gt;&lt;span style=&#34;color: #8b41b1&#34;&gt;nf&lt;/span&gt; {
    &lt;span style=&#34;color: #4b69c6&#34;&gt;color&lt;/span&gt;: &lt;span style=&#34;color: #b60157&#34;&gt;#&lt;/span&gt;&lt;span style=&#34;color: #b60157&#34;&gt;fdd0c0&lt;/span&gt;;
  } &lt;span style=&#34;color: #74747c&#34;&gt;/*&lt;/span&gt;&lt;span style=&#34;color: #74747c&#34;&gt; Name.Function &lt;/span&gt;&lt;span style=&#34;color: #74747c&#34;&gt;*/&lt;/span&gt;
  &lt;span style=&#34;color: #8b41b1&#34;&gt;.&lt;/span&gt;&lt;span style=&#34;color: #8b41b1&#34;&gt;highlight&lt;/span&gt; &lt;span style=&#34;color: #8b41b1&#34;&gt;.&lt;/span&gt;&lt;span style=&#34;color: #8b41b1&#34;&gt;nl&lt;/span&gt; {
    &lt;span style=&#34;color: #4b69c6&#34;&gt;color&lt;/span&gt;: &lt;span style=&#34;color: #b60157&#34;&gt;#&lt;/span&gt;&lt;span style=&#34;color: #b60157&#34;&gt;ddd0c0&lt;/span&gt;;
  } &lt;span style=&#34;color: #74747c&#34;&gt;/*&lt;/span&gt;&lt;span style=&#34;color: #74747c&#34;&gt; Name.Label &lt;/span&gt;&lt;span style=&#34;color: #74747c&#34;&gt;*/&lt;/span&gt;
  &lt;span style=&#34;color: #8b41b1&#34;&gt;.&lt;/span&gt;&lt;span style=&#34;color: #8b41b1&#34;&gt;highlight&lt;/span&gt; &lt;span style=&#34;color: #8b41b1&#34;&gt;.&lt;/span&gt;&lt;span style=&#34;color: #8b41b1&#34;&gt;nn&lt;/span&gt; {
    &lt;span style=&#34;color: #4b69c6&#34;&gt;color&lt;/span&gt;: &lt;span style=&#34;color: #b60157&#34;&gt;#&lt;/span&gt;&lt;span style=&#34;color: #b60157&#34;&gt;ddd0c0&lt;/span&gt;;
  } &lt;span style=&#34;color: #74747c&#34;&gt;/*&lt;/span&gt;&lt;span style=&#34;color: #74747c&#34;&gt; Name.Namespace &lt;/span&gt;&lt;span style=&#34;color: #74747c&#34;&gt;*/&lt;/span&gt;
  &lt;span style=&#34;color: #8b41b1&#34;&gt;.&lt;/span&gt;&lt;span style=&#34;color: #8b41b1&#34;&gt;highlight&lt;/span&gt; &lt;span style=&#34;color: #8b41b1&#34;&gt;.&lt;/span&gt;&lt;span style=&#34;color: #8b41b1&#34;&gt;nx&lt;/span&gt; {
    &lt;span style=&#34;color: #4b69c6&#34;&gt;color&lt;/span&gt;: &lt;span style=&#34;color: #b60157&#34;&gt;#&lt;/span&gt;&lt;span style=&#34;color: #b60157&#34;&gt;ddd0c0&lt;/span&gt;;
  } &lt;span style=&#34;color: #74747c&#34;&gt;/*&lt;/span&gt;&lt;span style=&#34;color: #74747c&#34;&gt; Name.Other &lt;/span&gt;&lt;span style=&#34;color: #74747c&#34;&gt;*/&lt;/span&gt;
  &lt;span style=&#34;color: #8b41b1&#34;&gt;.&lt;/span&gt;&lt;span style=&#34;color: #8b41b1&#34;&gt;highlight&lt;/span&gt; &lt;span style=&#34;color: #8b41b1&#34;&gt;.&lt;/span&gt;&lt;span style=&#34;color: #8b41b1&#34;&gt;py&lt;/span&gt; {
    &lt;span style=&#34;color: #4b69c6&#34;&gt;color&lt;/span&gt;: &lt;span style=&#34;color: #b60157&#34;&gt;#&lt;/span&gt;&lt;span style=&#34;color: #b60157&#34;&gt;dfaf87&lt;/span&gt;;
  } &lt;span style=&#34;color: #74747c&#34;&gt;/*&lt;/span&gt;&lt;span style=&#34;color: #74747c&#34;&gt; Name.Property &lt;/span&gt;&lt;span style=&#34;color: #74747c&#34;&gt;*/&lt;/span&gt;
  &lt;span style=&#34;color: #8b41b1&#34;&gt;.&lt;/span&gt;&lt;span style=&#34;color: #8b41b1&#34;&gt;highlight&lt;/span&gt; &lt;span style=&#34;color: #8b41b1&#34;&gt;.&lt;/span&gt;&lt;span style=&#34;color: #8b41b1&#34;&gt;nt&lt;/span&gt; {
    &lt;span style=&#34;color: #4b69c6&#34;&gt;color&lt;/span&gt;: &lt;span style=&#34;color: #b60157&#34;&gt;#&lt;/span&gt;&lt;span style=&#34;color: #b60157&#34;&gt;87afaf&lt;/span&gt;;
  } &lt;span style=&#34;color: #74747c&#34;&gt;/*&lt;/span&gt;&lt;span style=&#34;color: #74747c&#34;&gt; Name.Tag &lt;/span&gt;&lt;span style=&#34;color: #74747c&#34;&gt;*/&lt;/span&gt;
  &lt;span style=&#34;color: #8b41b1&#34;&gt;.&lt;/span&gt;&lt;span style=&#34;color: #8b41b1&#34;&gt;highlight&lt;/span&gt; &lt;span style=&#34;color: #8b41b1&#34;&gt;.&lt;/span&gt;&lt;span style=&#34;color: #8b41b1&#34;&gt;nv&lt;/span&gt; {
    &lt;span style=&#34;color: #4b69c6&#34;&gt;color&lt;/span&gt;: &lt;span style=&#34;color: #b60157&#34;&gt;#&lt;/span&gt;&lt;span style=&#34;color: #b60157&#34;&gt;ddd0c0&lt;/span&gt;;
  } &lt;span style=&#34;color: #74747c&#34;&gt;/*&lt;/span&gt;&lt;span style=&#34;color: #74747c&#34;&gt; Name.Variable &lt;/span&gt;&lt;span style=&#34;color: #74747c&#34;&gt;*/&lt;/span&gt;
  &lt;span style=&#34;color: #8b41b1&#34;&gt;.&lt;/span&gt;&lt;span style=&#34;color: #8b41b1&#34;&gt;highlight&lt;/span&gt; &lt;span style=&#34;color: #8b41b1&#34;&gt;.&lt;/span&gt;&lt;span style=&#34;color: #8b41b1&#34;&gt;ow&lt;/span&gt; {
    &lt;span style=&#34;color: #4b69c6&#34;&gt;color&lt;/span&gt;: &lt;span style=&#34;color: #b60157&#34;&gt;#&lt;/span&gt;&lt;span style=&#34;color: #b60157&#34;&gt;878787&lt;/span&gt;;
  } &lt;span style=&#34;color: #74747c&#34;&gt;/*&lt;/span&gt;&lt;span style=&#34;color: #74747c&#34;&gt; Operator.Word &lt;/span&gt;&lt;span style=&#34;color: #74747c&#34;&gt;*/&lt;/span&gt;
  &lt;span style=&#34;color: #8b41b1&#34;&gt;.&lt;/span&gt;&lt;span style=&#34;color: #8b41b1&#34;&gt;highlight&lt;/span&gt; &lt;span style=&#34;color: #8b41b1&#34;&gt;.&lt;/span&gt;&lt;span style=&#34;color: #8b41b1&#34;&gt;pm&lt;/span&gt; {
    &lt;span style=&#34;color: #4b69c6&#34;&gt;color&lt;/span&gt;: &lt;span style=&#34;color: #b60157&#34;&gt;#&lt;/span&gt;&lt;span style=&#34;color: #b60157&#34;&gt;ddd0c0&lt;/span&gt;;
  } &lt;span style=&#34;color: #74747c&#34;&gt;/*&lt;/span&gt;&lt;span style=&#34;color: #74747c&#34;&gt; Punctuation.Marker &lt;/span&gt;&lt;span style=&#34;color: #74747c&#34;&gt;*/&lt;/span&gt;
  &lt;span style=&#34;color: #8b41b1&#34;&gt;.&lt;/span&gt;&lt;span style=&#34;color: #8b41b1&#34;&gt;highlight&lt;/span&gt; &lt;span style=&#34;color: #8b41b1&#34;&gt;.&lt;/span&gt;&lt;span style=&#34;color: #8b41b1&#34;&gt;w&lt;/span&gt; {
    &lt;span style=&#34;color: #4b69c6&#34;&gt;color&lt;/span&gt;: &lt;span style=&#34;color: #b60157&#34;&gt;#&lt;/span&gt;&lt;span style=&#34;color: #b60157&#34;&gt;ddd0c0&lt;/span&gt;;
  } &lt;span style=&#34;color: #74747c&#34;&gt;/*&lt;/span&gt;&lt;span style=&#34;color: #74747c&#34;&gt; Text.Whitespace &lt;/span&gt;&lt;span style=&#34;color: #74747c&#34;&gt;*/&lt;/span&gt;
  &lt;span style=&#34;color: #8b41b1&#34;&gt;.&lt;/span&gt;&lt;span style=&#34;color: #8b41b1&#34;&gt;highlight&lt;/span&gt; &lt;span style=&#34;color: #8b41b1&#34;&gt;.&lt;/span&gt;&lt;span style=&#34;color: #8b41b1&#34;&gt;mb&lt;/span&gt; {
    &lt;span style=&#34;color: #4b69c6&#34;&gt;color&lt;/span&gt;: &lt;span style=&#34;color: #b60157&#34;&gt;#&lt;/span&gt;&lt;span style=&#34;color: #b60157&#34;&gt;87afaf&lt;/span&gt;;
  } &lt;span style=&#34;color: #74747c&#34;&gt;/*&lt;/span&gt;&lt;span style=&#34;color: #74747c&#34;&gt; Literal.Number.Bin &lt;/span&gt;&lt;span style=&#34;color: #74747c&#34;&gt;*/&lt;/span&gt;
  &lt;span style=&#34;color: #8b41b1&#34;&gt;.&lt;/span&gt;&lt;span style=&#34;color: #8b41b1&#34;&gt;highlight&lt;/span&gt; &lt;span style=&#34;color: #8b41b1&#34;&gt;.&lt;/span&gt;&lt;span style=&#34;color: #8b41b1&#34;&gt;mf&lt;/span&gt; {
    &lt;span style=&#34;color: #4b69c6&#34;&gt;color&lt;/span&gt;: &lt;span style=&#34;color: #b60157&#34;&gt;#&lt;/span&gt;&lt;span style=&#34;color: #b60157&#34;&gt;87afaf&lt;/span&gt;;
  } &lt;span style=&#34;color: #74747c&#34;&gt;/*&lt;/span&gt;&lt;span style=&#34;color: #74747c&#34;&gt; Literal.Number.Float &lt;/span&gt;&lt;span style=&#34;color: #74747c&#34;&gt;*/&lt;/span&gt;
  &lt;span style=&#34;color: #8b41b1&#34;&gt;.&lt;/span&gt;&lt;span style=&#34;color: #8b41b1&#34;&gt;highlight&lt;/span&gt; &lt;span style=&#34;color: #8b41b1&#34;&gt;.&lt;/span&gt;&lt;span style=&#34;color: #8b41b1&#34;&gt;mh&lt;/span&gt; {
    &lt;span style=&#34;color: #4b69c6&#34;&gt;color&lt;/span&gt;: &lt;span style=&#34;color: #b60157&#34;&gt;#&lt;/span&gt;&lt;span style=&#34;color: #b60157&#34;&gt;87afaf&lt;/span&gt;;
  } &lt;span style=&#34;color: #74747c&#34;&gt;/*&lt;/span&gt;&lt;span style=&#34;color: #74747c&#34;&gt; Literal.Number.Hex &lt;/span&gt;&lt;span style=&#34;color: #74747c&#34;&gt;*/&lt;/span&gt;
  &lt;span style=&#34;color: #8b41b1&#34;&gt;.&lt;/span&gt;&lt;span style=&#34;color: #8b41b1&#34;&gt;highlight&lt;/span&gt; &lt;span style=&#34;color: #8b41b1&#34;&gt;.&lt;/span&gt;&lt;span style=&#34;color: #8b41b1&#34;&gt;mi&lt;/span&gt; {
    &lt;span style=&#34;color: #4b69c6&#34;&gt;color&lt;/span&gt;: &lt;span style=&#34;color: #b60157&#34;&gt;#&lt;/span&gt;&lt;span style=&#34;color: #b60157&#34;&gt;87afaf&lt;/span&gt;;
  } &lt;span style=&#34;color: #74747c&#34;&gt;/*&lt;/span&gt;&lt;span style=&#34;color: #74747c&#34;&gt; Literal.Number.Integer &lt;/span&gt;&lt;span style=&#34;color: #74747c&#34;&gt;*/&lt;/span&gt;
  &lt;span style=&#34;color: #8b41b1&#34;&gt;.&lt;/span&gt;&lt;span style=&#34;color: #8b41b1&#34;&gt;highlight&lt;/span&gt; &lt;span style=&#34;color: #8b41b1&#34;&gt;.&lt;/span&gt;&lt;span style=&#34;color: #8b41b1&#34;&gt;mo&lt;/span&gt; {
    &lt;span style=&#34;color: #4b69c6&#34;&gt;color&lt;/span&gt;: &lt;span style=&#34;color: #b60157&#34;&gt;#&lt;/span&gt;&lt;span style=&#34;color: #b60157&#34;&gt;87afaf&lt;/span&gt;;
  } &lt;span style=&#34;color: #74747c&#34;&gt;/*&lt;/span&gt;&lt;span style=&#34;color: #74747c&#34;&gt; Literal.Number.Oct &lt;/span&gt;&lt;span style=&#34;color: #74747c&#34;&gt;*/&lt;/span&gt;
  &lt;span style=&#34;color: #8b41b1&#34;&gt;.&lt;/span&gt;&lt;span style=&#34;color: #8b41b1&#34;&gt;highlight&lt;/span&gt; &lt;span style=&#34;color: #8b41b1&#34;&gt;.&lt;/span&gt;&lt;span style=&#34;color: #8b41b1&#34;&gt;sa&lt;/span&gt; {
    &lt;span style=&#34;color: #4b69c6&#34;&gt;color&lt;/span&gt;: &lt;span style=&#34;color: #b60157&#34;&gt;#&lt;/span&gt;&lt;span style=&#34;color: #b60157&#34;&gt;dfaf87&lt;/span&gt;;
  } &lt;span style=&#34;color: #74747c&#34;&gt;/*&lt;/span&gt;&lt;span style=&#34;color: #74747c&#34;&gt; Literal.String.Affix &lt;/span&gt;&lt;span style=&#34;color: #74747c&#34;&gt;*/&lt;/span&gt;
  &lt;span style=&#34;color: #8b41b1&#34;&gt;.&lt;/span&gt;&lt;span style=&#34;color: #8b41b1&#34;&gt;highlight&lt;/span&gt; &lt;span style=&#34;color: #8b41b1&#34;&gt;.&lt;/span&gt;&lt;span style=&#34;color: #8b41b1&#34;&gt;sb&lt;/span&gt; {
    &lt;span style=&#34;color: #4b69c6&#34;&gt;color&lt;/span&gt;: &lt;span style=&#34;color: #b60157&#34;&gt;#&lt;/span&gt;&lt;span style=&#34;color: #b60157&#34;&gt;c9b98f&lt;/span&gt;;
  } &lt;span style=&#34;color: #74747c&#34;&gt;/*&lt;/span&gt;&lt;span style=&#34;color: #74747c&#34;&gt; Literal.String.Backtick &lt;/span&gt;&lt;span style=&#34;color: #74747c&#34;&gt;*/&lt;/span&gt;
  &lt;span style=&#34;color: #8b41b1&#34;&gt;.&lt;/span&gt;&lt;span style=&#34;color: #8b41b1&#34;&gt;highlight&lt;/span&gt; &lt;span style=&#34;color: #8b41b1&#34;&gt;.&lt;/span&gt;&lt;span style=&#34;color: #8b41b1&#34;&gt;sc&lt;/span&gt; {
    &lt;span style=&#34;color: #4b69c6&#34;&gt;color&lt;/span&gt;: &lt;span style=&#34;color: #b60157&#34;&gt;#&lt;/span&gt;&lt;span style=&#34;color: #b60157&#34;&gt;c9b98f&lt;/span&gt;;
  } &lt;span style=&#34;color: #74747c&#34;&gt;/*&lt;/span&gt;&lt;span style=&#34;color: #74747c&#34;&gt; Literal.String.Char &lt;/span&gt;&lt;span style=&#34;color: #74747c&#34;&gt;*/&lt;/span&gt;
  &lt;span style=&#34;color: #8b41b1&#34;&gt;.&lt;/span&gt;&lt;span style=&#34;color: #8b41b1&#34;&gt;highlight&lt;/span&gt; &lt;span style=&#34;color: #8b41b1&#34;&gt;.&lt;/span&gt;&lt;span style=&#34;color: #8b41b1&#34;&gt;dl&lt;/span&gt; {
    &lt;span style=&#34;color: #4b69c6&#34;&gt;color&lt;/span&gt;: &lt;span style=&#34;color: #b60157&#34;&gt;#&lt;/span&gt;&lt;span style=&#34;color: #b60157&#34;&gt;c9b98f&lt;/span&gt;;
  } &lt;span style=&#34;color: #74747c&#34;&gt;/*&lt;/span&gt;&lt;span style=&#34;color: #74747c&#34;&gt; Literal.String.Delimiter &lt;/span&gt;&lt;span style=&#34;color: #74747c&#34;&gt;*/&lt;/span&gt;
  &lt;span style=&#34;color: #8b41b1&#34;&gt;.&lt;/span&gt;&lt;span style=&#34;color: #8b41b1&#34;&gt;highlight&lt;/span&gt; &lt;span style=&#34;color: #8b41b1&#34;&gt;.&lt;/span&gt;&lt;span style=&#34;color: #8b41b1&#34;&gt;sd&lt;/span&gt; {
    &lt;span style=&#34;color: #4b69c6&#34;&gt;color&lt;/span&gt;: &lt;span style=&#34;color: #b60157&#34;&gt;#&lt;/span&gt;&lt;span style=&#34;color: #b60157&#34;&gt;878787&lt;/span&gt;;
  } &lt;span style=&#34;color: #74747c&#34;&gt;/*&lt;/span&gt;&lt;span style=&#34;color: #74747c&#34;&gt; Literal.String.Doc &lt;/span&gt;&lt;span style=&#34;color: #74747c&#34;&gt;*/&lt;/span&gt;
  &lt;span style=&#34;color: #8b41b1&#34;&gt;.&lt;/span&gt;&lt;span style=&#34;color: #8b41b1&#34;&gt;highlight&lt;/span&gt; &lt;span style=&#34;color: #8b41b1&#34;&gt;.&lt;/span&gt;&lt;span style=&#34;color: #8b41b1&#34;&gt;s2&lt;/span&gt; {
    &lt;span style=&#34;color: #4b69c6&#34;&gt;color&lt;/span&gt;: &lt;span style=&#34;color: #b60157&#34;&gt;#&lt;/span&gt;&lt;span style=&#34;color: #b60157&#34;&gt;c9b98f&lt;/span&gt;;
  } &lt;span style=&#34;color: #74747c&#34;&gt;/*&lt;/span&gt;&lt;span style=&#34;color: #74747c&#34;&gt; Literal.String.Double &lt;/span&gt;&lt;span style=&#34;color: #74747c&#34;&gt;*/&lt;/span&gt;
  &lt;span style=&#34;color: #8b41b1&#34;&gt;.&lt;/span&gt;&lt;span style=&#34;color: #8b41b1&#34;&gt;highlight&lt;/span&gt; &lt;span style=&#34;color: #8b41b1&#34;&gt;.&lt;/span&gt;&lt;span style=&#34;color: #8b41b1&#34;&gt;se&lt;/span&gt; {
    &lt;span style=&#34;color: #4b69c6&#34;&gt;color&lt;/span&gt;: &lt;span style=&#34;color: #b60157&#34;&gt;#&lt;/span&gt;&lt;span style=&#34;color: #b60157&#34;&gt;af5f5f&lt;/span&gt;;
  } &lt;span style=&#34;color: #74747c&#34;&gt;/*&lt;/span&gt;&lt;span style=&#34;color: #74747c&#34;&gt; Literal.String.Escape &lt;/span&gt;&lt;span style=&#34;color: #74747c&#34;&gt;*/&lt;/span&gt;
  &lt;span style=&#34;color: #8b41b1&#34;&gt;.&lt;/span&gt;&lt;span style=&#34;color: #8b41b1&#34;&gt;highlight&lt;/span&gt; &lt;span style=&#34;color: #8b41b1&#34;&gt;.&lt;/span&gt;&lt;span style=&#34;color: #8b41b1&#34;&gt;sh&lt;/span&gt; {
    &lt;span style=&#34;color: #4b69c6&#34;&gt;color&lt;/span&gt;: &lt;span style=&#34;color: #b60157&#34;&gt;#&lt;/span&gt;&lt;span style=&#34;color: #b60157&#34;&gt;c9b98f&lt;/span&gt;;
  } &lt;span style=&#34;color: #74747c&#34;&gt;/*&lt;/span&gt;&lt;span style=&#34;color: #74747c&#34;&gt; Literal.String.Heredoc &lt;/span&gt;&lt;span style=&#34;color: #74747c&#34;&gt;*/&lt;/span&gt;
  &lt;span style=&#34;color: #8b41b1&#34;&gt;.&lt;/span&gt;&lt;span style=&#34;color: #8b41b1&#34;&gt;highlight&lt;/span&gt; &lt;span style=&#34;color: #8b41b1&#34;&gt;.&lt;/span&gt;&lt;span style=&#34;color: #8b41b1&#34;&gt;si&lt;/span&gt; {
    &lt;span style=&#34;color: #4b69c6&#34;&gt;color&lt;/span&gt;: &lt;span style=&#34;color: #b60157&#34;&gt;#&lt;/span&gt;&lt;span style=&#34;color: #b60157&#34;&gt;af5f5f&lt;/span&gt;;
  } &lt;span style=&#34;color: #74747c&#34;&gt;/*&lt;/span&gt;&lt;span style=&#34;color: #74747c&#34;&gt; Literal.String.Interpol &lt;/span&gt;&lt;span style=&#34;color: #74747c&#34;&gt;*/&lt;/span&gt;
  &lt;span style=&#34;color: #8b41b1&#34;&gt;.&lt;/span&gt;&lt;span style=&#34;color: #8b41b1&#34;&gt;highlight&lt;/span&gt; &lt;span style=&#34;color: #8b41b1&#34;&gt;.&lt;/span&gt;&lt;span style=&#34;color: #8b41b1&#34;&gt;sx&lt;/span&gt; {
    &lt;span style=&#34;color: #4b69c6&#34;&gt;color&lt;/span&gt;: &lt;span style=&#34;color: #b60157&#34;&gt;#&lt;/span&gt;&lt;span style=&#34;color: #b60157&#34;&gt;fdd0c0&lt;/span&gt;;
  } &lt;span style=&#34;color: #74747c&#34;&gt;/*&lt;/span&gt;&lt;span style=&#34;color: #74747c&#34;&gt; Literal.String.Other &lt;/span&gt;&lt;span style=&#34;color: #74747c&#34;&gt;*/&lt;/span&gt;
  &lt;span style=&#34;color: #8b41b1&#34;&gt;.&lt;/span&gt;&lt;span style=&#34;color: #8b41b1&#34;&gt;highlight&lt;/span&gt; &lt;span style=&#34;color: #8b41b1&#34;&gt;.&lt;/span&gt;&lt;span style=&#34;color: #8b41b1&#34;&gt;sr&lt;/span&gt; {
    &lt;span style=&#34;color: #4b69c6&#34;&gt;color&lt;/span&gt;: &lt;span style=&#34;color: #b60157&#34;&gt;#&lt;/span&gt;&lt;span style=&#34;color: #b60157&#34;&gt;af5f5f&lt;/span&gt;;
  } &lt;span style=&#34;color: #74747c&#34;&gt;/*&lt;/span&gt;&lt;span style=&#34;color: #74747c&#34;&gt; Literal.String.Regex &lt;/span&gt;&lt;span style=&#34;color: #74747c&#34;&gt;*/&lt;/span&gt;
  &lt;span style=&#34;color: #8b41b1&#34;&gt;.&lt;/span&gt;&lt;span style=&#34;color: #8b41b1&#34;&gt;highlight&lt;/span&gt; &lt;span style=&#34;color: #8b41b1&#34;&gt;.&lt;/span&gt;&lt;span style=&#34;color: #8b41b1&#34;&gt;s1&lt;/span&gt; {
    &lt;span style=&#34;color: #4b69c6&#34;&gt;color&lt;/span&gt;: &lt;span style=&#34;color: #b60157&#34;&gt;#&lt;/span&gt;&lt;span style=&#34;color: #b60157&#34;&gt;c9b98f&lt;/span&gt;;
  } &lt;span style=&#34;color: #74747c&#34;&gt;/*&lt;/span&gt;&lt;span style=&#34;color: #74747c&#34;&gt; Literal.String.Single &lt;/span&gt;&lt;span style=&#34;color: #74747c&#34;&gt;*/&lt;/span&gt;
  &lt;span style=&#34;color: #8b41b1&#34;&gt;.&lt;/span&gt;&lt;span style=&#34;color: #8b41b1&#34;&gt;highlight&lt;/span&gt; &lt;span style=&#34;color: #8b41b1&#34;&gt;.&lt;/span&gt;&lt;span style=&#34;color: #8b41b1&#34;&gt;ss&lt;/span&gt; {
    &lt;span style=&#34;color: #4b69c6&#34;&gt;color&lt;/span&gt;: &lt;span style=&#34;color: #b60157&#34;&gt;#&lt;/span&gt;&lt;span style=&#34;color: #b60157&#34;&gt;af5f5f&lt;/span&gt;;
  } &lt;span style=&#34;color: #74747c&#34;&gt;/*&lt;/span&gt;&lt;span style=&#34;color: #74747c&#34;&gt; Literal.String.Symbol &lt;/span&gt;&lt;span style=&#34;color: #74747c&#34;&gt;*/&lt;/span&gt;
  &lt;span style=&#34;color: #8b41b1&#34;&gt;.&lt;/span&gt;&lt;span style=&#34;color: #8b41b1&#34;&gt;highlight&lt;/span&gt; &lt;span style=&#34;color: #8b41b1&#34;&gt;.&lt;/span&gt;&lt;span style=&#34;color: #8b41b1&#34;&gt;bp&lt;/span&gt; {
    &lt;span style=&#34;color: #4b69c6&#34;&gt;color&lt;/span&gt;: &lt;span style=&#34;color: #b60157&#34;&gt;#&lt;/span&gt;&lt;span style=&#34;color: #b60157&#34;&gt;87afaf&lt;/span&gt;;
  } &lt;span style=&#34;color: #74747c&#34;&gt;/*&lt;/span&gt;&lt;span style=&#34;color: #74747c&#34;&gt; Name.Builtin.Pseudo &lt;/span&gt;&lt;span style=&#34;color: #74747c&#34;&gt;*/&lt;/span&gt;
  &lt;span style=&#34;color: #8b41b1&#34;&gt;.&lt;/span&gt;&lt;span style=&#34;color: #8b41b1&#34;&gt;highlight&lt;/span&gt; &lt;span style=&#34;color: #8b41b1&#34;&gt;.&lt;/span&gt;&lt;span style=&#34;color: #8b41b1&#34;&gt;fm&lt;/span&gt; {
    &lt;span style=&#34;color: #4b69c6&#34;&gt;color&lt;/span&gt;: &lt;span style=&#34;color: #b60157&#34;&gt;#&lt;/span&gt;&lt;span style=&#34;color: #b60157&#34;&gt;fdd0c0&lt;/span&gt;;
  } &lt;span style=&#34;color: #74747c&#34;&gt;/*&lt;/span&gt;&lt;span style=&#34;color: #74747c&#34;&gt; Name.Function.Magic &lt;/span&gt;&lt;span style=&#34;color: #74747c&#34;&gt;*/&lt;/span&gt;
  &lt;span style=&#34;color: #8b41b1&#34;&gt;.&lt;/span&gt;&lt;span style=&#34;color: #8b41b1&#34;&gt;highlight&lt;/span&gt; &lt;span style=&#34;color: #8b41b1&#34;&gt;.&lt;/span&gt;&lt;span style=&#34;color: #8b41b1&#34;&gt;vc&lt;/span&gt; {
    &lt;span style=&#34;color: #4b69c6&#34;&gt;color&lt;/span&gt;: &lt;span style=&#34;color: #b60157&#34;&gt;#&lt;/span&gt;&lt;span style=&#34;color: #b60157&#34;&gt;ddd0c0&lt;/span&gt;;
  } &lt;span style=&#34;color: #74747c&#34;&gt;/*&lt;/span&gt;&lt;span style=&#34;color: #74747c&#34;&gt; Name.Variable.Class &lt;/span&gt;&lt;span style=&#34;color: #74747c&#34;&gt;*/&lt;/span&gt;
  &lt;span style=&#34;color: #8b41b1&#34;&gt;.&lt;/span&gt;&lt;span style=&#34;color: #8b41b1&#34;&gt;highlight&lt;/span&gt; &lt;span style=&#34;color: #8b41b1&#34;&gt;.&lt;/span&gt;&lt;span style=&#34;color: #8b41b1&#34;&gt;vg&lt;/span&gt; {
    &lt;span style=&#34;color: #4b69c6&#34;&gt;color&lt;/span&gt;: &lt;span style=&#34;color: #b60157&#34;&gt;#&lt;/span&gt;&lt;span style=&#34;color: #b60157&#34;&gt;ddd0c0&lt;/span&gt;;
  } &lt;span style=&#34;color: #74747c&#34;&gt;/*&lt;/span&gt;&lt;span style=&#34;color: #74747c&#34;&gt; Name.Variable.Global &lt;/span&gt;&lt;span style=&#34;color: #74747c&#34;&gt;*/&lt;/span&gt;
  &lt;span style=&#34;color: #8b41b1&#34;&gt;.&lt;/span&gt;&lt;span style=&#34;color: #8b41b1&#34;&gt;highlight&lt;/span&gt; &lt;span style=&#34;color: #8b41b1&#34;&gt;.&lt;/span&gt;&lt;span style=&#34;color: #8b41b1&#34;&gt;vi&lt;/span&gt; {
    &lt;span style=&#34;color: #4b69c6&#34;&gt;color&lt;/span&gt;: &lt;span style=&#34;color: #b60157&#34;&gt;#&lt;/span&gt;&lt;span style=&#34;color: #b60157&#34;&gt;ddd0c0&lt;/span&gt;;
  } &lt;span style=&#34;color: #74747c&#34;&gt;/*&lt;/span&gt;&lt;span style=&#34;color: #74747c&#34;&gt; Name.Variable.Instance &lt;/span&gt;&lt;span style=&#34;color: #74747c&#34;&gt;*/&lt;/span&gt;
  &lt;span style=&#34;color: #8b41b1&#34;&gt;.&lt;/span&gt;&lt;span style=&#34;color: #8b41b1&#34;&gt;highlight&lt;/span&gt; &lt;span style=&#34;color: #8b41b1&#34;&gt;.&lt;/span&gt;&lt;span style=&#34;color: #8b41b1&#34;&gt;vm&lt;/span&gt; {
    &lt;span style=&#34;color: #4b69c6&#34;&gt;color&lt;/span&gt;: &lt;span style=&#34;color: #b60157&#34;&gt;#&lt;/span&gt;&lt;span style=&#34;color: #b60157&#34;&gt;ddd0c0&lt;/span&gt;;
  } &lt;span style=&#34;color: #74747c&#34;&gt;/*&lt;/span&gt;&lt;span style=&#34;color: #74747c&#34;&gt; Name.Variable.Magic &lt;/span&gt;&lt;span style=&#34;color: #74747c&#34;&gt;*/&lt;/span&gt;
  &lt;span style=&#34;color: #8b41b1&#34;&gt;.&lt;/span&gt;&lt;span style=&#34;color: #8b41b1&#34;&gt;highlight&lt;/span&gt; &lt;span style=&#34;color: #8b41b1&#34;&gt;.&lt;/span&gt;&lt;span style=&#34;color: #8b41b1&#34;&gt;il&lt;/span&gt; {
    &lt;span style=&#34;color: #4b69c6&#34;&gt;color&lt;/span&gt;: &lt;span style=&#34;color: #b60157&#34;&gt;#&lt;/span&gt;&lt;span style=&#34;color: #b60157&#34;&gt;87afaf&lt;/span&gt;;
  } &lt;span style=&#34;color: #74747c&#34;&gt;/*&lt;/span&gt;&lt;span style=&#34;color: #74747c&#34;&gt; Literal.Number.Integer.Long &lt;/span&gt;&lt;span style=&#34;color: #74747c&#34;&gt;*/&lt;/span&gt;
}

\&lt;span style=&#34;color: #d73948&#34;&gt;@&lt;/span&gt;&lt;span style=&#34;color: #d73948&#34;&gt;media&lt;/span&gt; (prefers-&lt;span style=&#34;color: #4b69c6&#34;&gt;color&lt;/span&gt;-scheme: light) {
  &lt;span style=&#34;color: #8b41b1&#34;&gt;.&lt;/span&gt;&lt;span style=&#34;color: #8b41b1&#34;&gt;highlight&lt;/span&gt; {
    &lt;span style=&#34;color: #4b69c6&#34;&gt;background&lt;/span&gt;: &lt;span style=&#34;color: #4b69c6&#34;&gt;var&lt;/span&gt;(&lt;span style=&#34;color: #4b69c6&#34;&gt;--&lt;/span&gt;&lt;span style=&#34;color: #4b69c6&#34;&gt;code-background&lt;/span&gt;, #e7daca) &lt;span style=&#34;color: #d73948&#34;&gt;!important&lt;/span&gt;;
  }
  &lt;span style=&#34;color: #4b69c6&#34;&gt;pre&lt;/span&gt; {
    &lt;span style=&#34;color: #4b69c6&#34;&gt;line-height&lt;/span&gt;: &lt;span style=&#34;color: #b60157&#34;&gt;125&lt;/span&gt;&lt;span style=&#34;color: #d73948&#34;&gt;%&lt;/span&gt;;
  }
  &lt;span style=&#34;color: #4b69c6&#34;&gt;td&lt;/span&gt;&lt;span style=&#34;color: #8b41b1&#34;&gt;.&lt;/span&gt;&lt;span style=&#34;color: #8b41b1&#34;&gt;linenos&lt;/span&gt; &lt;span style=&#34;color: #8b41b1&#34;&gt;.&lt;/span&gt;&lt;span style=&#34;color: #8b41b1&#34;&gt;normal&lt;/span&gt; {
    &lt;span style=&#34;color: #4b69c6&#34;&gt;color&lt;/span&gt;: &lt;span style=&#34;color: #4b69c6&#34;&gt;inherit&lt;/span&gt;;
    &lt;span style=&#34;color: #4b69c6&#34;&gt;background-color&lt;/span&gt;: &lt;span style=&#34;color: #4b69c6&#34;&gt;transparent&lt;/span&gt;;
    &lt;span style=&#34;color: #4b69c6&#34;&gt;padding-left&lt;/span&gt;: &lt;span style=&#34;color: #b60157&#34;&gt;5&lt;/span&gt;&lt;span style=&#34;color: #d73948&#34;&gt;px&lt;/span&gt;;
    &lt;span style=&#34;color: #4b69c6&#34;&gt;padding-right&lt;/span&gt;: &lt;span style=&#34;color: #b60157&#34;&gt;5&lt;/span&gt;&lt;span style=&#34;color: #d73948&#34;&gt;px&lt;/span&gt;;
  }
  &lt;span style=&#34;color: #4b69c6&#34;&gt;span&lt;/span&gt;&lt;span style=&#34;color: #8b41b1&#34;&gt;.&lt;/span&gt;&lt;span style=&#34;color: #8b41b1&#34;&gt;linenos&lt;/span&gt; {
    &lt;span style=&#34;color: #4b69c6&#34;&gt;color&lt;/span&gt;: &lt;span style=&#34;color: #4b69c6&#34;&gt;inherit&lt;/span&gt;;
    &lt;span style=&#34;color: #4b69c6&#34;&gt;background-color&lt;/span&gt;: &lt;span style=&#34;color: #4b69c6&#34;&gt;transparent&lt;/span&gt;;
    &lt;span style=&#34;color: #4b69c6&#34;&gt;padding-left&lt;/span&gt;: &lt;span style=&#34;color: #b60157&#34;&gt;5&lt;/span&gt;&lt;span style=&#34;color: #d73948&#34;&gt;px&lt;/span&gt;;
    &lt;span style=&#34;color: #4b69c6&#34;&gt;padding-right&lt;/span&gt;: &lt;span style=&#34;color: #b60157&#34;&gt;5&lt;/span&gt;&lt;span style=&#34;color: #d73948&#34;&gt;px&lt;/span&gt;;
  }
  &lt;span style=&#34;color: #4b69c6&#34;&gt;td&lt;/span&gt;&lt;span style=&#34;color: #8b41b1&#34;&gt;.&lt;/span&gt;&lt;span style=&#34;color: #8b41b1&#34;&gt;linenos&lt;/span&gt; &lt;span style=&#34;color: #8b41b1&#34;&gt;.&lt;/span&gt;&lt;span style=&#34;color: #8b41b1&#34;&gt;special&lt;/span&gt; {
    &lt;span style=&#34;color: #4b69c6&#34;&gt;color&lt;/span&gt;: &lt;span style=&#34;color: #b60157&#34;&gt;#&lt;/span&gt;&lt;span style=&#34;color: #b60157&#34;&gt;000000&lt;/span&gt;;
    &lt;span style=&#34;color: #4b69c6&#34;&gt;background-color&lt;/span&gt;: &lt;span style=&#34;color: #b60157&#34;&gt;#&lt;/span&gt;&lt;span style=&#34;color: #b60157&#34;&gt;ffffc0&lt;/span&gt;;
    &lt;span style=&#34;color: #4b69c6&#34;&gt;padding-left&lt;/span&gt;: &lt;span style=&#34;color: #b60157&#34;&gt;5&lt;/span&gt;&lt;span style=&#34;color: #d73948&#34;&gt;px&lt;/span&gt;;
    &lt;span style=&#34;color: #4b69c6&#34;&gt;padding-right&lt;/span&gt;: &lt;span style=&#34;color: #b60157&#34;&gt;5&lt;/span&gt;&lt;span style=&#34;color: #d73948&#34;&gt;px&lt;/span&gt;;
  }
  &lt;span style=&#34;color: #4b69c6&#34;&gt;span&lt;/span&gt;&lt;span style=&#34;color: #8b41b1&#34;&gt;.&lt;/span&gt;&lt;span style=&#34;color: #8b41b1&#34;&gt;linenos&lt;/span&gt;&lt;span style=&#34;color: #8b41b1&#34;&gt;.&lt;/span&gt;&lt;span style=&#34;color: #8b41b1&#34;&gt;special&lt;/span&gt; {
    &lt;span style=&#34;color: #4b69c6&#34;&gt;color&lt;/span&gt;: &lt;span style=&#34;color: #b60157&#34;&gt;#&lt;/span&gt;&lt;span style=&#34;color: #b60157&#34;&gt;000000&lt;/span&gt;;
    &lt;span style=&#34;color: #4b69c6&#34;&gt;background-color&lt;/span&gt;: &lt;span style=&#34;color: #b60157&#34;&gt;#&lt;/span&gt;&lt;span style=&#34;color: #b60157&#34;&gt;ffffc0&lt;/span&gt;;
    &lt;span style=&#34;color: #4b69c6&#34;&gt;padding-left&lt;/span&gt;: &lt;span style=&#34;color: #b60157&#34;&gt;5&lt;/span&gt;&lt;span style=&#34;color: #d73948&#34;&gt;px&lt;/span&gt;;
    &lt;span style=&#34;color: #4b69c6&#34;&gt;padding-right&lt;/span&gt;: &lt;span style=&#34;color: #b60157&#34;&gt;5&lt;/span&gt;&lt;span style=&#34;color: #d73948&#34;&gt;px&lt;/span&gt;;
  }
  &lt;span style=&#34;color: #8b41b1&#34;&gt;.&lt;/span&gt;&lt;span style=&#34;color: #8b41b1&#34;&gt;highlight&lt;/span&gt; &lt;span style=&#34;color: #8b41b1&#34;&gt;.&lt;/span&gt;&lt;span style=&#34;color: #8b41b1&#34;&gt;hll&lt;/span&gt; {
    &lt;span style=&#34;color: #4b69c6&#34;&gt;background-color&lt;/span&gt;: &lt;span style=&#34;color: #b60157&#34;&gt;#&lt;/span&gt;&lt;span style=&#34;color: #b60157&#34;&gt;ffffcc&lt;/span&gt;;
  }
  &lt;span style=&#34;color: #8b41b1&#34;&gt;.&lt;/span&gt;&lt;span style=&#34;color: #8b41b1&#34;&gt;highlight&lt;/span&gt; {
    &lt;span style=&#34;color: #4b69c6&#34;&gt;background&lt;/span&gt;: &lt;span style=&#34;color: #b60157&#34;&gt;#&lt;/span&gt;&lt;span style=&#34;color: #b60157&#34;&gt;ffffff&lt;/span&gt;;
  }
  &lt;span style=&#34;color: #8b41b1&#34;&gt;.&lt;/span&gt;&lt;span style=&#34;color: #8b41b1&#34;&gt;highlight&lt;/span&gt; &lt;span style=&#34;color: #8b41b1&#34;&gt;.&lt;/span&gt;&lt;span style=&#34;color: #8b41b1&#34;&gt;c&lt;/span&gt; {
    &lt;span style=&#34;color: #4b69c6&#34;&gt;color&lt;/span&gt;: &lt;span style=&#34;color: #b60157&#34;&gt;#&lt;/span&gt;&lt;span style=&#34;color: #b60157&#34;&gt;999988&lt;/span&gt;;
    &lt;span style=&#34;color: #4b69c6&#34;&gt;font-style&lt;/span&gt;: &lt;span style=&#34;color: #4b69c6&#34;&gt;italic&lt;/span&gt;;
  } &lt;span style=&#34;color: #74747c&#34;&gt;/*&lt;/span&gt;&lt;span style=&#34;color: #74747c&#34;&gt; Comment &lt;/span&gt;&lt;span style=&#34;color: #74747c&#34;&gt;*/&lt;/span&gt;
  &lt;span style=&#34;color: #8b41b1&#34;&gt;.&lt;/span&gt;&lt;span style=&#34;color: #8b41b1&#34;&gt;highlight&lt;/span&gt; &lt;span style=&#34;color: #8b41b1&#34;&gt;.&lt;/span&gt;&lt;span style=&#34;color: #8b41b1&#34;&gt;err&lt;/span&gt; {
    &lt;span style=&#34;color: #4b69c6&#34;&gt;color&lt;/span&gt;: &lt;span style=&#34;color: #b60157&#34;&gt;#&lt;/span&gt;&lt;span style=&#34;color: #b60157&#34;&gt;a61717&lt;/span&gt;;
    &lt;span style=&#34;color: #4b69c6&#34;&gt;background-color&lt;/span&gt;: &lt;span style=&#34;color: #b60157&#34;&gt;#&lt;/span&gt;&lt;span style=&#34;color: #b60157&#34;&gt;e3d2d2&lt;/span&gt;;
  } &lt;span style=&#34;color: #74747c&#34;&gt;/*&lt;/span&gt;&lt;span style=&#34;color: #74747c&#34;&gt; Error &lt;/span&gt;&lt;span style=&#34;color: #74747c&#34;&gt;*/&lt;/span&gt;
  &lt;span style=&#34;color: #8b41b1&#34;&gt;.&lt;/span&gt;&lt;span style=&#34;color: #8b41b1&#34;&gt;highlight&lt;/span&gt; &lt;span style=&#34;color: #8b41b1&#34;&gt;.&lt;/span&gt;&lt;span style=&#34;color: #8b41b1&#34;&gt;k&lt;/span&gt; {
    &lt;span style=&#34;color: #4b69c6&#34;&gt;font-weight&lt;/span&gt;: &lt;span style=&#34;color: #4b69c6&#34;&gt;bold&lt;/span&gt;;
  } &lt;span style=&#34;color: #74747c&#34;&gt;/*&lt;/span&gt;&lt;span style=&#34;color: #74747c&#34;&gt; Keyword &lt;/span&gt;&lt;span style=&#34;color: #74747c&#34;&gt;*/&lt;/span&gt;
  &lt;span style=&#34;color: #8b41b1&#34;&gt;.&lt;/span&gt;&lt;span style=&#34;color: #8b41b1&#34;&gt;highlight&lt;/span&gt; &lt;span style=&#34;color: #8b41b1&#34;&gt;.&lt;/span&gt;&lt;span style=&#34;color: #8b41b1&#34;&gt;o&lt;/span&gt; {
    &lt;span style=&#34;color: #4b69c6&#34;&gt;font-weight&lt;/span&gt;: &lt;span style=&#34;color: #4b69c6&#34;&gt;bold&lt;/span&gt;;
  } &lt;span style=&#34;color: #74747c&#34;&gt;/*&lt;/span&gt;&lt;span style=&#34;color: #74747c&#34;&gt; Operator &lt;/span&gt;&lt;span style=&#34;color: #74747c&#34;&gt;*/&lt;/span&gt;
  &lt;span style=&#34;color: #8b41b1&#34;&gt;.&lt;/span&gt;&lt;span style=&#34;color: #8b41b1&#34;&gt;highlight&lt;/span&gt; &lt;span style=&#34;color: #8b41b1&#34;&gt;.&lt;/span&gt;&lt;span style=&#34;color: #8b41b1&#34;&gt;ch&lt;/span&gt; {
    &lt;span style=&#34;color: #4b69c6&#34;&gt;color&lt;/span&gt;: &lt;span style=&#34;color: #b60157&#34;&gt;#&lt;/span&gt;&lt;span style=&#34;color: #b60157&#34;&gt;999988&lt;/span&gt;;
    &lt;span style=&#34;color: #4b69c6&#34;&gt;font-style&lt;/span&gt;: &lt;span style=&#34;color: #4b69c6&#34;&gt;italic&lt;/span&gt;;
  } &lt;span style=&#34;color: #74747c&#34;&gt;/*&lt;/span&gt;&lt;span style=&#34;color: #74747c&#34;&gt; Comment.Hashbang &lt;/span&gt;&lt;span style=&#34;color: #74747c&#34;&gt;*/&lt;/span&gt;
  &lt;span style=&#34;color: #8b41b1&#34;&gt;.&lt;/span&gt;&lt;span style=&#34;color: #8b41b1&#34;&gt;highlight&lt;/span&gt; &lt;span style=&#34;color: #8b41b1&#34;&gt;.&lt;/span&gt;&lt;span style=&#34;color: #8b41b1&#34;&gt;cm&lt;/span&gt; {
    &lt;span style=&#34;color: #4b69c6&#34;&gt;color&lt;/span&gt;: &lt;span style=&#34;color: #b60157&#34;&gt;#&lt;/span&gt;&lt;span style=&#34;color: #b60157&#34;&gt;999988&lt;/span&gt;;
    &lt;span style=&#34;color: #4b69c6&#34;&gt;font-style&lt;/span&gt;: &lt;span style=&#34;color: #4b69c6&#34;&gt;italic&lt;/span&gt;;
  } &lt;span style=&#34;color: #74747c&#34;&gt;/*&lt;/span&gt;&lt;span style=&#34;color: #74747c&#34;&gt; Comment.Multiline &lt;/span&gt;&lt;span style=&#34;color: #74747c&#34;&gt;*/&lt;/span&gt;
  &lt;span style=&#34;color: #8b41b1&#34;&gt;.&lt;/span&gt;&lt;span style=&#34;color: #8b41b1&#34;&gt;highlight&lt;/span&gt; &lt;span style=&#34;color: #8b41b1&#34;&gt;.&lt;/span&gt;&lt;span style=&#34;color: #8b41b1&#34;&gt;cp&lt;/span&gt; {
    &lt;span style=&#34;color: #4b69c6&#34;&gt;color&lt;/span&gt;: &lt;span style=&#34;color: #b60157&#34;&gt;#&lt;/span&gt;&lt;span style=&#34;color: #b60157&#34;&gt;999999&lt;/span&gt;;
    &lt;span style=&#34;color: #4b69c6&#34;&gt;font-weight&lt;/span&gt;: &lt;span style=&#34;color: #4b69c6&#34;&gt;bold&lt;/span&gt;;
  } &lt;span style=&#34;color: #74747c&#34;&gt;/*&lt;/span&gt;&lt;span style=&#34;color: #74747c&#34;&gt; Comment.Preproc &lt;/span&gt;&lt;span style=&#34;color: #74747c&#34;&gt;*/&lt;/span&gt;
  &lt;span style=&#34;color: #8b41b1&#34;&gt;.&lt;/span&gt;&lt;span style=&#34;color: #8b41b1&#34;&gt;highlight&lt;/span&gt; &lt;span style=&#34;color: #8b41b1&#34;&gt;.&lt;/span&gt;&lt;span style=&#34;color: #8b41b1&#34;&gt;cpf&lt;/span&gt; {
    &lt;span style=&#34;color: #4b69c6&#34;&gt;color&lt;/span&gt;: &lt;span style=&#34;color: #b60157&#34;&gt;#&lt;/span&gt;&lt;span style=&#34;color: #b60157&#34;&gt;999988&lt;/span&gt;;
    &lt;span style=&#34;color: #4b69c6&#34;&gt;font-style&lt;/span&gt;: &lt;span style=&#34;color: #4b69c6&#34;&gt;italic&lt;/span&gt;;
  } &lt;span style=&#34;color: #74747c&#34;&gt;/*&lt;/span&gt;&lt;span style=&#34;color: #74747c&#34;&gt; Comment.PreprocFile &lt;/span&gt;&lt;span style=&#34;color: #74747c&#34;&gt;*/&lt;/span&gt;
  &lt;span style=&#34;color: #8b41b1&#34;&gt;.&lt;/span&gt;&lt;span style=&#34;color: #8b41b1&#34;&gt;highlight&lt;/span&gt; &lt;span style=&#34;color: #8b41b1&#34;&gt;.&lt;/span&gt;&lt;span style=&#34;color: #8b41b1&#34;&gt;c1&lt;/span&gt; {
    &lt;span style=&#34;color: #4b69c6&#34;&gt;color&lt;/span&gt;: &lt;span style=&#34;color: #b60157&#34;&gt;#&lt;/span&gt;&lt;span style=&#34;color: #b60157&#34;&gt;999988&lt;/span&gt;;
    &lt;span style=&#34;color: #4b69c6&#34;&gt;font-style&lt;/span&gt;: &lt;span style=&#34;color: #4b69c6&#34;&gt;italic&lt;/span&gt;;
  } &lt;span style=&#34;color: #74747c&#34;&gt;/*&lt;/span&gt;&lt;span style=&#34;color: #74747c&#34;&gt; Comment.Single &lt;/span&gt;&lt;span style=&#34;color: #74747c&#34;&gt;*/&lt;/span&gt;
  &lt;span style=&#34;color: #8b41b1&#34;&gt;.&lt;/span&gt;&lt;span style=&#34;color: #8b41b1&#34;&gt;highlight&lt;/span&gt; &lt;span style=&#34;color: #8b41b1&#34;&gt;.&lt;/span&gt;&lt;span style=&#34;color: #8b41b1&#34;&gt;cs&lt;/span&gt; {
    &lt;span style=&#34;color: #4b69c6&#34;&gt;color&lt;/span&gt;: &lt;span style=&#34;color: #b60157&#34;&gt;#&lt;/span&gt;&lt;span style=&#34;color: #b60157&#34;&gt;999999&lt;/span&gt;;
    &lt;span style=&#34;color: #4b69c6&#34;&gt;font-weight&lt;/span&gt;: &lt;span style=&#34;color: #4b69c6&#34;&gt;bold&lt;/span&gt;;
    &lt;span style=&#34;color: #4b69c6&#34;&gt;font-style&lt;/span&gt;: &lt;span style=&#34;color: #4b69c6&#34;&gt;italic&lt;/span&gt;;
  } &lt;span style=&#34;color: #74747c&#34;&gt;/*&lt;/span&gt;&lt;span style=&#34;color: #74747c&#34;&gt; Comment.Special &lt;/span&gt;&lt;span style=&#34;color: #74747c&#34;&gt;*/&lt;/span&gt;
  &lt;span style=&#34;color: #8b41b1&#34;&gt;.&lt;/span&gt;&lt;span style=&#34;color: #8b41b1&#34;&gt;highlight&lt;/span&gt; &lt;span style=&#34;color: #8b41b1&#34;&gt;.&lt;/span&gt;&lt;span style=&#34;color: #8b41b1&#34;&gt;gd&lt;/span&gt; {
    &lt;span style=&#34;color: #4b69c6&#34;&gt;color&lt;/span&gt;: &lt;span style=&#34;color: #b60157&#34;&gt;#&lt;/span&gt;&lt;span style=&#34;color: #b60157&#34;&gt;000000&lt;/span&gt;;
    &lt;span style=&#34;color: #4b69c6&#34;&gt;background-color&lt;/span&gt;: &lt;span style=&#34;color: #b60157&#34;&gt;#&lt;/span&gt;&lt;span style=&#34;color: #b60157&#34;&gt;ffdddd&lt;/span&gt;;
  } &lt;span style=&#34;color: #74747c&#34;&gt;/*&lt;/span&gt;&lt;span style=&#34;color: #74747c&#34;&gt; Generic.Deleted &lt;/span&gt;&lt;span style=&#34;color: #74747c&#34;&gt;*/&lt;/span&gt;
  &lt;span style=&#34;color: #8b41b1&#34;&gt;.&lt;/span&gt;&lt;span style=&#34;color: #8b41b1&#34;&gt;highlight&lt;/span&gt; &lt;span style=&#34;color: #8b41b1&#34;&gt;.&lt;/span&gt;&lt;span style=&#34;color: #8b41b1&#34;&gt;ge&lt;/span&gt; {
    &lt;span style=&#34;color: #4b69c6&#34;&gt;font-style&lt;/span&gt;: &lt;span style=&#34;color: #4b69c6&#34;&gt;italic&lt;/span&gt;;
  } &lt;span style=&#34;color: #74747c&#34;&gt;/*&lt;/span&gt;&lt;span style=&#34;color: #74747c&#34;&gt; Generic.Emph &lt;/span&gt;&lt;span style=&#34;color: #74747c&#34;&gt;*/&lt;/span&gt;
  &lt;span style=&#34;color: #8b41b1&#34;&gt;.&lt;/span&gt;&lt;span style=&#34;color: #8b41b1&#34;&gt;highlight&lt;/span&gt; &lt;span style=&#34;color: #8b41b1&#34;&gt;.&lt;/span&gt;&lt;span style=&#34;color: #8b41b1&#34;&gt;ges&lt;/span&gt; {
    &lt;span style=&#34;color: #4b69c6&#34;&gt;font-weight&lt;/span&gt;: &lt;span style=&#34;color: #4b69c6&#34;&gt;bold&lt;/span&gt;;
    &lt;span style=&#34;color: #4b69c6&#34;&gt;font-style&lt;/span&gt;: &lt;span style=&#34;color: #4b69c6&#34;&gt;italic&lt;/span&gt;;
  } &lt;span style=&#34;color: #74747c&#34;&gt;/*&lt;/span&gt;&lt;span style=&#34;color: #74747c&#34;&gt; Generic.EmphStrong &lt;/span&gt;&lt;span style=&#34;color: #74747c&#34;&gt;*/&lt;/span&gt;
  &lt;span style=&#34;color: #8b41b1&#34;&gt;.&lt;/span&gt;&lt;span style=&#34;color: #8b41b1&#34;&gt;highlight&lt;/span&gt; &lt;span style=&#34;color: #8b41b1&#34;&gt;.&lt;/span&gt;&lt;span style=&#34;color: #8b41b1&#34;&gt;gr&lt;/span&gt; {
    &lt;span style=&#34;color: #4b69c6&#34;&gt;color&lt;/span&gt;: &lt;span style=&#34;color: #b60157&#34;&gt;#&lt;/span&gt;&lt;span style=&#34;color: #b60157&#34;&gt;aa0000&lt;/span&gt;;
  } &lt;span style=&#34;color: #74747c&#34;&gt;/*&lt;/span&gt;&lt;span style=&#34;color: #74747c&#34;&gt; Generic.Error &lt;/span&gt;&lt;span style=&#34;color: #74747c&#34;&gt;*/&lt;/span&gt;
  &lt;span style=&#34;color: #8b41b1&#34;&gt;.&lt;/span&gt;&lt;span style=&#34;color: #8b41b1&#34;&gt;highlight&lt;/span&gt; &lt;span style=&#34;color: #8b41b1&#34;&gt;.&lt;/span&gt;&lt;span style=&#34;color: #8b41b1&#34;&gt;gh&lt;/span&gt; {
    &lt;span style=&#34;color: #4b69c6&#34;&gt;color&lt;/span&gt;: &lt;span style=&#34;color: #b60157&#34;&gt;#&lt;/span&gt;&lt;span style=&#34;color: #b60157&#34;&gt;999999&lt;/span&gt;;
  } &lt;span style=&#34;color: #74747c&#34;&gt;/*&lt;/span&gt;&lt;span style=&#34;color: #74747c&#34;&gt; Generic.Heading &lt;/span&gt;&lt;span style=&#34;color: #74747c&#34;&gt;*/&lt;/span&gt;
  &lt;span style=&#34;color: #8b41b1&#34;&gt;.&lt;/span&gt;&lt;span style=&#34;color: #8b41b1&#34;&gt;highlight&lt;/span&gt; &lt;span style=&#34;color: #8b41b1&#34;&gt;.&lt;/span&gt;&lt;span style=&#34;color: #8b41b1&#34;&gt;gi&lt;/span&gt; {
    &lt;span style=&#34;color: #4b69c6&#34;&gt;color&lt;/span&gt;: &lt;span style=&#34;color: #b60157&#34;&gt;#&lt;/span&gt;&lt;span style=&#34;color: #b60157&#34;&gt;000000&lt;/span&gt;;
    &lt;span style=&#34;color: #4b69c6&#34;&gt;background-color&lt;/span&gt;: &lt;span style=&#34;color: #b60157&#34;&gt;#&lt;/span&gt;&lt;span style=&#34;color: #b60157&#34;&gt;ddffdd&lt;/span&gt;;
  } &lt;span style=&#34;color: #74747c&#34;&gt;/*&lt;/span&gt;&lt;span style=&#34;color: #74747c&#34;&gt; Generic.Inserted &lt;/span&gt;&lt;span style=&#34;color: #74747c&#34;&gt;*/&lt;/span&gt;
  &lt;span style=&#34;color: #8b41b1&#34;&gt;.&lt;/span&gt;&lt;span style=&#34;color: #8b41b1&#34;&gt;highlight&lt;/span&gt; &lt;span style=&#34;color: #8b41b1&#34;&gt;.&lt;/span&gt;&lt;span style=&#34;color: #8b41b1&#34;&gt;go&lt;/span&gt; {
    &lt;span style=&#34;color: #4b69c6&#34;&gt;color&lt;/span&gt;: &lt;span style=&#34;color: #b60157&#34;&gt;#&lt;/span&gt;&lt;span style=&#34;color: #b60157&#34;&gt;888888&lt;/span&gt;;
  } &lt;span style=&#34;color: #74747c&#34;&gt;/*&lt;/span&gt;&lt;span style=&#34;color: #74747c&#34;&gt; Generic.Output &lt;/span&gt;&lt;span style=&#34;color: #74747c&#34;&gt;*/&lt;/span&gt;
  &lt;span style=&#34;color: #8b41b1&#34;&gt;.&lt;/span&gt;&lt;span style=&#34;color: #8b41b1&#34;&gt;highlight&lt;/span&gt; &lt;span style=&#34;color: #8b41b1&#34;&gt;.&lt;/span&gt;&lt;span style=&#34;color: #8b41b1&#34;&gt;gp&lt;/span&gt; {
    &lt;span style=&#34;color: #4b69c6&#34;&gt;color&lt;/span&gt;: &lt;span style=&#34;color: #b60157&#34;&gt;#&lt;/span&gt;&lt;span style=&#34;color: #b60157&#34;&gt;555555&lt;/span&gt;;
  } &lt;span style=&#34;color: #74747c&#34;&gt;/*&lt;/span&gt;&lt;span style=&#34;color: #74747c&#34;&gt; Generic.Prompt &lt;/span&gt;&lt;span style=&#34;color: #74747c&#34;&gt;*/&lt;/span&gt;
  &lt;span style=&#34;color: #8b41b1&#34;&gt;.&lt;/span&gt;&lt;span style=&#34;color: #8b41b1&#34;&gt;highlight&lt;/span&gt; &lt;span style=&#34;color: #8b41b1&#34;&gt;.&lt;/span&gt;&lt;span style=&#34;color: #8b41b1&#34;&gt;gs&lt;/span&gt; {
    &lt;span style=&#34;color: #4b69c6&#34;&gt;font-weight&lt;/span&gt;: &lt;span style=&#34;color: #4b69c6&#34;&gt;bold&lt;/span&gt;;
  } &lt;span style=&#34;color: #74747c&#34;&gt;/*&lt;/span&gt;&lt;span style=&#34;color: #74747c&#34;&gt; Generic.Strong &lt;/span&gt;&lt;span style=&#34;color: #74747c&#34;&gt;*/&lt;/span&gt;
  &lt;span style=&#34;color: #8b41b1&#34;&gt;.&lt;/span&gt;&lt;span style=&#34;color: #8b41b1&#34;&gt;highlight&lt;/span&gt; &lt;span style=&#34;color: #8b41b1&#34;&gt;.&lt;/span&gt;&lt;span style=&#34;color: #8b41b1&#34;&gt;gu&lt;/span&gt; {
    &lt;span style=&#34;color: #4b69c6&#34;&gt;color&lt;/span&gt;: &lt;span style=&#34;color: #b60157&#34;&gt;#&lt;/span&gt;&lt;span style=&#34;color: #b60157&#34;&gt;aaaaaa&lt;/span&gt;;
  } &lt;span style=&#34;color: #74747c&#34;&gt;/*&lt;/span&gt;&lt;span style=&#34;color: #74747c&#34;&gt; Generic.Subheading &lt;/span&gt;&lt;span style=&#34;color: #74747c&#34;&gt;*/&lt;/span&gt;
  &lt;span style=&#34;color: #8b41b1&#34;&gt;.&lt;/span&gt;&lt;span style=&#34;color: #8b41b1&#34;&gt;highlight&lt;/span&gt; &lt;span style=&#34;color: #8b41b1&#34;&gt;.&lt;/span&gt;&lt;span style=&#34;color: #8b41b1&#34;&gt;gt&lt;/span&gt; {
    &lt;span style=&#34;color: #4b69c6&#34;&gt;color&lt;/span&gt;: &lt;span style=&#34;color: #b60157&#34;&gt;#&lt;/span&gt;&lt;span style=&#34;color: #b60157&#34;&gt;aa0000&lt;/span&gt;;
  } &lt;span style=&#34;color: #74747c&#34;&gt;/*&lt;/span&gt;&lt;span style=&#34;color: #74747c&#34;&gt; Generic.Traceback &lt;/span&gt;&lt;span style=&#34;color: #74747c&#34;&gt;*/&lt;/span&gt;
  &lt;span style=&#34;color: #8b41b1&#34;&gt;.&lt;/span&gt;&lt;span style=&#34;color: #8b41b1&#34;&gt;highlight&lt;/span&gt; &lt;span style=&#34;color: #8b41b1&#34;&gt;.&lt;/span&gt;&lt;span style=&#34;color: #8b41b1&#34;&gt;kc&lt;/span&gt; {
    &lt;span style=&#34;color: #4b69c6&#34;&gt;font-weight&lt;/span&gt;: &lt;span style=&#34;color: #4b69c6&#34;&gt;bold&lt;/span&gt;;
  } &lt;span style=&#34;color: #74747c&#34;&gt;/*&lt;/span&gt;&lt;span style=&#34;color: #74747c&#34;&gt; Keyword.Constant &lt;/span&gt;&lt;span style=&#34;color: #74747c&#34;&gt;*/&lt;/span&gt;
  &lt;span style=&#34;color: #8b41b1&#34;&gt;.&lt;/span&gt;&lt;span style=&#34;color: #8b41b1&#34;&gt;highlight&lt;/span&gt; &lt;span style=&#34;color: #8b41b1&#34;&gt;.&lt;/span&gt;&lt;span style=&#34;color: #8b41b1&#34;&gt;kd&lt;/span&gt; {
    &lt;span style=&#34;color: #4b69c6&#34;&gt;font-weight&lt;/span&gt;: &lt;span style=&#34;color: #4b69c6&#34;&gt;bold&lt;/span&gt;;
  } &lt;span style=&#34;color: #74747c&#34;&gt;/*&lt;/span&gt;&lt;span style=&#34;color: #74747c&#34;&gt; Keyword.Declaration &lt;/span&gt;&lt;span style=&#34;color: #74747c&#34;&gt;*/&lt;/span&gt;
  &lt;span style=&#34;color: #8b41b1&#34;&gt;.&lt;/span&gt;&lt;span style=&#34;color: #8b41b1&#34;&gt;highlight&lt;/span&gt; &lt;span style=&#34;color: #8b41b1&#34;&gt;.&lt;/span&gt;&lt;span style=&#34;color: #8b41b1&#34;&gt;kn&lt;/span&gt; {
    &lt;span style=&#34;color: #4b69c6&#34;&gt;font-weight&lt;/span&gt;: &lt;span style=&#34;color: #4b69c6&#34;&gt;bold&lt;/span&gt;;
  } &lt;span style=&#34;color: #74747c&#34;&gt;/*&lt;/span&gt;&lt;span style=&#34;color: #74747c&#34;&gt; Keyword.Namespace &lt;/span&gt;&lt;span style=&#34;color: #74747c&#34;&gt;*/&lt;/span&gt;
  &lt;span style=&#34;color: #8b41b1&#34;&gt;.&lt;/span&gt;&lt;span style=&#34;color: #8b41b1&#34;&gt;highlight&lt;/span&gt; &lt;span style=&#34;color: #8b41b1&#34;&gt;.&lt;/span&gt;&lt;span style=&#34;color: #8b41b1&#34;&gt;kp&lt;/span&gt; {
    &lt;span style=&#34;color: #4b69c6&#34;&gt;font-weight&lt;/span&gt;: &lt;span style=&#34;color: #4b69c6&#34;&gt;bold&lt;/span&gt;;
  } &lt;span style=&#34;color: #74747c&#34;&gt;/*&lt;/span&gt;&lt;span style=&#34;color: #74747c&#34;&gt; Keyword.Pseudo &lt;/span&gt;&lt;span style=&#34;color: #74747c&#34;&gt;*/&lt;/span&gt;
  &lt;span style=&#34;color: #8b41b1&#34;&gt;.&lt;/span&gt;&lt;span style=&#34;color: #8b41b1&#34;&gt;highlight&lt;/span&gt; &lt;span style=&#34;color: #8b41b1&#34;&gt;.&lt;/span&gt;&lt;span style=&#34;color: #8b41b1&#34;&gt;kr&lt;/span&gt; {
    &lt;span style=&#34;color: #4b69c6&#34;&gt;font-weight&lt;/span&gt;: &lt;span style=&#34;color: #4b69c6&#34;&gt;bold&lt;/span&gt;;
  } &lt;span style=&#34;color: #74747c&#34;&gt;/*&lt;/span&gt;&lt;span style=&#34;color: #74747c&#34;&gt; Keyword.Reserved &lt;/span&gt;&lt;span style=&#34;color: #74747c&#34;&gt;*/&lt;/span&gt;
  &lt;span style=&#34;color: #8b41b1&#34;&gt;.&lt;/span&gt;&lt;span style=&#34;color: #8b41b1&#34;&gt;highlight&lt;/span&gt; &lt;span style=&#34;color: #8b41b1&#34;&gt;.&lt;/span&gt;&lt;span style=&#34;color: #8b41b1&#34;&gt;kt&lt;/span&gt; {
    &lt;span style=&#34;color: #4b69c6&#34;&gt;color&lt;/span&gt;: &lt;span style=&#34;color: #b60157&#34;&gt;#&lt;/span&gt;&lt;span style=&#34;color: #b60157&#34;&gt;445588&lt;/span&gt;;
    &lt;span style=&#34;color: #4b69c6&#34;&gt;font-weight&lt;/span&gt;: &lt;span style=&#34;color: #4b69c6&#34;&gt;bold&lt;/span&gt;;
  } &lt;span style=&#34;color: #74747c&#34;&gt;/*&lt;/span&gt;&lt;span style=&#34;color: #74747c&#34;&gt; Keyword.Type &lt;/span&gt;&lt;span style=&#34;color: #74747c&#34;&gt;*/&lt;/span&gt;
  &lt;span style=&#34;color: #8b41b1&#34;&gt;.&lt;/span&gt;&lt;span style=&#34;color: #8b41b1&#34;&gt;highlight&lt;/span&gt; &lt;span style=&#34;color: #8b41b1&#34;&gt;.&lt;/span&gt;&lt;span style=&#34;color: #8b41b1&#34;&gt;m&lt;/span&gt; {
    &lt;span style=&#34;color: #4b69c6&#34;&gt;color&lt;/span&gt;: &lt;span style=&#34;color: #b60157&#34;&gt;#&lt;/span&gt;&lt;span style=&#34;color: #b60157&#34;&gt;009999&lt;/span&gt;;
  } &lt;span style=&#34;color: #74747c&#34;&gt;/*&lt;/span&gt;&lt;span style=&#34;color: #74747c&#34;&gt; Literal.Number &lt;/span&gt;&lt;span style=&#34;color: #74747c&#34;&gt;*/&lt;/span&gt;
  &lt;span style=&#34;color: #8b41b1&#34;&gt;.&lt;/span&gt;&lt;span style=&#34;color: #8b41b1&#34;&gt;highlight&lt;/span&gt; &lt;span style=&#34;color: #8b41b1&#34;&gt;.&lt;/span&gt;&lt;span style=&#34;color: #8b41b1&#34;&gt;s&lt;/span&gt; {
    &lt;span style=&#34;color: #4b69c6&#34;&gt;color&lt;/span&gt;: &lt;span style=&#34;color: #b60157&#34;&gt;#&lt;/span&gt;&lt;span style=&#34;color: #b60157&#34;&gt;bb8844&lt;/span&gt;;
  } &lt;span style=&#34;color: #74747c&#34;&gt;/*&lt;/span&gt;&lt;span style=&#34;color: #74747c&#34;&gt; Literal.String &lt;/span&gt;&lt;span style=&#34;color: #74747c&#34;&gt;*/&lt;/span&gt;
  &lt;span style=&#34;color: #8b41b1&#34;&gt;.&lt;/span&gt;&lt;span style=&#34;color: #8b41b1&#34;&gt;highlight&lt;/span&gt; &lt;span style=&#34;color: #8b41b1&#34;&gt;.&lt;/span&gt;&lt;span style=&#34;color: #8b41b1&#34;&gt;na&lt;/span&gt; {
    &lt;span style=&#34;color: #4b69c6&#34;&gt;color&lt;/span&gt;: &lt;span style=&#34;color: #b60157&#34;&gt;#&lt;/span&gt;&lt;span style=&#34;color: #b60157&#34;&gt;008080&lt;/span&gt;;
  } &lt;span style=&#34;color: #74747c&#34;&gt;/*&lt;/span&gt;&lt;span style=&#34;color: #74747c&#34;&gt; Name.Attribute &lt;/span&gt;&lt;span style=&#34;color: #74747c&#34;&gt;*/&lt;/span&gt;
  &lt;span style=&#34;color: #8b41b1&#34;&gt;.&lt;/span&gt;&lt;span style=&#34;color: #8b41b1&#34;&gt;highlight&lt;/span&gt; &lt;span style=&#34;color: #8b41b1&#34;&gt;.&lt;/span&gt;&lt;span style=&#34;color: #8b41b1&#34;&gt;nb&lt;/span&gt; {
    &lt;span style=&#34;color: #4b69c6&#34;&gt;color&lt;/span&gt;: &lt;span style=&#34;color: #b60157&#34;&gt;#&lt;/span&gt;&lt;span style=&#34;color: #b60157&#34;&gt;999999&lt;/span&gt;;
  } &lt;span style=&#34;color: #74747c&#34;&gt;/*&lt;/span&gt;&lt;span style=&#34;color: #74747c&#34;&gt; Name.Builtin &lt;/span&gt;&lt;span style=&#34;color: #74747c&#34;&gt;*/&lt;/span&gt;
  &lt;span style=&#34;color: #8b41b1&#34;&gt;.&lt;/span&gt;&lt;span style=&#34;color: #8b41b1&#34;&gt;highlight&lt;/span&gt; &lt;span style=&#34;color: #8b41b1&#34;&gt;.&lt;/span&gt;&lt;span style=&#34;color: #8b41b1&#34;&gt;nc&lt;/span&gt; {
    &lt;span style=&#34;color: #4b69c6&#34;&gt;color&lt;/span&gt;: &lt;span style=&#34;color: #b60157&#34;&gt;#&lt;/span&gt;&lt;span style=&#34;color: #b60157&#34;&gt;445588&lt;/span&gt;;
    &lt;span style=&#34;color: #4b69c6&#34;&gt;font-weight&lt;/span&gt;: &lt;span style=&#34;color: #4b69c6&#34;&gt;bold&lt;/span&gt;;
  } &lt;span style=&#34;color: #74747c&#34;&gt;/*&lt;/span&gt;&lt;span style=&#34;color: #74747c&#34;&gt; Name.Class &lt;/span&gt;&lt;span style=&#34;color: #74747c&#34;&gt;*/&lt;/span&gt;
  &lt;span style=&#34;color: #8b41b1&#34;&gt;.&lt;/span&gt;&lt;span style=&#34;color: #8b41b1&#34;&gt;highlight&lt;/span&gt; &lt;span style=&#34;color: #8b41b1&#34;&gt;.&lt;/span&gt;&lt;span style=&#34;color: #8b41b1&#34;&gt;no&lt;/span&gt; {
    &lt;span style=&#34;color: #4b69c6&#34;&gt;color&lt;/span&gt;: &lt;span style=&#34;color: #b60157&#34;&gt;#&lt;/span&gt;&lt;span style=&#34;color: #b60157&#34;&gt;008080&lt;/span&gt;;
  } &lt;span style=&#34;color: #74747c&#34;&gt;/*&lt;/span&gt;&lt;span style=&#34;color: #74747c&#34;&gt; Name.Constant &lt;/span&gt;&lt;span style=&#34;color: #74747c&#34;&gt;*/&lt;/span&gt;
  &lt;span style=&#34;color: #8b41b1&#34;&gt;.&lt;/span&gt;&lt;span style=&#34;color: #8b41b1&#34;&gt;highlight&lt;/span&gt; &lt;span style=&#34;color: #8b41b1&#34;&gt;.&lt;/span&gt;&lt;span style=&#34;color: #8b41b1&#34;&gt;ni&lt;/span&gt; {
    &lt;span style=&#34;color: #4b69c6&#34;&gt;color&lt;/span&gt;: &lt;span style=&#34;color: #b60157&#34;&gt;#&lt;/span&gt;&lt;span style=&#34;color: #b60157&#34;&gt;800080&lt;/span&gt;;
  } &lt;span style=&#34;color: #74747c&#34;&gt;/*&lt;/span&gt;&lt;span style=&#34;color: #74747c&#34;&gt; Name.Entity &lt;/span&gt;&lt;span style=&#34;color: #74747c&#34;&gt;*/&lt;/span&gt;
  &lt;span style=&#34;color: #8b41b1&#34;&gt;.&lt;/span&gt;&lt;span style=&#34;color: #8b41b1&#34;&gt;highlight&lt;/span&gt; &lt;span style=&#34;color: #8b41b1&#34;&gt;.&lt;/span&gt;&lt;span style=&#34;color: #8b41b1&#34;&gt;ne&lt;/span&gt; {
    &lt;span style=&#34;color: #4b69c6&#34;&gt;color&lt;/span&gt;: &lt;span style=&#34;color: #b60157&#34;&gt;#&lt;/span&gt;&lt;span style=&#34;color: #b60157&#34;&gt;990000&lt;/span&gt;;
    &lt;span style=&#34;color: #4b69c6&#34;&gt;font-weight&lt;/span&gt;: &lt;span style=&#34;color: #4b69c6&#34;&gt;bold&lt;/span&gt;;
  } &lt;span style=&#34;color: #74747c&#34;&gt;/*&lt;/span&gt;&lt;span style=&#34;color: #74747c&#34;&gt; Name.Exception &lt;/span&gt;&lt;span style=&#34;color: #74747c&#34;&gt;*/&lt;/span&gt;
  &lt;span style=&#34;color: #8b41b1&#34;&gt;.&lt;/span&gt;&lt;span style=&#34;color: #8b41b1&#34;&gt;highlight&lt;/span&gt; &lt;span style=&#34;color: #8b41b1&#34;&gt;.&lt;/span&gt;&lt;span style=&#34;color: #8b41b1&#34;&gt;nf&lt;/span&gt; {
    &lt;span style=&#34;color: #4b69c6&#34;&gt;color&lt;/span&gt;: &lt;span style=&#34;color: #b60157&#34;&gt;#&lt;/span&gt;&lt;span style=&#34;color: #b60157&#34;&gt;990000&lt;/span&gt;;
    &lt;span style=&#34;color: #4b69c6&#34;&gt;font-weight&lt;/span&gt;: &lt;span style=&#34;color: #4b69c6&#34;&gt;bold&lt;/span&gt;;
  } &lt;span style=&#34;color: #74747c&#34;&gt;/*&lt;/span&gt;&lt;span style=&#34;color: #74747c&#34;&gt; Name.Function &lt;/span&gt;&lt;span style=&#34;color: #74747c&#34;&gt;*/&lt;/span&gt;
  &lt;span style=&#34;color: #8b41b1&#34;&gt;.&lt;/span&gt;&lt;span style=&#34;color: #8b41b1&#34;&gt;highlight&lt;/span&gt; &lt;span style=&#34;color: #8b41b1&#34;&gt;.&lt;/span&gt;&lt;span style=&#34;color: #8b41b1&#34;&gt;nn&lt;/span&gt; {
    &lt;span style=&#34;color: #4b69c6&#34;&gt;color&lt;/span&gt;: &lt;span style=&#34;color: #b60157&#34;&gt;#&lt;/span&gt;&lt;span style=&#34;color: #b60157&#34;&gt;555555&lt;/span&gt;;
  } &lt;span style=&#34;color: #74747c&#34;&gt;/*&lt;/span&gt;&lt;span style=&#34;color: #74747c&#34;&gt; Name.Namespace &lt;/span&gt;&lt;span style=&#34;color: #74747c&#34;&gt;*/&lt;/span&gt;
  &lt;span style=&#34;color: #8b41b1&#34;&gt;.&lt;/span&gt;&lt;span style=&#34;color: #8b41b1&#34;&gt;highlight&lt;/span&gt; &lt;span style=&#34;color: #8b41b1&#34;&gt;.&lt;/span&gt;&lt;span style=&#34;color: #8b41b1&#34;&gt;nt&lt;/span&gt; {
    &lt;span style=&#34;color: #4b69c6&#34;&gt;color&lt;/span&gt;: &lt;span style=&#34;color: #b60157&#34;&gt;#&lt;/span&gt;&lt;span style=&#34;color: #b60157&#34;&gt;000080&lt;/span&gt;;
  } &lt;span style=&#34;color: #74747c&#34;&gt;/*&lt;/span&gt;&lt;span style=&#34;color: #74747c&#34;&gt; Name.Tag &lt;/span&gt;&lt;span style=&#34;color: #74747c&#34;&gt;*/&lt;/span&gt;
  &lt;span style=&#34;color: #8b41b1&#34;&gt;.&lt;/span&gt;&lt;span style=&#34;color: #8b41b1&#34;&gt;highlight&lt;/span&gt; &lt;span style=&#34;color: #8b41b1&#34;&gt;.&lt;/span&gt;&lt;span style=&#34;color: #8b41b1&#34;&gt;nv&lt;/span&gt; {
    &lt;span style=&#34;color: #4b69c6&#34;&gt;color&lt;/span&gt;: &lt;span style=&#34;color: #b60157&#34;&gt;#&lt;/span&gt;&lt;span style=&#34;color: #b60157&#34;&gt;008080&lt;/span&gt;;
  } &lt;span style=&#34;color: #74747c&#34;&gt;/*&lt;/span&gt;&lt;span style=&#34;color: #74747c&#34;&gt; Name.Variable &lt;/span&gt;&lt;span style=&#34;color: #74747c&#34;&gt;*/&lt;/span&gt;
  &lt;span style=&#34;color: #8b41b1&#34;&gt;.&lt;/span&gt;&lt;span style=&#34;color: #8b41b1&#34;&gt;highlight&lt;/span&gt; &lt;span style=&#34;color: #8b41b1&#34;&gt;.&lt;/span&gt;&lt;span style=&#34;color: #8b41b1&#34;&gt;ow&lt;/span&gt; {
    &lt;span style=&#34;color: #4b69c6&#34;&gt;font-weight&lt;/span&gt;: &lt;span style=&#34;color: #4b69c6&#34;&gt;bold&lt;/span&gt;;
  } &lt;span style=&#34;color: #74747c&#34;&gt;/*&lt;/span&gt;&lt;span style=&#34;color: #74747c&#34;&gt; Operator.Word &lt;/span&gt;&lt;span style=&#34;color: #74747c&#34;&gt;*/&lt;/span&gt;
  &lt;span style=&#34;color: #8b41b1&#34;&gt;.&lt;/span&gt;&lt;span style=&#34;color: #8b41b1&#34;&gt;highlight&lt;/span&gt; &lt;span style=&#34;color: #8b41b1&#34;&gt;.&lt;/span&gt;&lt;span style=&#34;color: #8b41b1&#34;&gt;w&lt;/span&gt; {
    &lt;span style=&#34;color: #4b69c6&#34;&gt;color&lt;/span&gt;: &lt;span style=&#34;color: #b60157&#34;&gt;#&lt;/span&gt;&lt;span style=&#34;color: #b60157&#34;&gt;bbbbbb&lt;/span&gt;;
  } &lt;span style=&#34;color: #74747c&#34;&gt;/*&lt;/span&gt;&lt;span style=&#34;color: #74747c&#34;&gt; Text.Whitespace &lt;/span&gt;&lt;span style=&#34;color: #74747c&#34;&gt;*/&lt;/span&gt;
  &lt;span style=&#34;color: #8b41b1&#34;&gt;.&lt;/span&gt;&lt;span style=&#34;color: #8b41b1&#34;&gt;highlight&lt;/span&gt; &lt;span style=&#34;color: #8b41b1&#34;&gt;.&lt;/span&gt;&lt;span style=&#34;color: #8b41b1&#34;&gt;mb&lt;/span&gt; {
    &lt;span style=&#34;color: #4b69c6&#34;&gt;color&lt;/span&gt;: &lt;span style=&#34;color: #b60157&#34;&gt;#&lt;/span&gt;&lt;span style=&#34;color: #b60157&#34;&gt;009999&lt;/span&gt;;
  } &lt;span style=&#34;color: #74747c&#34;&gt;/*&lt;/span&gt;&lt;span style=&#34;color: #74747c&#34;&gt; Literal.Number.Bin &lt;/span&gt;&lt;span style=&#34;color: #74747c&#34;&gt;*/&lt;/span&gt;
  &lt;span style=&#34;color: #8b41b1&#34;&gt;.&lt;/span&gt;&lt;span style=&#34;color: #8b41b1&#34;&gt;highlight&lt;/span&gt; &lt;span style=&#34;color: #8b41b1&#34;&gt;.&lt;/span&gt;&lt;span style=&#34;color: #8b41b1&#34;&gt;mf&lt;/span&gt; {
    &lt;span style=&#34;color: #4b69c6&#34;&gt;color&lt;/span&gt;: &lt;span style=&#34;color: #b60157&#34;&gt;#&lt;/span&gt;&lt;span style=&#34;color: #b60157&#34;&gt;009999&lt;/span&gt;;
  } &lt;span style=&#34;color: #74747c&#34;&gt;/*&lt;/span&gt;&lt;span style=&#34;color: #74747c&#34;&gt; Literal.Number.Float &lt;/span&gt;&lt;span style=&#34;color: #74747c&#34;&gt;*/&lt;/span&gt;
  &lt;span style=&#34;color: #8b41b1&#34;&gt;.&lt;/span&gt;&lt;span style=&#34;color: #8b41b1&#34;&gt;highlight&lt;/span&gt; &lt;span style=&#34;color: #8b41b1&#34;&gt;.&lt;/span&gt;&lt;span style=&#34;color: #8b41b1&#34;&gt;mh&lt;/span&gt; {
    &lt;span style=&#34;color: #4b69c6&#34;&gt;color&lt;/span&gt;: &lt;span style=&#34;color: #b60157&#34;&gt;#&lt;/span&gt;&lt;span style=&#34;color: #b60157&#34;&gt;009999&lt;/span&gt;;
  } &lt;span style=&#34;color: #74747c&#34;&gt;/*&lt;/span&gt;&lt;span style=&#34;color: #74747c&#34;&gt; Literal.Number.Hex &lt;/span&gt;&lt;span style=&#34;color: #74747c&#34;&gt;*/&lt;/span&gt;
  &lt;span style=&#34;color: #8b41b1&#34;&gt;.&lt;/span&gt;&lt;span style=&#34;color: #8b41b1&#34;&gt;highlight&lt;/span&gt; &lt;span style=&#34;color: #8b41b1&#34;&gt;.&lt;/span&gt;&lt;span style=&#34;color: #8b41b1&#34;&gt;mi&lt;/span&gt; {
    &lt;span style=&#34;color: #4b69c6&#34;&gt;color&lt;/span&gt;: &lt;span style=&#34;color: #b60157&#34;&gt;#&lt;/span&gt;&lt;span style=&#34;color: #b60157&#34;&gt;009999&lt;/span&gt;;
  } &lt;span style=&#34;color: #74747c&#34;&gt;/*&lt;/span&gt;&lt;span style=&#34;color: #74747c&#34;&gt; Literal.Number.Integer &lt;/span&gt;&lt;span style=&#34;color: #74747c&#34;&gt;*/&lt;/span&gt;
  &lt;span style=&#34;color: #8b41b1&#34;&gt;.&lt;/span&gt;&lt;span style=&#34;color: #8b41b1&#34;&gt;highlight&lt;/span&gt; &lt;span style=&#34;color: #8b41b1&#34;&gt;.&lt;/span&gt;&lt;span style=&#34;color: #8b41b1&#34;&gt;mo&lt;/span&gt; {
    &lt;span style=&#34;color: #4b69c6&#34;&gt;color&lt;/span&gt;: &lt;span style=&#34;color: #b60157&#34;&gt;#&lt;/span&gt;&lt;span style=&#34;color: #b60157&#34;&gt;009999&lt;/span&gt;;
  } &lt;span style=&#34;color: #74747c&#34;&gt;/*&lt;/span&gt;&lt;span style=&#34;color: #74747c&#34;&gt; Literal.Number.Oct &lt;/span&gt;&lt;span style=&#34;color: #74747c&#34;&gt;*/&lt;/span&gt;
  &lt;span style=&#34;color: #8b41b1&#34;&gt;.&lt;/span&gt;&lt;span style=&#34;color: #8b41b1&#34;&gt;highlight&lt;/span&gt; &lt;span style=&#34;color: #8b41b1&#34;&gt;.&lt;/span&gt;&lt;span style=&#34;color: #8b41b1&#34;&gt;sa&lt;/span&gt; {
    &lt;span style=&#34;color: #4b69c6&#34;&gt;color&lt;/span&gt;: &lt;span style=&#34;color: #b60157&#34;&gt;#&lt;/span&gt;&lt;span style=&#34;color: #b60157&#34;&gt;bb8844&lt;/span&gt;;
  } &lt;span style=&#34;color: #74747c&#34;&gt;/*&lt;/span&gt;&lt;span style=&#34;color: #74747c&#34;&gt; Literal.String.Affix &lt;/span&gt;&lt;span style=&#34;color: #74747c&#34;&gt;*/&lt;/span&gt;
  &lt;span style=&#34;color: #8b41b1&#34;&gt;.&lt;/span&gt;&lt;span style=&#34;color: #8b41b1&#34;&gt;highlight&lt;/span&gt; &lt;span style=&#34;color: #8b41b1&#34;&gt;.&lt;/span&gt;&lt;span style=&#34;color: #8b41b1&#34;&gt;sb&lt;/span&gt; {
    &lt;span style=&#34;color: #4b69c6&#34;&gt;color&lt;/span&gt;: &lt;span style=&#34;color: #b60157&#34;&gt;#&lt;/span&gt;&lt;span style=&#34;color: #b60157&#34;&gt;bb8844&lt;/span&gt;;
  } &lt;span style=&#34;color: #74747c&#34;&gt;/*&lt;/span&gt;&lt;span style=&#34;color: #74747c&#34;&gt; Literal.String.Backtick &lt;/span&gt;&lt;span style=&#34;color: #74747c&#34;&gt;*/&lt;/span&gt;
  &lt;span style=&#34;color: #8b41b1&#34;&gt;.&lt;/span&gt;&lt;span style=&#34;color: #8b41b1&#34;&gt;highlight&lt;/span&gt; &lt;span style=&#34;color: #8b41b1&#34;&gt;.&lt;/span&gt;&lt;span style=&#34;color: #8b41b1&#34;&gt;sc&lt;/span&gt; {
    &lt;span style=&#34;color: #4b69c6&#34;&gt;color&lt;/span&gt;: &lt;span style=&#34;color: #b60157&#34;&gt;#&lt;/span&gt;&lt;span style=&#34;color: #b60157&#34;&gt;bb8844&lt;/span&gt;;
  } &lt;span style=&#34;color: #74747c&#34;&gt;/*&lt;/span&gt;&lt;span style=&#34;color: #74747c&#34;&gt; Literal.String.Char &lt;/span&gt;&lt;span style=&#34;color: #74747c&#34;&gt;*/&lt;/span&gt;
  &lt;span style=&#34;color: #8b41b1&#34;&gt;.&lt;/span&gt;&lt;span style=&#34;color: #8b41b1&#34;&gt;highlight&lt;/span&gt; &lt;span style=&#34;color: #8b41b1&#34;&gt;.&lt;/span&gt;&lt;span style=&#34;color: #8b41b1&#34;&gt;dl&lt;/span&gt; {
    &lt;span style=&#34;color: #4b69c6&#34;&gt;color&lt;/span&gt;: &lt;span style=&#34;color: #b60157&#34;&gt;#&lt;/span&gt;&lt;span style=&#34;color: #b60157&#34;&gt;bb8844&lt;/span&gt;;
  } &lt;span style=&#34;color: #74747c&#34;&gt;/*&lt;/span&gt;&lt;span style=&#34;color: #74747c&#34;&gt; Literal.String.Delimiter &lt;/span&gt;&lt;span style=&#34;color: #74747c&#34;&gt;*/&lt;/span&gt;
  &lt;span style=&#34;color: #8b41b1&#34;&gt;.&lt;/span&gt;&lt;span style=&#34;color: #8b41b1&#34;&gt;highlight&lt;/span&gt; &lt;span style=&#34;color: #8b41b1&#34;&gt;.&lt;/span&gt;&lt;span style=&#34;color: #8b41b1&#34;&gt;sd&lt;/span&gt; {
    &lt;span style=&#34;color: #4b69c6&#34;&gt;color&lt;/span&gt;: &lt;span style=&#34;color: #b60157&#34;&gt;#&lt;/span&gt;&lt;span style=&#34;color: #b60157&#34;&gt;bb8844&lt;/span&gt;;
  } &lt;span style=&#34;color: #74747c&#34;&gt;/*&lt;/span&gt;&lt;span style=&#34;color: #74747c&#34;&gt; Literal.String.Doc &lt;/span&gt;&lt;span style=&#34;color: #74747c&#34;&gt;*/&lt;/span&gt;
  &lt;span style=&#34;color: #8b41b1&#34;&gt;.&lt;/span&gt;&lt;span style=&#34;color: #8b41b1&#34;&gt;highlight&lt;/span&gt; &lt;span style=&#34;color: #8b41b1&#34;&gt;.&lt;/span&gt;&lt;span style=&#34;color: #8b41b1&#34;&gt;s2&lt;/span&gt; {
    &lt;span style=&#34;color: #4b69c6&#34;&gt;color&lt;/span&gt;: &lt;span style=&#34;color: #b60157&#34;&gt;#&lt;/span&gt;&lt;span style=&#34;color: #b60157&#34;&gt;bb8844&lt;/span&gt;;
  } &lt;span style=&#34;color: #74747c&#34;&gt;/*&lt;/span&gt;&lt;span style=&#34;color: #74747c&#34;&gt; Literal.String.Double &lt;/span&gt;&lt;span style=&#34;color: #74747c&#34;&gt;*/&lt;/span&gt;
  &lt;span style=&#34;color: #8b41b1&#34;&gt;.&lt;/span&gt;&lt;span style=&#34;color: #8b41b1&#34;&gt;highlight&lt;/span&gt; &lt;span style=&#34;color: #8b41b1&#34;&gt;.&lt;/span&gt;&lt;span style=&#34;color: #8b41b1&#34;&gt;se&lt;/span&gt; {
    &lt;span style=&#34;color: #4b69c6&#34;&gt;color&lt;/span&gt;: &lt;span style=&#34;color: #b60157&#34;&gt;#&lt;/span&gt;&lt;span style=&#34;color: #b60157&#34;&gt;bb8844&lt;/span&gt;;
  } &lt;span style=&#34;color: #74747c&#34;&gt;/*&lt;/span&gt;&lt;span style=&#34;color: #74747c&#34;&gt; Literal.String.Escape &lt;/span&gt;&lt;span style=&#34;color: #74747c&#34;&gt;*/&lt;/span&gt;
  &lt;span style=&#34;color: #8b41b1&#34;&gt;.&lt;/span&gt;&lt;span style=&#34;color: #8b41b1&#34;&gt;highlight&lt;/span&gt; &lt;span style=&#34;color: #8b41b1&#34;&gt;.&lt;/span&gt;&lt;span style=&#34;color: #8b41b1&#34;&gt;sh&lt;/span&gt; {
    &lt;span style=&#34;color: #4b69c6&#34;&gt;color&lt;/span&gt;: &lt;span style=&#34;color: #b60157&#34;&gt;#&lt;/span&gt;&lt;span style=&#34;color: #b60157&#34;&gt;bb8844&lt;/span&gt;;
  } &lt;span style=&#34;color: #74747c&#34;&gt;/*&lt;/span&gt;&lt;span style=&#34;color: #74747c&#34;&gt; Literal.String.Heredoc &lt;/span&gt;&lt;span style=&#34;color: #74747c&#34;&gt;*/&lt;/span&gt;
  &lt;span style=&#34;color: #8b41b1&#34;&gt;.&lt;/span&gt;&lt;span style=&#34;color: #8b41b1&#34;&gt;highlight&lt;/span&gt; &lt;span style=&#34;color: #8b41b1&#34;&gt;.&lt;/span&gt;&lt;span style=&#34;color: #8b41b1&#34;&gt;si&lt;/span&gt; {
    &lt;span style=&#34;color: #4b69c6&#34;&gt;color&lt;/span&gt;: &lt;span style=&#34;color: #b60157&#34;&gt;#&lt;/span&gt;&lt;span style=&#34;color: #b60157&#34;&gt;bb8844&lt;/span&gt;;
  } &lt;span style=&#34;color: #74747c&#34;&gt;/*&lt;/span&gt;&lt;span style=&#34;color: #74747c&#34;&gt; Literal.String.Interpol &lt;/span&gt;&lt;span style=&#34;color: #74747c&#34;&gt;*/&lt;/span&gt;
  &lt;span style=&#34;color: #8b41b1&#34;&gt;.&lt;/span&gt;&lt;span style=&#34;color: #8b41b1&#34;&gt;highlight&lt;/span&gt; &lt;span style=&#34;color: #8b41b1&#34;&gt;.&lt;/span&gt;&lt;span style=&#34;color: #8b41b1&#34;&gt;sx&lt;/span&gt; {
    &lt;span style=&#34;color: #4b69c6&#34;&gt;color&lt;/span&gt;: &lt;span style=&#34;color: #b60157&#34;&gt;#&lt;/span&gt;&lt;span style=&#34;color: #b60157&#34;&gt;bb8844&lt;/span&gt;;
  } &lt;span style=&#34;color: #74747c&#34;&gt;/*&lt;/span&gt;&lt;span style=&#34;color: #74747c&#34;&gt; Literal.String.Other &lt;/span&gt;&lt;span style=&#34;color: #74747c&#34;&gt;*/&lt;/span&gt;
  &lt;span style=&#34;color: #8b41b1&#34;&gt;.&lt;/span&gt;&lt;span style=&#34;color: #8b41b1&#34;&gt;highlight&lt;/span&gt; &lt;span style=&#34;color: #8b41b1&#34;&gt;.&lt;/span&gt;&lt;span style=&#34;color: #8b41b1&#34;&gt;sr&lt;/span&gt; {
    &lt;span style=&#34;color: #4b69c6&#34;&gt;color&lt;/span&gt;: &lt;span style=&#34;color: #b60157&#34;&gt;#&lt;/span&gt;&lt;span style=&#34;color: #b60157&#34;&gt;808000&lt;/span&gt;;
  } &lt;span style=&#34;color: #74747c&#34;&gt;/*&lt;/span&gt;&lt;span style=&#34;color: #74747c&#34;&gt; Literal.String.Regex &lt;/span&gt;&lt;span style=&#34;color: #74747c&#34;&gt;*/&lt;/span&gt;
  &lt;span style=&#34;color: #8b41b1&#34;&gt;.&lt;/span&gt;&lt;span style=&#34;color: #8b41b1&#34;&gt;highlight&lt;/span&gt; &lt;span style=&#34;color: #8b41b1&#34;&gt;.&lt;/span&gt;&lt;span style=&#34;color: #8b41b1&#34;&gt;s1&lt;/span&gt; {
    &lt;span style=&#34;color: #4b69c6&#34;&gt;color&lt;/span&gt;: &lt;span style=&#34;color: #b60157&#34;&gt;#&lt;/span&gt;&lt;span style=&#34;color: #b60157&#34;&gt;bb8844&lt;/span&gt;;
  } &lt;span style=&#34;color: #74747c&#34;&gt;/*&lt;/span&gt;&lt;span style=&#34;color: #74747c&#34;&gt; Literal.String.Single &lt;/span&gt;&lt;span style=&#34;color: #74747c&#34;&gt;*/&lt;/span&gt;
  &lt;span style=&#34;color: #8b41b1&#34;&gt;.&lt;/span&gt;&lt;span style=&#34;color: #8b41b1&#34;&gt;highlight&lt;/span&gt; &lt;span style=&#34;color: #8b41b1&#34;&gt;.&lt;/span&gt;&lt;span style=&#34;color: #8b41b1&#34;&gt;ss&lt;/span&gt; {
    &lt;span style=&#34;color: #4b69c6&#34;&gt;color&lt;/span&gt;: &lt;span style=&#34;color: #b60157&#34;&gt;#&lt;/span&gt;&lt;span style=&#34;color: #b60157&#34;&gt;bb8844&lt;/span&gt;;
  } &lt;span style=&#34;color: #74747c&#34;&gt;/*&lt;/span&gt;&lt;span style=&#34;color: #74747c&#34;&gt; Literal.String.Symbol &lt;/span&gt;&lt;span style=&#34;color: #74747c&#34;&gt;*/&lt;/span&gt;
  &lt;span style=&#34;color: #8b41b1&#34;&gt;.&lt;/span&gt;&lt;span style=&#34;color: #8b41b1&#34;&gt;highlight&lt;/span&gt; &lt;span style=&#34;color: #8b41b1&#34;&gt;.&lt;/span&gt;&lt;span style=&#34;color: #8b41b1&#34;&gt;bp&lt;/span&gt; {
    &lt;span style=&#34;color: #4b69c6&#34;&gt;color&lt;/span&gt;: &lt;span style=&#34;color: #b60157&#34;&gt;#&lt;/span&gt;&lt;span style=&#34;color: #b60157&#34;&gt;999999&lt;/span&gt;;
  } &lt;span style=&#34;color: #74747c&#34;&gt;/*&lt;/span&gt;&lt;span style=&#34;color: #74747c&#34;&gt; Name.Builtin.Pseudo &lt;/span&gt;&lt;span style=&#34;color: #74747c&#34;&gt;*/&lt;/span&gt;
  &lt;span style=&#34;color: #8b41b1&#34;&gt;.&lt;/span&gt;&lt;span style=&#34;color: #8b41b1&#34;&gt;highlight&lt;/span&gt; &lt;span style=&#34;color: #8b41b1&#34;&gt;.&lt;/span&gt;&lt;span style=&#34;color: #8b41b1&#34;&gt;fm&lt;/span&gt; {
    &lt;span style=&#34;color: #4b69c6&#34;&gt;color&lt;/span&gt;: &lt;span style=&#34;color: #b60157&#34;&gt;#&lt;/span&gt;&lt;span style=&#34;color: #b60157&#34;&gt;990000&lt;/span&gt;;
    &lt;span style=&#34;color: #4b69c6&#34;&gt;font-weight&lt;/span&gt;: &lt;span style=&#34;color: #4b69c6&#34;&gt;bold&lt;/span&gt;;
  } &lt;span style=&#34;color: #74747c&#34;&gt;/*&lt;/span&gt;&lt;span style=&#34;color: #74747c&#34;&gt; Name.Function.Magic &lt;/span&gt;&lt;span style=&#34;color: #74747c&#34;&gt;*/&lt;/span&gt;
  &lt;span style=&#34;color: #8b41b1&#34;&gt;.&lt;/span&gt;&lt;span style=&#34;color: #8b41b1&#34;&gt;highlight&lt;/span&gt; &lt;span style=&#34;color: #8b41b1&#34;&gt;.&lt;/span&gt;&lt;span style=&#34;color: #8b41b1&#34;&gt;vc&lt;/span&gt; {
    &lt;span style=&#34;color: #4b69c6&#34;&gt;color&lt;/span&gt;: &lt;span style=&#34;color: #b60157&#34;&gt;#&lt;/span&gt;&lt;span style=&#34;color: #b60157&#34;&gt;008080&lt;/span&gt;;
  } &lt;span style=&#34;color: #74747c&#34;&gt;/*&lt;/span&gt;&lt;span style=&#34;color: #74747c&#34;&gt; Name.Variable.Class &lt;/span&gt;&lt;span style=&#34;color: #74747c&#34;&gt;*/&lt;/span&gt;
  &lt;span style=&#34;color: #8b41b1&#34;&gt;.&lt;/span&gt;&lt;span style=&#34;color: #8b41b1&#34;&gt;highlight&lt;/span&gt; &lt;span style=&#34;color: #8b41b1&#34;&gt;.&lt;/span&gt;&lt;span style=&#34;color: #8b41b1&#34;&gt;vg&lt;/span&gt; {
    &lt;span style=&#34;color: #4b69c6&#34;&gt;color&lt;/span&gt;: &lt;span style=&#34;color: #b60157&#34;&gt;#&lt;/span&gt;&lt;span style=&#34;color: #b60157&#34;&gt;008080&lt;/span&gt;;
  } &lt;span style=&#34;color: #74747c&#34;&gt;/*&lt;/span&gt;&lt;span style=&#34;color: #74747c&#34;&gt; Name.Variable.Global &lt;/span&gt;&lt;span style=&#34;color: #74747c&#34;&gt;*/&lt;/span&gt;
  &lt;span style=&#34;color: #8b41b1&#34;&gt;.&lt;/span&gt;&lt;span style=&#34;color: #8b41b1&#34;&gt;highlight&lt;/span&gt; &lt;span style=&#34;color: #8b41b1&#34;&gt;.&lt;/span&gt;&lt;span style=&#34;color: #8b41b1&#34;&gt;vi&lt;/span&gt; {
    &lt;span style=&#34;color: #4b69c6&#34;&gt;color&lt;/span&gt;: &lt;span style=&#34;color: #b60157&#34;&gt;#&lt;/span&gt;&lt;span style=&#34;color: #b60157&#34;&gt;008080&lt;/span&gt;;
  } &lt;span style=&#34;color: #74747c&#34;&gt;/*&lt;/span&gt;&lt;span style=&#34;color: #74747c&#34;&gt; Name.Variable.Instance &lt;/span&gt;&lt;span style=&#34;color: #74747c&#34;&gt;*/&lt;/span&gt;
  &lt;span style=&#34;color: #8b41b1&#34;&gt;.&lt;/span&gt;&lt;span style=&#34;color: #8b41b1&#34;&gt;highlight&lt;/span&gt; &lt;span style=&#34;color: #8b41b1&#34;&gt;.&lt;/span&gt;&lt;span style=&#34;color: #8b41b1&#34;&gt;vm&lt;/span&gt; {
    &lt;span style=&#34;color: #4b69c6&#34;&gt;color&lt;/span&gt;: &lt;span style=&#34;color: #b60157&#34;&gt;#&lt;/span&gt;&lt;span style=&#34;color: #b60157&#34;&gt;008080&lt;/span&gt;;
  } &lt;span style=&#34;color: #74747c&#34;&gt;/*&lt;/span&gt;&lt;span style=&#34;color: #74747c&#34;&gt; Name.Variable.Magic &lt;/span&gt;&lt;span style=&#34;color: #74747c&#34;&gt;*/&lt;/span&gt;
  &lt;span style=&#34;color: #8b41b1&#34;&gt;.&lt;/span&gt;&lt;span style=&#34;color: #8b41b1&#34;&gt;highlight&lt;/span&gt; &lt;span style=&#34;color: #8b41b1&#34;&gt;.&lt;/span&gt;&lt;span style=&#34;color: #8b41b1&#34;&gt;il&lt;/span&gt; {
    &lt;span style=&#34;color: #4b69c6&#34;&gt;color&lt;/span&gt;: &lt;span style=&#34;color: #b60157&#34;&gt;#&lt;/span&gt;&lt;span style=&#34;color: #b60157&#34;&gt;009999&lt;/span&gt;;
  } &lt;span style=&#34;color: #74747c&#34;&gt;/*&lt;/span&gt;&lt;span style=&#34;color: #74747c&#34;&gt; Literal.Number.Integer.Long &lt;/span&gt;&lt;span style=&#34;color: #74747c&#34;&gt;*/&lt;/span&gt;
}&lt;/code&gt;&lt;/pre&gt;&lt;/div&gt;&lt;/details&gt;2:26am on October 20, 2024 from Haydarpaşa, Istanbul, Turkey&lt;p&gt;&lt;a href=&#34;mailto:reply@silasjelley.com?subject=Reply%20to%3A%20%E2%80%9CAdd%20syntax%20highlighting%20to%20code%20blocks%20using%20Pygments%E2%80%9D&#34;&gt;Reply via email&lt;/a&gt;&lt;/p&gt;
</content>
</entry>
<entry>
  <title>Changed body font to Source Serif Pro.</title>
  <link rel="alternate" type="text/html" href="https://silasjelley.com/2024/09/30/095616" />
  <id>tag:silasjelley.com,2020-08-20:a858082f-3a05-486a-a6ef-a66dff9f7008</id>
  <published>2024-09-30T09:56:16+03:00</published>
  <updated>2024-09-30T09:56:16+03:00</updated>
  <category term="notes" />
  <category term="changelogs" />
  <summary>I was playing around with serif fonts a bit and, landing on Source Serif, I found something that fit with my style in a way that no others did. Visually quite a big change, the previous body font was…</summary>
<mosaic:place>Plovdiv, Bulgaria</mosaic:place>
<content type="html">
    &lt;p&gt;I was playing around with serif fonts a bit and, landing on Source Serif, I found something that fit with my style in a way that no others did.&lt;/p&gt;&lt;p&gt;Visually quite a big change, the previous body font was the very modern &lt;em&gt;Inter&lt;/em&gt;, a serif font, which I have kept for eg. titles for now.&lt;/p&gt;&lt;aside class=&#34;aside&#34;&gt;&lt;p&gt;Just noticed that Source Serif Pro isn’t handling left-single-smart-quotes correctly when they’re in italics, instead falling back to the right-quote/apostrophe. A pretty niche case, but I care about those little details. I’ll have to investigate whether it’s just missing from the font altogether, or if I inadvertently removed it when sub-setting it for my uses.&lt;/p&gt;&lt;p&gt;&lt;em&gt;‘example’&lt;/em&gt;&lt;/p&gt;&lt;p&gt;(If the above is no longer wrong, it’s because I’ve fixed the issue.)&lt;/p&gt;&lt;time datetime=&#34;2024-11-04T09:04:48+03:00&#34;&gt;&lt;a href=&#34;/2024/11/04/090448&#34;&gt;November 4, 2024 9.04AM&lt;/a&gt;&lt;/time&gt;&lt;/aside&gt;9:56am on September 30, 2024 from Plovdiv, Bulgaria&lt;p&gt;&lt;a href=&#34;mailto:reply@silasjelley.com?subject=Reply%20to%3A%20%E2%80%9CChanged%20body%20font%20to%20Source%20Serif%20Pro.%E2%80%9D&#34;&gt;Reply via email&lt;/a&gt;&lt;/p&gt;
</content>
</entry>
<entry>
  <title>Swapped out map tile provider</title>
  <link rel="alternate" type="text/html" href="https://silasjelley.com/2024/09/28/142943" />
  <id>tag:silasjelley.com,2020-08-20:3b3e0dc1-ff11-4d17-a7ec-46036a519e30</id>
  <published>2024-09-28T14:29:43+03:00</published>
  <updated>2024-09-28T14:29:43+03:00</updated>
  <category term="notes" />
  <category term="changelogs" />
  <summary>Switched map tiles provider from Thunder Forest Outdoors to maptiler. Much prefer the topographic styling of these maps. They even offer a set of satellite tiles if I decide I want that option in the…</summary>
<mosaic:place>Plovdiv, Bulgaria</mosaic:place>
<mosaic:picture>/images/screens/2024/09/28/144219.square.jpg</mosaic:picture>
<content type="html">
    &lt;figure class=&#34;gallery narrow-image&#34;&gt;&lt;picture&gt;
  &lt;source srcset=&#34;/images/screens/2024/09/28/144219.avif&#34; type=&#34;image/avif&#34;/&gt;
  &lt;img alt=&#34;Screenshot of the map with the new tiles, also showing my GPS track across the southern Balkans.&#34; src=&#34;/images/screens/2024/09/28/144219.png&#34; height=&#34;1098&#34; width=&#34;1600&#34;/&gt;&lt;/picture&gt;

&lt;/figure&gt;
&lt;p&gt;Switched map tiles provider from &lt;a href=&#34;https://www.thunderforest.com/maps/outdoors/&#34;&gt;Thunder Forest Outdoors&lt;/a&gt; to &lt;a href=&#34;https://docs.maptiler.com/cloud/api/static-maps/&#34;&gt;maptiler&lt;/a&gt;.&lt;/p&gt;&lt;p&gt;Much prefer the topographic styling of these maps. They even offer a set of satellite tiles if I decide I want that option in the future.&lt;/p&gt;&lt;p&gt;Before and after:&lt;/p&gt;&lt;div class=&#34;code-block&#34; data-lang=&#34;js&#34;&gt;&lt;div class=&#34;code-header&#34; data-mosaic-chrome=&#34;&#34;&gt;&lt;span class=&#34;code-lang&#34;&gt;js&lt;/span&gt;&lt;button class=&#34;code-copy&#34; aria-label=&#34;Copy code&#34; type=&#34;button&#34;&gt;Copy&lt;/button&gt;&lt;/div&gt;&lt;pre&gt;&lt;code data-lang=&#34;js&#34;&gt;  .&lt;span style=&#34;color: #4b69c6&#34;&gt;then&lt;/span&gt;(() &lt;span style=&#34;color: #d73948&#34;&gt;=&amp;gt;&lt;/span&gt; {
    &lt;span style=&#34;color: #d73948&#34;&gt;var&lt;/span&gt; map &lt;span style=&#34;color: #d73948&#34;&gt;=&lt;/span&gt; &lt;span style=&#34;color: #4b69c6&#34;&gt;L&lt;/span&gt;.&lt;span style=&#34;color: #4b69c6&#34;&gt;map&lt;/span&gt;(&lt;span style=&#34;color: #198810&#34;&gt;&amp;#39;&lt;/span&gt;&lt;span style=&#34;color: #198810&#34;&gt;map&lt;/span&gt;&lt;span style=&#34;color: #198810&#34;&gt;&amp;#39;&lt;/span&gt;);
    &lt;span style=&#34;color: #4b69c6&#34;&gt;L&lt;/span&gt;.&lt;span style=&#34;color: #4b69c6&#34;&gt;tileLayer&lt;/span&gt;(&lt;span style=&#34;color: #198810&#34;&gt;&amp;#39;&lt;/span&gt;&lt;span style=&#34;color: #198810&#34;&gt;https://tile.thunderforest.com/outdoors/{z}/{x}/{y}.png?apikey=APIKEY&lt;/span&gt;&lt;span style=&#34;color: #198810&#34;&gt;&amp;#39;&lt;/span&gt;, {
        maxZoom: &lt;span style=&#34;color: #b60157&#34;&gt;19&lt;/span&gt;,
        attribution: &lt;span style=&#34;color: #d73948&#34;&gt;null&lt;/span&gt;
    }).&lt;span style=&#34;color: #4b69c6&#34;&gt;addTo&lt;/span&gt;(map);&lt;/code&gt;&lt;/pre&gt;&lt;/div&gt;&lt;div class=&#34;code-block&#34; data-lang=&#34;js&#34;&gt;&lt;div class=&#34;code-header&#34; data-mosaic-chrome=&#34;&#34;&gt;&lt;span class=&#34;code-lang&#34;&gt;js&lt;/span&gt;&lt;button class=&#34;code-copy&#34; aria-label=&#34;Copy code&#34; type=&#34;button&#34;&gt;Copy&lt;/button&gt;&lt;/div&gt;&lt;pre&gt;&lt;code data-lang=&#34;js&#34;&gt;  .&lt;span style=&#34;color: #4b69c6&#34;&gt;then&lt;/span&gt;(() &lt;span style=&#34;color: #d73948&#34;&gt;=&amp;gt;&lt;/span&gt; {
    &lt;span style=&#34;color: #d73948&#34;&gt;var&lt;/span&gt; map &lt;span style=&#34;color: #d73948&#34;&gt;=&lt;/span&gt; &lt;span style=&#34;color: #4b69c6&#34;&gt;L&lt;/span&gt;.&lt;span style=&#34;color: #4b69c6&#34;&gt;map&lt;/span&gt;(&lt;span style=&#34;color: #198810&#34;&gt;&amp;#39;&lt;/span&gt;&lt;span style=&#34;color: #198810&#34;&gt;map&lt;/span&gt;&lt;span style=&#34;color: #198810&#34;&gt;&amp;#39;&lt;/span&gt;);
    &lt;span style=&#34;color: #4b69c6&#34;&gt;L&lt;/span&gt;.&lt;span style=&#34;color: #4b69c6&#34;&gt;tileLayer&lt;/span&gt;(&lt;span style=&#34;color: #198810&#34;&gt;&amp;#39;&lt;/span&gt;&lt;span style=&#34;color: #198810&#34;&gt;https://api.maptiler.com/maps/topo-v2/{z}/{x}/{y}.png?key=APIKEY&lt;/span&gt;&lt;span style=&#34;color: #198810&#34;&gt;&amp;#39;&lt;/span&gt;, {
        maxZoom: &lt;span style=&#34;color: #b60157&#34;&gt;19&lt;/span&gt;,
        attribution: &lt;span style=&#34;color: #d73948&#34;&gt;null&lt;/span&gt;
    }).&lt;span style=&#34;color: #4b69c6&#34;&gt;addTo&lt;/span&gt;(map);&lt;/code&gt;&lt;/pre&gt;&lt;/div&gt;2:29pm on September 28, 2024 from Plovdiv, Bulgaria&lt;p&gt;&lt;a href=&#34;mailto:reply@silasjelley.com?subject=Reply%20to%3A%20%E2%80%9CSwapped%20out%20map%20tile%20provider%E2%80%9D&#34;&gt;Reply via email&lt;/a&gt;&lt;/p&gt;
</content>
</entry>

<div xmlns="http://www.w3.org/1999/xhtml" id="feed-chrome" hidden="" data-stylesheet="/style.css?a959535639bceb541eb7a955189913b9">
<header class="site-header">
<nav class="site-nav" aria-label="Site">
<a class="homelink" href="/" title="Homepage of silasjelley.com">Silas Jelley</a>
<ul class="navmain">
<li><a href="/wandering" title="Tales of my worldly travels">Wandering</a></li>
<li><a href="/rambling" title="The ramblings of an itinerant fool">Rambling</a></li>
<li><a href="/nonsense" title="Shaking my brain stem and seeing what fruit falls">Nonsense</a></li>
<li><a href="/quotes" title="Quotes, saved from anything and anywhere I find interest">Quotes</a></li>
</ul>
<ul class="navmisc top">
<li><a href="/about" title="Learn a little more about the author.">About</a></li>
<li><a href="/contact" title="Get in touch with me!">Contact</a></li>
<li><a href="/search" title="Search silasjelley.com">Search</a></li>
<li class="theme-choice" hidden=""><select class="theme-select" aria-label="Theme" title="Colour theme"><option value="system">Auto</option><option value="sepia">Sepia</option><option value="sepia-dark">Sepia dark</option><option value="light">Light</option><option value="dark">Dark</option></select></li>
</ul>
</nav>
</header>
<footer class="site-footer">
<p class="eyebrow">
<a href="/">Silas Jelley</a>
<a href="/feeds" title="Every feed on the site">Feeds</a>
<a href="/about">About</a>
<a href="/contact">Contact</a>
<a href="#top">Top ↑</a>
</p>
</footer>
</div>
<script xmlns="http://www.w3.org/1999/xhtml" src="/js/theme.js?04109bde1f72"></script>
<script xmlns="http://www.w3.org/1999/xhtml" src="/js/feed.js?aeaf63aa0cfc"></script>
</feed>