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/transformers/description.ts | 67 ++++++++++++++++++++++++++-------
1 files changed, 53 insertions(+), 14 deletions(-)
diff --git a/quartz/plugins/transformers/description.ts b/quartz/plugins/transformers/description.ts
index 884d5b1..3f8519b 100644
--- a/quartz/plugins/transformers/description.ts
+++ b/quartz/plugins/transformers/description.ts
@@ -5,13 +5,22 @@
export interface Options {
descriptionLength: number
+ maxDescriptionLength: number
+ replaceExternalLinks: boolean
}
const defaultOptions: Options = {
descriptionLength: 150,
+ maxDescriptionLength: 300,
+ replaceExternalLinks: true,
}
-export const Description: QuartzTransformerPlugin<Partial<Options> | undefined> = (userOpts) => {
+const urlRegex = new RegExp(
+ /(https?:\/\/)?(?<domain>([\da-z\.-]+)\.([a-z\.]{2,6})(:\d+)?)(?<path>[\/\w\.-]*)(\?[\/\w\.=&;-]*)?/,
+ "g",
+)
+
+export const Description: QuartzTransformerPlugin<Partial<Options>> = (userOpts) => {
const opts = { ...defaultOptions, ...userOpts }
return {
name: "Description",
@@ -19,22 +28,52 @@
return [
() => {
return async (tree: HTMLRoot, file) => {
- const frontMatterDescription = file.data.frontmatter?.description
- const text = escapeHTML(toString(tree))
+ let frontMatterDescription = file.data.frontmatter?.description
+ let text = escapeHTML(toString(tree))
- const desc = frontMatterDescription ?? text
- const sentences = desc.replace(/\s+/g, " ").split(".")
- let finalDesc = ""
- let sentenceIdx = 0
- const len = opts.descriptionLength
- while (finalDesc.length < len) {
- const sentence = sentences[sentenceIdx]
- if (!sentence) break
- finalDesc += sentence + "."
- sentenceIdx++
+ if (opts.replaceExternalLinks) {
+ frontMatterDescription = frontMatterDescription?.replace(
+ urlRegex,
+ "$<domain>" + "$<path>",
+ )
+ text = text.replace(urlRegex, "$<domain>" + "$<path>")
}
- file.data.description = finalDesc
+ 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
}
},
--
Gitblit v1.10.0