From 904b29dfa998ca491590cee2241c9ef92e16355c Mon Sep 17 00:00:00 2001 From: Dennis Fink Date: Fri, 6 Nov 2026 18:40:14 +0100 Subject: Add permalinks to blog post headings This adds direct permalink links to Markdown headings, making it easier to share specific sections of a blog post. The links appear on hover or keyboard focus and remain visible on touch devices. They are excluded from Pagefind indexing to avoid unnecessary search content. --- assets/static/css/style.css | 27 ++++++++++++++++++++++ .../lektor_blog_markdown_headings.py | 6 ++--- packages/blog-markdown-headings/setup.py | 2 +- 3 files changed, 31 insertions(+), 4 deletions(-) diff --git a/assets/static/css/style.css b/assets/static/css/style.css index beb9cc3..c210a9b 100644 --- a/assets/static/css/style.css +++ b/assets/static/css/style.css @@ -653,6 +653,33 @@ article { color: var(--green); } + /* --- Heading permalinks --- */ + & :is(h2, h3, h4, h5, h6)[id] { + & > a[aria-label="Permalink"] { + color: var(--dim-foreground); + font-size: 0.75em; + opacity: 0; + text-decoration: none; + vertical-align: center; + + &:hover, + &:focus-visible { + color: var(--blue); + } + } + + &:hover > a[aria-label="Permalink"], + &:focus-within > a[aria-label="Permalink"] { + opacity: 1; + } + + @media (hover: none) { + & > a[aria-label="Permalink"] { + opacity: 1; + } + } + } + & blockquote { font-style: italic; border-left: 2px solid var(--blue); diff --git a/packages/blog-markdown-headings/lektor_blog_markdown_headings.py b/packages/blog-markdown-headings/lektor_blog_markdown_headings.py index 5293676..f7703c0 100644 --- a/packages/blog-markdown-headings/lektor_blog_markdown_headings.py +++ b/packages/blog-markdown-headings/lektor_blog_markdown_headings.py @@ -113,13 +113,13 @@ def renderer_mixin_factory(anchor_type, adjusted_level): meta["toc"].append((level, anchor, Markup(text))) - return '%s' % (level, anchor, text, level) + return f'{text} #' - class RendererMixinMistune0(object): + class RendererMixinMistune0: def header(self, text, level, raw): return render_heading(text, level, self.meta, raw) - class RendererMixinMistune2(object): + class RendererMixinMistune2: def heading(self, text, level): meta = self.lektor.meta return render_heading(text, level, meta) diff --git a/packages/blog-markdown-headings/setup.py b/packages/blog-markdown-headings/setup.py index 59f9895..b924036 100644 --- a/packages/blog-markdown-headings/setup.py +++ b/packages/blog-markdown-headings/setup.py @@ -2,7 +2,7 @@ from setuptools import setup setup( name="lektor-blog-markdown-headings", - version="0.1", + version="0.2", py_modules=["lektor_blog_markdown_headings"], entry_points={ "lektor.plugins": [ -- cgit v1.3.1