Skipped references resolving inside code blocks

Signed-off-by: Ihor Aleksandrychiev <ihor.aleksandrychiev@northern.tech>

Author: aleksandrychev

generator/_scripts/cfdoc_references_resolver.py

@@ -41,10 +41,24 @@ def process(file_path, references):
     with open(file_path, "r", encoding="utf-8") as f:
         content = f.read()
 
+    # find code blocks positions to skip them
+    code_ranges = []
+    for match in re.finditer(r'```[\s\S]*?```', content):
+        code_ranges.append((match.start(), match.end()))
+
+    def is_in_code_block(pos):
+        for start, end in code_ranges:
+            if start <= pos < end:
+                return True
+        return False
+
     # Pattern to match reference links: [`text`][reference]
     pattern = r"\[(.*?)\]\[(.*?)\]"
 
     def replace_link(match):
+        if is_in_code_block(match.start()):
+            return match.group(0)
+
         text, ref = match.groups()
         ref = (
             ref or text
@@ -69,6 +83,9 @@ def replace_link(match):
     functions_pattern = r"(?<!\[)\`([^\s]*?)\(\)\`(?!\])"
 
     def replace_function_link(match):
+        if is_in_code_block(match.start()):
+            return match.group(0)
+
         ref = match.group(1)
         text = f"{ref}()"
         ref_lower = ref.lower()