chore(lib): moved Sphinx directive from docs to sphinxext

jeertmans · jeertmans · commit 880cba3064b9 · 2025-04-18T18:55:47.000+02:00
diff --git a/CHANGELOG.md b/CHANGELOG.md
@@ -18,6 +18,10 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
   when using one of those extras, but as they were not part of the public API,
   we do not consider this to be a **breaking change**.
   [#542](https://github.com/jeertmans/manim-slides/pull/542)
+- Moved `manim_slides.docs.manim_slides_directive` to `manim_slides.sphinxext.manim_slides_directive`.
+  This is a **breaking change** because documentation configs have
+  to be updated.
+  [#242](https://github.com/jeertmans/manim-slides/pull/242)
 
 (v5.5.1)=
 ## [v5.5.1](https://github.com/jeertmans/manim-slides/compare/v5.5.0...v5.5.1)
diff --git a/docs/source/conf.py b/docs/source/conf.py
@@ -37,7 +37,7 @@
     "sphinx_copybutton",
     "sphinx_design",
     # Custom
-    "manim_slides.docs.manim_slides_directive",
+    "manim_slides.sphinxext.manim_slides_directive",
 ]
 
 autodoc_typehints = "both"
diff --git a/docs/source/reference/sphinx_extension.md b/docs/source/reference/sphinx_extension.md
@@ -1,6 +1,6 @@
 # Manim Slides' Sphinx directive
 
 ```{eval-rst}
-.. automodule:: manim_slides.docs.manim_slides_directive
+.. automodule:: manim_slides.sphinxext.manim_slides_directive
    :members: ManimSlidesDirective
 ```
diff --git a/manim_slides/ipython/ipython_magic.py b/manim_slides/ipython/ipython_magic.py
@@ -116,7 +116,7 @@ def construct(self):
             file) will be moved relative to the video locations. Use-cases include building
             documentation with Sphinx and JupyterBook. See also the
             :mod:`Manim Slides directive for Sphinx
-            <manim_slides.docs.manim_slides_directive>`.
+            <manim_slides.sphinxext.manim_slides_directive>`.
 
         Examples
         --------
diff --git a/manim_slides/sphinxext/__init__.py b/manim_slides/sphinxext/__init__.py
diff --git a/manim_slides/sphinxext/manim_slides_directive.py b/manim_slides/sphinxext/manim_slides_directive.py
@@ -40,7 +40,7 @@
 
     extensions = [
         # ...
-        "manim_slides.docs.manim_slides_directive",
+        "manim_slides.sphinxext.manim_slides_directive",
     ]
 
 Its basic usage that allows processing **inline content**

Original file line number	Diff line number	Diff line change
`@@ -37,7 +37,7 @@`
`37`	`37`	`"sphinx_copybutton",`
`38`	`38`	`"sphinx_design",`
`39`	`39`	`# Custom`
`40`		`- "manim_slides.docs.manim_slides_directive",`
	`40`	`+ "manim_slides.sphinxext.manim_slides_directive",`
`41`	`41`	`]`
`42`	`42`
`43`	`43`	`autodoc_typehints = "both"`
Original file line number	Diff line number	Diff line change
`@@ -40,7 +40,7 @@`
`40`	`40`
`41`	`41`	`extensions = [`
`42`	`42`	`# ...`
`43`		`- "manim_slides.docs.manim_slides_directive",`
	`43`	`+ "manim_slides.sphinxext.manim_slides_directive",`
`44`	`44`	`]`
`45`	`45`
`46`	`46`	`Its basic usage that allows processing inline content`