Fix documentation issues

Signed-off-by: Cristian Le <[email protected]>

Author: LecrisUT

cmake/DynamicVersion.md

@@ -1,5 +1,7 @@
 # [`DynamicVersion.cmake`](DynamicVersion.cmake)
 
+<!-- SPHINX-START -->
+
 Calculate the project version from the git tags or `.git_archival.txt` if the source is not a git repository
 
 ## Example
@@ -27,3 +29,5 @@ add_dependencies(version_lib My_Project_Version)
 set_property(SOURCE version.cpp.in APPEND PROPERTY
 		OBJECT_DEPENDS ${CMAKE_CURRENT_BINARY_DIR}/.version)
 ```
+
+<!-- SPHINX-END -->

cmake/PackageComps.md

@@ -1,5 +1,7 @@
 # [`PackageComps.cmake`](PackageComps.cmake)
 
+<!-- SPHINX-START -->
+
 Export and import targets as individual components. Special components `shared` and `static`
 
 ## Example
@@ -54,3 +56,5 @@ project(Downstream_Project)
 
 find_package(My_Project COMPONENTS my_component)
 ```
+
+<!-- SPHINX-END -->

docs/cmake_modules/DynamicVersion.md

@@ -1,5 +1,6 @@
 # DynamicVersion
 
 ```{include} ../../cmake/DynamicVersion.md
-: start-after: "# [`DynamicVersion.cmake`](DynamicVersion.cmake)"
+:start-after: <!-- SPHINX-START -->
+:end-before: <!-- SPHINX-END -->
 ```

docs/cmake_modules/PackageComps.md

@@ -1,5 +1,6 @@
 # PackageComps
 
 ```{include} ../../cmake/PackageComps.md
-: start-after: "# [`PackageComps.cmake`](PackageComps.cmake)"
+:start-after: <!-- SPHINX-START -->
+:end-before: <!-- SPHINX-END -->
 ```

docs/cmake_modules/index.md

@@ -1,10 +1,8 @@
 # CMake modules
 
 ```{toctree}
-: maxdepth: 1
-: titlesonly: true
-: caption: Contents
-: glob: true
+:titlesonly: true
 
-./*
+DynamicVersion
+PackageComps
 ```

docs/index.md

@@ -2,14 +2,9 @@
 
 CMakeExtraUtils is a collection of cmake modules designed to help you manage and export your cmake project.
 
-See the [installation guide](install) for details on how to import this project and
-[CMake modules](cmake_modules/index) for the modules available.
-
 ```{toctree}
-: maxdepth: 2
-: titlesonly: true
-: caption: Contents
+:hidden: true
 
-install
+self
 cmake_modules/index
 ```