mirror of
https://github.com/waynesutton/markdown-site.git
synced 2026-01-12 04:09:14 +00:00
Updated:
- content/blog/raw-markdown-and-copy-improvements.md
- Changed title from 'v1.7 and v1.8' to 'v1.7 to v1.10'
- Added Fork configuration section (v1.10.0) with 9-file table
- Added Scroll-to-top section (v1.9.0) with configuration options
- Updated summary to include all features from v1.7 to v1.10
- Fixed image path to /images/v17.png
- Updated sync command guidance for dev vs prod
- TASK.md
- Added new To Do items for future features
- Removed duplicate Future Enhancements section
- content/pages/docs.md
- Added Mobile menu section
- Added Copy Page dropdown table with all options
- Added Markdown tables section
- content/pages/about.md
- Updated Features list with new v1.8.0 features
- content/blog/setup-guide.md
- Added image field to pages schema
- Updated Project structure with new directories
- Added /raw/{slug}.md to API endpoints
- Added Mobile Navigation and Copy Page Dropdown sections
- Added featured image documentation with ordering details
Documentation now covers all features from v1.7.0 through v1.10.0.
205 lines
5.2 KiB
TypeScript
205 lines
5.2 KiB
TypeScript
import { query, mutation } from "./_generated/server";
|
|
import { v } from "convex/values";
|
|
|
|
// Get all published pages for navigation
|
|
export const getAllPages = query({
|
|
args: {},
|
|
returns: v.array(
|
|
v.object({
|
|
_id: v.id("pages"),
|
|
slug: v.string(),
|
|
title: v.string(),
|
|
published: v.boolean(),
|
|
order: v.optional(v.number()),
|
|
excerpt: v.optional(v.string()),
|
|
image: v.optional(v.string()),
|
|
featured: v.optional(v.boolean()),
|
|
featuredOrder: v.optional(v.number()),
|
|
}),
|
|
),
|
|
handler: async (ctx) => {
|
|
const pages = await ctx.db
|
|
.query("pages")
|
|
.withIndex("by_published", (q) => q.eq("published", true))
|
|
.collect();
|
|
|
|
// Sort by order (lower numbers first), then by title
|
|
const sortedPages = pages.sort((a, b) => {
|
|
const orderA = a.order ?? 999;
|
|
const orderB = b.order ?? 999;
|
|
if (orderA !== orderB) return orderA - orderB;
|
|
return a.title.localeCompare(b.title);
|
|
});
|
|
|
|
return sortedPages.map((page) => ({
|
|
_id: page._id,
|
|
slug: page.slug,
|
|
title: page.title,
|
|
published: page.published,
|
|
order: page.order,
|
|
excerpt: page.excerpt,
|
|
image: page.image,
|
|
featured: page.featured,
|
|
featuredOrder: page.featuredOrder,
|
|
}));
|
|
},
|
|
});
|
|
|
|
// Get featured pages for the homepage featured section
|
|
export const getFeaturedPages = query({
|
|
args: {},
|
|
returns: v.array(
|
|
v.object({
|
|
_id: v.id("pages"),
|
|
slug: v.string(),
|
|
title: v.string(),
|
|
excerpt: v.optional(v.string()),
|
|
image: v.optional(v.string()),
|
|
featuredOrder: v.optional(v.number()),
|
|
}),
|
|
),
|
|
handler: async (ctx) => {
|
|
const pages = await ctx.db
|
|
.query("pages")
|
|
.withIndex("by_featured", (q) => q.eq("featured", true))
|
|
.collect();
|
|
|
|
// Filter to only published pages and sort by featuredOrder
|
|
const featuredPages = pages
|
|
.filter((p) => p.published)
|
|
.sort((a, b) => {
|
|
const orderA = a.featuredOrder ?? 999;
|
|
const orderB = b.featuredOrder ?? 999;
|
|
return orderA - orderB;
|
|
});
|
|
|
|
return featuredPages.map((page) => ({
|
|
_id: page._id,
|
|
slug: page.slug,
|
|
title: page.title,
|
|
excerpt: page.excerpt,
|
|
image: page.image,
|
|
featuredOrder: page.featuredOrder,
|
|
}));
|
|
},
|
|
});
|
|
|
|
// Get a single page by slug
|
|
export const getPageBySlug = query({
|
|
args: {
|
|
slug: v.string(),
|
|
},
|
|
returns: v.union(
|
|
v.object({
|
|
_id: v.id("pages"),
|
|
slug: v.string(),
|
|
title: v.string(),
|
|
content: v.string(),
|
|
published: v.boolean(),
|
|
order: v.optional(v.number()),
|
|
excerpt: v.optional(v.string()),
|
|
image: v.optional(v.string()),
|
|
featured: v.optional(v.boolean()),
|
|
featuredOrder: v.optional(v.number()),
|
|
}),
|
|
v.null(),
|
|
),
|
|
handler: async (ctx, args) => {
|
|
const page = await ctx.db
|
|
.query("pages")
|
|
.withIndex("by_slug", (q) => q.eq("slug", args.slug))
|
|
.first();
|
|
|
|
if (!page || !page.published) {
|
|
return null;
|
|
}
|
|
|
|
return {
|
|
_id: page._id,
|
|
slug: page.slug,
|
|
title: page.title,
|
|
content: page.content,
|
|
published: page.published,
|
|
order: page.order,
|
|
excerpt: page.excerpt,
|
|
image: page.image,
|
|
featured: page.featured,
|
|
featuredOrder: page.featuredOrder,
|
|
};
|
|
},
|
|
});
|
|
|
|
// Public mutation for syncing pages from markdown files
|
|
export const syncPagesPublic = mutation({
|
|
args: {
|
|
pages: v.array(
|
|
v.object({
|
|
slug: v.string(),
|
|
title: v.string(),
|
|
content: v.string(),
|
|
published: v.boolean(),
|
|
order: v.optional(v.number()),
|
|
excerpt: v.optional(v.string()),
|
|
image: v.optional(v.string()),
|
|
featured: v.optional(v.boolean()),
|
|
featuredOrder: v.optional(v.number()),
|
|
}),
|
|
),
|
|
},
|
|
returns: v.object({
|
|
created: v.number(),
|
|
updated: v.number(),
|
|
deleted: v.number(),
|
|
}),
|
|
handler: async (ctx, args) => {
|
|
let created = 0;
|
|
let updated = 0;
|
|
let deleted = 0;
|
|
|
|
const now = Date.now();
|
|
const incomingSlugs = new Set(args.pages.map((p) => p.slug));
|
|
|
|
// Get all existing pages
|
|
const existingPages = await ctx.db.query("pages").collect();
|
|
const existingBySlug = new Map(existingPages.map((p) => [p.slug, p]));
|
|
|
|
// Upsert incoming pages
|
|
for (const page of args.pages) {
|
|
const existing = existingBySlug.get(page.slug);
|
|
|
|
if (existing) {
|
|
// Update existing page
|
|
await ctx.db.patch(existing._id, {
|
|
title: page.title,
|
|
content: page.content,
|
|
published: page.published,
|
|
order: page.order,
|
|
excerpt: page.excerpt,
|
|
image: page.image,
|
|
featured: page.featured,
|
|
featuredOrder: page.featuredOrder,
|
|
lastSyncedAt: now,
|
|
});
|
|
updated++;
|
|
} else {
|
|
// Create new page
|
|
await ctx.db.insert("pages", {
|
|
...page,
|
|
lastSyncedAt: now,
|
|
});
|
|
created++;
|
|
}
|
|
}
|
|
|
|
// Delete pages that no longer exist in the repo
|
|
for (const existing of existingPages) {
|
|
if (!incomingSlugs.has(existing.slug)) {
|
|
await ctx.db.delete(existing._id);
|
|
deleted++;
|
|
}
|
|
}
|
|
|
|
return { created, updated, deleted };
|
|
},
|
|
});
|