From 645cf0b645ad4aa307232221ffa95b169db30caf Mon Sep 17 00:00:00 2001
From: Stan Lo <stan001212@gmail.com>
Date: Sun, 23 Nov 2025 23:31:54 +0000
Subject: [PATCH 1/2] Allow customizing Aliki's footer

---
 .rdoc_options                                  |  7 +++++++
 .../generator/template/aliki/_footer.rhtml     | 18 ++++++++----------
 lib/rdoc/generator/template/aliki/css/rdoc.css |  6 ++++++
 lib/rdoc/options.rb                            | 18 ++++++++++++++++++
 test/rdoc/rdoc_options_test.rb                 |  1 +
 5 files changed, 40 insertions(+), 10 deletions(-)

diff --git a/.rdoc_options b/.rdoc_options
index d60794a5eb..ab54556487 100644
--- a/.rdoc_options
+++ b/.rdoc_options
@@ -10,3 +10,10 @@ exclude:
 - AGENTS.md
 - CLAUDE.md
 - lib/rdoc/markdown.kpeg
+
+footer_content:
+  DOCUMENTATION:
+    Home: index.html
+  RESOURCES:
+    GitHub Repository: https://github.com/ruby/rdoc
+    Issue Tracker: https://github.com/ruby/rdoc/issues
diff --git a/lib/rdoc/generator/template/aliki/_footer.rhtml b/lib/rdoc/generator/template/aliki/_footer.rhtml
index c8da9b005f..b29abc42e3 100644
--- a/lib/rdoc/generator/template/aliki/_footer.rhtml
+++ b/lib/rdoc/generator/template/aliki/_footer.rhtml
@@ -1,20 +1,18 @@
 <footer class="site-footer">
+  <% if @options.footer_content && !@options.footer_content.empty? %>
   <div class="footer-content">
+    <% @options.footer_content.each do |column_title, links| %>
     <div>
-      <h3>Documentation</h3>
+      <h3><%= h column_title %></h3>
       <ul>
-        <li><a href="<%= h asset_rel_path %>/index.html">Home</a></li>
-      </ul>
-    </div>
-
-    <div>
-      <h3>Resources</h3>
-      <ul>
-        <li><a href="https://ruby.github.io/rdoc/">RDoc Documentation</a></li>
-        <li><a href="https://github.com/ruby/rdoc">RDoc GitHub</a></li>
+        <% links.each do |text, url| %>
+        <li><a href="<%= h url %>"><%= h text %></a></li>
+        <% end %>
       </ul>
     </div>
+    <% end %>
   </div>
+  <% end %>
 
   <div class="footer-bottom">
     <p>
diff --git a/lib/rdoc/generator/template/aliki/css/rdoc.css b/lib/rdoc/generator/template/aliki/css/rdoc.css
index f063100509..ab8a865415 100644
--- a/lib/rdoc/generator/template/aliki/css/rdoc.css
+++ b/lib/rdoc/generator/template/aliki/css/rdoc.css
@@ -1463,6 +1463,12 @@ footer.site-footer .footer-bottom {
   color: var(--color-text-tertiary);
 }
 
+footer.site-footer .footer-bottom:first-child {
+  margin-top: 0;
+  padding-top: 0;
+  border-top: none;
+}
+
 /* Search */
 #search-section {
   padding: var(--space-6);
diff --git a/lib/rdoc/options.rb b/lib/rdoc/options.rb
index 3ec08e4364..557993a263 100644
--- a/lib/rdoc/options.rb
+++ b/lib/rdoc/options.rb
@@ -378,6 +378,21 @@ class RDoc::Options
 
   attr_accessor :canonical_root
 
+  ##
+  # Custom footer content configuration for themes that support it.
+  # Currently only supported by the Aliki theme.
+  #
+  # A hash where keys are column titles and values are hashes of link text => URL pairs.
+  # Each column will be displayed in the upper footer section.
+  #
+  # Example:
+  #   {
+  #     "DOCUMENTATION" => {"Home" => "/index.html", "Guide" => "/guide.html"},
+  #     "RESOURCES" => {"RDoc" => "https://ruby.github.io/rdoc/", "GitHub" => "https://github.com/ruby/rdoc"}
+  #   }
+
+  attr_accessor :footer_content
+
   def initialize(loaded_options = nil) # :nodoc:
     init_ivars
     override loaded_options if loaded_options
@@ -434,6 +449,7 @@ def init_ivars # :nodoc:
     @class_module_path_prefix = nil
     @file_path_prefix = nil
     @canonical_root = nil
+    @footer_content = nil
   end
 
   def init_with(map) # :nodoc:
@@ -462,6 +478,7 @@ def init_with(map) # :nodoc:
 
     @apply_default_exclude   = map['apply_default_exclude']
     @autolink_excluded_words = map['autolink_excluded_words']
+    @footer_content          = map['footer_content']
 
     @rdoc_include = sanitize_path map['rdoc_include']
     @static_path  = sanitize_path map['static_path']
@@ -498,6 +515,7 @@ def override(map) # :nodoc:
     @autolink_excluded_words = map['autolink_excluded_words'] if map.has_key?('autolink_excluded_words')
     @apply_default_exclude = map['apply_default_exclude'] if map.has_key?('apply_default_exclude')
     @canonical_root = map['canonical_root'] if map.has_key?('canonical_root')
+    @footer_content = map['footer_content'] if map.has_key?('footer_content')
 
     @warn_missing_rdoc_ref = map['warn_missing_rdoc_ref'] if map.has_key?('warn_missing_rdoc_ref')
 
diff --git a/test/rdoc/rdoc_options_test.rb b/test/rdoc/rdoc_options_test.rb
index cdf32748d6..31da288023 100644
--- a/test/rdoc/rdoc_options_test.rb
+++ b/test/rdoc/rdoc_options_test.rb
@@ -90,6 +90,7 @@ def test_to_yaml
       'class_module_path_prefix' => nil,
       'file_path_prefix' => nil,
       'canonical_root' => nil,
+      'footer_content' => nil,
     }
 
     assert_equal expected, coder

From b35e6e26211c431a3c829944d48625e642b3d69f Mon Sep 17 00:00:00 2001
From: Stan Lo <stan001212@gmail.com>
Date: Tue, 25 Nov 2025 11:28:12 +0000
Subject: [PATCH 2/2] Do not force footer column names to be capitalized

---
 lib/rdoc/generator/template/aliki/css/rdoc.css | 1 -
 1 file changed, 1 deletion(-)

diff --git a/lib/rdoc/generator/template/aliki/css/rdoc.css b/lib/rdoc/generator/template/aliki/css/rdoc.css
index ab8a865415..ac3143cf9c 100644
--- a/lib/rdoc/generator/template/aliki/css/rdoc.css
+++ b/lib/rdoc/generator/template/aliki/css/rdoc.css
@@ -1429,7 +1429,6 @@ footer.site-footer h3 {
   font-weight: var(--font-weight-semibold);
   color: var(--color-text-primary);
   margin: 0 0 var(--space-4) 0;
-  text-transform: uppercase;
   letter-spacing: 0.05em;
 }