From 3cf08c132cbb57826c9583852d29f90035c7b257 Mon Sep 17 00:00:00 2001
From: Sean Mooney <work@seanmooney.info>
Date: Mon, 14 Apr 2025 23:21:08 +0100
Subject: [PATCH 1/2] support links in text-based browsers

This change modifies the list template to add
an additional <a> to the article header.

The existing a tag uses the `entry-link` css class
to make the containing article cliable by forcing
`position: absolute` in combination with an empty
anchor element `<a class='entry-link'></a>`

This has the effect of making the entire article
clickable to navigate in a graphical browser however
it is not rendered in a text-based browser.

To correct this the title text in the article header
is wrapped in a second <a> tag. The `entry-link` css
class is not applied and default css is inherited.

Closes: #1716
---
 layouts/_default/list.html | 4 +++-
 1 file changed, 3 insertions(+), 1 deletion(-)

diff --git a/layouts/_default/list.html b/layouts/_default/list.html
index 81aea6e4f7..74b67c39a3 100644
--- a/layouts/_default/list.html
+++ b/layouts/_default/list.html
@@ -68,7 +68,8 @@ <h1>
   {{- partial "cover.html" (dict "cxt" . "IsSingle" false "isHidden" $isHidden) }}
   <header class="entry-header">
     <h2 class="entry-hint-parent">
-      {{- .Title }}
+      <!-- This link makes the title text clickable in text mode -->
+      <a aria-label="post link to {{ .Title | plainify }}" href="{{ .Permalink }}">{{- .Title }}</a>
       {{- if .Draft }}
       <span class="entry-hint" title="Draft">
         <svg xmlns="http://www.w3.org/2000/svg" height="20" viewBox="0 -960 960 960" fill="currentColor">
@@ -89,6 +90,7 @@ <h2 class="entry-hint-parent">
     {{- partial "post_meta.html" . -}}
   </footer>
   {{- end }}
+  <!-- This link makes the entire entry clickable in a graphical browser -->
   <a class="entry-link" aria-label="post link to {{ .Title | plainify }}" href="{{ .Permalink }}"></a>
 </article>
 {{- end }}

From c05669e1fbff65b1b7877f5a84fac092c22c8b8a Mon Sep 17 00:00:00 2001
From: Sean Mooney <work@seanmooney.info>
Date: Tue, 15 Apr 2025 09:08:55 +0100
Subject: [PATCH 2/2] make archive links clickable on text-based browsers

This change makes the titles on archive lists
a tags so that they are clickable in text only mode.
As with the list template, no class is applied
to ensure correct indentation.
---
 layouts/_default/archives.html | 4 +++-
 1 file changed, 3 insertions(+), 1 deletion(-)

diff --git a/layouts/_default/archives.html b/layouts/_default/archives.html
index eea3fc8a49..778a02a328 100644
--- a/layouts/_default/archives.html
+++ b/layouts/_default/archives.html
@@ -56,7 +56,8 @@ <h3 class="archive-month-header" id="{{ $year }}-{{ .Key }}">
       {{- if eq .Kind "page" }}
       <div class="archive-entry">
         <h3 class="archive-entry-title entry-hint-parent">
-          {{- .Title | markdownify }}
+          <!-- This link makes the title text clickable in text mode -->
+          <a aria-label="post link to {{ .Title | plainify }}" href="{{ .Permalink }}">{{- .Title | markdownify }}</a>
           {{- if .Draft }}
           <span class="entry-hint" title="Draft">
             <svg xmlns="http://www.w3.org/2000/svg" height="15" viewBox="0 -960 960 960" fill="currentColor">
@@ -69,6 +70,7 @@ <h3 class="archive-entry-title entry-hint-parent">
         <div class="archive-meta">
           {{- partial "post_meta.html" . -}}
         </div>
+        <!-- This link makes the entire entry clickable in a graphical browser -->
         <a class="entry-link" aria-label="post link to {{ .Title | plainify }}" href="{{ .Permalink }}"></a>
       </div>
       {{- end }}