Allows to have multiple language definitions through conf.py using a language_map dictionary of the type: language_map = { 'en' : { 'exercise_title_text' : 'Exercise', 'solution_title_text' : 'Solution to' }, 'fr' : { 'exercise_title_text' : 'Exercice', 'solution_title_text' : 'Solution de' } }

Author: yguel

sphinx_exercise/__init__.py

@@ -100,13 +100,23 @@ def merge_exercises(
             **env.sphinx_exercise_registry,
             **other.sphinx_exercise_registry,
         }
+        
+def define_texts(app: Sphinx, config: Config) -> None:
+    if config.language is not None and config.language_map is not None:
+        lg = config.language_map[config.language]
+        if "exercise_title_text" in lg:
+            config.exercise_title_text = lg["exercise_title_text"]
+        if "solution_title_text" in lg:
+            config.solution_title_text = lg["solution_title_text"]
 
 
 def init_numfig(app: Sphinx, config: Config) -> None:
     """Initialize numfig"""
+    
+    define_texts(app, config)
 
     config["numfig"] = True
-    numfig_format = {"exercise": config.exercise_title + " %s"}
+    numfig_format = {"exercise": config.exercise_title_text + " %s"}
     # Merge with current sphinx settings
     numfig_format.update(config.numfig_format)
     config.numfig_format = numfig_format
@@ -141,9 +151,12 @@ def doctree_read(app: Sphinx, document: Node) -> None:
             section_name = node.attributes.get("title")
             domain.anonlabels[name] = docname, label
             domain.labels[name] = docname, label, section_name
-
-
+ 
 def setup(app: Sphinx) -> Dict[str, Any]:
+    #Define the extension configuration variables
+    app.add_config_value("exercise_title_text", "Exercise", "env") # The title of the exercise
+    app.add_config_value("solution_title_text", "Solution to", "env") # The title of the solution
+    app.add_config_value("language_map", None, "env") # A map of translated strings
     app.add_config_value("hide_solutions", False, "env")
 
     app.connect("config-inited", init_numfig)  # event order - 1
@@ -210,10 +223,6 @@ def setup(app: Sphinx) -> Dict[str, Any]:
     app.add_post_transform(ResolveLinkTextToSolutions)
 
     app.add_css_file("exercise.css")
-    
-    #Define the extension configuration variables
-    app.add_config_value("exercise_title", "Exercise", "env") # The title of the exercise
-    app.add_config_value("solution_title", "Solution to", "env") # The title of the solution
 
     return {
         "version": "builtin",

sphinx_exercise/directive.py

@@ -88,7 +88,8 @@ class : str,
     }
 
     def run(self) -> List[Node]:
-        self.defaults = {"title_text": self.env.config.exercise_title}
+        logger.debug("Running ExerciseDirective: exercise_title_text: " + self.env.config.exercise_title_text)
+        self.defaults = {"title_text": self.env.config.exercise_title_text}
         self.serial_number = self.env.new_serialno()
 
         # Initialise Registry (if needed)
@@ -153,7 +154,6 @@ def run(self) -> List[Node]:
         node["type"] = self.name
         node["hidden"] = True if "hidden" in self.options else False
         node["serial_number"] = self.serial_number
-        node["node_type"] = "exercise"
         node.document = self.state.document
 
         self.add_name(node)
@@ -217,7 +217,8 @@ class : str,
     solution_node = solution_node
 
     def run(self) -> List[Node]:
-        self.defaults = {"title_text": self.env.config.solution_title}
+        logger.debug("Running SolutionDirective: solution_title_text: " + self.env.config.solution_title_text)
+        self.defaults = {"title_text": self.env.config.solution_title_text}
         target_label = self.arguments[0]
         self.serial_number = self.env.new_serialno()
 
@@ -271,7 +272,6 @@ def run(self) -> List[Node]:
         node["type"] = self.name
         node["hidden"] = True if "hidden" in self.options else False
         node["serial_number"] = self.serial_number
-        node["node_type"] = "solution"
         node.document = self.state.document
 
         self.add_name(node)