-
-{content}
-
-
-
-
-
-
-
-"""
-
-
-def extract_book_info(project_dir: Path) -> tuple[str, str]:
- """
- 从 README.md 或 SUMMARY.md 中提取书籍标题和副标题。
-
- Returns:
- (title, subtitle)
- """
- title = "Untitled Book"
- subtitle = "Generated Book"
-
- # 优先尝试 README.md
- readme_path = project_dir / 'README.md'
- if readme_path.exists():
- try:
- content = readme_path.read_text(encoding='utf-8')
- lines = content.split('\n')
- for line in lines[:10]: # 只看前10行
- match = re.match(r'^#\s+(.+)$', line)
- if match:
- title = match.group(1).strip()
- break
-
- # 尝试查找引用块作为副标题
- for line in lines[:20]:
- match = re.match(r'^>\s+(.+)$', line)
- if match:
- subtitle = match.group(1).strip()
- break
- return title, subtitle
- except Exception:
- pass
-
- # 其次尝试 SUMMARY.md
- summary_path = project_dir / 'SUMMARY.md'
- if summary_path.exists():
- try:
- content = summary_path.read_text(encoding='utf-8')
- lines = content.split('\n')
- for line in lines[:5]:
- match = re.match(r'^#\s+(.+)$', line)
- if match:
- title = match.group(1).strip()
- return title, subtitle
- except Exception:
- pass
-
- return title, subtitle
-
-
-def parse_summary(summary_path: Path) -> list[tuple[str, str, int]]:
- """
- 解析 SUMMARY.md，提取所有章节链接。
-
- Returns:
- list of (title, file_path, indent_level)
- """
- entries = []
- if not summary_path.exists():
- return entries
-
- content = summary_path.read_text(encoding='utf-8')
-
- # 匹配 Markdown 链接格式: * [标题](文件路径) 或 - [标题](文件路径)
- # 支持多级缩进
- pattern = r'^(\s*)[\*\-]\s*\[([^\]]+)\]\(([^)]+)\)'
-
- for line in content.split('\n'):
- match = re.match(pattern, line)
- if match:
- indent = len(match.group(1))
- title = match.group(2)
- file_path = match.group(3)
-
- # 跳过外部链接
- if file_path.startswith('http'):
- continue
-
- entries.append((title, file_path, indent))
-
- return entries
-
-
-def convert_internal_links_to_anchors(content: str, file_to_anchor_map: dict[str, str]) -> str:
- """
- Convert internal markdown file links to anchor links for single-page output.
-
- Examples:
- [Title](1.2_xxx.md) -> [Title](#anchor-id)
- [Title](../04_mcp/README.md) -> [Title](#anchor-id)
- [Title](file.md#section) -> [Title](#section)
-
- Args:
- content: The markdown content to process
- file_to_anchor_map: Mapping from file paths to their anchor IDs
-
- Returns:
- Content with internal links converted to anchors
- """
- def replace_link(match):
- link_text = match.group(1)
- link_target = match.group(2)
-
- # Skip external URLs and mailto links
- if link_target.startswith('http://') or link_target.startswith('https://') or link_target.startswith('mailto:'):
- return match.group(0)
-
- # Skip image links (they start with !)
- # Check the character before the match - this is handled by the regex not matching ![]()
-
- # Handle anchor-only links
- if link_target.startswith('#'):
- return match.group(0)
-
- # Split target into file path and anchor
- if '#' in link_target:
- file_path, anchor = link_target.split('#', 1)
- # If there's a specific anchor, use it directly
- return f'[{link_text}](#{anchor})'
- else:
- file_path = link_target
-
- # Normalize the file path (remove ./, ../ prefixes and get the basename for matching)
- # Extract just the filename for simple matching
- normalized_path = file_path.replace('\\', '/').strip()
-
- # Try to find a matching anchor in the map
- # First try exact match
- if normalized_path in file_to_anchor_map:
- return f'[{link_text}](#{file_to_anchor_map[normalized_path]})'
-
- # Try matching by filename only (for links like ../04_mcp/README.md)
- from pathlib import PurePosixPath
- filename = PurePosixPath(normalized_path).name
-
- # Search for matching file in the map
- for path, anchor in file_to_anchor_map.items():
- if PurePosixPath(path).name == filename:
- # For README.md, we need to be more specific - check parent directory
- if filename == 'README.md':
- # Try to match by parent directory
- parts = normalized_path.replace('../', '').replace('./', '').split('/')
- if len(parts) >= 2:
- parent_dir = parts[-2]
- path_parts = path.split('/')
- if len(path_parts) >= 2 and path_parts[-2] == parent_dir:
- return f'[{link_text}](#{anchor})'
- continue
- return f'[{link_text}](#{anchor})'
-
- # If no match found, generate an anchor from the link text
- # This handles cases where the file might not be in the map
- fallback_anchor = re.sub(r'[^\w\u4e00-\u9fff]+', '-', link_text.lower()).strip('-')
- return f'[{link_text}](#{fallback_anchor})'
-
- # Match markdown links: [text](target) but not image links 
- # Use negative lookbehind for !
- pattern = r'(? str:
- """
- Fix relative image paths for single-page output.
-
- When combining files from different directories, relative image paths like
- `_images/xxx.png` need to be prefixed with the source file's directory.
-
- Examples:
- If file is from 07_coding/7.4_ide.md:
-  -> 
-
- Args:
- content: The markdown content to process
- file_path: The relative path of the source file (e.g., "07_coding/7.4_ide.md")
-
- Returns:
- Content with fixed image paths
- """
- from pathlib import PurePosixPath
-
- # Get the directory of the source file
- source_dir = str(PurePosixPath(file_path).parent)
-
- # If the file is in the root directory, no path fixing needed
- if source_dir == '.':
- return content
-
- def replace_image(match):
- alt_text = match.group(1)
- image_path = match.group(2)
-
- # Skip external URLs
- if image_path.startswith('http://') or image_path.startswith('https://'):
- return match.group(0)
-
- # Skip absolute paths
- if image_path.startswith('/'):
- return match.group(0)
-
- # Skip paths that already have a directory prefix (not starting with _images/)
- if not image_path.startswith('_images/') and not image_path.startswith('./_images/'):
- # Check if it's already a full path like 07_coding/_images/
- if '/_images/' in image_path or image_path.startswith('../'):
- return match.group(0)
-
- # Remove leading ./ if present
- clean_path = image_path.lstrip('./')
-
- # Prepend the source directory
- new_path = f"{source_dir}/{clean_path}"
-
- return f''
-
- # Match markdown image syntax: 
- pattern = r'!\[([^\]]*)\]\(([^)]+)\)'
- return re.sub(pattern, replace_image, content)
-
-
-def clean_navigation_links(content: str) -> str:
- """
- Remove navigation links (Next/Previous, arrows) from the end of the content.
- """
- lines = content.rstrip().split('\n')
-
- # Navigation line patterns
- nav_patterns = [
- r'^\s*[-=]{3,}\s*$', # Separator lines
- r'^\s*(\*\*|__)?(Next|Previous|下一[节章页]|上一[节章页])(\*\*|__)?.*$', # Text based
- r'^\s*(➡️|→|=>|==>|Example|Download)\s*.*$', # Arrow/Indicator based
- r'^\s*\[(Next|Previous|下一[节章]|上一[节章]).*?\]\(.*?\)\s*$', # Link with nav text
- ]
-
- # Also catch "Arrow [Link](Url)" specifically if not caught above
- # And purely link lines that look like nav " [Title](Url) " relative short
-
- while lines:
- last_line = lines[-1].strip()
- if not last_line:
- lines.pop()
- continue
-
- is_nav = False
-
- # Check explicit patterns
- for pattern in nav_patterns:
- if re.match(pattern, last_line, re.IGNORECASE):
- is_nav = True
- break
-
- # Check "Arrow + Link" specifically (common in this book)
- if not is_nav:
- # Pattern: Arrow (optional) + Link
- # e.g. "➡️ [Title](Link)"
- if re.match(r'^\s*(➡️|→|=>|==>)\s*\[.+?\]\(.+?\)\s*$', last_line):
- is_nav = True
-
- if is_nav:
- # print(f"DEBUG: Removing nav line: {last_line}")
- lines.pop()
- else:
- # Found a non-nav line, stop checking
- break
-
- return '\n'.join(lines)
-
-
-def clean_redundant_header(content: str, title: str, subtitle: str) -> str:
- """
- Remove the title and subtitle from the beginning of the content if they match the book info.
- """
- lines = content.split('\n')
-
- # Remove leading blank lines
- while lines and not lines[0].strip():
- lines.pop(0)
-
- if not lines:
- return content
-
- # Check for Title (H1)
- # Case 1: Exact match "# Title"
- # Case 2: Match with some whitespace flexibility
- if re.match(r'^#\s+' + re.escape(title) + r'\s*$', lines[0].strip(), re.IGNORECASE):
- lines.pop(0)
- # Remove blank lines after title
- while lines and not lines[0].strip():
- lines.pop(0)
-
- # Check for Subtitle (Blockquote)
- if subtitle and lines and lines[0].strip().startswith(">"):
- # Clean punctuation for comparison just in case
- line_text = lines[0].strip().lstrip('>').strip()
- if subtitle in line_text or line_text in subtitle:
- lines.pop(0)
- # Remove blank lines after subtitle
- while lines and not lines[0].strip():
- lines.pop(0)
-
- # Also remove common separator lines like "---" that often follow the header
- if lines and lines[0].strip().replace(' ', '') == '---':
- lines.pop(0)
- while lines and not lines[0].strip():
- lines.pop(0)
-
- return '\n'.join(lines)
-
-
-def markdown_to_html(md_content: str) -> str:
- """
- 将 Markdown 转换为 HTML。
- 简单实现，不依赖外部库。
- """
- lines = md_content.split('\n')
- html_lines = []
- in_code_block = False
- code_lang = ''
- code_content = []
- in_list = False
- in_table = False
- table_rows = []
-
- def process_inline(text: str) -> str:
- """处理行内格式"""
- # 代码
- text = re.sub(r'`([^`]+)`', r'\1', text)
- # 粗体
- text = re.sub(r'\*\*([^*]+)\*\*', r'\1', text)
- # 斜体
- text = re.sub(r'\*([^*]+)\*', r'\1', text)
- # 链接
- text = re.sub(r'\[([^\]]+)\]\(([^)]+)\)', r'\1', text)
- return text
-
- i = 0
- while i < len(lines):
- line = lines[i]
-
- # 代码块
- if line.startswith('```'):
- if in_code_block:
- html_lines.append(f'
{html.escape(chr(10).join(code_content))}
')
- code_content = []
- in_code_block = False
- else:
- code_lang = line[3:].strip() or 'text'
- in_code_block = True
- i += 1
- continue
-
- if in_code_block:
- code_content.append(line)
- i += 1
- continue
-
- # 表格
- if '|' in line and not line.strip().startswith('```'):
- cells = [c.strip() for c in line.split('|')]
- cells = [c for c in cells if c] # 移除空单元格
-
- if cells and not all(re.match(r'^[-:]+$', c) for c in cells):
- if not in_table:
- in_table = True
- table_rows = []
- table_rows.append(cells)
- elif in_table and all(re.match(r'^[-:]+$', c) for c in cells):
- pass # 跳过分隔行
-
- # 检查下一行是否还是表格
- if i + 1 >= len(lines) or '|' not in lines[i + 1]:
- if in_table and table_rows:
- html_lines.append('
')
- for j, row in enumerate(table_rows):
- tag = 'th' if j == 0 else 'td'
- html_lines.append('
')
- for cell in row:
- html_lines.append(f'<{tag}>{process_inline(cell)}')
- html_lines.append('