jekyll-documents 0.1.1

data/assets/icons/minimal/file-format-js-document-extension-file-format-svgrepo-com.svg

@@ -0,0 +1,7 @@
+<?xml version="1.0" ?>
+
+<svg width="800px" height="800px" viewBox="0 0 20 20" version="1.1" xmlns="http://www.w3.org/2000/svg">
+
+
+
+

data/assets/icons/minimal/file-format-vb-document-extension-file-format-svgrepo-com.svg

@@ -0,0 +1,7 @@
+<?xml version="1.0" ?>
+
+<svg width="800px" height="800px" viewBox="0 0 20 20" version="1.1" xmlns="http://www.w3.org/2000/svg">
+
+
+
+

data/assets/icons/minimal/folder-svgrepo-com.svg

@@ -0,0 +1,3 @@
+<svg xmlns="http://www.w3.org/2000/svg" width="24" height="24" viewBox="0 0 24 24" fill="none" stroke="currentColor" stroke-width="1.5">
+  <path d="M22 19a2 2 0 0 1-2 2H4a2 2 0 0 1-2-2V5a2 2 0 0 1 2-2h5l2 3h9a2 2 0 0 1 2 2z"/>
+</svg>

data/assets/icons/minimal/ico-file-format-svgrepo-com.svg

@@ -0,0 +1,7 @@
+<?xml version="1.0" ?>
+
+<svg width="800px" height="800px" viewBox="0 0 20 20" version="1.1" xmlns="http://www.w3.org/2000/svg">
+
+
+
+

data/assets/icons/ultra-minimal/doc.svg

@@ -0,0 +1,7 @@
+<svg xmlns="http://www.w3.org/2000/svg" width="24" height="24" viewBox="0 0 24 24" fill="none" stroke="currentColor" stroke-width="2" stroke-linecap="round" stroke-linejoin="round">
+  <path d="M14 2H6a2 2 0 0 0-2 2v16a2 2 0 0 0 2 2h12a2 2 0 0 0 2-2V8z"/>
+  <polyline points="14,2 14,8 20,8"/>
+  <line x1="16" y1="13" x2="8" y2="13"/>
+  <line x1="16" y1="17" x2="8" y2="17"/>
+  <polyline points="10,9 9,9 8,9"/>
+</svg>

data/assets/icons/ultra-minimal/file.svg

@@ -0,0 +1,4 @@
+<svg xmlns="http://www.w3.org/2000/svg" width="24" height="24" viewBox="0 0 24 24" fill="none" stroke="currentColor" stroke-width="2" stroke-linecap="round" stroke-linejoin="round">
+  <path d="M14 2H6a2 2 0 0 0-2 2v16a2 2 0 0 0 2 2h12a2 2 0 0 0 2-2V8z"/>
+  <polyline points="14,2 14,8 20,8"/>
+</svg>

data/assets/icons/ultra-minimal/folder-svgrepo-com.svg

@@ -0,0 +1,3 @@
+<svg xmlns="http://www.w3.org/2000/svg" width="24" height="24" viewBox="0 0 24 24" fill="none" stroke="currentColor" stroke-width="2" stroke-linecap="round" stroke-linejoin="round">
+  <path d="M22 19a2 2 0 0 1-2 2H4a2 2 0 0 1-2-2V5a2 2 0 0 1 2-2h5l2 3h9a2 2 0 0 1 2 2z"/>
+</svg>

data/assets/icons/ultra-minimal/jpg.svg

@@ -0,0 +1,6 @@
+<svg xmlns="http://www.w3.org/2000/svg" width="24" height="24" viewBox="0 0 24 24" fill="none" stroke="currentColor" stroke-width="2" stroke-linecap="round" stroke-linejoin="round">
+  <path d="M14 2H6a2 2 0 0 0-2 2v16a2 2 0 0 0 2 2h12a2 2 0 0 0 2-2V8z"/>
+  <polyline points="14,2 14,8 20,8"/>
+  <circle cx="10" cy="15" r="2"/>
+  <path d="M16 13l-4 4"/>
+</svg>

data/assets/icons/ultra-minimal/mp3.svg

