docs(src/assets/): update conda official documentation

Signed-off-by: github-actions[bot] <41898282+github-actions[bot]@users.noreply.github.com>

Author: KemingHe

src/assets/conda/Makefile

@@ -0,0 +1,25 @@
+# Minimal makefile for Sphinx documentation
+
+# You can set these variables from the command line.
+SPHINXOPTS    =
+SPHINXBUILD   = python3 -msphinx
+SPHINXPROJ    = conda
+SOURCEDIR     = source
+BUILDDIR      = _build
+
+# Put it first so that "make" without argument is like "make help".
+help:
+	@$(SPHINXBUILD) -M help "$(SOURCEDIR)" "$(BUILDDIR)" $(SPHINXOPTS) $(O)
+
+livehtml:
+	@AUTOBUILD=1 sphinx-autobuild "$(SOURCEDIR)" "$(BUILDDIR)" $(SPHINXOPTS) --ignore=.git/* --ignore=_build/* $(O)
+
+serve:
+	python3 -m http.server --directory "$(BUILDDIR)/html"
+
+.PHONY: help livehtml serve Makefile
+
+# Catch-all target: route all unknown targets to Sphinx using the new
+# "make mode" option.  $(O) is meant as a shortcut for $(SPHINXOPTS).
+%: Makefile
+	@$(SPHINXBUILD) -M $@ "$(SOURCEDIR)" "$(BUILDDIR)" $(SPHINXOPTS) $(O)

src/assets/conda/_metadata.yml

@@ -0,0 +1,4 @@
+source_repo: conda/conda
+docs_path: docs
+updated_at: 2025-07-16T02:52:06Z
+commit_sha: 85832cc9d76ac9316c6bc8fdac68cf053edfeee6

src/assets/conda/environment.yml

@@ -0,0 +1,34 @@
+name: sphinx
+channels:
+  - conda-forge
+dependencies:
+  - Pillow==10.1.0
+  - Sphinx<9
+  - boltons>=23.0.0
+  - conda-sphinx-theme==0.3.0
+  - frozendict>=2.4.2
+  - linkify-it-py==2.0.2
+  - myst-parser==2.0.0
+  - pluggy==1.3.0
+  - pylint==3.0.2
+  - requests>=2.28.0,<3
+  - ruamel.yaml>=0.11.14,<0.19
+  - sphinx-argparse==0.5.2
+  - sphinx-autoapi==3.0.0
+  - sphinx-autobuild==2021.3.14
+  - sphinx-reredirects==0.1.5
+  - sphinx-sitemap==2.5.1
+  - sphinx-design==0.5.0
+  - sphinxcontrib-applehelp==1.0.7
+  - sphinxcontrib-devhelp==1.0.5
+  - sphinxcontrib-htmlhelp==2.0.4
+  - sphinxcontrib-jsmath==1.0.1
+  - sphinxcontrib-mermaid==0.9.2
+  - sphinxcontrib-programoutput==0.17
+  - sphinxcontrib-qthelp==1.0.6
+  - sphinxcontrib-serializinghtml==1.1.9
+  - tqdm>=4
+  - conda-libmamba-solver>=24.11.0
+  - pip>25
+  - pip:
+      - sphinxcontrib-plantuml==0.21

src/assets/conda/source/_extensions/conda_umls.py

@@ -0,0 +1,140 @@
+#!/usr/bin/env python
+# Copyright (C) 2012 Anaconda, Inc
+# SPDX-License-Identifier: BSD-3-Clause
+import fileinput
+import os
+import shutil
+import sys
+
+import requests
+from pylint.pyreverse.main import Run
+
+here = os.path.dirname(__file__)
+plantuml_jarfile_url = (
+    "https://sourceforge.net/projects/plantuml/files/plantuml.jar/download"
+)
+
+
+# files and folders to ignore during generating the UML files
+ignore = [
+    "_vendor.py",
+    "compat.py",
+    "misc.py",
+    "utils.py",
+    "exports.py",
+    "api.py",
+]
+
+# additional PLantUML directives to add
+extra_puml = "\n".join(
+    [
+        "left to right direction",
+        "skinparam nodesep 5",
+        "skinparam ranksep 5",
+    ]
+)
+
+# some replacement to patch the PlantUML generated by pyreverse
+replacements = (
+    (
+        "set namespaceSeparator none",
+        f"set namespaceSeparator none\n{extra_puml}",
+    ),
+    (
+        'class "" as conda.common.compat.six_with_metaclass.',
+        'class "six_with_metaclass" as conda.common.compat.six_with_metaclass.',
+    ),
+)
+
+
+def post_process(files, output_path):
+    """Replace all items from the replacements list above in the given files."""
+    for file in files:
+        with fileinput.input(
+            files=[os.path.join(output_path, file)], inplace=True
+        ) as open_file:
+            for line in open_file:
+                for old, new in replacements:
+                    line = line.replace(old, new)
+                sys.stdout.write(line)
+
+
+def generate_pumls(app=None, config=None):
+    """
+    Generates PlantUML files for the given packages and writes
+    the files to the components directory in the documentation source.
+    """
+    sys.stdout.write("Generating PlantUML...\n")
+    sys.stdout.flush()
+    # TODO: make this a configurable thing via the docs config
+    packages = ["conda"]
+
+    for package in packages:
+        output_path = os.path.join(here, "..", "dev-guide", "umls")
+        output_format = "puml"
+        files = [
+            f"packages_{package}.{output_format}",
+            f"classes_{package}.{output_format}",
+        ]
+        ignore_list = ",".join(ignore)
+        args = [
+            package,
+            f"--ignore={ignore_list}",
+            f"--output={output_format}",
+            "--colorized",
+            "--max-color-depth=8",
+            f"--project={package}",
+            f"--output-directory={output_path}",
+            "--all-associated",
+            "--all-ancestors",
+        ]
+        # Run pyreverse to create the files first
+        try:
+            Run(args)
+        except SystemExit as err:
+            # ignore sys.exit() call from pyreverse.Run if the exit code is 0
+            if err.code:
+                raise
+        # Then post-process the generated files to fix some things.
+        post_process(files, output_path)
+        sys.stdout.write("Done generating PlantUML files.\n")
+
+
+def download_plantuml(app, config):
+    if os.path.exists(config.plantuml_jarfile_path):
+        sys.stdout.write(
+            f"PlantUML jar file already downloaded. "
+            f"To update run `make clean` or manually "
+            f"delete {config.plantuml_jarfile_path}.\n"
+        )
+    else:
+        parent = os.path.dirname(config.plantuml_jarfile_path)
+        if not os.path.isdir(parent):
+            os.makedirs(parent, exist_ok=True)
+        with requests.get(plantuml_jarfile_url, stream=True) as response:
+            sys.stdout.write(
+                f"Downloading PlantUML jar file to {config.plantuml_jarfile_path}..."
+            )
+            sys.stdout.flush()
+            response.raise_for_status()
+            response.raw.decode_content = True
+            with open(config.plantuml_jarfile_path, "wb") as jarfile:
+                shutil.copyfileobj(response.raw, jarfile)
+                sys.stdout.write("done.\n")
+
+
+def setup(app):
+    if "AUTOBUILD" not in os.environ:
+        app.add_config_value("plantuml_jarfile_path", None, rebuild="")
+        app.connect("config-inited", download_plantuml)
+        app.connect("config-inited", generate_pumls)
+
+    return {
+        "version": "0.1",
+        "parallel_read_safe": False,
+        "parallel_write_safe": False,
+    }
+
+
+if __name__ == "__main__":
+    generate_pumls()

src/assets/conda/source/_static/css/custom.css

@@ -0,0 +1,40 @@
+/** UML **/
+.plantuml {
+    height: 100%;
+    width: 100%;
+}
+
+.plantuml svg text {
+    /*  Make map text un-selectable */
+    -webkit-touch-callout: none;
+    -webkit-user-select: none;
+    -khtml-user-select: none;
+    -moz-user-select: none;
+    -ms-user-select: none;
+    -o-user-select: none;
+    user-select: none;
+    pointer-events: none;
+}
+
+.plantuml svg text::selection {
+    background: none;
+}
+
+/** JS Panel **/
+.jsPanel-ftr span.desc {
+    display: "flex";
+    justify-content: "space-between";
+}
+
+.jsPanel-ftr span.desc {
+    flex-grow: 1;
+}
+
+.jsPanel-ftr span.buttons {
+    display: flex;
+    align-items: center;
+}
+
+#conda-documentation .sd-tab-content {
+    min-height: 9rem;
+}