This is an automated email from the ASF dual-hosted git repository.
kaxil pushed a commit to branch main
in repository https://gitbox.apache.org/repos/asf/airflow-site.git
The following commit(s) were added to refs/heads/main by this push:
new 2be60c3030 Make the docs sidebar easier to scan (#1700)
2be60c3030 is described below
commit 2be60c303081990faf8db3f9ebee2f581d605e93
Author: Kaxil Naik <[email protected]>
AuthorDate: Fri Oct 23 14:05:15 2026 +0100
Make the docs sidebar easier to scan (#1700)
Tighten line height and add padding between sidebar entries so a wrapped
title reads as one entry, and list only pages in the left sidebar via a
new sidebar_titles_only theme option. Page headings stay in the
right-hand TOC.
---
landing-pages/site/assets/scss/_roadmap.scss | 12 ++++++++++--
sphinx_airflow_theme/.theme_files_hash | 2 +-
sphinx_airflow_theme/LATEST_VERSION.txt | 2 +-
sphinx_airflow_theme/README.md | 2 ++
sphinx_airflow_theme/sphinx_airflow_theme/__init__.py | 2 +-
sphinx_airflow_theme/sphinx_airflow_theme/globaltoc.html | 2 +-
sphinx_airflow_theme/sphinx_airflow_theme/theme.conf | 1 +
7 files changed, 17 insertions(+), 6 deletions(-)
diff --git a/landing-pages/site/assets/scss/_roadmap.scss
b/landing-pages/site/assets/scss/_roadmap.scss
index 9eddf6541b..991a84a8d5 100644
--- a/landing-pages/site/assets/scss/_roadmap.scss
+++ b/landing-pages/site/assets/scss/_roadmap.scss
@@ -104,11 +104,13 @@
li {
list-style: none;
font-family: "Roboto", sans-serif;
- font-size: 16px;
+ font-size: 15px;
font-weight: normal;
font-stretch: normal;
font-style: normal;
- line-height: 1.63;
+ // Tight lines with padding between items, so a wrapped title reads as
one entry
+ line-height: 1.4;
+ padding: 4px 0;
letter-spacing: normal;
color: var(--bs-secondary-color, #707070);
}
@@ -118,6 +120,12 @@
display: none;
}
+ ul ul {
+ margin-left: 3px;
+ padding-left: 12px;
+ border-left: 1px solid var(--bs-border-color, #ddd);
+ }
+
& > ul, li.current > ul {
display: block;
}
diff --git a/sphinx_airflow_theme/.theme_files_hash
b/sphinx_airflow_theme/.theme_files_hash
index d949404d1e..74c6965d84 100644
--- a/sphinx_airflow_theme/.theme_files_hash
+++ b/sphinx_airflow_theme/.theme_files_hash
@@ -1 +1 @@
-30c2a9b01b3467097a8196f4214826e7bf603ccdf75ff47af8f07d589748e3be
+e4b54635f22e8c98999b5ee604e6f02c6c5d35c851fa2bf0614217502ab5622c
diff --git a/sphinx_airflow_theme/LATEST_VERSION.txt
b/sphinx_airflow_theme/LATEST_VERSION.txt
index 0b69c00c5f..9e29e10619 100644
--- a/sphinx_airflow_theme/LATEST_VERSION.txt
+++ b/sphinx_airflow_theme/LATEST_VERSION.txt
@@ -1 +1 @@
-0.3.14
+0.3.15
diff --git a/sphinx_airflow_theme/README.md b/sphinx_airflow_theme/README.md
index 859d65fd66..82c5bf5e8a 100644
--- a/sphinx_airflow_theme/README.md
+++ b/sphinx_airflow_theme/README.md
@@ -11,6 +11,7 @@
- [`hide_website_buttons`](#hide_website_buttons)
- [`sidebar_collapse`](#sidebar_collapse)
- [`sidebar_includehidden`](#sidebar_includehidden)
+ - [`sidebar_titles_only`](#sidebar_titles_only)
- [Theme's source files](#themes-source-files)
<!-- END doctoc generated TOC please keep comment here to allow auto update -->
@@ -151,6 +152,7 @@ html_theme_options = {
## `sidebar_collapse`
## `sidebar_includehidden`
+## `sidebar_titles_only`
Controls the ToC display in the sidebar. See
https://www.sphinx-doc.org/en/master/templating.html#toctree for more info
diff --git a/sphinx_airflow_theme/sphinx_airflow_theme/__init__.py
b/sphinx_airflow_theme/sphinx_airflow_theme/__init__.py
index afc44ed3bd..d8e596c95d 100644
--- a/sphinx_airflow_theme/sphinx_airflow_theme/__init__.py
+++ b/sphinx_airflow_theme/sphinx_airflow_theme/__init__.py
@@ -18,7 +18,7 @@
from os import path
from sphinx.application import Sphinx
-__version__ = '0.3.14'
+__version__ = '0.3.15'
__version_full__ = __version__
diff --git a/sphinx_airflow_theme/sphinx_airflow_theme/globaltoc.html
b/sphinx_airflow_theme/sphinx_airflow_theme/globaltoc.html
index d4426f62d9..0257879495 100644
--- a/sphinx_airflow_theme/sphinx_airflow_theme/globaltoc.html
+++ b/sphinx_airflow_theme/sphinx_airflow_theme/globaltoc.html
@@ -19,7 +19,7 @@
#}
<div class="toctree" role="navigation" aria-label="main navigation">
- {{ toctree(includehidden=theme_sidebar_includehidden,
collapse=theme_sidebar_collapse) }}
+ {{ toctree(includehidden=theme_sidebar_includehidden,
collapse=theme_sidebar_collapse, titles_only=theme_sidebar_titles_only|tobool)
}}
</div>
<!-- Toctree layout styles — colors are handled by the SCSS system
(_roadmap.scss)
diff --git a/sphinx_airflow_theme/sphinx_airflow_theme/theme.conf
b/sphinx_airflow_theme/sphinx_airflow_theme/theme.conf
index f72996aae7..2a0928e82c 100644
--- a/sphinx_airflow_theme/sphinx_airflow_theme/theme.conf
+++ b/sphinx_airflow_theme/sphinx_airflow_theme/theme.conf
@@ -11,3 +11,4 @@ navbar_links =
hide_website_buttons = false
sidebar_collapse = true
sidebar_includehidden = true
+sidebar_titles_only = true
