Fix anchors and hide pages from TOC

psonnera · psonnera · commit 38bdc2aa3228 · 2026-06-22T22:42:00.000+02:00
diff --git a/docs/EN/CompatiblePumps/Accu-Chek-Combo-Tips-for-Basic-usage.md b/docs/EN/CompatiblePumps/Accu-Chek-Combo-Tips-for-Basic-usage.md
@@ -1,3 +1,7 @@
+---
+orphan: true
+---
+
 # 
 
 <head>
diff --git a/docs/EN/Getting-Started/CompatiblePumps.md b/docs/EN/Getting-Started/CompatiblePumps.md
@@ -21,7 +21,7 @@ AAPS works with a number of insulin pumps. The following list shows the currentl
 ../CompatiblePumps/Future-possible-Pump-Drivers.md
 ```
 
-- [Accu-Chek Combo](../CompatiblePumps/Accu-Chek-Combo-Pump-v2.md) (Bluetooth; see also [Tips for basic usage](../CompatiblePumps/Accu-Chek-Combo-Pump-v2.md#combov2-tips-for-basic-usage))
+- [Accu-Chek Combo](../CompatiblePumps/Accu-Chek-Combo-Pump-v2.md) (Bluetooth; see also [Tips for basic usage](#combov2-tips-for-basic-usage))
 - [Accu-Chek Insight](../CompatiblePumps/Accu-Chek-Insight-Pump.md) (Bluetooth)
 - [DanaR](../CompatiblePumps/DanaR-Insulin-Pump.md) (Bluetooth)
 - [DanaRS](../CompatiblePumps/DanaRS-Insulin-Pump.md) (Bluetooth)
diff --git a/docs/EN/Getting-Started/PreparingForAaps.md b/docs/EN/Getting-Started/PreparingForAaps.md
@@ -103,7 +103,7 @@ A “keystore” (.jks file) is a password encrypted file unique to your own cop
 
 How you save the keystore depends on your build method:
 
-- **Android Studio (computer) build**: the keystore is created during the build — see [Generate signed APK](../SettingUpAaps/ComputerBuild.md#Building-APK-generate-signed-apk) for instructions on where to save it.
+- **Android Studio (computer) build**: the keystore is created during the build — see [Generate signed APK](#Building-APK-generate-signed-apk) for instructions on where to save it.
 - **Browser build**: use the dedicated [Export keystore](../SettingUpAaps/BrowserBuild.md#ci-keystore-export) workflow to download a copy to your Google Drive.
 
 This will ensure that you can use that exact same keystore file each time an updated version of **AAPS** is created. On average, there will be 2 **AAPS** updates required each year.
diff --git a/docs/EN/Getting-Started/Watches.md b/docs/EN/Getting-Started/Watches.md
@@ -84,7 +84,7 @@ To support installation and use of any version of **AAPS** or **AAPSClient**, a
 If you install **AAPS** wear.apk on a **Wear OS** watch, there are a range of different custom **AAPS** watchfaces which can be selected. Alternatively, you can use a standard smartphone watchface, with your **AAPS** information included in small tiles known as “complications” on the face. A complication is any feature that is displayed on a watchface in addition to the time.
 
 ```{note}
