diff --git a/INSTALL.md b/INSTALL.md index 0ecbcadf000b..42b5b6e0d757 100644 --- a/INSTALL.md +++ b/INSTALL.md @@ -1,12 +1,10 @@ Building QGIS from source - step by step - + -# 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) @@ -14,45 +12,52 @@ Building QGIS from source - step by step * [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) + + # 1. Introduction