Merge branch 'branch-23.12' into adding_build_all

README.md

@@ -43,8 +43,8 @@
   - [Contributing to cuGraph](./readme_pages/CONTRIBUTING.md)
 - General
   - [Latest News](./readme_pages/news.md)
-  - [Current list of algorithms](./readme_pages/algorithms.md)
-  - [Blogs and Presentation](./docs/cugraph/source/basics/cugraph_blogs.rst)
+  - [Current list of algorithms](./docs/cugraph/source/graph_support/algorithms.md)
+  - [Blogs and Presentation](./docs/cugraph/source/tutorials/cugraph_blogs.rst)
   - [Performance](./readme_pages/performance/performance.md)
 - Packages
   - [cuGraph Python](./readme_pages/cugraph_python.md)

ci/build_docs.sh

@@ -40,6 +40,13 @@ rapids-mamba-retry install "${PYTHON_CHANNEL}/linux-64/cugraph-dgl-*.tar.bz2"
 export RAPIDS_VERSION_NUMBER="23.12"
 export RAPIDS_DOCS_DIR="$(mktemp -d)"
 
+for PROJECT in libcugraphops libwholegraph; do
+  rapids-logger "Download ${PROJECT} xml_tar"
+  TMP_DIR=$(mktemp -d)
+  export XML_DIR_${PROJECT^^}="$TMP_DIR"
+  aws s3 cp --only-show-errors "s3://rapidsai-docs/${PROJECT}/xml_tar/${RAPIDS_VERSION_NUMBER}/xml.tar.gz" - | tar xzf - -C "${TMP_DIR}"
+done
+
 rapids-logger "Build CPP docs"
 pushd cpp/doxygen
 doxygen Doxyfile

conda/environments/all_cuda-118_arch-x86_64.yaml

@@ -11,6 +11,7 @@ channels:
 - nvidia
 dependencies:
 - aiohttp
+- breathe
 - c-compiler
 - cmake>=3.26.4
 - cuda-version=11.8

conda/environments/all_cuda-120_arch-x86_64.yaml

@@ -11,6 +11,7 @@ channels:
 - nvidia
 dependencies:
 - aiohttp
+- breathe
 - c-compiler
 - cmake>=3.26.4
 - cuda-nvcc

dependencies.yaml

@@ -334,6 +334,7 @@ dependencies:
     common:
       - output_types: [conda]
         packages:
+          - breathe
           - doxygen
           - graphviz
           - ipython

docs/cugraph/source/conf.py

@@ -37,6 +37,7 @@
 # extensions coming with Sphinx (named 'sphinx.ext.*') or your custom
 # ones.
 extensions = [
+    "breathe",
     "sphinx.ext.intersphinx",
     "sphinx.ext.autodoc",
     "sphinx.ext.autosummary",
@@ -205,4 +206,10 @@ def setup(app):
 # The following is used by sphinx.ext.linkcode to provide links to github
 linkcode_resolve = make_linkcode_resolve(
     "https://github.com/rapidsai/cugraph/blob/{revision}/python/{path}#L{lineno}"
-)
+)
+
+breathe_projects = {
+    'libcugraphops': os.environ['XML_DIR_LIBCUGRAPHOPS'],
+    'libwholegraph': os.environ['XML_DIR_LIBWHOLEGRAPH']
+}
+breathe_default_project = "libcugraph"