add --multiversion option to gen_docs.py and use in doc generation

Author: ndgrigorian

.github/workflows/generate-docs.yml

@@ -75,7 +75,7 @@ jobs:
           source /opt/intel/oneapi/setvars.sh
           wget https://github.com/vovkos/doxyrest/releases/download/doxyrest-2.1.2/doxyrest-2.1.2-linux-amd64.tar.xz
           tar xf doxyrest-2.1.2-linux-amd64.tar.xz
-          python scripts/gen_docs.py --doxyrest-root=`pwd`/doxyrest-2.1.2-linux-amd64 --verbose || exit 1
+          python scripts/gen_docs.py --doxyrest-root=`pwd`/doxyrest-2.1.2-linux-amd64 --verbose --multiversion || exit 1
           python -c "import dpctl; print(dpctl.__version__)" || exit 1
           pushd "$(find _skbuild -name cmake-build)" || exit 1
           cmake --build . --target Sphinx || exit 1

scripts/gen_docs.py

@@ -95,6 +95,12 @@ def parse_args():
         ),
     )
 
+    p.add_argument(
+        "--multiversion",
+        action="store_true",
+        help="Enable multiversion sidebar links in docs (default: False)",
+    )
+
     p.add_argument(
         "--clean",
         action="store_true",
@@ -137,6 +143,9 @@ def main():
         cmake_args += ["-DDPCTL_ENABLE_DOXYREST=ON"]
         cmake_args += [f"-DDoxyrest_DIR={args.doxyrest_root}"]
 
+    if args.multiversion:
+        cmake_args += ["-DDPCTL_USE_MULTIVERSION_TEMPLATE=ON"]
+
     log_cmake_args(cmake_args, "gen_docs")
 
     env = os.environ.copy()