Merge commit '5be51ac3db225d5df501ed1fa1499c41d97dbf65'

Author: bep

docs/.cspell.json

@@ -60,6 +60,7 @@
     "redirections",
     "subexpression",
     "suppressible",
+    "synchronisation",
     "templating",
     "transpile",
     "unmarshal",
@@ -161,7 +162,7 @@
     "# ----------------------------------------------------------------------",
     "achristie",
     "ccpa",
-    "crpa",
+    "cpra",
     "ddmaurier",
     "dring",
     "fleqn",
@@ -171,6 +172,8 @@
     "jsmith",
     "leqno",
     "milli",
+    "monokai",
+    "mysanityprojectid",
     "rgba",
     "rsmith",
     "tdewolff",

docs/.gitignore

@@ -4,10 +4,9 @@
 /.vscode
 /dist
 /public
+/resources
 hugo_stats.json
 node_modules/
 nohup.out
 package-lock.json
-public/
-resources/
-trace.out
+trace.out

docs/.markdownlint.yaml

@@ -22,5 +22,6 @@ MD041: false
 MD046: false
 MD049: false
 MD050: false
+MD051: false
 MD053: false
 MD055: false

docs/.prettierignore

@@ -0,0 +1,18 @@
+# Ignore all SVG icons.
+**/icons.html
+
+# These are whitespace sensitive.
+layouts/_default/_markup/render-code*
+layouts/_default/_markup/render-table*
+layouts/shortcodes/glossary-term.html
+layouts/shortcodes/glossary.html
+layouts/shortcodes/highlighting-styles.html
+layouts/shortcodes/list-pages-in-section.html
+layouts/shortcodes/quick-reference.html
+
+# No root node.
+layouts/partials/layouts/head/head.html
+
+# Auto generated.
+assets/css/components/chroma*.css
+assets/jsconfig.json

docs/.prettierrc

@@ -0,0 +1,24 @@
+{
+  "plugins": [
+    "prettier-plugin-go-template",
+    "@awmottaz/prettier-plugin-void-html"
+  ],
+  "overrides": [
+    {
+      "files": ["*.html"],
+      "options": {
+        "parser": "go-template",
+        "goTemplateBracketSpacing": true,
+        "bracketSameLine": true
+      }
+    },
+    {
+      "files": ["*.js", "*.ts"],
+      "options": {
+        "useTabs": true,
+        "printWidth": 120,
+        "singleQuote": true
+      }
+    }
+  ]
+}

docs/LICENSE.md

@@ -1,3 +1,3 @@
 See [content/LICENSE.md](content/LICENSE.md) for the license of the content of this repository.
 
-The theme (layouts, CSS, JavaScript etc.) of this repository has no open source license. It is custom made for the Hugo sites and is not meant for reuse. 
+The theme (layouts, CSS, JavaScript etc.) of this repository has no open source license. It is custom made for the Hugo sites and is not meant for reuse.

docs/README.md

@@ -19,9 +19,9 @@ Please see the [contributing] section for guidelines, examples, and process.
 
 # Install
 
