Squash merge feature/59-continuous-code-refactoring into develop

Author: tbouska

docs/features/20211123215420.md

@@ -8,8 +8,8 @@ tags: [hyperlink, zettel, markdown]
 
 Two syntaxes of links inside markdown documents are supported:
 
-1. Markdown style: `[title](url)`
-2. Wiki style: `[[url]]`
+1. Markdown style: ```[title](url)```
+2. Wiki style: ```[[url]]```
 
 When linking to a markdown document which is a zettel, wiki-style links will be converted to markdown-style and the title of the target zettel will be used.
 

mkdocs_zettelkasten/plugin/adapters/backlinks_to_page.py

@@ -2,42 +2,68 @@
 
 from mkdocs.structure.pages import Page
 
+from mkdocs_zettelkasten.plugin.entities.zettel import Zettel
 from mkdocs_zettelkasten.plugin.services.zettel_service import ZettelService
 
 logger = logging.getLogger(
     __name__.replace("mkdocs_zettelkasten.plugin.", "mkdocs.plugins.zettelkasten.")
 )
 
 
+def add_backlink_to_target(
+    link: str,
+    page: Page,
+    zettel: Zettel,
+    zettel_service: ZettelService,
+) -> None:
+    """
+    Adds a backlink to the target zettel if the given zettel links to the page.
+
+    This function checks if the zettel corresponds to the current page. If so,
+    it finds the target zettel referenced by the link and appends a backlink
+    entry to its backlinks list.
+
+    Args:
+        link (str): The link to the target zettel.
+        page (Page): The current MkDocs page.
+        zettel (Zettel): The zettel associated with the current page.
+        zettel_service (ZettelService): Service to retrieve zettels.
+    """
+
+    if zettel.id != page.meta["zettel"].id:
+        return
+
+    target_zettel = zettel_service.get_zettel_by_partial_path(link)
+
+    if not target_zettel:
+        return
+
+    backlink = {
+        "url": page.url,
+        "title": page.title,
+    }
+    target_zettel.backlinks.append(backlink)
+    logger.debug(
+        "Found link from %s to %s. Adding it to %s's backlinks.",
+        zettel.rel_path,
+        target_zettel.rel_path,
+        target_zettel.rel_path,
+    )
+
+
 def adapt_backlinks_to_page(page: Page, zettel_service: ZettelService) -> None:
     """
     Update backlinks for zettels that link to the current page.
 
     :param page: The page whose backlinks should be updated.
+    :type page: Page
     :param zettel_service: Service providing zettel and backlink information.
+    :type zettel_service: ZettelService
     """
+
     if not page.meta["is_zettel"]:
         return
 
-    current_zettel_id = page.meta["zettel"].id
-
     for link, source_zettels in zettel_service.backlinks.items():
         for zettel in source_zettels:
-            if zettel.id != current_zettel_id:
-                continue
-
-            target_zettel = zettel_service.get_zettel_by_partial_path(link)
-            if not target_zettel:
-                continue
-
-            backlink = {
-                "url": page.url,
-                "title": page.title,
-            }
-            target_zettel.backlinks.append(backlink)
-            logger.debug(
-                "Found link from %s to %s. Adding it to %s's backlinks.",
-                zettel.rel_path,
-                target_zettel.rel_path,
-                target_zettel.rel_path,
-            )
+            add_backlink_to_target(link, page, zettel, zettel_service)

mkdocs_zettelkasten/plugin/adapters/page_links_to_zettels.py

@@ -1,5 +1,6 @@
 from __future__ import annotations
 
+import re
 from typing import TYPE_CHECKING
 
 if TYPE_CHECKING:
@@ -69,6 +70,16 @@ def process_match(m: Match) -> str:
 
         return f"[{title}]({url})"
 
-    markdown = WIKI_LINK.sub(process_match, markdown)
+    # Split markdown into alternating segments (non-code/code)
+    code_block_pattern = re.compile(r"```", re.DOTALL)
+    parts = code_block_pattern.split(markdown)
 
-    return MD_LINK.sub(process_match, markdown)
+    processed_parts = []
+    for i, original_part in enumerate(parts):
+        processed_part = original_part
+        if i % 2 == 0:  # Process even-indexed non-code segments
+            processed_part = WIKI_LINK.sub(process_match, processed_part)
+            processed_part = MD_LINK.sub(process_match, processed_part)
+        processed_parts.append(processed_part)
+
+    return "```".join(processed_parts)