Fixing doxygen builds on Windows

Fixed a quoting issue with doxygen builds on Windows.
Updated doxygen-awesome-css to 2.4.1
Changed recommendation on setting CPM_SOURCE_CACHE to only apply if the project is top-level.

Author: sean-parent

README.md

@@ -28,7 +28,10 @@ cmake_minimum_required(VERSION 3.20)
 # Project declaration - cpp_library_setup will use this name and detect version from git tags
 project(your-library)
 
-set(CPM_SOURCE_CACHE ${CMAKE_SOURCE_DIR}/.cache/cpm CACHE PATH "CPM cache")
+# Setup cpp-library infrastructure
+if(PROJECT_IS_TOP_LEVEL)
+    set(CPM_SOURCE_CACHE ${CMAKE_SOURCE_DIR}/.cache/cpm CACHE PATH "CPM cache")
+endif()
 include(cmake/CPM.cmake)
 
 # Fetch cpp-library via CPM
@@ -173,7 +176,7 @@ cpp_library_setup(
 ### Documentation Features
 
 - **Doxygen integration** with modern configuration
-- **[email protected].0** theme for beautiful output
+- **[email protected].1** theme for beautiful output
 - **Symbol exclusion** support for implementation details
 - **GitHub Pages deployment** via CI
 - **Custom Doxyfile support** (falls back to template)
@@ -224,7 +227,9 @@ cmake_minimum_required(VERSION 3.20)
 project(enum-ops)
 
 # Setup cpp-library infrastructure
-set(CPM_SOURCE_CACHE ${CMAKE_SOURCE_DIR}/.cache/cpm CACHE PATH "CPM cache" FORCE)
+if(PROJECT_IS_TOP_LEVEL)
+    set(CPM_SOURCE_CACHE ${CMAKE_SOURCE_DIR}/.cache/cpm CACHE PATH "CPM cache")
+endif()
 include(cmake/CPM.cmake)
 
 # Fetch cpp-library via CPM

cmake/cpp-library-docs.cmake

@@ -11,28 +11,29 @@ function(_cpp_library_setup_docs)
     set(multiValueArgs
         DOCS_EXCLUDE_SYMBOLS
     )
-    
+
     cmake_parse_arguments(ARG "" "${oneValueArgs}" "${multiValueArgs}" ${ARGN})
-    
+
     find_package(Doxygen REQUIRED)
     if(NOT DOXYGEN_FOUND)
         message(WARNING "Doxygen not found. Documentation will not be built.")
         return()
     endif()
-    
+
     # Download doxygen-awesome-css theme via CPM
+    # https://github.com/jothepro/doxygen-awesome-css
     CPMAddPackage(
-        URI gh:jothepro/[email protected].0
+        URI gh:jothepro/[email protected].1
         DOWNLOAD_ONLY YES
     )
-    
+
     # Set the CSS directory path
     set(AWESOME_CSS_DIR ${doxygen-awesome-css_SOURCE_DIR})
-    
+
     # Configure Doxyfile from template
     set(DOXYFILE_IN ${CPP_LIBRARY_ROOT}/templates/Doxyfile.in)
     set(DOXYFILE_OUT ${CMAKE_CURRENT_BINARY_DIR}/Doxyfile)
-    
+
     # Set variables for Doxyfile template
     set(PROJECT_NAME "${ARG_NAME}")
     set(PROJECT_BRIEF "${ARG_DESCRIPTION}")
@@ -41,27 +42,27 @@ function(_cpp_library_setup_docs)
     set(OUTPUT_DIR "${CMAKE_CURRENT_BINARY_DIR}")
     set(AWESOME_CSS_PATH "${AWESOME_CSS_DIR}")
     set(EXAMPLES_PATH "${CMAKE_CURRENT_SOURCE_DIR}/examples")
-    
+
     # Convert exclude symbols list to space-separated string
     if(ARG_DOCS_EXCLUDE_SYMBOLS)
         string(REPLACE ";" " " EXCLUDE_SYMBOLS_STR "${ARG_DOCS_EXCLUDE_SYMBOLS}")
         set(EXCLUDE_SYMBOLS "${EXCLUDE_SYMBOLS_STR}")
     else()
         set(EXCLUDE_SYMBOLS "")
     endif()
-    
+
     # Check if we have a custom Doxyfile, otherwise use template
     if(EXISTS "${CMAKE_CURRENT_SOURCE_DIR}/docs/Doxyfile")
         configure_file("${CMAKE_CURRENT_SOURCE_DIR}/docs/Doxyfile" ${DOXYFILE_OUT} @ONLY)
     else()
         configure_file(${DOXYFILE_IN} ${DOXYFILE_OUT} @ONLY)
     endif()
-    
+
     # Add custom target for documentation with proper stderr capture
     if(WIN32)
         # On Windows, use PowerShell to redirect stderr to stdout
         add_custom_target(docs
-            COMMAND PowerShell -Command "& { ${DOXYGEN_EXECUTABLE} ${DOXYFILE_OUT} 2>&1 }"
+            COMMAND PowerShell -Command "& '${DOXYGEN_EXECUTABLE}' '${DOXYFILE_OUT}' 2>&1"
             WORKING_DIRECTORY ${CMAKE_CURRENT_BINARY_DIR}
             COMMENT "Generating API documentation with Doxygen"
             VERBATIM
@@ -75,11 +76,11 @@ function(_cpp_library_setup_docs)
             VERBATIM
         )
     endif()
-    
+
     # Ensure the output directory exists
     file(MAKE_DIRECTORY ${OUTPUT_DIR})
-    
+
     message(STATUS "Documentation target 'docs' configured")
     message(STATUS "Run 'cmake --build . --target docs' to generate documentation")
-    
+
 endfunction()

templates/custom.css

@@ -1,3 +1,3 @@
 /*
-    No fixes needed for [email protected].0
+    No fixes needed for [email protected].1
 */