-```bash
+```sh
 npm i
 hugo server
 ```
 
-**Note:** We're working on removing the need to run `npm i` for local development. Stay tuned.
+**Note:** We're working on removing the need to run `npm i` for local development. Stay tuned.

docs/archetypes/default.md

@@ -0,0 +1,6 @@
+---
+title: {{ replace .File.ContentBaseName "-" " " | strings.FirstUpper }}
+description:
+categories: []
+keywords: []
+---

docs/archetypes/functions.md

@@ -3,9 +3,9 @@ title: {{ replace .File.ContentBaseName "-" " " | title }}
 description:
 categories: []
 keywords: []
-action:
-  aliases: []
-  related: []
-  returnType:
-  signatures: []
+params:
+  functions_and_methods:
+    aliases: []
+    returnType:
+    signatures: []
 ---

docs/archetypes/glossary.md

@@ -1,6 +1,7 @@
 ---
 title: {{ replace .File.ContentBaseName "-" " " }}
-reference: 
+params:
+  reference: 
 ---
 
 <!--

docs/archetypes/methods.md

@@ -3,8 +3,8 @@ title: {{ replace .File.ContentBaseName "-" " " | title }}
 description:
 categories: []
 keywords: []
-action:
-  related: []
-  returnType:
-  signatures: []
+params:
+  functions_and_methods:
+    returnType:
+    signatures: []
 ---

docs/archetypes/news.md

@@ -0,0 +1,7 @@
+---
+title: {{ replace .File.ContentBaseName "-" " " | strings.FirstUpper }}
+description:
+categories: []
+keywords: []
+publishDate: {{ .Date }}
+---

docs/archetypes/news/index.md

@@ -1,4 +1,4 @@
-/* The ordeer of these does not matter. */
+/* The order of these does not matter. */
 @import "./content.css";
 @import "./fonts.css";
 @import "./helpers.css";

docs/archetypes/showcase/bio.md

@@ -5,7 +5,7 @@
 /* CodeLine */ .dark .chroma .cl {  }
 /* LineTableTD */ .dark .chroma .lntd { vertical-align: top; padding: 0; margin: 0; border: 0; }
 /* LineTable */ .dark .chroma .lntable { border-spacing: 0; padding: 0; margin: 0; border: 0; }
-/* LineHighlight */ .dark .chroma .hl { background-color: #ffffcc }
+/* LineHighlight */ .dark .chroma .hl { background-color: rgb(0,19,28) }
 /* LineNumbersTable */ .dark .chroma .lnt { white-space: pre; user-select: none; margin-right: 0.4em; padding: 0 0.4em 0 0.4em;color: #7f7f7f }
 /* LineNumbers */ .dark .chroma .ln { white-space: pre; user-select: none; margin-right: 0.4em; padding: 0 0.4em 0 0.4em;color: #7f7f7f }
 /* Line */ .dark .chroma .line { display: flex; }

docs/archetypes/showcase/index.md

@@ -12,31 +12,32 @@
 }
 
 .highlight code {
-  @apply text-sm;
+  @apply text-sm/6;
 }
 
 .content {
   @apply prose prose-sm sm:prose-base prose-stone max-w-none dark:prose-invert dark:text-slate-200;
   /* headings */
-  @apply prose-h4:font-bold prose-h5:font-bold prose-h6:font-bold;
+  @apply prose-headings:font-semibold;
   /* lead */
   @apply prose-lead:text-slate-500 prose-lead:text-xl prose-lead:mt-2 sm:prose-lead:mt-4 prose-lead:leading-relaxed dark:prose-lead:text-slate-400;
   /* links */
-  @apply prose-a:text-primary prose-a:hover:text-primary/70 prose-a:underline;
-  @apply prose-a:prose-code:underline prose-a:prose-code:hover:text-primary/70 prose-a:prose-code:hover:underline;
+  @apply prose-a:text-primary dark:prose-a:text-blue-500 prose-a:hover:text-blue-500 dark:prose-a:hover:text-blue-400 prose-a:underline;
+  @apply prose-a:prose-code:underline prose-a:prose-code:hover:text-blue-500 prose-a:prose-code:hover:underline;
   /* pre */
   @apply prose-pre:text-gray-800 prose-pre:border-1 prose-pre:border-gray-100 prose-pre:bg-light dark:prose-pre:bg-dark dark:prose-pre:ring-1 dark:prose-pre:ring-slate-300/10;
   /* code */
   @apply prose-code:px-0.5 prose-code:text-gray-500 prose-code:dark:text-gray-300 border-none;
   @apply prose-code:before:hidden prose-code:after:hidden prose-code:font-mono;
+  @apply prose-table:prose-th:prose-code:text-white;
   /* tables */
-  @apply prose-table:border-2 prose-table:border-gray-100  prose-table:dark:border-gray-800 prose-table:relative prose-table:overflow-scroll prose-table:prose-th:font-bold prose-table:prose-th:bg-blue-500 dark:prose-table:prose-th:bg-blue-500/50 prose-table:prose-th:p-2 prose-table:prose-td:p-2 prose-table:prose-th:text-white;
+  @apply prose-table:w-auto prose-table:border-2 prose-table:border-gray-100 prose-table:dark:border-gray-800 prose-table:prose-th:font-bold prose-table:prose-th:bg-blue-500 dark:prose-table:prose-th:bg-blue-500/50 prose-table:prose-th:p-2 prose-table:prose-td:p-2 prose-table:prose-th:text-white;
   /* hr */
   @apply dark:prose-hr:border-slate-800;
-
-  h6 + * {
-    @apply mt-2;
-  }
+  /* ol */
+  @apply prose-ol:marker:prose dark:prose-ol:marker:text-gray-300;
+  /* ul */
+  @apply prose-ul:marker:text-gray-500 dark:prose-ul:marker:text-gray-300;
 }
 
 /* This will not match highlighting inside e.g. the code-toggle shortcode. */

docs/assets/css/components/all.css

@@ -16,7 +16,5 @@
 
 /* Turbo styles */
 .turbo-progress-bar {
-  @apply bg-blue-500;
-  opacity: 0.35;
-  height: 3px;
+  visibility: hidden;
 }

docs/assets/css/components/chroma_dark.css

@@ -76,8 +76,9 @@
   --color-green-950: #051410;
 
   /* Fonts. */
-  --font-sans: "Mulish", ui-sans-serif, system-ui, sans-serif,
-    "Apple Color Emoji", "Segoe UI Emoji", "Segoe UI Symbol", "Noto Color Emoji";
+  --font-sans:
+    "Mulish", ui-sans-serif, system-ui, sans-serif, "Apple Color Emoji",
+    "Segoe UI Emoji", "Segoe UI Symbol", "Noto Color Emoji";
 }
 
 html {
@@ -121,3 +122,10 @@ body {
 .algolia-docsearch-suggestion--highlight {
   color: var(--color-primary);
 }
+
+/* Footnotes */
+.footnote-backref,
+.footnote-ref {
+  text-decoration: none;
+  padding-left: .0625em;
+}

docs/assets/css/components/content.css

@@ -1,6 +1,6 @@
 var debug = 0 ? console.log.bind(console, '[explorer]') : function () {};
 
-// This is cureently not used, but kept in case I change my mind.
+// This is currently not used, but kept in case I change my mind.
 export const explorer = (Alpine) => ({
 	uiState: {
 		containerScrollTop: -1,

docs/assets/css/components/view-transitions.css

@@ -1,6 +1,24 @@
 export const navbar = (Alpine) => ({
 	init: function () {
 		Alpine.bind(this.$root, this.root);
+
+		return this.$nextTick(() => {
+			let contentEl = document.querySelector('.content:not(.content--ready)');
+			if (contentEl) {
+				contentEl.classList.add('content--ready');
+				let anchorTemplate = document.getElementById('anchor-heading');
+				if (anchorTemplate) {
+					let els = contentEl.querySelectorAll('h2[id], h3[id], h4[id], h5[id], h6[id], dt[id]');
+					for (let i = 0; i < els.length; i++) {
+						let el = els[i];
+						el.classList.add('group');
+						let a = anchorTemplate.content.cloneNode(true).firstElementChild;
+						a.href = '#' + el.id;
+						el.appendChild(a);
+					}
+				}
+			}
+		});
 	},
 	root: {
 		['@scroll.window.debounce.10ms'](event) {

docs/assets/css/styles.css

@@ -1,3 +1,5 @@
+import { LRUCache } from '../../helpers';
+
 const designMode = false;
 
 const groupByLvl0 = (array) => {
@@ -33,10 +35,10 @@ const applyHelperFuncs = (array) => {
 };
 
 export const search = (Alpine, cfg) => ({
-	query: designMode ? 'shortcodes' : '',
+	query: designMode ? 'apac' : '',
 	open: designMode,
 	result: {},
-
+	cache: new LRUCache(10), // Small cache, avoids network requests on e.g. backspace.
 	init() {
 		Alpine.bind(this.$root, this.root);
 
@@ -66,6 +68,13 @@ export const search = (Alpine, cfg) => ({
 			this.result = {};
 			return;
 		}
+
+		// Check cache first.
+		const cached = this.cache.get(this.query);
+		if (cached) {
+			this.result = cached;
+			return;
+		}
 		var queries = {
 			requests: [
 				{
@@ -91,6 +100,7 @@ export const search = (Alpine, cfg) => ({
 			.then((response) => response.json())
 			.then((data) => {
 				this.result = groupByLvl0(applyHelperFuncs(data.results[0].hits));
+				this.cache.put(this.query, this.result);
 			});
 	},
 	root: {
@@ -102,7 +112,7 @@ export const search = (Alpine, cfg) => ({
 		['@search-toggle.window']() {
 			this.toggleOpen();
 		},
-		['@keydown.meta.k.window.prevent']() {
+		['@keydown.slash.window.prevent']() {
 			this.toggleOpen();
 		},
 	},

docs/assets/js/alpinejs/data/explorer.js

@@ -23,7 +23,7 @@ export const toc = (Alpine) => ({
 		});
 
 		return this.$nextTick(() => {
-			let contentEl = document.getElementById('content');
+			let contentEl = document.getElementById('article');
 			if (contentEl) {
 				const handleIntersect = (entries) => {
 					if (this.justClicked) {