Check if directive is a CodeBlock directive

Avoids problems on styleguide with python link

Author: sciencewhiz

source/_extensions/redown.py

@@ -14,6 +14,7 @@
 from pathlib import Path
 from sphinx.application import Sphinx
 from dataclasses import dataclass
+from sphinx.directives.code import CodeBlock
 
 
 LINK_CORE = r"""
@@ -73,7 +74,15 @@ def replace(match: re.Match) -> str:
 
         for line in code.splitlines(keepends=True):
             if line.strip().startswith(":") and not firstCode:
-                ret += cindent + line
+                colon_start = line.find(":")
+                colon_end = line.rfind(":")
+                if colon_start != -1 and colon_end != -1 and colon_start < colon_end:
+                    option = line[colon_start + 1 : colon_end].strip()
+                    if option in CodeBlock.option_spec:
+                        ret += cindent + line
+                    else:
+                        ret += "\n" + cindent + line
+                        firstCode = True
             elif line.strip() == "":
                 if not firstCode:
                     firstCode = True

source/docs/beta/tasks/task-3-port-code.rst

@@ -13,9 +13,9 @@ Desired Feedback
 
 Please keep the following questions in mind as you complete the task and include this information, as appropriate, in your Task 3 report.
 
- 1. Note any required changes to your robot program not detailed in the :doc:`documentation for porting robot code </docs/yearly-overview/yearly-changelog>`.
- 2. What problems or difficulties did you encounter?
- 3. What questions did you have during the process?
- 4. Any specific suggestions on improving the documentation? (Were any instructions unclear?)
- 5. Compare the Free RAM on the DS diagnostics tab to similar code running on the 2024 image.
- 6. Is there anything else you want to tell us related to this task?
+1. Note any required changes to your robot program not detailed in the :doc:`documentation for porting robot code </docs/yearly-overview/yearly-changelog>`.
+2. What problems or difficulties did you encounter?
+3. What questions did you have during the process?
+4. Any specific suggestions on improving the documentation? (Were any instructions unclear?)
+5. Compare the Free RAM on the DS diagnostics tab to similar code running on the 2024 image.
+6. Is there anything else you want to tell us related to this task?