doc: updates to open source site

Author: ranukund

cmake/Sphinx.cmake

@@ -54,8 +54,9 @@ if (Python_FOUND AND SPHINX_FOUND)
             ${SPHINX_SOURCE_DIR}/_static
         COMMAND ${Python_EXECUTABLE}
             ${CMAKE_CURRENT_BINARY_DIR}/cleanup.py ${SPHINX_SOURCE_DIR}
-        COMMAND ${SPHINX_EXECUTABLE} -b ${SPHINX_GENERATOR}
-            -D release=v${PROJECT_VERSION} -j auto rst ${SPHINX_OUTPUT_DIR}
+        COMMAND ${CMAKE_COMMAND} -E env PROJECT_VERSION=v${PROJECT_VERSION}
+            ${SPHINX_EXECUTABLE} -b ${SPHINX_GENERATOR}
+            -j auto rst ${SPHINX_OUTPUT_DIR}
         COMMAND ${CMAKE_COMMAND} -E touch ${SPHINX_STAMP_FILE}
         WORKING_DIRECTORY ${CMAKE_CURRENT_BINARY_DIR}/reference
         COMMENT "Generating API documentation with Sphinx" VERBATIM)

doc/rst/index.rst

@@ -1,5 +1,5 @@
-oneAPI Deep Neural Network Library Developer Guide and Reference
-=======================================================================
+oneAPI Deep Neural Network Library (oneDNN) Developer Guide and Reference
+=========================================================================
 
 .. toctree::
    :maxdepth: 1

doc/sphinx/_static/favicons.png

@@ -51,9 +51,11 @@ def whereis(binary):
 # -- Project information -----------------------------------------------------
 
 project = 'oneDNN'
-copyright = '2016-2024 Intel Corporation'
+copyright = '2016-2025 Intel Corporation'
 author = ''
 
+release = os.environ.get("PROJECT_VERSION", "unknown")
+
 # -- General configuration ---------------------------------------------------
 
 # Add any Sphinx extension module names here, as strings. They can be
@@ -116,6 +118,8 @@ def whereis(binary):
 # Add any paths that contain templates here, relative to this directory.
 templates_path = ['_templates']
 
+source_suffix = '.rst'
+
 # List of patterns, relative to source directory, that match files and
 # directories to ignore when looking for source files.
 # This pattern also affects html_static_path and html_extra_path.
@@ -135,13 +139,20 @@ def whereis(binary):
 html_static_path = ['_static']
 #html_js_files = [('dnnl.js', {'defer': 'defer'})]
 
+html_logo = '_static/oneAPI-rgb-rev-100.png'
+html_favicon = '_static/favicons.png'
+
 html_theme_options = {
     "repository_url": "https://github.com/oneapi-src/oneDNN",
-    "repository_branch": "master",
+    "repository_branch": "main",
     "use_repository_button": True,
-    "use_download_button": False
+    "use_download_button": True,
+    "path_to_docs": "doc",
+    "use_issues_button": True
 }
 
+html_theme_options["logo"] = {"text": "oneDNN Documentation\n" + release}
+
 mathjax3_config = {
 'tex': {
     'macros': {