feat: add social_description frontmatter to customise the text shown in social embeds, and adjust keyword extraction for head metadata

Author: TrebledJ

archive/template.md

@@ -12,6 +12,8 @@ tags:
 thumbnail_src: ~/assets/img/to/thumbnail.jpg  # Start with ./... for images relative to your directory.
 thumbnail_banner: true # or false depending if you want the thumbnail to show on the post's page.
 keywords: key words  # Not really important.
+social_description: |
+  This description shows up when sharing the page over social media embeds.
 comments: true      # Enable comments.
 sharable: false     # Enable share buttons.
 use_math: false

content/advisories/2026-05-03-pixera.md

@@ -3,6 +3,7 @@ title: "Advisory: RCE and Arbitrary File Read in AV Stumpfl PIXERA < 25.2 R3"
 excerpt: CVE-2026-7703, CVE-2026-7704
 # thumbnail_src: assets/deserialization_meme_69.png
 # thumbnail_banner: false
+social_description: A Remote Code Execution (RCE) vulnerability was discovered in PIXERA media servers. A crafted payload sent to a websocket JSON-RPC API allows unauthenticated users to run arbitrary commands with Administrator privileges and pivot across connected networks.
 ---
 
 ## Overview

content/meta/search.json.njk

@@ -11,7 +11,7 @@ permalink: /search.json
 "type": "post",
 "title": "{{post.data.safeTitle | safe}}",
 "excerpt": "{{post.data.excerpt}}",
-"keywords": {{((post.data.excerpt | mdInline) + post.content) | striptags | keywords | jsonify | safe}},
+"keywords": {{((post.data.excerpt | mdInline) + post.content) | striptags | keywordsWithCount | jsonify | safe}},
 "tags": {{post.data.tags | exclude("posts") | jsonify | safe}},
 "url": "{{post.url}}"
 }
@@ -25,7 +25,7 @@ permalink: /search.json
 "type": "tag",
 "title": "{{page.data.safeTitle | safe}}",
 "excerpt": {{clean | truncateWords(20) | jsonify | safe}},
-"keywords": {{clean | keywords | jsonify | safe}},
+"keywords": {{clean | keywordsWithCount | jsonify | safe}},
 "tags": [],
 "url": "{{page.url}}"
 }

eleventy/filters.js

@@ -224,10 +224,11 @@ export default function (eleventyConfig) {
 
   if (process.env.ENVIRONMENT === 'fast') {
     // Keep things fast.
-    eleventyConfig.addFilter('keywords', content => content);
+    eleventyConfig.addFilter('keywordsWithCount', content => content);
+    eleventyConfig.addFilter('keywords', content => [content]);
   } else {
     // Extract a set of keywords and run-length-encode them to optimise size.
-    eleventyConfig.addFilter('keywords', function (content) {
+    eleventyConfig.addFilter('keywordsWithCount', function (content) {
       const res = findKeywords(content);
       const counter = new Map();
       for (const w of res) {
@@ -238,6 +239,10 @@ export default function (eleventyConfig) {
       );
       return lengthEncoded.join(' ');
     });
+    eleventyConfig.addFilter('keywords', function (content) {
+      const res = findKeywords(content, false);
+      return [...new Set(res)];
+    });
   }
 
   eleventyConfig.addFilter('maxDate', (a, b) => {

partials/_includes/utilities/metadata.html

@@ -32,10 +32,13 @@
 {% set page_keywords = [] %}
 {% set page_keywords = page_keywords | push(site.author.alias | lower) %}
 {% if safeTitle %}
-    {% set page_keywords = page_keywords | push(safeTitle | lower | e) %}
+    {% set page_keywords = page_keywords | extend(safeTitle | lower | keywords) %}
 {% endif %}
 {% if excerpt %}
-    {% set page_keywords = page_keywords | push(safeExcerpt | lower | e) %}
+    {% set page_keywords = page_keywords | extend(safeExcerpt | lower | keywords) %}
+{% endif %}
+{% if social_description %}
+    {% set page_keywords = page_keywords | extend(social_description | lower | keywords) %}
 {% endif %}
 {% if tags %}
     {% set page_keywords = page_keywords | extend(tags | exclude('posts')) %}
@@ -76,7 +79,11 @@
 <meta property="twitter:title" content="{{ titleTagText | safe }}"/>
 
 {% if excerpt %}
-    {% set meta_desc = safeExcerpt + "\n\n" + (content | annihilate('.article-header, .post-preamble, .metadata-container, .metadata-tag-container, #toc-sidebar') | striptags | truncateWords(30)) %}
+    {% if social_description %}
+        {% set meta_desc = safeExcerpt + "\n\n" + social_description %}
+    {% else %}
+        {% set meta_desc = safeExcerpt + "\n\n" + (content | annihilate('.article-header, .post-preamble, .metadata-container, .metadata-tag-container, #toc-sidebar') | striptags | truncateWords(30)) %}
+    {% endif %}
 {% else %}
     {% set meta_desc = site.description %}
 {% endif %}