ssqch 0.7.1 → 0.9.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (155) hide show
  1. package/README.md +8 -4
  2. package/bin/ssqch.js +14 -48
  3. package/bundled/README.md +1314 -0
  4. package/bundled/completions/bash +840 -0
  5. package/bundled/completions/elvish +286 -0
  6. package/bundled/completions/fish +182 -0
  7. package/bundled/completions/powershell +318 -0
  8. package/bundled/completions/zsh +510 -0
  9. package/bundled/ssqch.d.ts +540 -0
  10. package/bundled/starter/engines/index.edge +11 -0
  11. package/bundled/starter/engines/index.ejs +11 -0
  12. package/bundled/starter/engines/index.hbs +11 -0
  13. package/bundled/starter/engines/index.liquid +11 -0
  14. package/bundled/starter/engines/layout.edge +35 -0
  15. package/bundled/starter/engines/layout.ejs +35 -0
  16. package/bundled/starter/engines/layout.hbs +35 -0
  17. package/bundled/starter/engines/layout.liquid +35 -0
  18. package/bundled/starter/gitignore +3 -0
  19. package/bundled/starter/jsconfig.json +11 -0
  20. package/bundled/starter/src/404.md +8 -0
  21. package/bundled/starter/src/_blueprints/posts.md +5 -0
  22. package/bundled/starter/src/_data/site.json +4 -0
  23. package/bundled/starter/src/_includes/layout.jinja +35 -0
  24. package/bundled/starter/src/index.jinja +11 -0
  25. package/bundled/starter/src/posts/i-know-what-i-saw.md +11 -0
  26. package/bundled/starter/src/posts/posts.json +4 -0
  27. package/bundled/starter/src/posts/raiders-of-the-lost-path.md +27 -0
  28. package/bundled/starter/src/posts/the-cache-of-the-wild.md +26 -0
  29. package/bundled/starter/src/posts/the-stump-has-moved.md +15 -0
  30. package/bundled/starter/src/posts/upon-further-review-a-stump.md +18 -0
  31. package/bundled/starter/ssqch.config.js +29 -0
  32. package/bundled/starter-docs/engines/edge/base.edge +41 -0
  33. package/bundled/starter-docs/engines/edge/containers/details.edge +5 -0
  34. package/bundled/starter-docs/engines/edge/containers/tab.edge +4 -0
  35. package/bundled/starter-docs/engines/edge/containers/tabs.edge +5 -0
  36. package/bundled/starter-docs/engines/edge/doc.edge +59 -0
  37. package/bundled/starter-docs/engines/edge/hooks/heading.edge +2 -0
  38. package/bundled/starter-docs/engines/ejs/base.ejs +41 -0
  39. package/bundled/starter-docs/engines/ejs/containers/details.ejs +5 -0
  40. package/bundled/starter-docs/engines/ejs/containers/tab.ejs +4 -0
  41. package/bundled/starter-docs/engines/ejs/containers/tabs.ejs +5 -0
  42. package/bundled/starter-docs/engines/ejs/doc.ejs +59 -0
  43. package/bundled/starter-docs/engines/ejs/hooks/heading.ejs +2 -0
  44. package/bundled/starter-docs/engines/hbs/base.hbs +41 -0
  45. package/bundled/starter-docs/engines/hbs/containers/details.hbs +5 -0
  46. package/bundled/starter-docs/engines/hbs/containers/tab.hbs +4 -0
  47. package/bundled/starter-docs/engines/hbs/containers/tabs.hbs +5 -0
  48. package/bundled/starter-docs/engines/hbs/doc.hbs +58 -0
  49. package/bundled/starter-docs/engines/hbs/hooks/heading.hbs +2 -0
  50. package/bundled/starter-docs/engines/liquid/base.liquid +41 -0
  51. package/bundled/starter-docs/engines/liquid/containers/details.liquid +5 -0
  52. package/bundled/starter-docs/engines/liquid/containers/tab.liquid +4 -0
  53. package/bundled/starter-docs/engines/liquid/containers/tabs.liquid +5 -0
  54. package/bundled/starter-docs/engines/liquid/doc.liquid +60 -0
  55. package/bundled/starter-docs/engines/liquid/hooks/heading.liquid +2 -0
  56. package/bundled/starter-docs/gitignore +4 -0
  57. package/bundled/starter-docs/src/404.md +12 -0
  58. package/bundled/starter-docs/src/_blueprints/docs.md +5 -0
  59. package/bundled/starter-docs/src/_data/nav.yml +10 -0
  60. package/bundled/starter-docs/src/_data/site.json +5 -0
  61. package/bundled/starter-docs/src/_includes/base.jinja +41 -0
  62. package/bundled/starter-docs/src/_includes/containers/details.jinja +5 -0
  63. package/bundled/starter-docs/src/_includes/containers/tab.jinja +4 -0
  64. package/bundled/starter-docs/src/_includes/containers/tabs.jinja +5 -0
  65. package/bundled/starter-docs/src/_includes/doc.jinja +59 -0
  66. package/bundled/starter-docs/src/_includes/hooks/heading.jinja +2 -0
  67. package/bundled/starter-docs/src/assets/docs.css +257 -0
  68. package/bundled/starter-docs/src/assets/docs.js +67 -0
  69. package/bundled/starter-docs/src/docs/docs.json +1 -0
  70. package/bundled/starter-docs/src/docs/guides/deploying.md +77 -0
  71. package/bundled/starter-docs/src/docs/guides/writing.md +65 -0
  72. package/bundled/starter-docs/src/docs/index.md +29 -0
  73. package/bundled/starter-docs/src/docs/install.md +42 -0
  74. package/bundled/starter-docs/src/index.md +13 -0
  75. package/bundled/starter-docs/ssqch.config.js +40 -0
  76. package/bundled/trailheads/from-component-frameworks.md +116 -0
  77. package/bundled/trailheads/from-docusaurus.md +55 -0
  78. package/bundled/trailheads/from-eleventy.md +140 -0
  79. package/bundled/trailheads/from-hexo.md +92 -0
  80. package/bundled/trailheads/from-jekyll.md +79 -0
  81. package/bundled/trailheads/from-mkdocs.md +45 -0
  82. package/bundled/trailheads/from-zola.md +71 -0
  83. package/lib/assets.js +235 -3
  84. package/lib/chunk-3A647I3N.js +384 -0
  85. package/lib/chunk-3GYLOC6Y.js +1017 -0
  86. package/lib/chunk-3K3ANWZ2.js +118 -0
  87. package/lib/chunk-3NYSSA2C.js +22 -0
  88. package/lib/chunk-47P4YREZ.js +1287 -0
  89. package/lib/chunk-4Q6WMTER.js +32 -0
  90. package/lib/chunk-76NTVE34.js +338 -0
  91. package/lib/chunk-7PWCYHTJ.js +1350 -0
  92. package/lib/chunk-7RDRZHJD.js +217 -0
  93. package/lib/chunk-7SD7K567.js +57 -0
  94. package/lib/chunk-7XLK2GEG.js +54 -0
  95. package/lib/chunk-AD3HAW3W.js +10 -0
  96. package/lib/chunk-BEGC7YP6.js +502 -0
  97. package/lib/chunk-CMUWRPSQ.js +113 -0
  98. package/lib/chunk-CZ4XQC56.js +999 -0
  99. package/lib/chunk-D2XE2GTY.js +71 -0
  100. package/lib/chunk-DDV6JEC2.js +46 -0
  101. package/lib/chunk-DELWRJAO.js +37409 -0
  102. package/lib/chunk-DELWRJAO.js.LEGAL.txt +27 -0
  103. package/lib/chunk-F65YUXZ7.js +334 -0
  104. package/lib/chunk-FVZ5JBRI.js +115 -0
  105. package/lib/chunk-GRWMGC7D.js +4435 -0
  106. package/lib/chunk-GRWMGC7D.js.LEGAL.txt +41 -0
  107. package/lib/chunk-GUKSZ2XM.js +207 -0
  108. package/lib/chunk-HPXAZ2HU.js +251 -0
  109. package/lib/chunk-HXCLCXRT.js +20 -0
  110. package/lib/chunk-I3PS26CI.js +48 -0
  111. package/lib/chunk-IAFM5ITE.js +11 -0
  112. package/lib/chunk-II5DEH3Q.js +209 -0
  113. package/lib/chunk-IJWHOFRP.js +44 -0
  114. package/lib/chunk-LPHNACE4.js +29 -0
  115. package/lib/chunk-MI6EJWA2.js +175 -0
  116. package/lib/chunk-NCWFYT74.js +1541 -0
  117. package/lib/chunk-NKXEPHRZ.js +136 -0
  118. package/lib/chunk-NNUKIGOO.js +160 -0
  119. package/lib/chunk-R7K3D5W5.js +3957 -0
  120. package/lib/chunk-RNJFPFXE.js +29 -0
  121. package/lib/chunk-SF4I6Z7S.js +25 -0
  122. package/lib/chunk-SURPOAW7.js +44 -0
  123. package/lib/chunk-SXMJ52IK.js +572 -0
  124. package/lib/chunk-TICWN55Z.js +20 -0
  125. package/lib/chunk-TVU3OPPK.js +146 -0
  126. package/lib/chunk-UU43WIZG.js +29 -0
  127. package/lib/chunk-VJWQSYEG.js +119 -0
  128. package/lib/chunk-XMXBHXZR.js +75 -0
  129. package/lib/chunk-YTHQBMDJ.js +211 -0
  130. package/lib/cli.js +547 -0
  131. package/lib/elements.js +180 -3
  132. package/lib/image.js +27 -3
  133. package/lib/links.js +464 -3
  134. package/lib/minify.js +69 -3
  135. package/lib/redirects.js +152 -3
  136. package/lib/rss.js +139 -3
  137. package/lib/sass.js +256 -3
  138. package/lib/sitemap.js +113 -3
  139. package/lib/ssqch.js +28 -0
  140. package/package.json +83 -80
  141. package/src/serve/live.js +174 -0
  142. package/src/serve/not-found.html +31 -0
  143. package/types/globals.d.ts +3 -2
  144. package/types/image.d.ts +7 -3
  145. package/types/index.d.ts +28 -9
  146. package/types/links.d.ts +1 -1
  147. package/types/minify.d.ts +1 -1
  148. package/types/rss.d.ts +1 -1
  149. package/types/sass.d.ts +1 -1
  150. package/types/sitemap.d.ts +2 -0
  151. package/wasm/markdown.wasm +0 -0
  152. package/wasm/minify.wasm +0 -0
  153. package/wasm/sass.wasm +0 -0
  154. package/lib/index.js +0 -3
  155. package/platforms.json +0 -6
