From c538c151c7462ad0395ff2c15c5e11e89e362aa8 Mon Sep 17 00:00:00 2001
From: Striven <sg.striven@cutecat.club>
Date: Sat, 04 Apr 2026 19:47:16 +0000
Subject: [PATCH] Initial commit
---
quartz/plugins/transformers/description.ts | 102 ++++++++++++++++++++++++++++++++++----------------
1 files changed, 69 insertions(+), 33 deletions(-)
diff --git a/quartz/plugins/transformers/description.ts b/quartz/plugins/transformers/description.ts
index 065d3bf..3f8519b 100644
--- a/quartz/plugins/transformers/description.ts
+++ b/quartz/plugins/transformers/description.ts
@@ -1,54 +1,90 @@
-import { PluggableList } from "unified"
-import { Root as HTMLRoot } from 'hast'
+import { Root as HTMLRoot } from "hast"
import { toString } from "hast-util-to-string"
import { QuartzTransformerPlugin } from "../types"
+import { escapeHTML } from "../../util/escape"
export interface Options {
descriptionLength: number
+ maxDescriptionLength: number
+ replaceExternalLinks: boolean
}
const defaultOptions: Options = {
- descriptionLength: 150
+ descriptionLength: 150,
+ maxDescriptionLength: 300,
+ replaceExternalLinks: true,
}
-export class Description extends QuartzTransformerPlugin {
- name = "Description"
- opts: Options
+const urlRegex = new RegExp(
+ /(https?:\/\/)?(?<domain>([\da-z\.-]+)\.([a-z\.]{2,6})(:\d+)?)(?<path>[\/\w\.-]*)(\?[\/\w\.=&;-]*)?/,
+ "g",
+)
- constructor(opts?: Options) {
- super()
- this.opts = { ...defaultOptions, ...opts }
- }
+export const Description: QuartzTransformerPlugin<Partial<Options>> = (userOpts) => {
+ const opts = { ...defaultOptions, ...userOpts }
+ return {
+ name: "Description",
+ htmlPlugins() {
+ return [
+ () => {
+ return async (tree: HTMLRoot, file) => {
+ let frontMatterDescription = file.data.frontmatter?.description
+ let text = escapeHTML(toString(tree))
- markdownPlugins(): PluggableList {
- return []
- }
+ if (opts.replaceExternalLinks) {
+ frontMatterDescription = frontMatterDescription?.replace(
+ urlRegex,
+ "$<domain>" + "$<path>",
+ )
+ text = text.replace(urlRegex, "$<domain>" + "$<path>")
+ }
- htmlPlugins(): PluggableList {
- return [
- () => {
- return async (tree: HTMLRoot, file) => {
- const frontMatterDescription = file.data.frontmatter?.description
- const desc = frontMatterDescription ?? toString(tree)
- const sentences = desc.replace(/\s+/g, ' ').split('.')
- let finalDesc = ""
- let sentenceIdx = 0
- const len = this.opts.descriptionLength
- while (finalDesc.length < len) {
- finalDesc += sentences[sentenceIdx] + '.'
- sentenceIdx++
+ if (frontMatterDescription) {
+ file.data.description = frontMatterDescription
+ file.data.text = text
+ return
+ }
+
+ // otherwise, use the text content
+ const desc = text
+ const sentences = desc.replace(/\s+/g, " ").split(/\.\s/)
+ let finalDesc = ""
+ let sentenceIdx = 0
+
+ // Add full sentences until we exceed the guideline length
+ while (sentenceIdx < sentences.length) {
+ const sentence = sentences[sentenceIdx]
+ if (!sentence) break
+
+ const currentSentence = sentence.endsWith(".") ? sentence : sentence + "."
+ const nextLength = finalDesc.length + currentSentence.length + (finalDesc ? 1 : 0)
+
+ // Add the sentence if we're under the guideline length
+ // or if this is the first sentence (always include at least one)
+ if (nextLength <= opts.descriptionLength || sentenceIdx === 0) {
+ finalDesc += (finalDesc ? " " : "") + currentSentence
+ sentenceIdx++
+ } else {
+ break
+ }
+ }
+
+ // truncate to max length if necessary
+ file.data.description =
+ finalDesc.length > opts.maxDescriptionLength
+ ? finalDesc.slice(0, opts.maxDescriptionLength) + "..."
+ : finalDesc
+ file.data.text = text
}
-
- file.data.description = finalDesc
- }
- }
- ]
+ },
+ ]
+ },
}
}
-declare module 'vfile' {
+declare module "vfile" {
interface DataMap {
description: string
+ text: string
}
}
-
--
Gitblit v1.10.0