From f576e5febf92b47c80db097c5f921889da466b89 Mon Sep 17 00:00:00 2001
From: Stan Lo <stan.lo@shopify.com>
Date: Sun, 8 Sep 2024 22:43:55 +0100
Subject: [PATCH] Make methods and attributes linkable

---
 .../generator/template/darkfish/class.rhtml   | 24 ++++++++++++-------
 .../generator/template/darkfish/css/rdoc.css  | 13 +++++++++-
 2 files changed, 28 insertions(+), 9 deletions(-)

diff --git a/lib/rdoc/generator/template/darkfish/class.rhtml b/lib/rdoc/generator/template/darkfish/class.rhtml
index 26652cada9..afac0c44cd 100644
--- a/lib/rdoc/generator/template/darkfish/class.rhtml
+++ b/lib/rdoc/generator/template/darkfish/class.rhtml
@@ -72,8 +72,10 @@
       <%- attributes.each do |attrib| -%>
       <div id="<%= attrib.aref %>" class="method-detail">
         <div class="method-heading attribute-method-heading">
-          <span class="method-name"><%= h attrib.name %></span><span
-            class="attribute-access-type">[<%= attrib.rw %>]</span>
+          <a href="#<%= attrib.aref %>" title="Link to this attribute">
+            <span class="method-name"><%= h attrib.name %></span>
+            <span class="attribute-access-type">[<%= attrib.rw %>]</span>
+          </a>
         </div>
 
         <div class="method-description">
@@ -103,21 +105,27 @@
           <%- if (call_seq = method.call_seq) then -%>
             <%- call_seq.strip.split("\n").each_with_index do |call_seq, i| -%>
               <div class="method-heading">
-                <span class="method-callseq">
-                  <%= h(call_seq.strip.
+                <a href="#<%= method.aref %>" title="Link to this method">
+                  <span class="method-callseq">
+                    <%= h(call_seq.strip.
                         gsub( /^\w+\./m, '')).
                         gsub(/(.*)[-=]&gt;/, '\1&rarr;') %>
-                </span>
+                  </span>
+                </a>
               </div>
             <%- end -%>
           <%- elsif method.has_call_seq? then -%>
             <div class="method-heading">
-              <span class="method-name"><%= h method.name %></span>
+              <a href="#<%= method.aref %>" title="Link to this method">
+                <span class="method-name"><%= h method.name %></span>
+              </a>
             </div>
           <%- else -%>
             <div class="method-heading">
-              <span class="method-name"><%= h method.name %></span>
-              <span class="method-args"><%= h method.param_seq %></span>
+              <a href="#<%= method.aref %>" title="Link to this method">
+                <span class="method-name"><%= h method.name %></span>
+                <span class="method-args"><%= h method.param_seq %></span>
+              </a>
             </div>
           <%- end -%>
         </div>
diff --git a/lib/rdoc/generator/template/darkfish/css/rdoc.css b/lib/rdoc/generator/template/darkfish/css/rdoc.css
index 09470a8ec9..12212a341e 100644
--- a/lib/rdoc/generator/template/darkfish/css/rdoc.css
+++ b/lib/rdoc/generator/template/darkfish/css/rdoc.css
@@ -631,6 +631,18 @@ main .method-heading {
   color: var(--text-color);
 }
 
+main .method-heading::after {
+  content: '¶';
+  position: absolute;
+  visibility: hidden;
+  color: var(--secondary-color);
+  font-size: 0.5em;
+}
+
+main .method-heading:hover::after {
+  visibility: visible;
+}
+
 main .method-controls {
   line-height: 20px;
   float: right;
@@ -663,7 +675,6 @@ main #attribute-method-details .method-detail:hover {
 }
 main .attribute-access-type {
   text-transform: uppercase;
-  padding: 0 1em;
 }
 /* @end */