{post.data.excerpt}
} +{post.data.title}
+{post.data.excerpt}
+
+
+```
+
+When an admin is logged in and views the site, these attributes enable click-to-edit functionality.
+
+## Common Page Patterns
+
+### List page (e.g., `/posts/index.astro`)
+
+```astro
+---
+import { getEmDashCollection } from "emdash";
+import { Image } from "emdash/ui";
+import Base from "../../layouts/Base.astro";
+
+const { entries: posts, cacheHint } = await getEmDashCollection("posts", {
+ orderBy: { published_at: "desc" },
+ limit: 20,
+});
+if (Astro.cache?.enabled) Astro.cache.set(cacheHint);
+---
+
+
+ )}
+ {post.data.title}
+
+ {tags.map(t => {t.label})}
+
+ )}
+ {term.label}
+ {posts.map(post => ( + {post.data.title} + ))} + +``` + +### RSS feed (e.g., `/rss.xml.ts`) + +```typescript +import type { APIRoute } from "astro"; +import { getEmDashCollection } from "emdash"; + +const siteTitle = "My Site"; + +export const GET: APIRoute = async ({ url }) => { + const siteUrl = url.origin; + const { entries: posts } = await getEmDashCollection("posts", { + orderBy: { published_at: "desc" }, + limit: 20, + }); + + const items = posts + .filter((p) => p.data.publishedAt) + .map((post) => { + const postUrl = `${siteUrl}/posts/${post.id}`; + return `Page not found
+The page you're looking for doesn't exist.
+ Go home + +``` + +### Empty state + +When a collection has no content, show a helpful empty state: + +```astro +{posts.length === 0 ? ( +No posts yet
+Create your first post in the admin panel.
+ Create a post +Search
+{term.label}
+No posts in this category yet.
+ ) : ( +
+ {filteredPosts.map(({ post, tags }) => (
+ ({ slug: t.slug, label: t.label }))}
+ edit={post.edit}
+ />
+ ))}
+
+ )
+ }
+
+ No posts yet
+Create your first post in the admin panel.
+ + Create a post + +
+ {/* Featured Post - Side by side */}
+ {featuredPost && (
+
+
+ )}
+
+ {/* Latest Posts */}
+ {gridPostsWithTags.length > 0 && (
+
+
+
+
+ )}
+
+ )
+ }
+
+
+
diff --git a/potluck/src/pages/pages/[slug].astro b/potluck/src/pages/pages/[slug].astro
new file mode 100644
index 0000000..be5473d
--- /dev/null
+++ b/potluck/src/pages/pages/[slug].astro
@@ -0,0 +1,124 @@
+---
+import {
+ getEmDashEntry,
+ getSeoMeta,
+ decodeSlug,
+ getSiteSettings,
+} from "emdash";
+import { PortableText } from "emdash/ui";
+import Base from "../../layouts/Base.astro";
+import { resolveBlogSiteIdentity } from "../../utils/site-identity";
+
+const slug = decodeSlug(Astro.params.slug);
+
+if (!slug) {
+ return Astro.redirect("/404");
+}
+
+const { entry: page, cacheHint } = await getEmDashEntry("pages", slug);
+
+if (!page) {
+ return Astro.redirect("/404");
+}
+
+if (Astro.cache?.enabled) Astro.cache.set(cacheHint);
+const { siteTitle } = resolveBlogSiteIdentity(await getSiteSettings());
+const seo = getSeoMeta(page, {
+ siteTitle,
+ siteUrl: Astro.url.origin,
+ path: Astro.url.pathname.replace(/\/$/, ""),
+});
+---
+
+
+
+
+
+
+
+
+
+
+ {featuredBylines.length > 0 && (
+ <>
+
+
+
+ {featuredBylines.slice(0, 2).map((credit, index) => (
+ <>
+ {index > 0 && }
+
+ {credit.byline.avatarMediaId && (
+ 
+ )}
+
+
+
+ ))}
+ {featuredBylines.length > 2 && (
+
+ )}
+
+
+
+ )}
+ {formatDate(featuredPost.data.publishedAt) && (
+
+ )}
+
+
+ {getReadingTime(featuredPost.data.content)} min read
+
+
+ )}
+
+
+
+ ))}
+ {featuredBylines.length > 2 && (
+
+ )}
+ {featuredPost.data.title}
+ + {featuredPost.data.excerpt && ( +{featuredPost.data.excerpt}
+ )} + {featuredTags.length > 0 && ( + + )} +Latest
+ {hasMorePosts && ( + + View all + + )} +
+ {gridPostsWithTags.map(({ post, tags, bylines }) => (
+
+ {page.data.title}
+
+
+
+
+ )
+ }
+
+ {/* Three-column layout */}
+
+ {/* Left gutter: Meta information */}
+
+
+ {/* Main content */}
+
+
+
+
+
+
+
+
+ {/* Right gutter: TOC + Sidebar widgets */}
+
+ {post.data.title}
+ { + post.data.excerpt && ( ++ {post.data.excerpt} +
+ ) + } +
+
+
+
+
+
+
+ Continue reading
+
+ {otherPostsWithTags.map(
+ ({ post: p, tags: postTags, bylines: postBylines }) => (
+ ({ slug: t.slug, label: t.label }))}
+ bylines={postBylines}
+ edit={p.edit}
+ />
+ ),
+ )}
+
+
+
+
+
+ {
+ posts.length === 0 ? (
+
+
+
+
diff --git a/potluck/src/pages/rss.xml.ts b/potluck/src/pages/rss.xml.ts
new file mode 100644
index 0000000..0dfd56b
--- /dev/null
+++ b/potluck/src/pages/rss.xml.ts
@@ -0,0 +1,70 @@
+import type { APIRoute } from "astro";
+import { getEmDashCollection, getSiteSettings } from "emdash";
+
+import { resolveBlogSiteIdentity } from "../utils/site-identity";
+
+export const GET: APIRoute = async ({ site, url }) => {
+ const siteUrl = site ?? new URL(url.origin);
+ const { siteTitle, siteTagline } = resolveBlogSiteIdentity(await getSiteSettings());
+
+ const { entries: posts } = await getEmDashCollection("posts", {
+ orderBy: { published_at: "desc" },
+ limit: 20,
+ });
+
+ const items = posts
+ .map((post) => {
+ if (!post.data.publishedAt) return null;
+ const pubDate = post.data.publishedAt.toUTCString();
+
+ const postUrl = new URL(`/posts/${post.id}`, siteUrl).href;
+ const title = escapeXml(post.data.title || "Untitled");
+ const description = escapeXml(post.data.excerpt || "");
+
+ return ` All Posts
++ {posts.length}{" "} + {posts.length === 1 ? "article" : "articles"} +
+No posts yet.
+ ) : ( +
+ {postsWithTags.map(({ post, tags, bylines }) => (
+
+
+
+ ))}
+
+ )
+ }
+
+
+ {bylines.length > 0 && (
+ <>
+
+
+ {bylines.slice(0, 2).map((credit, index) => (
+ <>
+ {index > 0 && }
+
+ {credit.byline.avatarMediaId && (
+
+ )}
+
+
+
+ ))}
+ {bylines.length > 2 && (
+
+ )}
+
+
+
+ )}
+ {post.data.publishedAt && (
+
+ )}
+ {post.data.publishedAt && }
+ {getReadingTime(post.data.content)} min read
+
+ )}
+
+
+
+ ))}
+ {bylines.length > 2 && (
+
+ )}
+ {post.data.title}
+ {post.data.excerpt && ( +{post.data.excerpt}
+ )} + + {tags.length > 0 && ( + + )} +Search
+ + + + { + query && ( ++ {results.length === 0 + ? `No results for "${query}"` + : `${results.length} result${results.length === 1 ? "" : "s"} for "${query}"`} +
+ ) + } + + { + results.length > 0 && ( +-
+ {results.map((result) => (
+
-
+
+
{result.title ?? "Untitled"}
+ {result.snippet && ( + + )} + +
+ ))}
+
Enter a search term to find posts.
} +{term.label}
+No posts with this tag yet.
+ ) : ( +
+ {filteredPosts.map(({ post, tags }) => (
+ ({ slug: t.slug, label: t.label }))}
+ edit={post.edit}
+ />
+ ))}
+
+ )
+ }
+
+