Browse Source

Tutorial: Add redirect pages for removed steps

Vito Gamberini 1 month ago
parent
commit
058e7da541

+ 10 - 0
Help/guide/tutorial/A Basic Starting Point.rst

@@ -0,0 +1,10 @@
+Step 1: A Basic Starting Point
+==============================
+
+This page was once part of an older version of the CMake tutorial which
+last appeared in CMake 4.1.  See the current tutorial version :guide:`here <CMake Tutorial>`.
+
+.. only:: cmakeorg
+
+  To see the older version, follow `this link <https://cmake.org/cmake/help/v4.1/guide/tutorial/A%20Basic%20Starting%20Point.html>`_
+  or select the drop-down in the page header.

+ 10 - 0
Help/guide/tutorial/Adding Export Configuration.rst

@@ -0,0 +1,10 @@
+Step 11: Adding Export Configuration
+====================================
+
+This page was once part of an older version of the CMake tutorial which
+last appeared in CMake 4.1.  See the current tutorial version :guide:`here <CMake Tutorial>`.
+
+.. only:: cmakeorg
+
+  To see the older version, follow `this link <https://cmake.org/cmake/help/v4.1/guide/tutorial/Adding%20Export%20Configuration.html>`_
+  or select the drop-down in the page header.

+ 10 - 0
Help/guide/tutorial/Adding Generator Expressions.rst

@@ -0,0 +1,10 @@
+Step 4: Adding Generator Expressions
+====================================
+
+This page was once part of an older version of the CMake tutorial which
+last appeared in CMake 4.1.  See the current tutorial version :guide:`here <CMake Tutorial>`.
+
+.. only:: cmakeorg
+
+  To see the older version, follow `this link <https://cmake.org/cmake/help/v4.1/guide/tutorial/Adding%20Generator%20Expressions.html>`_
+  or select the drop-down in the page header.

+ 10 - 0
Help/guide/tutorial/Adding Support for a Testing Dashboard.rst

@@ -0,0 +1,10 @@
+Step 6: Adding Support for a Testing Dashboard
+==============================================
+
+This page was once part of an older version of the CMake tutorial which
+last appeared in CMake 4.1.  See the current tutorial version :guide:`here <CMake Tutorial>`.
+
+.. only:: cmakeorg
+
+  To see the older version, follow `this link <https://cmake.org/cmake/help/v4.1/guide/tutorial/Adding%20Support%20for%20a%20Testing%20Dashboard.html>`_
+  or select the drop-down in the page header.

+ 10 - 0
Help/guide/tutorial/Adding System Introspection.rst

@@ -0,0 +1,10 @@
+Step 7: Adding System Introspection
+===================================
+
+This page was once part of an older version of the CMake tutorial which
+last appeared in CMake 4.1.  See the current tutorial version :guide:`here <CMake Tutorial>`.
+
+.. only:: cmakeorg
+
+  To see the older version, follow `this link <https://cmake.org/cmake/help/v4.1/guide/tutorial/Adding%20System%20Introspection.html>`_
+  or select the drop-down in the page header.

+ 10 - 0
Help/guide/tutorial/Adding Usage Requirements for a Library.rst

@@ -0,0 +1,10 @@
+Step 3: Adding Usage Requirements for a Library
+===============================================
+
+This page was once part of an older version of the CMake tutorial which
+last appeared in CMake 4.1.  See the current tutorial version :guide:`here <CMake Tutorial>`.
+
+.. only:: cmakeorg
+
+  To see the older version, follow `this link <https://cmake.org/cmake/help/v4.1/guide/tutorial/Adding%20Usage%20Requirements%20for%20a%20Library.html>`_
+  or select the drop-down in the page header.

+ 10 - 0
Help/guide/tutorial/Adding a Custom Command and Generated File.rst

@@ -0,0 +1,10 @@
+Step 8: Adding a Custom Command and Generated File
+==================================================
+
+This page was once part of an older version of the CMake tutorial which
+last appeared in CMake 4.1.  See the current tutorial version :guide:`here <CMake Tutorial>`.
+
+.. only:: cmakeorg
+
+  To see the older version, follow `this link <https://cmake.org/cmake/help/v4.1/guide/tutorial/Adding%20a%20Custom%20Command%20and%20Generated%20File.html>`_
+  or select the drop-down in the page header.

+ 10 - 0
Help/guide/tutorial/Adding a Library.rst