-Recent **Wear OS** changes progressively break the custom **AAPS** watchfaces (the higher the Wear OS version, the more severe), although **complications** keep working. Before buying or updating a watch, read [Wear OS watch face changes](../WearOS/WearOsSmartwatch.md#wearos-watchface-changes).
+Recent **Wear OS** changes progressively break the custom **AAPS** watchfaces (the higher the Wear OS version, the more severe), although **complications** keep working. Before buying or updating a watch, read [Wear OS watch face changes](#wearos-watchface-changes).
 ```
 
 
diff --git a/docs/EN/GettingHelp/GeneralTroubleshooting.md b/docs/EN/GettingHelp/GeneralTroubleshooting.md
@@ -150,7 +150,7 @@ Useful links to known issues and steps to resolve for CGMs.
 Useful links to known issues and steps to resolve for Pumps
 
 * [DanaRS](#DanaRS-Insulin-Pump-dana-rs-specific-errors)
-* [Accu-Chek Combo general](../CompatiblePumps/Accu-Chek-Combo-Pump-v2.md#combov2-tips-for-basic-usage)
+* [Accu-Chek Combo general](#combov2-tips-for-basic-usage)
 * [Accu-Chek Insight](#Accu-Chek-Insight-Pump-insight-specific-errors)
 * [Medtronic + RileyLink](#MedtronicPump-what-to-do-if-i-loose-connection-to-rileylink-and-or-pump)
 * [Medtrum Nano](#medtrum-nano-troubleshooting)
diff --git a/docs/EN/RemoteFeatures/RemoteControlWearOS.md b/docs/EN/RemoteFeatures/RemoteControlWearOS.md
@@ -6,7 +6,7 @@
 
 ```{warning}
 AAPS Watchfaces are available for Wear OS smartwatches with API level 31 to 33.
-Wear OS 5 changes locked the watchfaces: only complications can be used. See [Wear OS watch face changes](../WearOS/WearOsSmartwatch.md#wearos-watchface-changes) for what breaks on each Wear OS version and why.
+Wear OS 5 changes locked the watchfaces: only complications can be used. See [Wear OS watch face changes](#wearos-watchface-changes) for what breaks on each Wear OS version and why.
 ```
 
 There are several watchfaces to choose from that are included in the base build of the AAPS Wear APK. These watchfaces include average delta, IOB, currently active temp basal rate and basal profiles and a CGM readings graph.
diff --git a/docs/EN/Sandbox/sandbox1.md b/docs/EN/Sandbox/sandbox1.md
@@ -1,3 +1,7 @@
+---
+orphan: true
+---
+
 # internal sandbox file 1 for testing our sprint
 
 ```{admonition} no need to translate this
diff --git a/docs/EN/WearOS/BuildingAapsWearOS.md b/docs/EN/WearOS/BuildingAapsWearOS.md
@@ -10,7 +10,7 @@ AAPS requires at least Wear OS API level 31 (Android 12).
 
 ```{warning}
 AAPS Watchfaces are available for Wear OS smartwatches with API level 31 to 33.<br>
-Newer Wear OS versions progressively break the AAPS watchfaces — see [Wear OS watch face changes](WearOsSmartwatch.md#wearos-watchface-changes) and the [Wear OS 5 limitations](#BuildingAapsWearOs-WearOS5).
+Newer Wear OS versions progressively break the AAPS watchfaces — see [Wear OS watch face changes](#wearos-watchface-changes) and the [Wear OS 5 limitations](#BuildingAapsWearOs-WearOS5).
 ```
 
 ## Building the **AAPS** Wear apk
diff --git a/docs/EN/index.md b/docs/EN/index.md
@@ -5,7 +5,7 @@
 ```{admonition} Latest Release
 :class: note
 
- 4 June 2026 : Version 3.4.2.3 is out. Check the [Release Notes](#latestrelease) to see what's new and follow the instructions in the [update manual](./Maintenance/UpdateToNewVersion.md) to update.
+ xx xxxx 202x : Version {{ aaps_version }}.x.x is out. Check the [Release Notes](#latestrelease) to see what's new and follow the instructions in the [update manual](./Maintenance/UpdateToNewVersion.md) to update.
 
 ```
 
@@ -200,12 +200,6 @@ State of translations <./SupportingAaps/StateOfTranslations.md>
 Open Humans Uploader <./SupportingAaps/OpenHumans.md>
 
 ```
-```{toctree}
-:hidden:
-
-Sandbox/sandbox1.md
-```
-
 ```{toctree}
 :caption: 12) Resources
 
diff --git a/docs/_templates/layout.html b/docs/_templates/layout.html
@@ -1,4 +1,38 @@
-{% extends "!layout.html" %}
-{% block extrahead %}
-    <link href="{{ pathto("_static/css/custom.css", True) }}" rel="stylesheet" type="text/css">
-{% endblock %}
+{% extends "!layout.html" %}
+{% block extrahead %}
+    <link href="{{ pathto("_static/css/custom.css", True) }}" rel="stylesheet" type="text/css">
+{% endblock %}
+
+{# Re-implement the theme's sidebar header so the documented AAPS version is
+   always shown under the icon/title. sphinx_rtd_theme 3.0 dropped the static
+   version div, showing it only via the (here disabled) RTD flyout. The value
+   comes from `version` in shared.conf.py (single source of truth). #}
+{%- block sidebartitle %}
+
+{%- set _logo_url = logo_url|default(pathto('_static/' + (logo or ""), 1)) %}
+{%- set _root_doc = root_doc|default(master_doc) %}
+<a href="{{ pathto(_root_doc) }}"{% if not theme_logo_only %} class="icon icon-home"{% endif %}>
+  {% if not theme_logo_only %}{{ project }}{% endif %}
+  {%- if logo or logo_url %}
+    <img src="{{ _logo_url }}" class="logo" alt="{{ _('Logo') }}"/>
+  {%- endif %}
+</a>
+
+{%- if version %}
+  <div class="version">
+    {{ _('Version') }} {{ version }}
+  </div>
+{%- endif %}
+
+{%- if READTHEDOCS or DEBUG %}
+  {%- if theme_version_selector or theme_language_selector %}
+    <div class="switch-menus">
+      <div class="version-switch"></div>
+      <div class="language-switch"></div>
+    </div>
+  {%- endif %}
+{%- endif %}
+
+{%- include "searchbox.html" %}
+
+{%- endblock %}
diff --git a/docs/shared.conf.py b/docs/shared.conf.py
@@ -49,6 +49,7 @@
 
 myst_enable_extensions = [
   "colon_fence",
+  "substitution",
 ]
 
 myst_heading_anchors = 3
@@ -81,10 +82,20 @@
 # |version| and |release|, also used in various other places throughout the
 # built documents.
 #
-# The short X.Y version.
-version = u'3.4'
-# The full version, including alpha/beta/rc tags.
-release = u'3.4'
+# >>> SINGLE SOURCE OF TRUTH FOR THE DOCUMENTED AAPS VERSION <<<
+# Update this one line only; everything else (sidebar, page text via the
+# {{ aaps_version }} substitution, |version|/|release|) is derived from it.
+version = u'4.0'
+# The full version, including alpha/beta/rc tags. Mirrors the version above.
+release = version
+
+# Expose the version to pages as {{ aaps_version }} (requires the MyST
+# "substitution" extension enabled above). HTML templates already receive
+# `version`/`release` from Sphinx automatically, so no extra wiring is needed
+# for the sidebar.
+myst_substitutions = {
+  "aaps_version": version,
+}
 
 # The language for content autogenerated by Sphinx. Refer to documentation
 # for a list of supported languages.

Original file line number	Diff line number	Diff line change
`@@ -1,3 +1,7 @@`
	`1`	`+---`
	`2`	`+orphan: true`
	`3`	`+---`
	`4`	`+`
`1`	`5`	`#`
`2`	`6`
`3`	`7`	`<head>`