No description
Find a file
saberzero1 21bd3be046
feat: exclude unlisted pages from tag discovery and listings
Respect the file.data.unlisted convention in both the tag discovery loop
(virtual tag page generation in pageType.generate) and the tag listing
itself (allPagesWithTag and the root-index tag set builder in TagContent).

Unlisted pages no longer contribute tags, and no longer appear in any
tag listing. A tag that exists only on unlisted pages will not cause a
virtual tag page to be generated at all.

Adds 4 unit tests for pageType.generate covering tag discovery from
listed pages, unlisted exclusion, shared tags across listed and unlisted
pages, and tag-only-on-unlisted-pages suppression.
2026-04-11 13:51:04 +02:00
.github/workflows ci: add dist externals verification step 2026-03-17 19:41:48 +01:00
dist feat: exclude unlisted pages from tag discovery and listings 2026-04-11 13:51:04 +02:00
src feat: exclude unlisted pages from tag discovery and listings 2026-04-11 13:51:04 +02:00
test feat: exclude unlisted pages from tag discovery and listings 2026-04-11 13:51:04 +02:00
types chore: centralize type declarations and standardize tooling config 2026-03-16 18:55:26 +01:00
.eslintrc.json chore: centralize type declarations and standardize tooling config 2026-03-16 18:55:26 +01:00
.gitignore chore: commit dist/ and remove prepare script 2026-03-14 22:01:54 +01:00
.prettierignore chore: centralize type declarations and standardize tooling config 2026-03-16 18:55:26 +01:00
.prettierrc Initial commit 2026-02-13 18:36:35 +01:00
CHANGELOG.md feat: exclude unlisted pages from tag discovery and listings 2026-04-11 13:51:04 +02:00
LICENSE Initial commit 2026-02-13 18:36:35 +01:00
package-lock.json deps: update @quartz-community/types and @quartz-community/utils 2026-04-03 16:19:42 +02:00
package.json fix: add missing peer dependencies as devDependencies for CI build 2026-03-16 19:07:38 +01:00
README.md docs: add prefixTags option to configuration table 2026-03-18 17:47:01 +01:00
tsconfig.build.json fix: use separate tsconfig for DTS build to avoid vitest dependency 2026-03-22 13:12:01 +01:00
tsconfig.json Initial commit 2026-02-13 18:36:35 +01:00
tsup.config.ts fix: bundle @quartz-community/utils to avoid runtime subpath resolution failures 2026-04-04 11:28:40 +02:00
vitest.config.ts fix: add passWithNoTests to vitest config 2026-03-09 03:21:30 +01:00

@quartz-community/tag-page

Renders tag pages showing all content tagged with a specific tag. Automatically generates virtual pages for all tags found across content.

Installation

npx quartz plugin add github:quartz-community/tag-page

Usage

plugins:
  - source: github:quartz-community/tag-page
    enabled: true

For advanced use cases, you can override in TypeScript:

import * as ExternalPlugin from "./.quartz/plugins";

ExternalPlugin.TagPage({
  numPages: 10,
  prefixTags: false,
});

Configuration

Option Type Default Description
sort SortFn undefined A function to sort the pages with the tag.
numPages number undefined The number of pages to show per tag page.
prefixTags boolean false Whether to prefix generated tag page titles with "Tag: " (e.g. "Tag: recipes").

Documentation

See the Quartz documentation for more information.

License

MIT