docs: Revise Examples Gallery and update navigation structure

- Integrated the Examples Gallery page into the Gallery Overview for streamlined access.
- Updated the navigation links in the main index to point directly to the new gallery structure.
- Enhanced the table of contents for the gallery to improve user navigation and visibility of categories.

Author: wonjun-lab

docs/conf.py

@@ -82,6 +82,52 @@
 myst_heading_anchors = 3
 
 
+_GALLERY_TOC_OLD = """.. toctree::
+   :hidden:
+   :includehidden:
+
+
+   /gallery/01_basic_plots/index.rst
+   /gallery/02_statistical_plots/index.rst
+   /gallery/03_bar_charts/index.rst
+   /gallery/04_scientific_plots/index.rst
+   /gallery/05_time_series/index.rst
+   /gallery/06_specialized_plots/index.rst
+   /gallery/07_layout_styling/index.rst
+   /gallery/08_colors_images/index.rst
+"""
+
+_GALLERY_TOC_NEW = """.. toctree::
+   :maxdepth: 1
+   :caption: Categories
+
+   Basic Plots <gallery/01_basic_plots/index>
+   Statistical Plots <gallery/02_statistical_plots/index>
+   Bar Charts <gallery/03_bar_charts/index>
+   Scientific Plots <gallery/04_scientific_plots/index>
+   Time Series <gallery/05_time_series/index>
+   Specialized Plots <gallery/06_specialized_plots/index>
+   Layout & Styling <gallery/07_layout_styling/index>
+   Colors & Images <gallery/08_colors_images/index>
+"""
+
+
+def _patch_gallery_toc(_app, docname, source):
+    """Ensure sphinx-gallery output exposes the category toctree in nav."""
+    if docname != "gallery/index":
+        return
+
+    current = source[0]
+    if _GALLERY_TOC_NEW in current:
+        return
+
+    if _GALLERY_TOC_OLD in current:
+        source[0] = current.replace(_GALLERY_TOC_OLD, _GALLERY_TOC_NEW)
+    else:
+        # Fall back to appending so nav still appears if template changes.
+        source[0] = f"{current.strip()}\n\n{_GALLERY_TOC_NEW}"
+
+
 def _generate_gallery_assets(_app):
     """Bake high-res color system images during the build."""
     from generate_gallery import build_gallery_assets
@@ -91,4 +137,5 @@ def _generate_gallery_assets(_app):
 
 def setup(app):
     app.connect("builder-inited", _generate_gallery_assets)
+    app.connect("source-read", _patch_gallery_toc)
     return {"parallel_read_safe": True}

docs/examples_gallery.md

@@ -1,32 +1,15 @@
-# Examples Gallery
+---
+orphan: true
+---
 
-Browse every category’s thumbnails on a single page. Use the left sidebar to jump
-to a section; the page will scroll to that spot. To view all examples on a separate page,
-use the {doc}`gallery/index` link.
+# Examples Gallery
 
-```{eval-rst}
-.. include:: gallery/index.rst
-   :start-line: 22
-   :end-before: .. toctree::
-```
+이 페이지는 이제 `Gallery Overview <gallery/index>`_ 페이지로 통합되었습니다. 즐겨찾기나 링크를 업데이트해 주세요.
 
 ```{eval-rst}
 .. only:: html
 
-    .. container:: sphx-glr-footer sphx-glr-footer-gallery
-
-        .. container:: sphx-glr-download sphx-glr-download-python
-
-            :download:`Download all examples in Python source code: gallery_python.zip </gallery/gallery_python.zip>`
-
-        .. container:: sphx-glr-download sphx-glr-download-jupyter
-
-            :download:`Download all examples in Jupyter notebooks: gallery_jupyter.zip </gallery/gallery_jupyter.zip>`
-
-
-.. only:: html
-
-    .. rst-class:: sphx-glr-signature
+   .. raw:: html
 
-        `Gallery generated by Sphinx-Gallery <https://sphinx-gallery.github.io>`_
+      <meta http-equiv="refresh" content="0; url=gallery/index.html">
 ```

docs/index.md

@@ -16,6 +16,6 @@ opinionated styles, curated color libraries, and layout utilities.
 Installation <installation>
 Usage Guide <DARTWORK_MPL_USAGE_GUIDE>
 Color System <COLOR_SYSTEM>
-Examples Gallery <examples_gallery>
+Examples Gallery <gallery/index>
 API Reference <api/index>
 ```