@@ -0,0 +1,10 @@
+Step 2: Adding a Library
+========================
+
+This page was once part of an older version of the CMake tutorial which
+last appeared in CMake 4.1.  See the current tutorial version :guide:`here <CMake Tutorial>`.
+
+.. only:: cmakeorg
+
+  To see the older version, follow `this link <https://cmake.org/cmake/help/v4.1/guide/tutorial/Adding%20a%20Library.html>`_
+  or select the drop-down in the page header.

+ 10 - 0
Help/guide/tutorial/Installing and Testing.rst

@@ -0,0 +1,10 @@
+Step 5: Installing and Testing
+==============================
+
+This page was once part of an older version of the CMake tutorial which
+last appeared in CMake 4.1.  See the current tutorial version :guide:`here <CMake Tutorial>`.
+
+.. only:: cmakeorg
+
+  To see the older version, follow `this link <https://cmake.org/cmake/help/v4.1/guide/tutorial/Installing%20and%20Testing.html>`_
+  or select the drop-down in the page header.

+ 10 - 0
Help/guide/tutorial/Packaging Debug and Release.rst

@@ -0,0 +1,10 @@
+Step 12: Packaging Debug and Release
+====================================
+
+This page was once part of an older version of the CMake tutorial which
+last appeared in CMake 4.1.  See the current tutorial version :guide:`here <CMake Tutorial>`.
+
+.. only:: cmakeorg
+
+  To see the older version, follow `this link <https://cmake.org/cmake/help/v4.1/guide/tutorial/Packaging%20Debug%20and%20Release.html>`_
+  or select the drop-down in the page header.

+ 10 - 0
Help/guide/tutorial/Packaging an Installer.rst

@@ -0,0 +1,10 @@
+Step 9: Packaging an Installer
+==============================
+
+This page was once part of an older version of the CMake tutorial which
+last appeared in CMake 4.1.  See the current tutorial version :guide:`here <CMake Tutorial>`.
+
+.. only:: cmakeorg
+
+  To see the older version, follow `this link <https://cmake.org/cmake/help/v4.1/guide/tutorial/Packaging%20an%20Installer.html>`_
+  or select the drop-down in the page header.

+ 10 - 0
Help/guide/tutorial/Selecting Static or Shared Libraries.rst

@@ -0,0 +1,10 @@
+Step 10: Selecting Static or Shared Libraries
+=============================================
+
+This page was once part of an older version of the CMake tutorial which
+last appeared in CMake 4.1.  See the current tutorial version :guide:`here <CMake Tutorial>`.
+
+.. only:: cmakeorg
+
+  To see the older version, follow `this link <https://cmake.org/cmake/help/v4.1/guide/tutorial/Selecting%20Static%20or%20Shared%20Libraries.html>`_
+  or select the drop-down in the page header.

+ 13 - 0
Help/guide/tutorial/index.rst

@@ -40,3 +40,16 @@ provides the complete solution for the previous step.
 .. toctree::
   :maxdepth: 1
   :hidden:
+
+  A Basic Starting Point
+  Adding a Library
+  Adding Usage Requirements for a Library
+  Adding Generator Expressions
+  Installing and Testing
+  Adding Support for a Testing Dashboard
+  Adding System Introspection
+  Adding a Custom Command and Generated File
+  Packaging an Installer
+  Selecting Static or Shared Libraries
+  Adding Export Configuration
+  Packaging Debug and Release

+ 6 - 0
Utilities/Sphinx/CMakeLists.txt

@@ -64,6 +64,12 @@ else()
   set(conf_baseurl "")
 endif()
 
+if(CMake_SPHINX_CMAKE_ORG)
+  set(conf_cmakeorg "True")
+else()
+  set(conf_cmakeorg "False")
+endif()
+
 set(conf_docs "${CMake_SOURCE_DIR}/Help")
 set(conf_path "${CMAKE_CURRENT_SOURCE_DIR}")
 set(conf_version "${CMake_VERSION_MAJOR}.${CMake_VERSION_MINOR}.${CMake_VERSION_PATCH}")

+ 3 - 0
Utilities/Sphinx/conf.py.in

@@ -35,6 +35,9 @@ templates_path = ['@conf_path@/templates']
 nitpicky = True
 smartquotes = False
 
+if @conf_cmakeorg@:
+    tags.add('cmakeorg')
+
 cmake_manuals = sorted(glob.glob(r'@conf_docs@/manual/*.rst'))
 cmake_manual_description = re.compile(r'^\.\. cmake-manual-description:(.*)$')
 man_pages = []