Doc: insert Unicode zero-width space character in :choices: output, t…

…o be nice with browsers line-break insertion logic Fixes OSGeo#10778
OSGeo-jp · Sep 12, 2024 · a63ef82 · a63ef82
1 parent 63ed1ea
commit a63ef82
Showing 1 changed file with 8 additions and 1 deletion.
diff --git a/doc/source/_extensions/configoptions.py b/doc/source/_extensions/configoptions.py
@@ -104,7 +104,14 @@ def render(self, app):
         elif len(self.choices) == 1:
             text += f"={self.choices[0]}: "
         else:
-            text += f'=[{"/".join(self.choices)}]: '
+            # Insert Unicode zero-width space around separating forward slash,
+            # so that all browsers produce line breaks.
+            # Cf https://github.com/OSGeo/gdal/issues/10778
+            zero_width_space = "\u200b"
+            concatenated_choices = f"{zero_width_space}/{zero_width_space}".join(
+                self.choices
+            )
+            text += f"=[{concatenated_choices}]: "
 
         para += nodes.strong(text, text)