fix(readme): normalize image paths via config to restore README/Pages rendering

Author: Nora

README.md

@@ -22,7 +22,7 @@
 [![Discord](https://img.shields.io/badge/💬_Discord-Join_Discussion-5865F2?style=for-the-badge&logo=discord&logoColor=white)](https://discord.gg/awBHrRJx)
 [![Issues](https://img.shields.io/badge/💡_GitHub-Open_Issue-181717?style=for-the-badge&logo=github&logoColor=white)](https://github.com/DeepSoftwareAnalytics/Awesome-Issue-Resolution/issues)
 
-<img src="docs/images/awesome-issue-resolution.png" alt="Awesome Issue Resolution" width="60%">
+<img src="app/docs/images/awesome-issue-resolution.png" alt="Awesome Issue Resolution" width="60%">
 
 </div>
 
@@ -91,7 +91,7 @@ Based on a systematic review of **204 papers and online resources**, this survey
 
 <!-- START DEMO -->
 <div align="center">
-<img src="docs/images/database.gif" alt="Admin Interface Demo" style="zoom:50%;" />
+<img src="app/docs/images/database.gif" alt="Admin Interface Demo" style="zoom:50%;" />
 
 </div>
 <!-- END DEMO -->

app/config.py

@@ -42,3 +42,6 @@ def script(name: str) -> Path:
 HOST = '0.0.0.0'
 PORT = 5000
 DEBUG = True
+
+README_IMAGE_PREFIX = 'app/docs/images'
+DOCS_IMAGE_PREFIX = 'images'

app/view/sync_readme.py

@@ -126,6 +126,21 @@
 )
 
 
+def normalize_readme_asset_paths(content: str) -> str:
+    image_prefix = getattr(config, 'README_IMAGE_PREFIX', 'app/docs/images').rstrip('/')
+    content = re.sub(
+        r'(<img\s+[^>]*src=["\'])docs/images/',
+        rf'\1{image_prefix}/',
+        content
+    )
+    content = re.sub(
+        r'(\!\[[^\]]*\]\()docs/images/',
+        rf'\1{image_prefix}/',
+        content
+    )
+    return content
+
+
 def load_yaml(path: Path) -> List[Dict]:
     """Load YAML file and return list of entries."""
     if not path.exists():
@@ -381,7 +396,8 @@ def update_readme() -> bool:
         print(f"[ERROR] {README_PATH} does not exist!", file=sys.stderr)
         return False
 
-    content = README_PATH.read_text(encoding="utf-8")
+    raw_content = README_PATH.read_text(encoding="utf-8")
+    content = normalize_readme_asset_paths(raw_content)
 
     # Check if papers markers exist
     if "<!-- START PAPERS -->" not in content:
@@ -437,7 +453,7 @@ def update_readme() -> bool:
         )
 
     # Write back to file
-    if new_content != content:
+    if new_content != raw_content:
         README_PATH.write_text(new_content, encoding="utf-8")
         print("\n✓ README.md updated successfully!")
         return True