From ec00a40aefca73596ab76e3ebe3a8e1129b43688 Mon Sep 17 00:00:00 2001
From: dependabot[bot] <49699333+dependabot[bot]@users.noreply.github.com>
Date: Tue, 27 Jan 2026 18:27:17 +0000
Subject: [PATCH] chore(deps): bump the production-dependencies group with 4 updates (#2289)
---
quartz/plugins/emitters/tagPage.tsx | 195 ++++++++++++++++++++++++++++++++++++------------
1 files changed, 145 insertions(+), 50 deletions(-)
diff --git a/quartz/plugins/emitters/tagPage.tsx b/quartz/plugins/emitters/tagPage.tsx
index 30717fa..5f23893 100644
--- a/quartz/plugins/emitters/tagPage.tsx
+++ b/quartz/plugins/emitters/tagPage.tsx
@@ -3,73 +3,168 @@
import HeaderConstructor from "../../components/Header"
import BodyConstructor from "../../components/Body"
import { pageResources, renderPage } from "../../components/renderPage"
-import { ProcessedContent, defaultProcessedContent } from "../vfile"
+import { ProcessedContent, QuartzPluginData, defaultProcessedContent } from "../vfile"
import { FullPageLayout } from "../../cfg"
-import { CanonicalSlug, FilePath, ServerSlug } from "../../path"
+import { FullSlug, getAllSegmentPrefixes, joinSegments, pathToRoot } from "../../util/path"
+import { defaultListPageLayout, sharedPageComponents } from "../../../quartz.layout"
+import { TagContent } from "../../components"
+import { write } from "./helpers"
+import { i18n, TRANSLATIONS } from "../../i18n"
+import { BuildCtx } from "../../util/ctx"
+import { StaticResources } from "../../util/resources"
-export const TagPage: QuartzEmitterPlugin<FullPageLayout> = (opts) => {
- if (!opts) {
- throw new Error("TagPage must be initialized with options specifiying the components to use")
+interface TagPageOptions extends FullPageLayout {
+ sort?: (f1: QuartzPluginData, f2: QuartzPluginData) => number
+}
+
+function computeTagInfo(
+ allFiles: QuartzPluginData[],
+ content: ProcessedContent[],
+ locale: keyof typeof TRANSLATIONS,
+): [Set<string>, Record<string, ProcessedContent>] {
+ const tags: Set<string> = new Set(
+ allFiles.flatMap((data) => data.frontmatter?.tags ?? []).flatMap(getAllSegmentPrefixes),
+ )
+
+ // add base tag
+ tags.add("index")
+
+ const tagDescriptions: Record<string, ProcessedContent> = Object.fromEntries(
+ [...tags].map((tag) => {
+ const title =
+ tag === "index"
+ ? i18n(locale).pages.tagContent.tagIndex
+ : `${i18n(locale).pages.tagContent.tag}: ${tag}`
+ return [
+ tag,
+ defaultProcessedContent({
+ slug: joinSegments("tags", tag) as FullSlug,
+ frontmatter: { title, tags: [] },
+ }),
+ ]
+ }),
+ )
+
+ // Update with actual content if available
+ for (const [tree, file] of content) {
+ const slug = file.data.slug!
+ if (slug.startsWith("tags/")) {
+ const tag = slug.slice("tags/".length)
+ if (tags.has(tag)) {
+ tagDescriptions[tag] = [tree, file]
+ if (file.data.frontmatter?.title === tag) {
+ file.data.frontmatter.title = `${i18n(locale).pages.tagContent.tag}: ${tag}`
+ }
+ }
+ }
}
- const { head: Head, header, beforeBody, pageBody: Content, left, right, footer: Footer } = opts
+ return [tags, tagDescriptions]
+}
+
+async function processTagPage(
+ ctx: BuildCtx,
+ tag: string,
+ tagContent: ProcessedContent,
+ allFiles: QuartzPluginData[],
+ opts: FullPageLayout,
+ resources: StaticResources,
+) {
+ const slug = joinSegments("tags", tag) as FullSlug
+ const [tree, file] = tagContent
+ const cfg = ctx.cfg.configuration
+ const externalResources = pageResources(pathToRoot(slug), resources)
+ const componentData: QuartzComponentProps = {
+ ctx,
+ fileData: file.data,
+ externalResources,
+ cfg,
+ children: [],
+ tree,
+ allFiles,
+ }
+
+ const content = renderPage(cfg, slug, componentData, opts, externalResources)
+ return write({
+ ctx,
+ content,
+ slug: file.data.slug!,
+ ext: ".html",
+ })
+}
+
+export const TagPage: QuartzEmitterPlugin<Partial<TagPageOptions>> = (userOpts) => {
+ const opts: FullPageLayout = {
+ ...sharedPageComponents,
+ ...defaultListPageLayout,
+ pageBody: TagContent({ sort: userOpts?.sort }),
+ ...userOpts,
+ }
+
+ const { head: Head, header, beforeBody, pageBody, afterBody, left, right, footer: Footer } = opts
const Header = HeaderConstructor()
const Body = BodyConstructor()
return {
name: "TagPage",
getQuartzComponents() {
- return [Head, Header, Body, ...header, ...beforeBody, Content, ...left, ...right, Footer]
+ return [
+ Head,
+ Header,
+ Body,
+ ...header,
+ ...beforeBody,
+ pageBody,
+ ...afterBody,
+ ...left,
+ ...right,
+ Footer,
+ ]
},
- async emit(_contentDir, cfg, content, resources, emit): Promise<FilePath[]> {
- const fps: FilePath[] = []
- const allFiles = content.map(c => c[1].data)
+ async *emit(ctx, content, resources) {
+ const allFiles = content.map((c) => c[1].data)
+ const cfg = ctx.cfg.configuration
+ const [tags, tagDescriptions] = computeTagInfo(allFiles, content, cfg.locale)
- const tags: Set<string> = new Set(allFiles.flatMap(data => data.frontmatter?.tags ?? []))
- const tagDescriptions: Record<string, ProcessedContent> = Object.fromEntries([...tags].map(tag => ([
- tag, defaultProcessedContent({ slug: `tags/${tag}` as ServerSlug, frontmatter: { title: `Tag: ${tag}`, tags: [] } })
- ])))
+ for (const tag of tags) {
+ yield processTagPage(ctx, tag, tagDescriptions[tag], allFiles, opts, resources)
+ }
+ },
+ async *partialEmit(ctx, content, resources, changeEvents) {
+ const allFiles = content.map((c) => c[1].data)
+ const cfg = ctx.cfg.configuration
- for (const [tree, file] of content) {
- const slug = file.data.slug!
+ // Find all tags that need to be updated based on changed files
+ const affectedTags: Set<string> = new Set()
+ for (const changeEvent of changeEvents) {
+ if (!changeEvent.file) continue
+ const slug = changeEvent.file.data.slug!
+
+ // If it's a tag page itself that changed
if (slug.startsWith("tags/")) {
const tag = slug.slice("tags/".length)
- if (tags.has(tag)) {
- tagDescriptions[tag] = [tree, file]
+ affectedTags.add(tag)
+ }
+
+ // If a file with tags changed, we need to update those tag pages
+ const fileTags = changeEvent.file.data.frontmatter?.tags ?? []
+ fileTags.flatMap(getAllSegmentPrefixes).forEach((tag) => affectedTags.add(tag))
+
+ // Always update the index tag page if any file changes
+ affectedTags.add("index")
+ }
+
+ // If there are affected tags, rebuild their pages
+ if (affectedTags.size > 0) {
+ // We still need to compute all tags because tag pages show all tags
+ const [_tags, tagDescriptions] = computeTagInfo(allFiles, content, cfg.locale)
+
+ for (const tag of affectedTags) {
+ if (tagDescriptions[tag]) {
+ yield processTagPage(ctx, tag, tagDescriptions[tag], allFiles, opts, resources)
}
}
}
-
- for (const tag of tags) {
- const slug = `tags/${tag}` as CanonicalSlug
- const externalResources = pageResources(slug, resources)
- const [tree, file] = tagDescriptions[tag]
- const componentData: QuartzComponentProps = {
- fileData: file.data,
- externalResources,
- cfg,
- children: [],
- tree,
- allFiles
- }
-
- const content = renderPage(
- slug,
- componentData,
- opts,
- externalResources
- )
-
- const fp = file.data.slug + ".html" as FilePath
- await emit({
- content,
- slug: file.data.slug!,
- ext: ".html",
- })
-
- fps.push(fp)
- }
- return fps
- }
+ },
}
}
--
Gitblit v1.10.0