Merge #8 from RealA10N/golang-packages

Host Golang Packages

mdsvex.config.js

@@ -12,7 +12,10 @@ const config = defineConfig({
 
 	remarkPlugins: [[readingTime, { wpm: 185 }], remarkMath],
 	rehypePlugins: [rehypeKatexSvelte],
-	layout: 'src/routes/posts/_PostLayout.svelte'
+	layout: {
+		post: 'src/routes/posts/_PostLayout.svelte',
+		package: 'src/routes/x/_PackageLayout.svelte'
+	}
 });
 
 export default config;

src/lib/Header.svelte

@@ -1,15 +1,20 @@
 <script lang="ts">
-	import '@fontsource/zilla-slab/300-italic.css';
+	export let title: string;
+	export let description: string;
+	export let tags: string[] = [];
 </script>
 
-<div class="text-center font-thin italic my-8 bg-zinc-100 dark:bg-zinc-900 z-50">
-	<a
-		href="/"
-		class="relative before:absolute before:left-0 before:bottom-0
-			before:w-full before:h-[2px] before:rounded no-underline
-			before:bg-red-500 before:transition-transform
-			before:scale-x-100 before:hover:scale-x-105"
-	>
-		Alon Krymgand
-	</a>
-</div>
+<header class="flex flex-col items-center mb-4 text-zinc-700 dark:text-zinc-300">
+	<h1 class="text-center mt-0">{title}</h1>
+	<div class="font-medium tracking-wider text-md italic text-center">
+		{description}
+	</div>
+
+	{#if tags.length > 0}
+		<ul class="flex flex-wrap justify-center mt-1 gap-2">
+			{#each tags as tag}
+				<li class="tag m-0">{tag}</li>
+			{/each}
+		</ul>
+	{/if}
+</header>

src/lib/Title.svelte

@@ -0,0 +1,15 @@
+<script lang="ts">
+	import '@fontsource/zilla-slab/300-italic.css';
+</script>
+
+<div class="text-center font-thin italic my-8 bg-zinc-100 dark:bg-zinc-900 z-50">
+	<a
+		href="/"
+		class="relative before:absolute before:left-0 before:bottom-0
+			before:w-full before:h-[2px] before:rounded no-underline
+			before:bg-red-500 before:transition-transform
+			before:scale-x-100 before:hover:scale-x-105"
+	>
+		Alon Krymgand
+	</a>
+</div>

src/lib/interfaces/package.ts

@@ -0,0 +1,15 @@
+export interface Package {
+	name: string;
+	title: string;
+	description: string;
+	versionSourceControl: 'bzr' | 'fossil' | 'git' | 'hg' | 'svn';
+	sourceUrl: string;
+}
+
+export const packageUrl = (pkg: Package) => {
+	return 'alon.kr/x/' + pkg.name;
+};
+
+export const documentationUrl = (pkg: Package) => {
+	return 'https://pkg.go.dev/' + packageUrl(pkg);
+};

src/routes/+layout.svelte

@@ -1,13 +1,13 @@
 <script lang="ts">
 	import '$src/app.css';
 	import '@fontsource/zilla-slab';
-	import Header from '$lib/Header.svelte';
+	import Title from '$src/lib/Title.svelte';
 	import LoadingBar from '$lib/LoadingBar.svelte';
 </script>
 
 <LoadingBar />
 
-<Header />
+<Title />
 
 <main class="max-w-3xl px-6 m-auto">
 	<slot />

src/routes/posts/PostLayout.svelte

@@ -1,6 +1,7 @@
 <script lang="ts">
 	import { browser } from '$app/environment';
 	import Metadata from '$lib/Metadata.svelte';
+	import Header from '$src/lib/Header.svelte';
 	import { type Post, toTaglist } from '$src/lib/interfaces/post';
 	export let post: Post;
 
@@ -9,15 +10,7 @@
 
 <Metadata title={post.title} description={post.description} />
 
-<header class="mb-4 text-zinc-700 dark:text-zinc-300">
-	<h1>{post.title}</h1>
-	<div class="font-medium tracking-wider text-sm italic">
-		{post.description}
-	</div>
-	<ul class="flex flex-wrap mt-1 gap-2">
-		{#each toTaglist(post, true) as tag}<li class="tag m-0">{tag}</li>{/each}
-	</ul>
-</header>
+<Header title={post.title} description={post.description} tags={toTaglist(post, true)} />
 
 <article class="text-justify">
 	<slot />

src/routes/posts/christofides/+page.md

@@ -1,4 +1,5 @@
 ---
+layout: post
 title: The Christofides Algorithm
 description: "Approximating the Metric TSP Problem: An Introduction to Combinatorial Optimization."
 published: 2023-05-20

src/routes/x/PackageLayout.svelte

@@ -0,0 +1,27 @@
+<script lang="ts">
+	import { type Package, packageUrl, documentationUrl } from '$src/lib/interfaces/package';
+	import Header from '$src/lib/Header.svelte';
+	import Metadata from '$src/lib/Metadata.svelte';
+
+	export let pkg: Package;
+	export const prerender = true;
+</script>
+
+<svelte:head>
+	<meta name="go-import" content="{packageUrl(pkg)} {pkg.versionSourceControl} {pkg.sourceUrl}" />
+</svelte:head>
+
+<Metadata title={pkg.title} description={pkg.description} />
+
+<Header title={pkg.title} description={pkg.description} />
+
+<h2>Get</h2>
+<code>go get {packageUrl(pkg)}</code>
+
+<h2>Source</h2>
+<p>can be found <a href={pkg.sourceUrl}>here</a>.</p>
+
+<h2>Documentation</h2>
+<p>can be found <a href={documentationUrl(pkg)}>here</a>.</p>
+
+<slot />

src/routes/x/_PackageLayout.svelte

@@ -0,0 +1,12 @@
+<!-- This is a workaround, since MDSvex does not officially support
+	preprocessing (typescript and postcss) in layout files.
+	So, this layout file does not contain any of that, but it directly imports
+	one does use it. -->
+
+<script>
+	import PackageLayout from './PackageLayout.svelte';
+</script>
+
+<PackageLayout pkg={$$props}>
+	<slot />
+</PackageLayout>

src/routes/x/faststringmap/+page.md

@@ -0,0 +1,8 @@
+---
+layout: package
+name: faststringmap
+title: Fast String Map
+description:  A fast (5x) string keyed read-only map - good for keys using a small set of runes.
+sourceUrl: https://github.com/RealA10N/faststringmap
+versionSourceControl: git
+---