getfilepress 0.1.28 → 0.1.30

package/README.md

@@ -8,7 +8,17 @@ Written **FilePress**. npm **`getfilepress`**. CLI **`filepress`** (same script
 
 ## Start a site
 
-From a clone of this repo:
+Shortest path: a folder with `filepress.config.ts` (`title`, `url`), `posts/*.md`, and `"getfilepress": "^0.1.29"` in `package.json`.
+
+```bash
+pnpm install
+pnpm build      # → ./build/
+pnpm preview    # serve build/, no Genie
+```
+
+`pnpm dev` is optional (Genie). FilePress does not upload `build/`.
+
+From a clone of this repo, scaffold a fuller starter:
 
 ```bash
 pnpm install
@@ -18,7 +28,7 @@ cd ../my-blog && pnpm install && pnpm dev
 
 `filepress new "Title"` stamps `posts/YYYY-MM-DD-slug.md`. Config, frontmatter, images, and commands: [Docs](https://getfilepress.com/docs).
 
-Pin CI on npm (`getfilepress` current is `0.1.19`) or a git SHA / existing tag. `link:` is local only.
+Pin CI on npm (`getfilepress` current is `0.1.29`) or a git SHA / existing tag. `link:` is local only.
 
 ## Import
 

package/package.json

@@ -1,6 +1,6 @@
 {
 	"name": "getfilepress",
-	"version": "0.1.28",
+	"version": "0.1.30",
 	"private": false,
 	"type": "module",
 	"description": "FilePress — file-based Markdown blog engine. Link this package from a content-only site (config + posts), then run `filepress build`.",

package/packages/app/src/routes/tags/[tag]/+page.svelte

@@ -1,19 +1,19 @@
 <script lang="ts">
 	import type { PageData } from './$types';
-	import { PostCard } from '@filepress/core';
+	import { PostCard, tagDisplayLabel } from '@filepress/core';
 	import config from '$site-config';
 
 	let { data }: { data: PageData } = $props();
+	const heading = $derived(tagDisplayLabel(config.topics, data.tag));
 </script>
 
 <svelte:head>
-	<title>{data.tag} — {config.title}</title>
-	<meta name="description" content="Posts tagged {data.tag} on {config.title}." />
+	<title>{heading} — {config.title}</title>
+	<meta name="description" content="Posts tagged {heading} on {config.title}." />
 </svelte:head>
 
 <header class="post-header">
-	<p class="eyebrow">Tag</p>
-	<h1>{data.tag}</h1>
+	<h1>{heading}</h1>
 </header>
 
 <ul class="post-list">

package/packages/core/src/lib/format.ts

@@ -34,3 +34,17 @@ export function readingMinutes(body: string, wordsPerMinute = 228): number {
 export function formatReadingTime(minutes: number): string {
 	return minutes === 1 ? '1 min read' : `${minutes} min read`;
 }
+
+/** Display name for a tag: curated topic label, else title-cased slug. */
+export function tagDisplayLabel(
+	topics: Array<{ label: string; tag: string }>,
+	tag: string
+): string {
+	const curated = topics.find((topic) => topic.tag === tag)?.label.trim();
+	if (curated) return curated;
+	return tag
+		.split('-')
+		.filter(Boolean)
+		.map((word) => word.charAt(0).toUpperCase() + word.slice(1))
+		.join(' ');
+}

package/packages/core/src/lib/index.ts

@@ -32,6 +32,6 @@ export type {
 
 export { isPathMountHref } from './paths-shared';
 
-export { formatDate, formatReadingTime, readingMinutes } from './format';
+export { formatDate, formatReadingTime, readingMinutes, tagDisplayLabel } from './format';
 
 export type { PostMeta, PostSource, RenderedPost, RawFrontmatter } from './content/types';