fix: update conf.py to fix error in preview

shenxianpeng · shenxianpeng · commit 7a0fce7082ae · 2025-10-14T23:37:42.000+03:00
diff --git a/docs/conf.py b/docs/conf.py
@@ -125,14 +125,21 @@ def setup(app: Sphinx):
 
     CLI_OPT_NAME = re.compile(r"^\s*(\-\w)(?:\s+[A-Z_\[\]]*)?(?:,\s+(\-\-[a-z\-]+))?")
     in_options_section = False
+    skip_lines = set()  # Track lines we've already processed
+
+    lines = result.stdout.splitlines()
+
+    for i, line in enumerate(lines):
+        if i in skip_lines:
+            continue
 
-    for line in result.stdout.splitlines():
         stripped = line.strip()
 
         # Start processing options when we see the "options:" line
         if stripped.lower() == "options:":
             in_options_section = True
             doc.append(line)
+            doc.append("")  # Add blank line after options header
             continue
 
         if in_options_section:
@@ -141,12 +148,39 @@ def setup(app: Sphinx):
                 short_opt = match.group(1)
                 long_opt = match.group(2)
 
-                # Always add a blank line before std:option to avoid indentation issues
+                # Add the std:option directive
                 if short_opt and long_opt:
-                    doc.extend(["", f".. std:option:: {short_opt}, {long_opt}", ""])
+                    doc.append(f".. std:option:: {short_opt}, {long_opt}")
                 elif short_opt:
-                    doc.extend(["", f".. std:option:: {short_opt}", ""])
+                    doc.append(f".. std:option:: {short_opt}")
+
+                doc.append("")  # Blank line after directive
+
+                # Collect all description lines for this option
+                description_lines = []
+
+                # Add the current line (contains the option and start of description)
+                parts = line.split(None, 2)  # Split on whitespace, max 2 splits
+                if len(parts) > 2:
+                    description_lines.append(parts[2])
+
+                # Look ahead for continuation lines
+                j = i + 1
+                while j < len(lines) and lines[j].startswith(
+                    "                        "
+                ):
+                    description_lines.append(lines[j].strip())
+                    skip_lines.add(j)
+                    j += 1
+
+                # Add description with proper indentation
+                for desc_line in description_lines:
+                    doc.append(f"   {desc_line}")
+
+                doc.append("")  # Blank line after option description
+                continue
 
+        # For non-option lines that we haven't processed, add as-is
         doc.append(line)
 
     cli_doc = Path(app.srcdir, "cli_args.rst")