@@ -0,0 +1,5 @@
+<svg xmlns="http://www.w3.org/2000/svg" width="24" height="24" viewBox="0 0 24 24" fill="none" stroke="currentColor" stroke-width="2" stroke-linecap="round" stroke-linejoin="round">
+  <path d="M14 2H6a2 2 0 0 0-2 2v16a2 2 0 0 0 2 2h12a2 2 0 0 0 2-2V8z"/>
+  <polyline points="14,2 14,8 20,8"/>
+  <polygon points="10,13 10,17 13,15 16,17 16,13 13,15"/>
+</svg>

data/assets/icons/ultra-minimal/mp4.svg

@@ -0,0 +1,5 @@
+<svg xmlns="http://www.w3.org/2000/svg" width="24" height="24" viewBox="0 0 24 24" fill="none" stroke="currentColor" stroke-width="2" stroke-linecap="round" stroke-linejoin="round">
+  <path d="M14 2H6a2 2 0 0 0-2 2v16a2 2 0 0 0 2 2h12a2 2 0 0 0 2-2V8z"/>
+  <polyline points="14,2 14,8 20,8"/>
+  <polygon points="10,13 10,17 14,15 18,17 18,13 14,15"/>
+</svg>

data/assets/icons/ultra-minimal/pdf.svg

@@ -0,0 +1,7 @@
+<svg xmlns="http://www.w3.org/2000/svg" width="24" height="24" viewBox="0 0 24 24" fill="none" stroke="currentColor" stroke-width="2" stroke-linecap="round" stroke-linejoin="round">
+  <path d="M14 2H6a2 2 0 0 0-2 2v16a2 2 0 0 0 2 2h12a2 2 0 0 0 2-2V8z"/>
+  <polyline points="14,2 14,8 20,8"/>
+  <line x1="16" y1="13" x2="8" y2="13"/>
+  <line x1="16" y1="17" x2="8" y2="17"/>
+  <polyline points="10,9 9,9 8,9"/>
+</svg>

data/assets/icons/ultra-minimal/png.svg

@@ -0,0 +1,5 @@
+<svg xmlns="http://www.w3.org/2000/svg" width="24" height="24" viewBox="0 0 24 24" fill="none" stroke="currentColor" stroke-width="2" stroke-linecap="round" stroke-linejoin="round">
+  <path d="M14 2H6a2 2 0 0 0-2 2v16a2 2 0 0 0 2 2h12a2 2 0 0 0 2-2V8z"/>
+  <polyline points="14,2 14,8 20,8"/>
+  <rect x="8" y="12" width="8" height="6" rx="1"/>
+</svg>

data/assets/icons/ultra-minimal/ppt.svg

@@ -0,0 +1,5 @@
+<svg xmlns="http://www.w3.org/2000/svg" width="24" height="24" viewBox="0 0 24 24" fill="none" stroke="currentColor" stroke-width="2" stroke-linecap="round" stroke-linejoin="round">
+  <path d="M14 2H6a2 2 0 0 0-2 2v16a2 2 0 0 0 2 2h12a2 2 0 0 0 2-2V8z"/>
+  <polyline points="14,2 14,8 20,8"/>
+  <rect x="8" y="13" width="8" height="6"/>
+</svg>

data/assets/icons/ultra-minimal/txt.svg

@@ -0,0 +1,7 @@
+<svg xmlns="http://www.w3.org/2000/svg" width="24" height="24" viewBox="0 0 24 24" fill="none" stroke="currentColor" stroke-width="2" stroke-linecap="round" stroke-linejoin="round">
+  <path d="M14 2H6a2 2 0 0 0-2 2v16a2 2 0 0 0 2 2h12a2 2 0 0 0 2-2V8z"/>
+  <polyline points="14,2 14,8 20,8"/>
+  <line x1="16" y1="13" x2="8" y2="13"/>
+  <line x1="16" y1="17" x2="8" y2="17"/>
+  <polyline points="10,9 9,9 8,9"/>
+</svg>

data/assets/icons/ultra-minimal/xls.svg

