feat!: Define revealjs_use_index to set False as default

Inludes these
- implementation
- test cases
- document
- changelog

BREAKING CHANGE: Default value is not compatible for 1.x
Refs: #104

CHANGES-2.x.rst

@@ -15,6 +15,10 @@ Added Features
 * Config ``reveajs_notes_from_comments`` toggle if it creates speaker-view content from comment-block
 
   * BREAKING CHANGE: Default value is False. You must set ``True`` explicitly to use as same as ver 1.x
+* Config ``reveajs_use_index`` toggle if it creates ``genindex.html``
+
+  * BREAKING CHANGE: Default value is False. You must set ``True`` explicitly to use as same as ver 1.x
+
 
 Deleted feaures
 ---------------

doc/configurations.rst

@@ -36,6 +36,13 @@ Basic configurations
 
    If you want to customize presentation by CSS, write external css and use it.
 
+.. confval:: revealjs_use_index
+
+   :Type: ``bool``
+   :Default: ``False``
+
+   Flag that does builder generate ``genindex.html`` (same as :confval:`sphinx:html_use_index` ).
+
 Style Configurations
 ====================
 

doc/upgrade/2.x.rst

@@ -114,6 +114,12 @@ You must do one of these.
 * Copy needy values of ``html_js_files`` to ``revealjs_js_files``
 * Sync ``html_js_files`` to ``revealjs_js_files`` (ex: ``revealjs_js_files = html_js_files``)
 
+revealjs_use_index
+------------------
+
+|THIS| does not generate ``genindex.html`` (list of in vals) on default.
+If you want ``genindex.html`` for Reveal.js builder, you muse set ``True``.
+
 Directives
 ==========
 

sphinx_revealjs/__init__.py

@@ -93,6 +93,7 @@ def setup(app: Sphinx):
     app.add_directive("revealjs-fragments", RevealjsFragments)
     app.add_directive("revealjs-code-block", RevealjsCodeBlock)
     app.add_config_value("revealjs_use_section_ids", False, True)
+    app.add_config_value("revealjs_use_index", False, "env")
     app.add_config_value("revealjs_static_path", [], True)
     app.add_config_value("revealjs_style_theme", "black", True)
     app.add_config_value("revealjs_js_files", [], True)

sphinx_revealjs/builders.py

@@ -52,6 +52,7 @@ def init(self):  # noqa
         # Hand over builder configs to html builder.
         setattr(self.config, "html_static_path", self.config.revealjs_static_path)
         super().init()
+        self.use_index = self.get_builder_config("use_index", "revealjs")
 
     def init_css_files(self) -> None:  # noqa
         self.add_css_file(self.revealjs_context.engine.css_path)

tests/test_configurations/test_generatings.py

@@ -0,0 +1,11 @@
+"""Test cases for generating giles."""
+import pytest
+from sphinx.testing.util import SphinxTestApp
+
+
+@pytest.mark.sphinx(
+    "revealjs", testroot="default", confoverrides={"revealjs_use_index": True}
+)
+def test_generating_genindex(app: SphinxTestApp, status, warning):  # noqa
+    app.build()
+    assert (app.outdir / "genindex.html").exists()

tests/test_generatings.py

@@ -0,0 +1,9 @@
+"""Test cases for generating giles."""
+import pytest
+from sphinx.testing.util import SphinxTestApp
+
+
+@pytest.mark.sphinx("revealjs", testroot="default")
+def test_not_generate_genindex(app: SphinxTestApp, status, warning):  # noqa
+    app.build()
+    assert not (app.outdir / "genindex.html").exists()