Convert to code fences (#224)

pfultz2 · web-flow · commit 63ac019fca32 · 2023-01-11T18:32:42.000-06:00
* Convert to code fences

* Improve handling of conde fences and nested lists
diff --git a/doc/conf.py b/doc/conf.py
@@ -407,6 +407,53 @@ def parse_version():
 
 nitpicky = True
 
+def convert_to_code_fences(lines, fence='```'):
+    output = []
+    incode = False
+    isempty = False
+    infence = False
+    for line in lines:
+        sline = line.strip()
+        iscode = (isempty or incode) and line.startswith('    ') and not infence
+        isempty = not sline
+        isfence = line.startswith('```')
+        if infence:
+            if isfence:
+                infence = False
+            output.append(line)
+        elif incode:
+            if isempty:
+                output.append(line)
+            elif iscode:
+                output.append(line[4:])
+            else:
+                output.append(fence)
+                output.append('\n\n')
+                output.append(line)
+                incode = False
+        else:
+            if iscode:
+                nested_list = sline.startswith(('-', '*', '+')) or sline[0].isdigit()
+                x = line[4:]
+                if nested_list:
+                    output.append(line)
+                elif x.startswith('!'):
+                    output.append('{fence}{language}'.format(
+                        fence=fence, language=x[1:].strip()))
+                    output.append('\n')
+                else:
+                    output.append(fence+'cpp')
+                    output.append('\n')
+                    output.append(x)
+                incode = not nested_list
+            elif isfence:
+                infence = True
+                incode = False
+                output.append(line)
+            else:
+                output.append(line)
+    return '\n'.join(output)
+
 def insert_header(lines, f):
     for line in lines:
         yield line
@@ -428,6 +475,9 @@ def extract_doc(app, docname, source):
         lines = source[0].split('\n')
         md = [line[len(extract_prefix):] for line in lines if line.startswith(extract_prefix)]
         source[0] = '\n'.join(insert_header(md, os.path.relpath(path, include_dir)))
+    if path.endswith(('.hpp', '.md')):
+        lines = source[0].split('\n')
+        source[0] = convert_to_code_fences(lines)
 
 # app setup hook
 def setup(app):
