Updated look and feel for Doxygen-generated documentation.

Author: WardF

CMakeLists.txt

@@ -65,6 +65,8 @@ ENDIF()
 # End BUILDNAME customization.
 ###
 
+set(abs_top_builddir "${CMAKE_CURRENT_BINARY_DIR}")
+set(abs_top_srcdir "${CMAKE_CURRENT_SOURCE_DIR}")
 
 # Determine if DOXYGEN and DOT are available. These will be used
 # when building the documentation.

RELEASE_NOTES.md

@@ -6,7 +6,7 @@ Release Notes {#nf_release_notes}
 This file contains a high-level description of this package's evolution.
 Entries are in reverse chronological order (most recent first).
 
-## 4.6.2 - March 25, 2025
+## 4.6.2 - March 26, 2025
 
 ### Requirements
 

docs/Doxyfile.developer

@@ -1122,7 +1122,8 @@ HTML_STYLESHEET        =
 # list). For an example see the documentation.
 # This tag requires that the tag GENERATE_HTML is set to YES.
 
-HTML_EXTRA_STYLESHEET  =
+HTML_EXTRA_STYLESHEET  = ./docs/doxygen-awesome-css/doxygen-awesome.css
+HTML_COLORSTYLE        = LIGHT
 
 # The HTML_EXTRA_FILES tag can be used to specify one or more extra images or
 # other source files which should be copied to the HTML output directory. Note
@@ -1132,7 +1133,7 @@ HTML_EXTRA_STYLESHEET  =
 # files will be copied as-is; there are no commands or markers available.
 # This tag requires that the tag GENERATE_HTML is set to YES.
 
-HTML_EXTRA_FILES       =
+HTML_EXTRA_FILES       = ./docs/doxygen-awesome-css/doxygen-awesome-darkmode-toggle.js
 
 # The HTML_COLORSTYLE_HUE tag controls the color of the HTML output. Doxygen
 # will adjust the colors in the style sheet and background images according to

docs/Doxyfile.in

@@ -1057,7 +1057,7 @@ HTML_FILE_EXTENSION    = .html
 # of the possible markers and block names see the documentation.
 # This tag requires that the tag GENERATE_HTML is set to YES.
 
-HTML_HEADER            =
+HTML_HEADER            = @abs_top_builddir@/docs/header.html
 
 # The HTML_FOOTER tag can be used to specify a user-defined HTML footer for each
 # generated HTML page. If the tag is left blank doxygen will generate a standard
@@ -1090,7 +1090,8 @@ HTML_STYLESHEET        =
 # see the documentation.
 # This tag requires that the tag GENERATE_HTML is set to YES.
 
-HTML_EXTRA_STYLESHEET  =
+HTML_EXTRA_STYLESHEET  = @abs_top_srcdir@/docs/doxygen-awesome-css/doxygen-awesome.css
+HTML_COLORSTYLE        = LIGHT
 
 # The HTML_EXTRA_FILES tag can be used to specify one or more extra images or
 # other source files which should be copied to the HTML output directory. Note
@@ -1993,13 +1994,13 @@ SKIP_FUNCTION_MACROS   = YES
 # the path). If a tag file is not located in the directory in which doxygen is
 # run, you must also specify the path to the tagfile here.
 
-TAGFILES               =
+TAGFILES               = https://docs.unidata.ucar.edu/netcdf-c/current/netcdf-c.tag
 
 # When a file name is specified after GENERATE_TAGFILE, doxygen will create a
 # tag file that is based on the input files it reads. See section "Linking to
 # external documentation" for more information about the usage of tag files.
 
-GENERATE_TAGFILE       =
+GENERATE_TAGFILE       = html/netcdf-fortran.tag
 
 # If the ALLEXTERNALS tag is set to YES all external class will be listed in the
 # class index. If set to NO only the inherited external classes will be listed.

docs/Makefile.am

@@ -53,7 +53,7 @@ Doxyfile.in netcdf-f77.md netcdf-f90-sec1-usage.md			\
 netcdf-f90-sec3-groups.md netcdf-f90-sec5-user_defined_types.md		\
 netcdf-f90-sec7-attributes.md netcdf-f90.md				\
 netcdf-f90-sec2-datasets.md netcdf-f90-sec4-dimensions.md		\
-netcdf-f90-sec6-variables.md
+netcdf-f90-sec6-variables.md doxygen-awesome-css header.html
 
 CLEANFILES = doxyfile.stamp