@@ -0,0 +1,6 @@
+<svg xmlns="http://www.w3.org/2000/svg" width="24" height="24" viewBox="0 0 24 24" fill="none" stroke="currentColor" stroke-width="2" stroke-linecap="round" stroke-linejoin="round">
+  <path d="M14 2H6a2 2 0 0 0-2 2v16a2 2 0 0 0 2 2h12a2 2 0 0 0 2-2V8z"/>
+  <polyline points="14,2 14,8 20,8"/>
+  <line x1="8" y1="15" x2="16" y2="15"/>
+  <line x1="8" y1="11" x2="16" y2="11"/>
+</svg>

data/assets/icons/ultra-minimal/zip.svg

@@ -0,0 +1,5 @@
+<svg xmlns="http://www.w3.org/2000/svg" width="24" height="24" viewBox="0 0 24 24" fill="none" stroke="currentColor" stroke-width="2" stroke-linecap="round" stroke-linejoin="round">
+  <path d="M14 2H6a2 2 0 0 0-2 2v16a2 2 0 0 0 2 2h12a2 2 0 0 0 2-2V8z"/>
+  <polyline points="14,2 14,8 20,8"/>
+  <path d="M10 13v4M8 15h4"/>
+</svg>

data/assets/js/documents-search.js

@@ -0,0 +1,139 @@
+/* Minimal client-side search using Lunr and /documents.json (generated by the plugin).
+   Usage on any page:
+     {% include documents_search.html %}
+     <script src="https://unpkg.com/lunr/lunr.js"></script>
+     <script src="{{ '/assets/js/documents-search.js' | relative_url }}"></script>
+*/
+(function () {
+  const input = document.getElementById("doc-search-input");
+  const resultsEl = document.getElementById("doc-search-results");
+  if (!input || !resultsEl) return;
+
+  const indexUrl = (window.__jekyllDocumentsIndexPath || "/documents.json");
+  let idx, docs = [];
+
+  function escapeHtml(s) {
+    const div = document.createElement("div");
+    div.appendChild(document.createTextNode(s));
+    return div.innerHTML;
+  }
+
+  function getIconPath(fileType, iconSet) {
+    iconSet = iconSet || "color";
+    const iconMap = {
+      "color": {
+        "pdf": "/assets/icons/color/pdf-document-svgrepo-com.svg",
+        "docx": "/assets/icons/color/word-document-svgrepo-com.svg",
+        "doc": "/assets/icons/color/word-document-svgrepo-com.svg",
+        "pptx": "/assets/icons/color/ppt-document-svgrepo-com.svg",
+        "ppt": "/assets/icons/color/ppt-document-svgrepo-com.svg",
+        "xlsx": "/assets/icons/color/excel-document-svgrepo-com.svg",
+        "xls": "/assets/icons/color/excel-document-svgrepo-com.svg",
+        "txt": "/assets/icons/color/txt-document-svgrepo-com.svg",
+        "zip": "/assets/icons/color/zip-document-svgrepo-com.svg"
+      },
+      "lines": {
+        "pdf": "/assets/icons/lines/pdf-svgrepo-com.svg",
+        "doc": "/assets/icons/lines/doc-svgrepo-com.svg",
+        "docx": "/assets/icons/lines/doc-svgrepo-com.svg",
+        "ppt": "/assets/icons/lines/ppt-svgrepo-com.svg",
+        "pptx": "/assets/icons/lines/ppt-svgrepo-com.svg",
+        "xls": "/assets/icons/lines/xls-svgrepo-com.svg",
+        "xlsx": "/assets/icons/lines/xls-svgrepo-com.svg",
+        "txt": "/assets/icons/lines/txt-svgrepo-com.svg",
+        "zip": "/assets/icons/lines/zip-svgrepo-com.svg"
+      },
+      "minimal": {
+        "pdf": "/assets/icons/minimal/pdf-svgrepo-com.svg",
+        "doc": "/assets/icons/minimal/doc-svgrepo-com.svg",
+        "docx": "/assets/icons/minimal/doc-svgrepo-com.svg",
+        "ppt": "/assets/icons/minimal/ppt-svgrepo-com.svg",
+        "pptx": "/assets/icons/minimal/ppt-svgrepo-com.svg",
+        "xls": "/assets/icons/minimal/xls-svgrepo-com.svg",
+        "xlsx": "/assets/icons/minimal/xls-svgrepo-com.svg",
+        "txt": "/assets/icons/minimal/txt-svgrepo-com.svg",
+        "zip": "/assets/icons/minimal/zip-svgrepo-com.svg"
+      },
+      "ultra-minimal": {
+        "pdf": "/assets/icons/ultra-minimal/pdf.svg",
+        "doc": "/assets/icons/ultra-minimal/doc.svg",
+        "docx": "/assets/icons/ultra-minimal/doc.svg",
+        "ppt": "/assets/icons/ultra-minimal/ppt.svg",
+        "pptx": "/assets/icons/ultra-minimal/ppt.svg",
+        "xls": "/assets/icons/ultra-minimal/xls.svg",
+        "xlsx": "/assets/icons/ultra-minimal/xls.svg",
+        "txt": "/assets/icons/ultra-minimal/txt.svg",
+        "zip": "/assets/icons/ultra-minimal/zip.svg"
+      }
+    };
+    const icons = iconMap[iconSet] || iconMap["color"];
+    return icons[fileType] || `/assets/icons/${iconSet}/unknown-document-svgrepo-com.svg`;
+  }
+
+  function getIconTag(fileType) {
+    const iconSet = window.__jekyllDocumentsIconSet || "color";
+    const iconPath = getIconPath(fileType, iconSet);
+    const altText = (fileType || "file").toUpperCase() + " file";
+    return `<img src="${iconPath}" alt="${escapeHtml(altText)}" class="file-icon" />`;
+  }
+
+  function render(matches) {
+    if (!matches || matches.length === 0) {
+      resultsEl.innerHTML = "<p>No results.</p>";
+      return;
+    }
+    const items = matches.slice(0, 20).map(m => {
+      const d = docs.find(x => x.url === m.ref);
+      if (!d) return "";
+      const title = escapeHtml(d.title || "Untitled");
+      const category = escapeHtml(d.category || "uncategorized");
+      const date = d.date ? `<small>${escapeHtml(d.date)}</small>` : "";
+      const icon = d.file_type ? getIconTag(d.file_type) : "";
+      return `<li>${icon}<a href="${d.url}">${title}</a> <small>[${category}]</small> ${date}</li>`;
+    });
+    resultsEl.innerHTML = `<ul class="documents-search-list">${items.join("")}</ul>`;
+  }
+
+  function debounce(fn, wait) {
+    let t; return function (...args) {
+      clearTimeout(t); t = setTimeout(() => fn.apply(this, args), wait);
+    };
+  }
+
+  function buildIndex() {
+    idx = lunr(function () {
+      this.ref("url");
+      this.field("title", { boost: 10 });
+      this.field("category", { boost: 5 });
+      this.field("slug");
+      docs.forEach(doc => this.add(doc));
+    });
+  }
+
+  function doSearch(q) {
+    if (!idx || !q || q.trim().length === 0) {
+      resultsEl.innerHTML = "";
+      return;
+    }
+    try {
+      const res = idx.search(q);
+      render(res);
+    } catch (e) {
+      // If Lunr query syntax fails, fallback to simple contains filter
+      const qlc = q.toLowerCase();
+      const res = docs.filter(d =>
+        (d.title || "").toLowerCase().includes(qlc) ||
+        (d.category || "").toLowerCase().includes(qlc) ||
+        (d.slug || "").toLowerCase().includes(qlc)
+      ).map(d => ({ ref: d.url }));
+      render(res);
+    }
+  }
+
+  fetch(indexUrl)
+    .then(r => r.json())
+    .then(json => { docs = json; buildIndex(); })
+    .catch(err => { console.error("Documents search index failed:", err); });
+
+  input.addEventListener("input", debounce(e => doSearch(e.target.value), 150));
+})();

