diff options
| author | Dennis Fink | 2026-11-06 18:40:14 +0100 |
|---|---|---|
| committer | Dennis Fink | 2026-11-06 18:40:14 +0100 |
| commit | 904b29dfa998ca491590cee2241c9ef92e16355c (patch) | |
| tree | 1474f7307ade4194cfbaf9ef994918861c043c20 | |
| parent | 2fc37fa4e2930e7c8603660301b1b0fe80a6c5a8 (diff) | |
| download | dennisfink.me-904b29dfa998ca491590cee2241c9ef92e16355c.tar.gz dennisfink.me-904b29dfa998ca491590cee2241c9ef92e16355c.zip | |
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.
Diffstat (limited to '')
| -rw-r--r-- | assets/static/css/style.css | 27 | ||||
| -rw-r--r-- | packages/blog-markdown-headings/lektor_blog_markdown_headings.py | 6 | ||||
| -rw-r--r-- | 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 '<h%d id="%s">%s</h%d>' % (level, anchor, text, level) + return f'<h{level} id="{anchor}">{text} <a href="#{anchor}" aria-label="Permalink" data-pagefind-ignore>#</a></h{level}>' - 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": [ |
