mirror of
https://github.com/ROCm/ROCm.git
synced 2026-02-21 03:00:39 -05:00
267eda26ea
update toc add images update formatting and wording formatting update formatting update conf.py update formatting update docker img tweak formatting Fix stuff fix mock-data/data-path add specific commit hash to checkout update docker pull tag fix docker run cmd and examples path fix docker cmd
122 lines
4.4 KiB
Python
122 lines
4.4 KiB
Python
# Configuration file for the Sphinx documentation builder.
|
|
#
|
|
# This file only contains a selection of the most common options. For a full
|
|
# list see the documentation:
|
|
# https://www.sphinx-doc.org/en/master/usage/configuration.html
|
|
|
|
import os
|
|
import shutil
|
|
|
|
shutil.copy2("../RELEASE.md", "./about/release-notes.md")
|
|
|
|
os.system("mkdir -p ../_readthedocs/html/downloads")
|
|
os.system("cp compatibility/compatibility-matrix-historical-6.0.csv ../_readthedocs/html/downloads/compatibility-matrix-historical-6.0.csv")
|
|
|
|
latex_engine = "xelatex"
|
|
latex_elements = {
|
|
"fontpkg": r"""
|
|
\usepackage{tgtermes}
|
|
\usepackage{tgheros}
|
|
\renewcommand\ttdefault{txtt}
|
|
"""
|
|
}
|
|
|
|
html_baseurl = os.environ.get("READTHEDOCS_CANONICAL_URL", "rocm.docs.amd.com")
|
|
html_context = {}
|
|
if os.environ.get("READTHEDOCS", "") == "True":
|
|
html_context["READTHEDOCS"] = True
|
|
|
|
# configurations for PDF output by Read the Docs
|
|
project = "ROCm Documentation"
|
|
author = "Advanced Micro Devices, Inc."
|
|
copyright = "Copyright (c) 2024 Advanced Micro Devices, Inc. All rights reserved."
|
|
version = "6.3.0"
|
|
release = "6.3.0"
|
|
setting_all_article_info = True
|
|
all_article_info_os = ["linux", "windows"]
|
|
all_article_info_author = ""
|
|
|
|
# pages with specific settings
|
|
article_pages = [
|
|
{"file": "about/release-notes", "os": ["linux", "windows"], "date": "2024-12-03"},
|
|
{"file": "how-to/deep-learning-rocm", "os": ["linux"]},
|
|
{"file": "how-to/rocm-for-ai/index", "os": ["linux"]},
|
|
{"file": "how-to/rocm-for-ai/install", "os": ["linux"]},
|
|
{"file": "how-to/rocm-for-ai/train-a-model", "os": ["linux"]},
|
|
{"file": "how-to/rocm-for-ai/accelerate-training", "os": ["linux"]},
|
|
{"file": "how-to/rocm-for-ai/deploy-your-model", "os": ["linux"]},
|
|
{"file": "how-to/rocm-for-ai/hugging-face-models", "os": ["linux"]},
|
|
{"file": "how-to/rocm-for-hpc/index", "os": ["linux"]},
|
|
{"file": "how-to/llm-fine-tuning-optimization/index", "os": ["linux"]},
|
|
{"file": "how-to/llm-fine-tuning-optimization/overview", "os": ["linux"]},
|
|
{
|
|
"file": "how-to/llm-fine-tuning-optimization/fine-tuning-and-inference",
|
|
"os": ["linux"],
|
|
},
|
|
{
|
|
"file": "how-to/llm-fine-tuning-optimization/single-gpu-fine-tuning-and-inference",
|
|
"os": ["linux"],
|
|
},
|
|
{
|
|
"file": "how-to/llm-fine-tuning-optimization/multi-gpu-fine-tuning-and-inference",
|
|
"os": ["linux"],
|
|
},
|
|
{
|
|
"file": "how-to/llm-fine-tuning-optimization/llm-inference-frameworks",
|
|
"os": ["linux"],
|
|
},
|
|
{
|
|
"file": "how-to/llm-fine-tuning-optimization/model-acceleration-libraries",
|
|
"os": ["linux"],
|
|
},
|
|
{"file": "how-to/llm-fine-tuning-optimization/model-quantization", "os": ["linux"]},
|
|
{
|
|
"file": "how-to/llm-fine-tuning-optimization/optimizing-with-composable-kernel",
|
|
"os": ["linux"],
|
|
},
|
|
{
|
|
"file": "how-to/llm-fine-tuning-optimization/optimizing-triton-kernel",
|
|
"os": ["linux"],
|
|
},
|
|
{
|
|
"file": "how-to/llm-fine-tuning-optimization/profiling-and-debugging",
|
|
"os": ["linux"],
|
|
},
|
|
{"file": "how-to/performance-validation/mi300x/vllm-benchmark", "os": ["linux"]},
|
|
{"file": "how-to/system-optimization/index", "os": ["linux"]},
|
|
{"file": "how-to/system-optimization/mi300x", "os": ["linux"]},
|
|
{"file": "how-to/system-optimization/mi200", "os": ["linux"]},
|
|
{"file": "how-to/system-optimization/mi100", "os": ["linux"]},
|
|
{"file": "how-to/system-optimization/w6000-v620", "os": ["linux"]},
|
|
{"file": "how-to/tuning-guides/mi300x/index", "os": ["linux"]},
|
|
{"file": "how-to/tuning-guides/mi300x/system", "os": ["linux"]},
|
|
{"file": "how-to/tuning-guides/mi300x/workload", "os": ["linux"]},
|
|
{"file": "how-to/system-debugging", "os": ["linux"]},
|
|
{"file": "how-to/gpu-enabled-mpi", "os": ["linux"]},
|
|
]
|
|
|
|
external_toc_path = "./sphinx/_toc.yml"
|
|
|
|
extensions = ["rocm_docs", "sphinx_reredirects", "sphinx_sitemap"]
|
|
|
|
external_projects_current_project = "rocm"
|
|
|
|
html_baseurl = os.environ.get("READTHEDOCS_CANONICAL_URL", "https://rocm-stg.amd.com/")
|
|
html_context = {}
|
|
if os.environ.get("READTHEDOCS", "") == "True":
|
|
html_context["READTHEDOCS"] = True
|
|
|
|
html_theme = "rocm_docs_theme"
|
|
html_theme_options = {"flavor": "rocm-docs-home"}
|
|
|
|
html_static_path = ["sphinx/static/css"]
|
|
html_css_files = ["rocm_custom.css", "rocm_rn.css"]
|
|
|
|
html_title = "ROCm Documentation"
|
|
|
|
html_theme_options = {"link_main_doc": False}
|
|
|
|
redirects = {"reference/openmp/openmp": "../../about/compatibility/openmp.html"}
|
|
|
|
numfig = False
|