@@ -0,0 +1,5 @@
1
+ {{!-- ::::tabs around :::tab blocks. Without JavaScript the tabs read as
2
+ labeled sections; assets/docs.js turns the labels into buttons. --}}
3
+ <div class="tabs">
4
+ {{{container.content}}}
5
+ </div>
@@ -0,0 +1,58 @@
1
+ ---
2
+ layout: base.hbs
3
+ sidebar: true
4
+ ---
5
+ <div class="docs">
6
+ <main id="content" data-pagefind-body>
7
+ {{#if (gt (len (navBreadcrumbs nav page.url)) 1)}}
8
+ <nav class="breadcrumbs" aria-label="Breadcrumbs">
9
+ {{#each (navBreadcrumbs nav page.url)}}{{#unless @last}}
10
+ <span>{{title}}</span> ›
11
+ {{/unless}}{{/each}}
12
+ <span aria-current="page">{{title}}</span>
13
+ </nav>
14
+ {{/if}}
15
+ <h1>{{title}}</h1>
16
+ {{{content}}}
17
+
18
+ <footer class="page-footer">
19
+ {{#if site.editUrl}}
20
+ <p><a href="{{site.editUrl}}{{sourcePath page.inputPath}}">Edit this page</a></p>
21
+ {{/if}}
22
+ {{#with (navPager nav page.url)}}
23
+ <nav class="pager" aria-label="Previous and next pages">
24
+ <span>
25
+ {{#if previous}}
26
+ <a rel="prev" href="{{previous.url}}">← {{previous.title}}</a>
27
+ {{/if}}
28
+ </span>
29
+ <span>
30
+ {{#if next}}
31
+ <a rel="next" href="{{next.url}}">{{next.title}} →</a>
32
+ {{/if}}
33
+ </span>
34
+ </nav>
35
+ {{/with}}
36
+ </footer>
37
+ </main>
38
+
39
+ <aside class="toc" aria-label="On this page">
40
+ {{#if (toc page.headings)}}
41
+ <p class="toc-title">On this page</p>
42
+ {{{toc page.headings}}}
43
+ {{/if}}
44
+ </aside>
45
+
46
+ {{!-- After the content in the HTML, so a phone (and a screen reader) gets
47
+ the page first. The stylesheet puts it on the left on wide screens. --}}
48
+ <nav class="sidebar" id="sidebar" aria-label="Documentation">
49
+ {{#each (navTree nav page.url)}}
50
+ <h2>{{title}}</h2>
51
+ <ul>
52
+ {{#each pages}}
53
+ <li><a href="{{url}}"{{#if current}} aria-current="page"{{/if}}>{{title}}</a></li>
54
+ {{/each}}
55
+ </ul>
56
+ {{/each}}
57
+ </nav>
58
+ </div>
@@ -0,0 +1,2 @@
1
+ {{!-- How Markdown headings render: with a link to themselves. --}}
2
+ <h{{heading.level}} id="{{heading.id}}">{{{heading.content}}} <a class="anchor" href="#{{heading.id}}" aria-hidden="true" tabindex="-1">#</a></h{{heading.level}}>
@@ -0,0 +1,41 @@
1
+ <!doctype html>
2
+ <html lang="en">
3
+ <head>
4
+ <meta charset="utf-8">
5
+ <meta name="viewport" content="width=device-width, initial-scale=1">
6
+ <title>{% if title and title != "" %}{{ title }} | {% endif %}{{ site.name }}</title>
7
+ <meta name="description" content="{{ description | default: site.description }}">
8
+ <meta name="generator" content="{{ ssqch.generator }}">
9
+ <link rel="stylesheet" href="/highlight.css">
10
+ <link rel="stylesheet" href="/assets/docs.css">
11
+ {% if search %}
12
+ <link rel="stylesheet" href="/pagefind/pagefind-ui.css">
13
+ <script src="/pagefind/pagefind-ui.js" defer></script>
14
+ {% endif %}
15
+ <script src="/assets/docs.js" defer></script>
16
+ {% comment %} Before the page is drawn, so a reader who picked a theme doesn't see the other one first. {% endcomment %}
17
+ <script>try { const theme = localStorage.getItem("theme"); if (theme) document.documentElement.dataset.theme = theme; } catch {}</script>
18
+ </head>
19
+ <body>
20
+ <a class="skip-link" href="#content">Skip to content</a>
21
+ <header class="site-header">
22
+ <a class="site-name" href="/">{{ site.name }}</a>
23
+ <nav aria-label="Site">
24
+ <a href="/docs/">Docs</a>
25
+ {% if sidebar %}
26
+ <a class="menu-link" href="#sidebar">Menu</a>
27
+ {% endif %}
28
+ </nav>
29
+ {% if search %}
30
+ <div id="search"></div>
31
+ {% endif %}
32
+ {% comment %} docs.js shows it. Without JavaScript, the theme follows the system. {% endcomment %}
33
+ <button class="theme-switch" type="button" hidden>Switch theme</button>
34
+ </header>
35
+ {% if sidebar %}
36
+ {{ content }}
37
+ {% else %}
38
+ <main id="content">{{ content }}</main>
39
+ {% endif %}
40
+ </body>
41
+ </html>
@@ -0,0 +1,5 @@
1
+ {% comment %} :::details Summary text {% endcomment %}
2
+ <details>
3
+ <summary>{{ container.args | default: 'Details' }}</summary>
4
+ {{ container.content }}
5
+ </details>
@@ -0,0 +1,4 @@
1
+ <section class="tab" data-label="{{ container.args }}">
2
+ <p class="tab-label">{{ container.args }}</p>
3
+ {{ container.content }}
4
+ </section>
@@ -0,0 +1,5 @@
1
+ {% comment %} ::::tabs around :::tab blocks. Without JavaScript the tabs read as
2
+ labeled sections; assets/docs.js turns the labels into buttons. {% endcomment %}
3
+ <div class="tabs">
4
+ {{ container.content }}
5
+ </div>
@@ -0,0 +1,60 @@
1
+ ---
2
+ layout: base.liquid
3
+ sidebar: true
4
+ ---
5
+ <div class="docs">
6
+ <main id="content" data-pagefind-body>
7
+ {% assign crumbs = nav | navBreadcrumbs: page.url %}
8
+ {% if crumbs.size > 1 %}
9
+ <nav class="breadcrumbs" aria-label="Breadcrumbs">
10
+ {% for crumb in crumbs %}{% unless forloop.last %}
11
+ <span>{{ crumb.title }}</span> ›
12
+ {% endunless %}{% endfor %}
13
+ <span aria-current="page">{{ title }}</span>
14
+ </nav>
15
+ {% endif %}
16
+ <h1>{{ title }}</h1>
17
+ {{ content }}
18
+
19
+ <footer class="page-footer">
20
+ {% if site.editUrl and site.editUrl != "" %}
21
+ <p><a href="{{ site.editUrl }}{{ page.inputPath | replace_first: './', '' }}">Edit this page</a></p>
22
+ {% endif %}
23
+ {% assign pager = nav | navPager: page.url %}
24
+ <nav class="pager" aria-label="Previous and next pages">
25
+ <span>
26
+ {% if pager.previous %}
27
+ <a rel="prev" href="{{ pager.previous.url }}">← {{ pager.previous.title }}</a>
28
+ {% endif %}
29
+ </span>
30
+ <span>
31
+ {% if pager.next %}
32
+ <a rel="next" href="{{ pager.next.url }}">{{ pager.next.title }} →</a>
33
+ {% endif %}
34
+ </span>
35
+ </nav>
36
+ </footer>
37
+ </main>
38
+
39
+ {% assign contents = page.headings | toc %}
40
+ <aside class="toc" aria-label="On this page">
41
+ {% if contents and contents != "" %}
42
+ <p class="toc-title">On this page</p>
43
+ {{ contents }}
44
+ {% endif %}
45
+ </aside>
46
+
47
+ {% comment %} After the content in the HTML, so a phone (and a screen reader) gets
48
+ the page first. The stylesheet puts it on the left on wide screens. {% endcomment %}
49
+ {% assign sections = nav | navTree: page.url %}
50
+ <nav class="sidebar" id="sidebar" aria-label="Documentation">
51
+ {% for section in sections %}
52
+ <h2>{{ section.title }}</h2>
53
+ <ul>
54
+ {% for item in section.pages %}
55
+ <li><a href="{{ item.url }}"{% if item.current %} aria-current="page"{% endif %}>{{ item.title }}</a></li>
56
+ {% endfor %}
57
+ </ul>
58
+ {% endfor %}
59
+ </nav>
60
+ </div>
@@ -0,0 +1,2 @@
1
+ {% comment %} How Markdown headings render: with a link to themselves. {% endcomment %}
2
+ <h{{ heading.level }} id="{{ heading.id }}">{{ heading.content }} <a class="anchor" href="#{{ heading.id }}" aria-hidden="true" tabindex="-1">#</a></h{{ heading.level }}>
@@ -0,0 +1,4 @@
1
+ dist/
2
+ dist-before/
3
+ .cache/
4
+ node_modules/
@@ -0,0 +1,12 @@
1
+ ---
2
+ title: Page not found
3
+ layout: base.jinja
4
+ permalink: /404.html
5
+ ---
6
+ <div class="home">
7
+
8
+ # Page not found
9
+
10
+ We have several eyewitness accounts of this page, but no page. [Back to the trailhead](/), or try [the docs](/docs/).
11
+
12
+ </div>
@@ -0,0 +1,5 @@
1
+ ---
2
+ title:
3
+ description:
4
+ ---
5
+ Write the page here, then add it to `src/_data/nav.yml` so it's in the sidebar.
@@ -0,0 +1,10 @@
1
+ # The sidebar. A page that isn't listed here still builds; it just isn't in
2
+ # the sidebar, the breadcrumbs or the previous/next links.
3
+ - title: Getting started
4
+ pages:
5
+ - { title: Introduction, url: /docs/ }
6
+ - { title: Installation, url: /docs/install/ }
7
+ - title: Guides
8
+ pages:
9
+ - { title: Writing pages, url: /docs/guides/writing/ }
10
+ - { title: Deploying, url: /docs/guides/deploying/ }
@@ -0,0 +1,5 @@
1
+ {
2
+ "name": "Squatch Docs",
3
+ "description": "Documentation built with SiteSquatch.",
4
+ "editUrl": ""
5
+ }
@@ -0,0 +1,41 @@
1
+ <!doctype html>
2
+ <html lang="en">
3
+ <head>
4
+ <meta charset="utf-8">
5
+ <meta name="viewport" content="width=device-width, initial-scale=1">
6
+ <title>{% if title %}{{ title }} | {% endif %}{{ site.name }}</title>
7
+ <meta name="description" content="{{ description or site.description }}">
8
+ <meta name="generator" content="{{ ssqch.generator }}">
9
+ <link rel="stylesheet" href="/highlight.css">
10
+ <link rel="stylesheet" href="/assets/docs.css">
11
+ {% if search %}
12
+ <link rel="stylesheet" href="/pagefind/pagefind-ui.css">
13
+ <script src="/pagefind/pagefind-ui.js" defer></script>
14
+ {% endif %}
15
+ <script src="/assets/docs.js" defer></script>
16
+ {# Before the page is drawn, so a reader who picked a theme doesn't see the other one first. #}
17
+ <script>try { const theme = localStorage.getItem("theme"); if (theme) document.documentElement.dataset.theme = theme; } catch {}</script>
18
+ </head>
19
+ <body>
20
+ <a class="skip-link" href="#content">Skip to content</a>
21
+ <header class="site-header">
22
+ <a class="site-name" href="/">{{ site.name }}</a>
23
+ <nav aria-label="Site">
24
+ <a href="/docs/">Docs</a>
25
+ {% if sidebar %}
26
+ <a class="menu-link" href="#sidebar">Menu</a>
27
+ {% endif %}
28
+ </nav>
29
+ {% if search %}
30
+ <div id="search"></div>
31
+ {% endif %}
32
+ {# docs.js shows it. Without JavaScript, the theme follows the system. #}
33
+ <button class="theme-switch" type="button" hidden>Switch theme</button>
34
+ </header>
35
+ {% if sidebar %}
36
+ {{ content }}
37
+ {% else %}
38
+ <main id="content">{{ content }}</main>
39
+ {% endif %}
40
+ </body>
41
+ </html>
@@ -0,0 +1,5 @@
1
+ {# :::details Summary text #}
2
+ <details>
3
+ <summary>{{ container.args or 'Details' }}</summary>
4
+ {{ container.content | safe }}
5
+ </details>
@@ -0,0 +1,4 @@
1
+ <section class="tab" data-label="{{ container.args }}">
2
+ <p class="tab-label">{{ container.args }}</p>
3
+ {{ container.content | safe }}
4
+ </section>
@@ -0,0 +1,5 @@
1
+ {# ::::tabs around :::tab blocks. Without JavaScript the tabs read as
2
+ labeled sections; assets/docs.js turns the labels into buttons. #}
3
+ <div class="tabs">
4
+ {{ container.content | safe }}
5
+ </div>
@@ -0,0 +1,59 @@
1
+ ---
2
+ layout: base.jinja
3
+ sidebar: true
4
+ ---
5
+ <div class="docs">
6
+ <main id="content" data-pagefind-body>
7
+ {% set crumbs = nav | navBreadcrumbs(page.url) %}
8
+ {% if crumbs | length > 1 %}
9
+ <nav class="breadcrumbs" aria-label="Breadcrumbs">
10
+ {% for crumb in crumbs[:-1] %}
11
+ <span>{{ crumb.title }}</span> ›
12
+ {% endfor %}
13
+ <span aria-current="page">{{ title }}</span>
14
+ </nav>
15
+ {% endif %}
16
+ <h1>{{ title }}</h1>
17
+ {{ content }}
18
+
19
+ <footer class="page-footer">
20
+ {% if site.editUrl %}
21
+ <p><a href="{{ site.editUrl }}{{ page.inputPath | replace('./', '') }}">Edit this page</a></p>
22
+ {% endif %}
23
+ {% set pager = nav | navPager(page.url) %}
24
+ <nav class="pager" aria-label="Previous and next pages">
25
+ <span>
26
+ {% if pager.previous %}
27
+ <a rel="prev" href="{{ pager.previous.url }}">← {{ pager.previous.title }}</a>
28
+ {% endif %}
29
+ </span>
30
+ <span>
31
+ {% if pager.next %}
32
+ <a rel="next" href="{{ pager.next.url }}">{{ pager.next.title }} →</a>
33
+ {% endif %}
34
+ </span>
35
+ </nav>
36
+ </footer>
37
+ </main>
38
+
39
+ {% set contents = toc(page.headings) %}
40
+ <aside class="toc" aria-label="On this page">
41
+ {% if contents %}
42
+ <p class="toc-title">On this page</p>
43
+ {{ contents | safe }}
44
+ {% endif %}
45
+ </aside>
46
+
47
+ {# After the content in the HTML, so a phone (and a screen reader) gets
48
+ the page first. The stylesheet puts it on the left on wide screens. #}
49
+ <nav class="sidebar" id="sidebar" aria-label="Documentation">
50
+ {% for section in nav | navTree(page.url) %}
51
+ <h2>{{ section.title }}</h2>
52
+ <ul>
53
+ {% for item in section.pages %}
54
+ <li><a href="{{ item.url }}"{% if item.current %} aria-current="page"{% endif %}>{{ item.title }}</a></li>
55
+ {% endfor %}
56
+ </ul>
57
+ {% endfor %}
58
+ </nav>
59
+ </div>
@@ -0,0 +1,2 @@
1
+ {# How Markdown headings render: with a link to themselves. #}
2
+ <h{{ heading.level }} id="{{ heading.id }}">{{ heading.content | safe }} <a class="anchor" href="#{{ heading.id }}" aria-hidden="true" tabindex="-1">#</a></h{{ heading.level }}>
@@ -0,0 +1,257 @@
1
+ /* The docs theme, in the Ranger Station '76 palette. Soft white in light mode and a slightly
2
+ green charcoal in dark mode, with neutral body text. Pine gives headings and navigation their
3
+ identity; burnt orange is for links and selection markers, avocado for selected navigation
4
+ and code, and harvest gold for callout borders. The narrow four-color stripe under the header
5
+ carries the retro theme across both modes.
6
+
7
+ Dark mode follows the system, unless the reader picks one with the switch in the header
8
+ (docs.js sets data-theme on <html>). */
9
+ :root {
10
+ color-scheme: light;
11
+ --width: 46rem;
12
+ --text: #29332c;
13
+ --heading: #233b2b;
14
+ --muted: #5e6a61;
15
+ --background: #fafaf7;
16
+ --chrome: #f1f1eb;
17
+ --surface: #eeefe7;
18
+ --border: #dcddd4;
19
+ --link: #a23e20;
20
+ --code: #3f5a2a;
21
+ --selected: #e6ecda;
22
+ --marker: #a23e20;
23
+ --stripe-pine: #233b2b;
24
+ /* Callouts: the border, the background, and the title. */
25
+ --note-bar: #e8af43;
26
+ --note-bg: #f6efdf;
27
+ --note: #29332c;
28
+ --tip-bar: #a9b66a;
29
+ --tip-bg: #eef1e4;
30
+ --tip: #4e5e24;
31
+ --warning-bar: #e8af43;
32
+ --warning-bg: #f6efdf;
33
+ --warning: #7a500a;
34
+ --caution-bar: #a23e20;
35
+ --caution-bg: #f8eae4;
36
+ --caution: #a23e20;
37
+ /* Code, over /highlight.css's defaults (this file loads after it). */
38
+ --hl-comment: #5e6a61;
39
+ --hl-keyword: #a23e20;
40
+ --hl-operator: #a23e20;
41
+ --hl-string: #4e5e24;
42
+ --hl-regexp: #4e5e24;
43
+ --hl-escape: #4e5e24;
44
+ --hl-number: #7a500a;
45
+ --hl-constant: #7a500a;
46
+ --hl-builtin: #7a500a;
47
+ --hl-property: #233b2b;
48
+ --hl-attribute: #7a500a;
49
+ --hl-function: #233b2b;
50
+ --hl-type: #7a500a;
51
+ --hl-parameter: #7a500a;
52
+ --hl-tag: #a23e20;
53
+ --hl-heading: #a23e20;
54
+ --hl-link: #a23e20;
55
+ --hl-inserted: #4e5e24;
56
+ --hl-inserted-bg: #e6ecda;
57
+ --hl-deleted: #a23e20;
58
+ --hl-deleted-bg: #f8eae4;
59
+ --hl-line-bg: rgba(232, 175, 67, 0.25);
60
+ }
61
+ @media (prefers-color-scheme: dark) {
62
+ :root:not([data-theme="light"]) {
63
+ color-scheme: dark;
64
+ --text: #e5e9e1;
65
+ --heading: #d6e4c8;
66
+ --muted: #a2aca3;
67
+ --background: #1b201d;
68
+ --chrome: #252b27;
69
+ --surface: #252b27;
70
+ --border: #3a413b;
71
+ --link: #f0a17d;
72
+ --code: #b9c77e;
73
+ --selected: #2e3f2b;
74
+ --marker: #f0a17d;
75
+ --stripe-pine: #2e5a3c;
76
+ --note-bar: #e8af43;
77
+ --note-bg: #2e2b21;
78
+ --note: #e5e9e1;
79
+ --tip-bar: #a9b66a;
80
+ --tip-bg: #283023;
81
+ --tip: #b9c77e;
82
+ --warning-bar: #e8af43;
83
+ --warning-bg: #2e2b21;
84
+ --warning: #e8af43;
85
+ --caution-bar: #f0a17d;
86
+ --caution-bg: #33241f;
87
+ --caution: #f0a17d;
88
+ --hl-comment: #a2aca3;
89
+ --hl-keyword: #f0a17d;
90
+ --hl-operator: #f0a17d;
91
+ --hl-string: #b9c77e;
92
+ --hl-regexp: #b9c77e;
93
+ --hl-escape: #b9c77e;
94
+ --hl-number: #e8af43;
95
+ --hl-constant: #e8af43;
96
+ --hl-builtin: #e8af43;
97
+ --hl-property: #e5e9e1;
98
+ --hl-attribute: #e8af43;
99
+ --hl-function: #d6e4c8;
100
+ --hl-type: #e8af43;
101
+ --hl-parameter: #e8af43;
102
+ --hl-tag: #f0a17d;
103
+ --hl-heading: #f0a17d;
104
+ --hl-link: #f0a17d;
105
+ --hl-inserted: #b9c77e;
106
+ --hl-inserted-bg: #2e3f2b;
107
+ --hl-deleted: #f0a17d;
108
+ --hl-deleted-bg: #33241f;
109
+ --hl-line-bg: rgba(232, 175, 67, 0.15);
110
+ }
111
+ }
112
+ :root[data-theme="dark"] {
113
+ color-scheme: dark;
114
+ --text: #e5e9e1;
115
+ --heading: #d6e4c8;
116
+ --muted: #a2aca3;
117
+ --background: #1b201d;
118
+ --chrome: #252b27;
119
+ --surface: #252b27;
120
+ --border: #3a413b;
121
+ --link: #f0a17d;
122
+ --code: #b9c77e;
123
+ --selected: #2e3f2b;
124
+ --marker: #f0a17d;
125
+ --stripe-pine: #2e5a3c;
126
+ --note-bar: #e8af43;
127
+ --note-bg: #2e2b21;
128
+ --note: #e5e9e1;
129
+ --tip-bar: #a9b66a;
130
+ --tip-bg: #283023;
131
+ --tip: #b9c77e;
132
+ --warning-bar: #e8af43;
133
+ --warning-bg: #2e2b21;
134
+ --warning: #e8af43;
135
+ --caution-bar: #f0a17d;
136
+ --caution-bg: #33241f;
137
+ --caution: #f0a17d;
138
+ --hl-comment: #a2aca3;
139
+ --hl-keyword: #f0a17d;
140
+ --hl-operator: #f0a17d;
141
+ --hl-string: #b9c77e;
142
+ --hl-regexp: #b9c77e;
143
+ --hl-escape: #b9c77e;
144
+ --hl-number: #e8af43;
145
+ --hl-constant: #e8af43;
146
+ --hl-builtin: #e8af43;
147
+ --hl-property: #e5e9e1;
148
+ --hl-attribute: #e8af43;
149
+ --hl-function: #d6e4c8;
150
+ --hl-type: #e8af43;
151
+ --hl-parameter: #e8af43;
152
+ --hl-tag: #f0a17d;
153
+ --hl-heading: #f0a17d;
154
+ --hl-link: #f0a17d;
155
+ --hl-inserted: #b9c77e;
156
+ --hl-inserted-bg: #2e3f2b;
157
+ --hl-deleted: #f0a17d;
158
+ --hl-deleted-bg: #33241f;
159
+ --hl-line-bg: rgba(232, 175, 67, 0.15);
160
+ }
161
+
162
+ * { box-sizing: border-box; }
163
+ html { scroll-padding-top: 4rem; }
164
+ body { margin: 0; font: 1.0625rem/1.65 system-ui, sans-serif; color: var(--text); background: var(--background); }
165
+ a { color: var(--link); text-decoration: underline; text-underline-offset: 0.18em; }
166
+ ::selection { background: rgba(232, 175, 67, 0.4); }
167
+ h1, h2, h3, h4 { color: var(--heading); }
168
+ img { max-width: 100%; height: auto; }
169
+
170
+ .site-header { position: sticky; top: 0; z-index: 1; display: flex; align-items: center; gap: 1.5rem; padding: 0.75rem 1.25rem; background: var(--chrome); }
171
+ /* The four-color stripe: pine, burnt orange, harvest gold, avocado. */
172
+ .site-header::after { content: ""; position: absolute; left: 0; right: 0; bottom: -5px; height: 5px; background: linear-gradient(to right, var(--stripe-pine) 0 25%, #a23e20 25% 50%, #e8af43 50% 75%, #a9b66a 75%); }
173
+ .theme-switch { margin-left: auto; padding: 0.35rem 0.8rem; border: 1px solid var(--muted); border-radius: 0.375rem; background: none; color: var(--text); font: inherit; font-size: 0.9rem; cursor: pointer; }
174
+ #search + .theme-switch { margin-left: 0; }
175
+ .theme-switch:hover { background: var(--selected); }
176
+ :focus-visible { outline: 2px solid var(--marker); outline-offset: 2px; }
177
+ /* Off the screen until the keyboard reaches it: the first thing Tab gets to on each page. */
178
+ .skip-link { position: absolute; left: 1rem; top: -3rem; z-index: 2; padding: 0.4rem 0.9rem; border-radius: 4px; background: var(--heading); color: var(--background); font-weight: 600; }
179
+ .skip-link:focus { top: 0.5rem; }
180
+ .site-header nav { display: flex; gap: 1rem; }
181
+ /* Navigation is pine, like the headings; links in the text are burnt orange. */
182
+ .site-header a { color: var(--heading); text-decoration: none; }
183
+ .site-header nav a:hover { text-decoration: underline; text-decoration-color: var(--marker); text-decoration-thickness: 2px; text-underline-offset: 0.3em; }
184
+ .site-name { font-weight: 700; font-size: 1.15rem; color: var(--heading); }
185
+ .menu-link { display: none; }
186
+ #search { margin-left: auto; min-width: 12rem; }
187
+
188
+ /* The sidebar's column is tinted the whole way down, however short the sidebar is. */
189
+ .docs { margin-top: 5px; min-height: calc(100vh - 3.5rem); background: linear-gradient(to right, var(--chrome) 0 16rem, var(--border) 16rem calc(16rem + 1px), transparent calc(16rem + 1px)); display: grid; grid-template-columns: 16rem minmax(0, 1fr) 14rem; grid-template-areas: "sidebar main toc"; }
190
+ .docs > main { grid-area: main; padding: 1.5rem 2.5rem 4rem; max-width: calc(var(--width) + 5rem); }
191
+ .sidebar { grid-area: sidebar; padding: 1.25rem; font-size: 0.95rem; }
192
+ .toc { grid-area: toc; padding: 1.5rem 1.25rem; font-size: 0.9rem; }
193
+ .sidebar, .toc { position: sticky; top: 3.1rem; align-self: start; max-height: calc(100vh - 3.1rem); overflow-y: auto; }
194
+ .sidebar h2 { margin: 1.25rem 0 0.25rem; font-size: 0.8rem; text-transform: uppercase; letter-spacing: 0.04em; color: var(--muted); }
195
+ .sidebar h2:first-child { margin-top: 0; }
196
+ .sidebar ul, .toc ul { list-style: none; margin: 0; padding: 0; }
197
+ .toc ul ul { padding-left: 0.9rem; }
198
+ .sidebar a, .toc a { display: block; padding: 0.2rem 0.5rem; border-radius: 0.375rem; color: var(--text); text-decoration: none; }
199
+ .sidebar a:hover, .toc a:hover { background: var(--selected); }
200
+ .sidebar a[aria-current] { border-radius: 0; border-left: 4px solid var(--marker); padding-left: calc(0.5rem - 4px); background: var(--selected); color: var(--heading); font-weight: 600; }
201
+ .toc-title { margin: 0 0 0.25rem; padding: 0 0.5rem; font-weight: 600; }
202
+ .toc a { color: var(--muted); }
203
+
204
+ .home { max-width: var(--width); margin: 0 auto; padding: 3rem 1.25rem; }
205
+ .breadcrumbs { color: var(--muted); font-size: 0.9rem; }
206
+ h1 { margin: 0.25rem 0 1rem; font-size: 2.25rem; line-height: 1.2; }
207
+ main h2 { margin-top: 2.5rem; padding-bottom: 0.3rem; border-bottom: 1px solid var(--border); }
208
+ .anchor { margin-left: 0.25rem; color: var(--muted); text-decoration: none; opacity: 0; }
209
+ :is(h2, h3, h4):hover .anchor, .anchor:focus { opacity: 1; }
210
+
211
+ code { padding: 0.15em 0.35em; border-radius: 0.375rem; background: var(--surface); color: var(--code); font-size: 0.9em; }
212
+ pre { padding: 1rem; overflow-x: auto; border-radius: 0.5rem; background: var(--surface); line-height: 1.5; }
213
+ pre code { padding: 0; background: none; color: var(--text); }
214
+ table { border-collapse: collapse; display: block; overflow-x: auto; }
215
+ th, td { padding: 0.55rem 0.8rem; border-bottom: 1px solid var(--border); text-align: left; }
216
+ th { background: var(--chrome); border-bottom: 0; }
217
+ .task-list-item { list-style: none; margin-left: -1.25rem; }
218
+ blockquote { margin-inline: 0; padding-left: 1rem; border-left: 4px solid var(--border); color: var(--muted); }
219
+
220
+ /* :::note, :::tip, :::warning and :::caution, and GitHub's > [!NOTE] alerts. */
221
+ .note, .tip, .warning, .caution, .markdown-alert { --accent: var(--note); --bar: var(--note-bar); --tint: var(--note-bg); margin: 1.25rem 0; padding: 0.5rem 1.25rem; border-left: 5px solid var(--bar); background: var(--tint); }
222
+ .tip, .markdown-alert-tip { --accent: var(--tip); --bar: var(--tip-bar); --tint: var(--tip-bg); }
223
+ .warning, .markdown-alert-warning, .markdown-alert-important { --accent: var(--warning); --bar: var(--warning-bar); --tint: var(--warning-bg); }
224
+ .caution, .markdown-alert-caution { --accent: var(--caution); --bar: var(--caution-bar); --tint: var(--caution-bg); }
225
+ .container-title, .markdown-alert-title { margin: 0.25rem 0; font-weight: 700; color: var(--accent); }
226
+ details { margin: 1.25rem 0; padding: 0.5rem 1rem; border: 1px solid var(--border); border-radius: 0.5rem; }
227
+ summary { font-weight: 600; cursor: pointer; }
228
+
229
+ /* Tabs: labeled sections, until docs.js makes the labels buttons. */
230
+ .tabs { margin: 1.25rem 0; border: 1px solid var(--border); border-radius: 0.5rem; }
231
+ .tab { padding: 0 1rem; }
232
+ .tab + .tab { border-top: 1px solid var(--border); }
233
+ .tab-label { margin: 0.75rem 0 0; font-weight: 700; }
234
+ .tabs [role="tablist"] { display: flex; gap: 0.25rem; padding: 0.4rem 0.4rem 0; border-bottom: 1px solid var(--border); background: var(--surface); border-radius: 0.5rem 0.5rem 0 0; }
235
+ .tabs [role="tab"] { padding: 0.35rem 0.9rem; border: 0; border-bottom: 2px solid transparent; background: none; color: var(--muted); font: inherit; cursor: pointer; }
236
+ .tabs [role="tab"][aria-selected="true"] { border-color: var(--marker); color: var(--heading); font-weight: 600; }
237
+ .tabs [role="tablist"] ~ .tab { border-top: 0; }
238
+
239
+ .page-footer { margin-top: 3rem; padding-top: 1rem; border-top: 1px solid var(--border); }
240
+ .pager { display: flex; justify-content: space-between; gap: 1rem; }
241
+ .footnotes { margin-top: 2.5rem; font-size: 0.9rem; color: var(--muted); }
242
+
243
+ @media (max-width: 72rem) {
244
+ .docs { grid-template-columns: 16rem minmax(0, 1fr); grid-template-areas: "sidebar main"; }
245
+ .toc { display: none; }
246
+ }
247
+ @media (max-width: 50rem) {
248
+ .docs { display: block; }
249
+ .docs > main { padding: 1.25rem; }
250
+ .docs { background: none; }
251
+ .sidebar { position: static; max-height: none; border-top: 1px solid var(--border); background: var(--chrome); }
252
+ .site-header { gap: 0.9rem; padding: 0.6rem 1rem; }
253
+ .site-name, .site-header nav, .theme-switch { white-space: nowrap; }
254
+ .site-name { font-size: 1.05rem; }
255
+ .theme-switch { padding: 0.25rem 0.6rem; font-size: 0.85rem; }
256
+ .menu-link { display: inline; }
257
+ }