Rename config option to exercise_style for clarity

Changed configuration option name from 'style_solution_after_exercise'
to 'exercise_style' to make it clearer that this belongs to sphinx-exercise.

Changes:
- Config option: exercise_style = 'solution_follow_exercise' (was: style_solution_after_exercise = True)
- Default value: '' (empty string) instead of False
- More descriptive and namespaced for clarity in config files

This makes it clearer in configuration files that this is a
sphinx-exercise specific setting, especially when used alongside
other sphinx extensions like sphinx-proof.

Updated:
- sphinx_exercise/__init__.py
- sphinx_exercise/post_transforms.py
- tests/test_style_solution_after_exercise.py
- docs/source/syntax.md

All 113 tests pass.

Author: mmcky

docs/source/syntax.md

@@ -411,15 +411,15 @@ sphinx:
 
 ### Solution Title Styling
 
-By default, solution titles include a hyperlink to the corresponding exercise. This behavior can be modified using the `style_solution_after_exercise` configuration option.
+By default, solution titles include a hyperlink to the corresponding exercise. This behavior can be modified using the `exercise_style` configuration option.
 
-When solutions follow exercises directly in your content (common in lecture notes), you may want to remove the hyperlink to avoid confusion when using the `dropdown` class. Set `style_solution_after_exercise` to `True` to display only text without hyperlinks in solution titles.
+When solutions follow exercises directly in your content (common in lecture notes), you may want to remove the hyperlink to avoid confusion when using the `dropdown` class. Set `exercise_style` to `"solution_follow_exercise"` to display only text without hyperlinks in solution titles.
 
 For Sphinx projects, add the configuration key in the `conf.py` file:
 
 ```python
 # conf.py
-style_solution_after_exercise = True
+exercise_style = "solution_follow_exercise"
 ```
 
 For Jupyter Book projects, set the configuration key in `_config.yml`:
@@ -428,11 +428,11 @@ For Jupyter Book projects, set the configuration key in `_config.yml`:
 ...
 sphinx:
   config:
-    style_solution_after_exercise: True
+    exercise_style: "solution_follow_exercise"
 ...
 ```
 
-When `style_solution_after_exercise` is `True`, the solution title will display plain text like "Solution to Exercise 1 (Title)" instead of a hyperlink. When `False` (default), the exercise reference in the solution title remains clickable.
+When `exercise_style` is set to `"solution_follow_exercise"`, the solution title will display plain text like "Solution to Exercise 1 (Title)" instead of a hyperlink. When empty `""` (default), the exercise reference in the solution title remains clickable.
 
 ## Custom CSS or JavaScript
 

sphinx_exercise/__init__.py

@@ -147,7 +147,7 @@ def doctree_read(app: Sphinx, document: Node) -> None:
 
 def setup(app: Sphinx) -> Dict[str, Any]:
     app.add_config_value("hide_solutions", False, "env")
-    app.add_config_value("style_solution_after_exercise", False, "env")
+    app.add_config_value("exercise_style", "", "env")
 
     app.connect("config-inited", init_numfig)  # event order - 1
     app.connect("env-purge-doc", purge_exercises)  # event order - 5 per file

sphinx_exercise/post_transforms.py

@@ -148,8 +148,8 @@ def resolve_solution_title(app, node, exercise_node):
         # New Title Node
         updated_title = docutil_nodes.title()
 
-        # Check if style_solution_after_exercise is enabled
-        if app.config.style_solution_after_exercise:
+        # Check if exercise_style is set to "solution_follow_exercise"
+        if app.config.exercise_style == "solution_follow_exercise":
             # Don't create hyperlink - just add plain text and nodes
             updated_title += docutil_nodes.Text(entry_title_text)
             updated_title += docutil_nodes.Text(updated_title_text)

tests/test_style_solution_after_exercise.py

@@ -11,10 +11,12 @@
 
 
 @pytest.mark.sphinx(
-    "html", testroot="mybook", confoverrides={"style_solution_after_exercise": True}
+    "html",
+    testroot="mybook",
+    confoverrides={"exercise_style": "solution_follow_exercise"},
 )
 def test_solution_no_link(app):
-    """Test solution directive with style_solution_after_exercise=True removes hyperlink."""
+    """Test solution directive with exercise_style='solution_follow_exercise' removes hyperlink."""
     app.build()
     path_solution_directive = app.outdir / "solution" / "_linked_enum.html"
     assert path_solution_directive.exists()
@@ -27,23 +29,21 @@ def test_solution_no_link(app):
     sol = soup.select("div.solution")[0]
     title = sol.select("p.admonition-title")[0]
 
-    # Check that there is NO hyperlink in the title when style_solution_after_exercise=True
+    # Check that there is NO hyperlink in the title when exercise_style='solution_follow_exercise'
     links = title.find_all("a")
     assert (
         len(links) == 0
-    ), "Solution title should not contain hyperlink when style_solution_after_exercise=True"
+    ), "Solution title should not contain hyperlink when exercise_style='solution_follow_exercise'"
 
     # Check that the title text still contains the exercise reference
     title_text = title.get_text()
     assert "Exercise" in title_text
     assert "This is a title" in title_text
 
 
-@pytest.mark.sphinx(
-    "html", testroot="mybook", confoverrides={"style_solution_after_exercise": False}
-)
+@pytest.mark.sphinx("html", testroot="mybook", confoverrides={"exercise_style": ""})
 def test_solution_with_link(app):
-    """Test solution directive with style_solution_after_exercise=False keeps hyperlink."""
+    """Test solution directive with exercise_style='' (default) keeps hyperlink."""
     app.build()
     path_solution_directive = app.outdir / "solution" / "_linked_enum.html"
     assert path_solution_directive.exists()
@@ -56,11 +56,11 @@ def test_solution_with_link(app):
     sol = soup.select("div.solution")[0]
     title = sol.select("p.admonition-title")[0]
 
-    # Check that there IS a hyperlink in the title when style_solution_after_exercise=False (default)
+    # Check that there IS a hyperlink in the title when exercise_style='' (default)
     links = title.find_all("a")
     assert (
         len(links) == 1
-    ), "Solution title should contain hyperlink when style_solution_after_exercise=False"
+    ), "Solution title should contain hyperlink when exercise_style='' (default)"
 
     # Check that the link points to the exercise
     link = links[0]
@@ -69,10 +69,12 @@ def test_solution_with_link(app):
 
 
 @pytest.mark.sphinx(
-    "html", testroot="mybook", confoverrides={"style_solution_after_exercise": True}
+    "html",
+    testroot="mybook",
+    confoverrides={"exercise_style": "solution_follow_exercise"},
 )
 def test_solution_no_link_unenum(app):
-    """Test unnumbered solution directive with style_solution_after_exercise=True removes hyperlink."""
+    """Test unnumbered solution directive with exercise_style='solution_follow_exercise' removes hyperlink."""
     app.build()
     path_solution_directive = app.outdir / "solution" / "_linked_unenum_title.html"
     assert path_solution_directive.exists()
@@ -89,7 +91,7 @@ def test_solution_no_link_unenum(app):
     links = title.find_all("a")
     assert (
         len(links) == 0
-    ), "Solution title should not contain hyperlink when style_solution_after_exercise=True"
+    ), "Solution title should not contain hyperlink when exercise_style='solution_follow_exercise'"
 
     # Check that the title text still contains the exercise reference
     title_text = title.get_text()