data/jekyll-documents.gemspec

@@ -0,0 +1,27 @@
+# frozen_string_literal: true
+
+Gem::Specification.new do |spec|
+  spec.name          = "jekyll-documents"
+  spec.version       = File.read(File.expand_path("lib/jekyll/documents/version.rb", __dir__))
+                         .match(/VERSION\s*=\s*"([^"]+)"/)[1]
+  spec.authors       = ["Svend Gundestrup"]
+  spec.email         = ["no-reply@borg-collective.eu"]
+
+  spec.summary       = "Auto-generate Jekyll pages for documents (PDF/DOCX/...) with category/date/title parsing."
+  spec.description   = "A Jekyll plugin + theme that scans assets/documents/**, creates a collection item per file, " \
+                       "adds metadata (title/date/category), outputs pages, generates a JSON index for Lunr, and integrates with jekyll-sitemap."
+  spec.homepage      = "https://github.com/gundestrup/jekyll-documents"
+  spec.license       = "AGPL-3.0-only"
+
+  spec.required_ruby_version = ">= 2.7"
+
+  spec.files         = Dir.glob("{lib,assets,_includes,_layouts}/**/*") +
+                       ["README.md", "CHANGELOG.md", "LICENSE", "jekyll-documents.gemspec"]
+  spec.require_paths = ["lib"]
+
+  spec.add_dependency "jekyll", ">= 4.0"
+  
+  spec.add_development_dependency "rspec", "~> 3.12"
+  spec.add_development_dependency "rake", "~> 13.0"
+  spec.add_development_dependency "yard", "~> 0.9"
+end

