chore(docs): document config options

docs/source/conf.py

@@ -30,6 +30,7 @@
     # Additional
     "nbsphinx",
     "myst_parser",
+    "sphinxcontrib.programoutput",
     "sphinxext.opengraph",
     "sphinx_click",
     "sphinx_copybutton",

docs/source/reference/cli.md

@@ -8,3 +8,34 @@ This page contains an exhaustive list of all the commands available with `manim-
     :prog: manim-slides
     :nested: full
 ```
+
+# Config Options
+
+Each converter has its own configuration options, which are listed below.
+
+::::{dropdown} HTML
+:open:
+```{program-output} manim-slides convert --to=html --show-config
+```
+::::
+
+::::{dropdown} Zip
+:open:
+:::{note}
+The Zip converter inherits from the HTML converter.
+:::
+```{program-output} manim-slides convert --to=zip --show-config
+```
+::::
+
+::::{dropdown} PDF
+:open:
+```{program-output} manim-slides convert --to=pdf --show-config
+```
+::::
+
+::::{dropdown} HTML
+:open:
+```{program-output} manim-slides convert --to=pdf --show-config
+```
+::::

manim_slides/convert.py

@@ -884,7 +884,7 @@ def callback(ctx: Context, param: Parameter, value: bool) -> None:
 @click.command()
 @click.argument("scenes", nargs=-1)
 @folder_path_option
-@click.argument("dest", type=click.Path(dir_okay=False, path_type=Path), is_eager=True)
+@click.argument("dest", type=click.Path(dir_okay=False, path_type=Path))
 @click.option(
     "--to",
     type=click.Choice(["auto", "html", "pdf", "pptx", "zip"], case_sensitive=False),

pyproject.toml

@@ -50,6 +50,7 @@ docs = [
   "nbsphinx>=0.9.2",
   "pandoc>=2.3",
   "sphinx>=7.0.1",
+  "sphinxcontrib-programoutput>=0.18",
   "sphinx-click>=4.4.0",
   "sphinx-copybutton>=0.5.1",
   "sphinxext-opengraph>=0.7.5",