Merge pull request #59378 from nicogodet/patch-1

Update INSTALL.md TOC - take 2
qgis · Nov 8, 2024 · cbcfe86 · cbcfe86
2 parents f58c6ac + da72457
commit cbcfe86
Showing 1 changed file with 33 additions and 28 deletions.
diff --git a/INSTALL.md b/INSTALL.md
@@ -1,58 +1,63 @@
 Building QGIS from source - step by step
 
-<!-- Table of contents generated with https://freelance-tech-writer.github.io/table-of-contents-generator/index.html -->
+<!-- TOC start (generated with https://bitdowntoc.derlin.ch/) -->
 
-# Table of Contents
-* [Table of Contents](#table-of-contents)
-* [1. Introduction](#1-introduction)
-* [2. Overview](#2-overview)
-* [3. Building on GNU/Linux](#3-building-on-gnulinux)
+- [1. Introduction](#1-introduction)
+- [2. Overview](#2-overview)
+- [3. Building on GNU/Linux](#3-building-on-gnulinux)
    * [3.1. Building QGIS with Qt 5.x](#31-building-qgis-with-qt-5x)
    * [3.2. Prepare apt](#32-prepare-apt)
    * [3.3. Install build dependencies](#33-install-build-dependencies)
    * [3.4. Setup ccache (Optional, but recommended)](#34-setup-ccache-optional-but-recommended)
    * [3.5. Prepare your development environment](#35-prepare-your-development-environment)
    * [3.6. Check out the QGIS Source Code](#36-check-out-the-qgis-source-code)
    * [3.7. Starting the compile](#37-starting-the-compile)
-       * [3.7.1 Available compilation flags](#371-available-compilation-flags)
+      + [3.7.1 Available compilation flags](#371-available-compilation-flags)
    * [3.8. Compiling with 3D](#38-compiling-with-3d)
-       * [3.8.1. Compiling with 3D on old Debian based distributions](#381-compiling-with-3d-on-old-debian-based-distributions)
+      + [3.8.1. Compiling with 3D on old Debian based distributions](#381-compiling-with-3d-on-old-debian-based-distributions)
    * [3.9. Building different branches](#39-building-different-branches)
    * [3.10. Building Debian packages](#310-building-debian-packages)
-       * [3.10.1. Building packages with oracle support](#3101-building-packages-with-oracle-support)
+      + [3.10.1. Building packages with Oracle support](#3101-building-packages-with-oracle-support)
    * [3.11. On Fedora Linux](#311-on-fedora-linux)
-       * [3.11.1. Install build dependencies](#3111-install-build-dependencies)
-       * [3.11.2. Suggested system tweaks](#3112-suggested-system-tweaks)
-       * [3.11.3. Additional tools for QGIS development](#3113-additional-tools-for-qgis-development)
-* [4. Building on Windows](#4-building-on-windows)
+      + [3.11.1. Install build dependencies](#3111-install-build-dependencies)
+      + [3.11.2. Suggested system tweaks](#3112-suggested-system-tweaks)
+      + [3.11.3. Additional tools for QGIS development](#3113-additional-tools-for-qgis-development)
+      + [3.11.4. QT6 experimental builds with Fedora Rawhide](#3114-qt6-experimental-builds-with-fedora-rawhide)
+- [4. Building on Windows](#4-building-on-windows)
    * [4.1. Building with Microsoft Visual Studio](#41-building-with-microsoft-visual-studio)
-       * [4.1.1. Visual Studio 2022 Community Edition](#411-visual-studio-2022-community-edition)
-       * [4.1.2. Other tools and dependencies](#412-other-tools-and-dependencies)
-       * [4.1.3. Clone the QGIS Source Code](#413-clone-the-qgis-source-code)
-       * [4.1.4. OSGeo4W](#414-osgeo4w)
+      + [4.1.1. Visual Studio 2022 Community Edition](#411-visual-studio-2022-community-edition)
+      + [4.1.2. Other tools and dependencies](#412-other-tools-and-dependencies)
+      + [4.1.3. Clone the QGIS Source Code](#413-clone-the-qgis-source-code)
+      + [4.1.4. OSGeo4W](#414-osgeo4w)
    * [4.2. Building on Linux with mingw64](#42-building-on-linux-with-mingw64)
-       * [4.2.1. Building with Docker](#421-building-with-docker)
-           * [4.2.1.1. Initial setup](#4211-initial-setup)
-           * [4.2.1.2. Building the dependencies](#4212-building-the-dependencies)
-           * [4.2.1.3. Cross-Building QGIS](#4213-cross-building-qgis)
-       * [4.2.2. Testing QGIS](#422-testing-qgis)
-   * [4.3 Building for Qt 6 with VCPKG in Microsoft Visual Studio](43-building-on-windows-with-vcpkg)
-* [5. Building on MacOS X](#5-building-on-macos-x)
+      + [4.2.1. Building with Docker](#421-building-with-docker)
+         - [4.2.1.1. Initial setup](#4211-initial-setup)
+         - [4.2.1.2. Building the dependencies](#4212-building-the-dependencies)
+         - [4.2.1.3. Cross-Building QGIS](#4213-cross-building-qgis)
+      + [4.2.2. Testing QGIS](#422-testing-qgis)
+   * [4.3 Building on Windows with vcpkg](#43-building-on-windows-with-vcpkg)
+      + [4.3.1 Install Build Tools](#431-install-build-tools)
+      + [4.3.2 Build QGIS](#432-build-qgis)
+         - [4.3.2.1 Build with an SDK](#4321-build-with-an-sdk)
+         - [4.3.2.1 Build all the dependencies locally](#4321-build-all-the-dependencies-locally)
+- [5. Building on MacOS X](#5-building-on-macos-x)
    * [5.1. Install Developer Tools](#51-install-developer-tools)
    * [5.2. Install CMake and other build tools](#52-install-cmake-and-other-build-tools)
    * [5.3. Install Qt5 and QGIS-Deps](#53-install-qt5-and-qgis-deps)
    * [5.4. QGIS source](#54-qgis-source)
    * [5.5. Configure the build](#55-configure-the-build)
    * [5.6. Building](#56-building)
-* [6. Setting up the WCS test server on GNU/Linux](#6-setting-up-the-wcs-test-server-on-gnulinux)
+- [6. Setting up the WCS test server on GNU/Linux](#6-setting-up-the-wcs-test-server-on-gnulinux)
    * [6.1. Preparation](#61-preparation)
    * [6.2. Setup mapserver](#62-setup-mapserver)
    * [6.3. Create a home page](#63-create-a-home-page)
    * [6.4. Now deploy it](#64-now-deploy-it)
    * [6.5. Debugging](#65-debugging)
-* [7. Setting up a Jenkins Build Server](#7-setting-up-a-jenkins-build-server)
-* [8. Debug output and running tests](#8-debug-output-and-running-tests)
-* [9. Authors and Acknowledgments](#9-authors-and-acknowledgments)
+- [7. Setting up a Jenkins Build Server](#7-setting-up-a-jenkins-build-server)
+- [8. Debug output and running tests](#8-debug-output-and-running-tests)
+- [9. Authors and Acknowledgments](#9-authors-and-acknowledgments)
+
+<!-- TOC end -->
 
 # 1. Introduction