From 3ee5dc131df4e26e6b2798db9e63c9bab262d771 Mon Sep 17 00:00:00 2001
From: "Paul Gauthier (aider)" <paul@aider.chat>
Date: Fri, 21 Mar 2025 13:17:34 -0700
Subject: [PATCH] feat: Add hierarchical table of contents to documentation
 homepage

---
 aider/website/_config.yml   | 15 ++++++++++
 aider/website/docs/index.md | 58 +++++++++++++++++++++++++++++++++++++
 2 files changed, 73 insertions(+)

diff --git a/aider/website/_config.yml b/aider/website/_config.yml
index b34011eb3..20eebdd5e 100644
--- a/aider/website/_config.yml
+++ b/aider/website/_config.yml
@@ -51,4 +51,19 @@ callouts:
   note:
     title: Note
     color: yellow
+
+# Custom CSS for our table of contents
+kramdown:
+  syntax_highlighter_opts:
+    css_class: highlight
     
+sass:
+  style: compressed
+  
+# Additional CSS
+compress_html:
+  clippings: all
+  comments: all
+  endings: all
+  startings: []
+  
diff --git a/aider/website/docs/index.md b/aider/website/docs/index.md
index e69de29bb..f3ecfa1b1 100644
--- a/aider/website/docs/index.md
+++ b/aider/website/docs/index.md
@@ -0,0 +1,58 @@
+---
+layout: default
+title: Home
+nav_order: 1
+permalink: /
+---
+
+# Aider Documentation
+
+Aider is AI pair programming in your terminal. This documentation will help you get the most out of aider.
+
+## Table of Contents
+
+<div class="toc">
+{% assign pages_list = site.html_pages | sort:"nav_order" %}
+{% assign top_level_pages = pages_list | where_exp:"item", "item.parent == nil and item.title != nil and item.nav_exclude != true" %}
+
+<ul>
+{% for page in top_level_pages %}
+  {% if page.title != nil and page.url != "/" %}
+    <li>
+      <a href="{{ page.url | absolute_url }}">{{ page.title }}</a>
+      {% assign children = pages_list | where:"parent", page.title | sort:"nav_order" %}
+      {% if children.size > 0 %}
+        <ul>
+        {% for child in children %}
+          <li>
+            <a href="{{ child.url | absolute_url }}">{{ child.title }}</a>
+            {% assign grandchildren = pages_list | where:"parent", child.title | sort:"nav_order" %}
+            {% if grandchildren.size > 0 %}
+              <ul>
+              {% for grandchild in grandchildren %}
+                <li>
+                  <a href="{{ grandchild.url | absolute_url }}">{{ grandchild.title }}</a>
+                </li>
+              {% endfor %}
+              </ul>
+            {% endif %}
+          </li>
+        {% endfor %}
+        </ul>
+      {% endif %}
+    </li>
+  {% endif %}
+{% endfor %}
+</ul>
+</div>
+
+## Quick Links
+
+- [Installation Guide](/docs/installation)
+- [Getting Started](/docs/getting-started)
+- [Command Reference](/docs/commands)
+- [Configuration Options](/docs/configuration)
+
+## About Aider
+
+Aider is an open-source tool that brings the power of AI coding assistants directly to your terminal. Use natural language to add features, fix bugs, and refactor code with an AI assistant that understands your entire codebase.