documentation: Add new theme and pages (#5212)

* change: update jumpstart region_config, update image_uri_configs 06-12-2025 07:18:12 PST

* feat: Add support for MetricDefinitions in ModelTrainer (#5202)

* feat: Add support for MetricDefinitions in ModelTrainer

* style fix

* Update model_trainer.py to generate the doc

* resolve unit test failed

* solve another unit test error

---------

Co-authored-by: Chad Chiang <[email protected]>

* prepare release v2.247.0

* update development version to v2.247.1.dev0

* change: update image_uri_configs 06-19-2025 07:18:34 PST

* prepare release v2.247.1

* update development version to v2.247.2.dev0

* documentation: update theme and add new pages

* Add template files for custom logo and navbar

---------

Co-authored-by: sagemaker-bot <[email protected]>
Co-authored-by: Chad Chiang <[email protected]>
Co-authored-by: Chad Chiang <[email protected]>
Co-authored-by: ci <ci>
Co-authored-by: adishaa <[email protected]>

Author: 5 people

CHANGELOG.md

@@ -1,5 +1,23 @@
 # Changelog
 
+## v2.247.1 (2025-06-23)
+
+### Bug Fixes and Other Changes
+
+ * update image_uri_configs 06-19-2025 07:18:34 PST
+
+## v2.247.0 (2025-06-13)
+
+### Features
+
+ * Add support for MetricDefinitions in ModelTrainer
+
+### Bug Fixes and Other Changes
+
+ * update jumpstart region_config, update image_uri_configs 06-12-2025 07:18:12 PST
+ * Add ignore_patterns in ModelTrainer to ignore specific files/folders
+ * Allow import failure for internal _hashlib module
+
 ## v2.246.0 (2025-06-04)
 
 ### Features

VERSION

@@ -1 +1 @@
-2.246.1.dev0
+2.247.2.dev0

doc/_templates/custom-logo.html

@@ -0,0 +1,6 @@
+<a href="#" class="aws-brand">
+    <img src="https://d1.awsstatic.com/logos/aws-logo-lockups/poweredbyaws/PB_AWS_logo_RGB_stacked_REV_SQ.91cd4af40773cbfbd15577a3c2b8a346fe3e8fa2.png"
+         alt="AWS Logo"
+         class="aws-logo">
+    <span class="aws-title">SageMaker Python SDK</span>
+</a>

doc/_templates/navbar-right.html

@@ -0,0 +1,9 @@
+<div class="navbar" style="display: flex; width: 100%;">
+    <div class="navbar-right-items">
+        <a href="/guide" class="nav-link">Guide</a>
+        <a href="/examples" class="nav-link">Examples</a>
+        <a href="/api" class="nav-link">API Reference</a>
+        <a href="https://github.com/aws/sagemaker-python-sdk" class="nav-link github-button" target="_blank">GitHub</a>
+    </div>
+</div>
+

doc/_templates/search.html

@@ -7,7 +7,7 @@
   :copyright: Copyright 2007-2013 by the Sphinx team, see AUTHORS.
   :license: BSD, see https://github.com/sphinx-doc/sphinx/blob/master/LICENSE for details.
 #}
-{%- extends "layout.html" %}
+{% extends "!layout.html" %}
 {% set title = _('Search') %}
 {% set display_vcs_links = False %}
 {%- block scripts %}

doc/conf.py

@@ -35,12 +35,34 @@
     "sphinx.ext.autosummary",
     "sphinx.ext.napoleon",
     "sphinx.ext.autosectionlabel",
+    "myst_parser",
+    "sphinx_design",
+    "sphinx_tabs.tabs"
 ]
 
 # Add any paths that contain templates here, relative to this directory.
 templates_path = ["_templates"]
 
-source_suffix = ".rst"  # The suffix of source filenames.
+source_suffix = {
+    '.rst': 'restructuredtext',
+    '.md': 'markdown',
+}
+
+# MyST parser settings
+# myst_heading_anchors = 3
+myst_enable_extensions = [
+    "amsmath",
+    "colon_fence",
+    "deflist",
+    "dollarmath",
+    "html_admonition",
+    "html_image",
+    "replacements",
+    "smartquotes",
+    "substitution",
+    "tasklist",
+]
+myst_url_schemes = ("http", "https", "mailto")
 master_doc = "index"  # The master toctree document.
 
 copyright = "%s, Amazon" % datetime.now().year
@@ -58,17 +80,21 @@
 autodoc_default_flags = ["show-inheritance", "members", "undoc-members"]
 autodoc_member_order = "bysource"
 
-html_theme = "sphinx_rtd_theme"
+html_theme = "sphinx_book_theme"
 
 html_theme_options = {
-    "collapse_navigation": True,
-    "sticky_navigation": True,
-    "navigation_depth": 6,
-    "includehidden": True,
-    "titles_only": False,
+    "use_repository_button": False,
+    "use_edit_page_button": False,
+    "use_issues_button": False,
+    "use_download_button": False,
+    "toc_title": "On This Page",
+    "navbar_start": ["custom-logo.html"],
+    "navbar_center": [],
+    "navbar_end": ["navbar-right.html"],
+    "navigation_depth": 2,
+    "collapse_navigation": True
 }
 
-
 html_static_path = ["_static"]
 
 htmlhelp_basename = "%sdoc" % project
@@ -82,10 +108,12 @@
 ]
 
 html_css_files = [
+    "https://cdn.jsdelivr.net/npm/[email protected]/dist/tailwind.min.css",
     "https://cdn.datatables.net/1.10.23/css/jquery.dataTables.min.css",
     "theme_overrides.css",
     "pagination.css",
     "search_accessories.css",
+    "custom.css"
 ]
 
 # Example configuration for intersphinx: refer to the Python standard library.