gaschz/trilium
1
0
Fork 0
mirror of https://github.com/zadam/trilium.git synced 2025-10-20 07:08:55 +02:00
Code Issues Actions 18 Packages Projects Releases Wiki Activity

feat(docs): try to handle moved files too in script

Browse Source
This commit is contained in:
perf3ct 2025-09-04 21:55:28 -07:00
parent 1847fc2060
commit 94089113ef
No known key found for this signature in database
GPG Key ID: 569C4EEC436F5232
1 changed files with 41 additions and 11 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

52
scripts/fix-mkdocs-structure.py
View File

@ -66,26 +66,56 @@ def update_references(docs_dir):
original_content = content original_content = content
# Update references to moved files # Update references to moved files
# This is a simplified approach - you might need more sophisticated regex
# for complex cases
# Look for markdown links like [text](path.md) # Look for markdown links like [text](path.md)
import re import re
from urllib.parse import unquote, quote
pattern = r'\[([^\]]*)\]\(([^)]+\.md)\)' pattern = r'\[([^\]]*)\]\(([^)]+\.md)\)'
def fix_link(match): def fix_link(match):
text = match.group(1) text = match.group(1)
link = match.group(2) link = match.group(2)
# If the link doesn't contain a slash, it's a local reference # Skip external links
if '/' not in link and not link.startswith('http'): if link.startswith('http'):
# Check if this might be a moved file return match.group(0)
basename = link[:-3] # Remove .md
# If there's a directory with this name, update the link # Decode URL-encoded paths for processing
possible_dir = Path(root) / basename decoded_link = unquote(link)
# Resolve the link path relative to current file
current_dir = Path(root)
# For any .md link, check if there's a directory with index.md
# that should be used instead
if not decoded_link.startswith('/'):
# Resolve relative to current directory
resolved_path = (current_dir / decoded_link).resolve()
# Check if this points to a file that should be a directory
# Remove .md extension to get the potential directory name
if resolved_path.suffix == '.md':
potential_dir = resolved_path.with_suffix('')
potential_index = potential_dir / 'index.md'
# If a directory with index.md exists, update the link
if potential_index.exists():
# Calculate relative path from current file to the directory
new_path = os.path.relpath(potential_dir, current_dir)
# Return link pointing to directory (MkDocs will serve index.md)
# Replace backslashes with forward slashes for consistency
new_path = new_path.replace('\\', '/')
# Re-encode spaces in the path for URL compatibility
new_path = new_path.replace(' ', '%20')
return f'[{text}]({new_path}/)'
# Also handle local references (same directory)
elif '/' not in decoded_link:
basename = decoded_link[:-3] # Remove .md
possible_dir = current_dir / basename
if possible_dir.exists() and possible_dir.is_dir(): if possible_dir.exists() and possible_dir.is_dir():
# Point to the directory (which will serve index.md) # Re-encode spaces for URL compatibility
return f'[{text}]({basename}/)' encoded_basename = basename.replace(' ', '%20')
return f'[{text}]({encoded_basename}/)'
return match.group(0) return match.group(0)