data/lib/jekyll/documents/configuration.rb

@@ -0,0 +1,37 @@
+# frozen_string_literal: true
+
+module Jekyll
+  module Documents
+    class Configuration
+      DEFAULTS = {
+        "root" => "assets/documents",
+        "permalink" => "/documents/:category/:slug/",
+        "slug_downcase" => true,
+        "slug_danish_map" => true,
+        "categories_from_path" => true,
+        "include_extensions" => %w[.pdf .docx .pptx .xlsx .odt .ods .odp],
+        "layout" => "document",
+        "latest_default_count" => 5,
+
+        # Icon configuration
+        "icon_set" => "color",
+
+        # Validation
+        "strict_filename" => true,
+        "strict_extensions" => true,
+
+        # JSON Index for Lunr
+        "json_index" => true,
+        "json_index_path" => "/documents.json",
+
+        # Optional category mapping
+        "category_map" => {}
+      }.freeze
+
+      def self.read(site)
+        cfg = site.config["documents"] || {}
+        DEFAULTS.merge(cfg)
+      end
+    end
+  end
+end

data/lib/jekyll/documents/file_type_icons.rb

@@ -0,0 +1,144 @@
+# frozen_string_literal: true
+
+module Jekyll
+  module Documents
+    # Maps file extensions to local SVG icon files with configurable icon sets
+    # Provides Liquid filters for displaying file type icons
+    # Icons are based on designs from svgrepo.com and included in the gem
+    # @api public
+    module FileTypeIcons
+      # Mapping of file extensions to icon files for each icon set
+      # Icons sourced from svgrepo.com collections:
+      # Color: https://www.svgrepo.com/collection/file-type-doctype-vectors/
+      # Lines: https://www.svgrepo.com/collection/simple-file-types-line-vectors/
+      # Minimal: https://www.svgrepo.com/collection/file-type-minimal-icons/
+      # Ultra-minimal: Based on simple document icons
+      ICON_MAP = {
+        "color" => {
+          "pdf" => "/assets/icons/color/pdf-document-svgrepo-com.svg",
+          "docx" => "/assets/icons/color/word-document-svgrepo-com.svg",
+          "doc" => "/assets/icons/color/word-document-svgrepo-com.svg",
+          "pptx" => "/assets/icons/color/ppt-document-svgrepo-com.svg",
+          "ppt" => "/assets/icons/color/ppt-document-svgrepo-com.svg",
+          "xlsx" => "/assets/icons/color/excel-document-svgrepo-com.svg",
+          "xls" => "/assets/icons/color/excel-document-svgrepo-com.svg",
+          "odt" => "/assets/icons/color/word-document-svgrepo-com.svg",
+          "ods" => "/assets/icons/color/excel-document-svgrepo-com.svg",
+          "odp" => "/assets/icons/color/ppt-document-svgrepo-com.svg",
+          "txt" => "/assets/icons/color/txt-document-svgrepo-com.svg",
+          "zip" => "/assets/icons/color/zip-document-svgrepo-com.svg",
+          "mp3" => "/assets/icons/color/audio-document-svgrepo-com.svg",
+          "mp4" => "/assets/icons/color/mp4-document-svgrepo-com.svg",
+          "jpg" => "/assets/icons/color/image-document-svgrepo-com.svg",
+          "jpeg" => "/assets/icons/color/image-document-svgrepo-com.svg",
+          "png" => "/assets/icons/color/image-document-svgrepo-com.svg",
+          "csv" => "/assets/icons/color/csv-document-svgrepo-com.svg",
+          "html" => "/assets/icons/color/html-document-svgrepo-com.svg",
+          "xml" => "/assets/icons/color/xml-document-svgrepo-com.svg",
+          "rtf" => "/assets/icons/color/rtf-document-svgrepo-com.svg"
+        },
+        "lines" => {
+          "pdf" => "/assets/icons/lines/pdf-svgrepo-com.svg",
+          "docx" => "/assets/icons/lines/doc-svgrepo-com.svg",
+          "doc" => "/assets/icons/lines/doc-svgrepo-com.svg",
+          "pptx" => "/assets/icons/lines/ppt-svgrepo-com.svg",
+          "ppt" => "/assets/icons/lines/ppt-svgrepo-com.svg",
+          "xlsx" => "/assets/icons/lines/xls-svgrepo-com.svg",
+          "xls" => "/assets/icons/lines/xls-svgrepo-com.svg",
+          "odt" => "/assets/icons/lines/doc-svgrepo-com.svg",
+          "ods" => "/assets/icons/lines/xls-svgrepo-com.svg",
+          "odp" => "/assets/icons/lines/ppt-svgrepo-com.svg",
+          "txt" => "/assets/icons/lines/txt-svgrepo-com.svg",
+          "zip" => "/assets/icons/lines/zip-svgrepo-com.svg",
+          "mp3" => "/assets/icons/lines/mp3-svgrepo-com.svg",
+          "mp4" => "/assets/icons/lines/mp4-svgrepo-com.svg",
+          "jpg" => "/assets/icons/lines/jpg-svgrepo-com.svg",
+          "jpeg" => "/assets/icons/lines/jpg-svgrepo-com.svg",
+          "png" => "/assets/icons/lines/png-svgrepo-com.svg"
+        },
+        "minimal" => {
+          "pdf" => "/assets/icons/minimal/pdf-svgrepo-com.svg",
+          "docx" => "/assets/icons/minimal/doc-svgrepo-com.svg",
+          "doc" => "/assets/icons/minimal/doc-svgrepo-com.svg",
+          "pptx" => "/assets/icons/minimal/ppt-svgrepo-com.svg",
+          "ppt" => "/assets/icons/minimal/ppt-svgrepo-com.svg",
+          "xlsx" => "/assets/icons/minimal/xls-svgrepo-com.svg",
+          "xls" => "/assets/icons/minimal/xls-svgrepo-com.svg",
+          "odt" => "/assets/icons/minimal/doc-svgrepo-com.svg",
+          "ods" => "/assets/icons/minimal/xls-svgrepo-com.svg",
+          "odp" => "/assets/icons/minimal/ppt-svgrepo-com.svg",
+          "txt" => "/assets/icons/minimal/txt-svgrepo-com.svg",
+          "zip" => "/assets/icons/minimal/zip-svgrepo-com.svg",
+          "mp3" => "/assets/icons/minimal/mp3-svgrepo-com.svg",
+          "mp4" => "/assets/icons/minimal/mp4-svgrepo-com.svg",
+          "jpg" => "/assets/icons/minimal/jpg-svgrepo-com.svg",
+          "jpeg" => "/assets/icons/minimal/jpg-svgrepo-com.svg",
+          "png" => "/assets/icons/minimal/png-svgrepo-com.svg"
+        },
+        "ultra-minimal" => {
+          "pdf" => "/assets/icons/ultra-minimal/pdf.svg",
+          "docx" => "/assets/icons/ultra-minimal/doc.svg",
+          "doc" => "/assets/icons/ultra-minimal/doc.svg",
+          "pptx" => "/assets/icons/ultra-minimal/ppt.svg",
+          "ppt" => "/assets/icons/ultra-minimal/ppt.svg",
+          "xlsx" => "/assets/icons/ultra-minimal/xls.svg",
+          "xls" => "/assets/icons/ultra-minimal/xls.svg",
+          "odt" => "/assets/icons/ultra-minimal/doc.svg",
+          "ods" => "/assets/icons/ultra-minimal/xls.svg",
+          "odp" => "/assets/icons/ultra-minimal/ppt.svg",
+          "txt" => "/assets/icons/ultra-minimal/txt.svg",
+          "zip" => "/assets/icons/ultra-minimal/zip.svg",
+          "mp3" => "/assets/icons/ultra-minimal/mp3.svg",
+          "mp4" => "/assets/icons/ultra-minimal/mp4.svg",
+          "jpg" => "/assets/icons/ultra-minimal/jpg.svg",
+          "png" => "/assets/icons/ultra-minimal/png.svg"
+        }
+      }.freeze
+
+      # Returns the icon URL for a given file type using configured icon set
+      # @param file_type [String] the file extension (e.g., 'pdf', 'docx')
+      # @param context [Liquid::Context] the Liquid context for accessing site config
+      # @return [String] the icon file URL
+      # @example
+      #   file_type_icon('pdf') #=> "/assets/icons/color/pdf.svg"
+      def file_type_icon(file_type, context = nil)
+        icon_set = get_icon_set(context)
+        icons = ICON_MAP[icon_set] || ICON_MAP["color"]
+        icons[file_type.to_s.downcase] || "/assets/icons/#{icon_set}/unknown-document-svgrepo-com.svg"
+      end
+
+      # Returns an HTML img tag for the file type icon
+      # @param file_type [String] the file extension
+      # @param css_class [String] CSS class for the img tag (default: 'file-icon')
+      # @param alt [String, nil] alt text for the image (default: auto-generated)
+      # @param context [Liquid::Context] the Liquid context for accessing site config
+      # @return [String] HTML img tag
+      # @example
+      #   file_type_icon_tag('pdf') #=> '<img src="/assets/icons/color/pdf.svg" alt="PDF file" class="file-icon" />'
+      def file_type_icon_tag(file_type, css_class: "file-icon", alt: nil, context: nil)
+        url = file_type_icon(file_type, context)
+        alt_text = alt || "#{file_type.upcase} file"
+        %(<img src="#{url}" alt="#{alt_text}" class="#{css_class}" />)
+      end
+
+      private
+
+      # Gets the configured icon set from site configuration
+      # @param context [Liquid::Context] the Liquid context
+      # @return [String] the icon set name
+      def get_icon_set(context)
+        return "color" unless context
+        
+        site_config = context.registers[:site]&.config
+        documents_config = site_config["documents"] if site_config
+        icon_set = documents_config["icon_set"] if documents_config
+        
+        # Validate icon set exists
+        return "color" unless icon_set && ICON_MAP.key?(icon_set)
+        icon_set
+      end
+    end
+  end
+end
+
+Liquid::Template.register_filter(Jekyll::Documents::FileTypeIcons)

