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 | 48 ++++++++++++++++++++++++++++++------------------
1 files changed, 30 insertions(+), 18 deletions(-)
diff --git a/quartz/plugins/transformers/description.ts b/quartz/plugins/transformers/description.ts
index 0f8cd8d..3f8519b 100644
--- a/quartz/plugins/transformers/description.ts
+++ b/quartz/plugins/transformers/description.ts
@@ -5,11 +5,13 @@
export interface Options {
descriptionLength: number
+ maxDescriptionLength: number
replaceExternalLinks: boolean
}
const defaultOptions: Options = {
descriptionLength: 150,
+ maxDescriptionLength: 300,
replaceExternalLinks: true,
}
@@ -18,7 +20,7 @@
"g",
)
-export const Description: QuartzTransformerPlugin<Partial<Options> | undefined> = (userOpts) => {
+export const Description: QuartzTransformerPlugin<Partial<Options>> = (userOpts) => {
const opts = { ...defaultOptions, ...userOpts }
return {
name: "Description",
@@ -37,31 +39,41 @@
text = text.replace(urlRegex, "$<domain>" + "$<path>")
}
- const desc = frontMatterDescription ?? text
+ 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
- const len = opts.descriptionLength
- if (sentences[0] !== undefined && sentences[0].length >= len) {
- const firstSentence = sentences[0].split(" ")
- while (finalDesc.length < len) {
- const sentence = firstSentence[sentenceIdx]
- if (!sentence) break
- finalDesc += sentence + " "
+ // 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++
- }
- finalDesc = finalDesc.trimEnd() + "..."
- } else {
- while (finalDesc.length < len) {
- const sentence = sentences[sentenceIdx]
- if (!sentence) break
- finalDesc += sentence.endsWith(".") ? sentence : sentence + "."
- sentenceIdx++
+ } else {
+ break
}
}
- file.data.description = finalDesc
+ // truncate to max length if necessary
+ file.data.description =
+ finalDesc.length > opts.maxDescriptionLength
+ ? finalDesc.slice(0, opts.maxDescriptionLength) + "..."
+ : finalDesc
file.data.text = text
}
},
--
Gitblit v1.10.0