data/lib/jekyll/documents/filters.rb

@@ -0,0 +1,34 @@
+# frozen_string_literal: true
+
+module Jekyll
+  module Documents
+    module Filters
+      DANISH_MAP = {
+        "æ" => "ae", "ø" => "oe", "å" => "aa",
+        "Æ" => "Ae", "Ø" => "Oe", "Å" => "Aa"
+      }.freeze
+
+      # Slugify while handling Danish letters and basic punctuation cleanup.
+      def documents_slugify(input, downcase = true, danish_map = true)
+        s = input.to_s.dup
+        s = s.gsub(/[æøåÆØÅ]/) { |ch| DANISH_MAP[ch] } if danish_map
+        s = s.strip.gsub(/[^\p{Alnum}\-_\s]/u, "")
+        s = s.tr(" ", "-").gsub(/-+/, "-")
+        s = s.gsub(/[æøåÆØÅ]/, "") unless danish_map  # Remove Danish chars if mapping disabled
+        s = s.downcase if downcase
+        s
+      end
+
+      # Title from filename e.g. "2026-03-01_Title_Here" -> "Title Here"
+      def documents_title_from_filename(basename)
+        if basename =~ /^\d{4}-\d{2}-\d{2}_(.+)$/
+          Regexp.last_match(1).tr("_", " ")
+        else
+          basename.tr("_", " ")
+        end
+      end
+    end
+  end
+end
+
+Liquid::Template.register_filter(Jekyll::Documents::Filters)